Repository navigation
Run the game every way with one ./rylween command, and move support/ into runtimes/, tools/ and game/ - #58
Merged
Merged
Conversation
The repository root keeps only what it is about: the game, its runtimes, tools, and deployment. :web-common moves to runtimes/web-common beside the runtimes that use it, :tools to tools/, and the Python audio synthesizers to game/audio-tools beside the sounds they render. The ANSI terminal primitives (AnsiTerminal, AnsiCodes, AnsiInput) move into :runtime, which now depends on JLine itself, so the :terminal project and its check are gone. The ledger test, CI, and the module guides follow the new paths.
./rylween, a link to deploy/rylween, replaces bin/run.sh, bin/run-server.sh, bin/run-bitmap-server.sh, bin/backup-web-data.sh, deploy/deploy-rylween.sh, and the root deploy.sh: - ./rylween plays the ANSI game in this terminal, as bin/run.sh did. The terminal zip ships it as bin/rylween, where it only plays. - ./rylween serve hosts the game for browsers. Its defaults are the bitmap game, in a container, over HTTP, on this machine only: --bitmap --docker --http --local. --ansi, --no-docker, --https, and --lan or --host pick the others; deploy.sh published on the LAN by default. - ./rylween stop stops whatever serve started, and ./rylween backup archives a data directory or a container volume. The images are deploy/docker/Dockerfile.bitmap and Dockerfile.ansi (once Dockerfile.bitmap-production and Dockerfile.production); the dev-only deploy/docker/Dockerfile is gone. compose.yaml runs the ANSI game too, in its ansi profile, which the release's compose copy leaves out. deploy/README.md documents the command and its defaults, and the other guides use it.
lagergren
force-pushed
the
lagergren/one-rylween-command
branch
from
November 7, 2026 17:43
0b6c186 to
dd6b9ce
Compare
The release has attached a compose.https.yaml pinned to its image since the HTTPS deployment landed; the Releasing section named only the zip and compose.yaml.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Six scripts become one command:
./rylweenplays the game, serves it, stops it, and backs up its data. Serving defaults to this machine only, so nothing is reachable from other machines unless you ask for it with--lan. The repository root also losesbin/andsupport/: their modules move next to the code that uses them.Stacked on #57; the base moves to
mainonce that merges.Commits
Move support/ into runtimes/, tools/ and game/.
support/web-common→runtimes/web-common, beside the runtimes that use it.support/tools→tools.support/audio→game/audio-tools, beside the sounds it renders.support/terminalis merged into:runtime.AnsiTerminal,AnsiCodesandAnsiInputkeep theirrylween.terminalpackage, and:runtimenow depends on JLine directly. The:terminalproject and its check are gone, and CI and the rootcheckdrop it.The ledger test,
.gitignore, and the module guides follow the new paths.Run the game every way with one ./rylween command.
./rylween, a link todeploy/rylween, replacesbin/run.sh,bin/run-server.sh,bin/run-bitmap-server.sh,bin/backup-web-data.sh,deploy/deploy-rylween.shand the rootdeploy.sh:./rylweenbin/run.shdid). The terminal zip ships the same script asbin/rylween, where it only plays../rylween serve./rylween stopservestarted../rylween backup--data) or a container volume (--volume)../rylween helpservetakes one choice from each pair, defaulting to--bitmap --docker --http --local:--bitmapor--ansipicks the game.--dockeror--no-dockerpicks where it runs: a container, or the launcher built from the checkout.--httpor--httpspicks the protocol.--local,--lanor--host ADDRESSpicks who can connect.--localis the default becausedeploy.shpublished on the LAN by default.deploy/docker/Dockerfile.bitmapandDockerfile.ansi, renamed fromDockerfile.bitmap-productionandDockerfile.production. The dev-onlydeploy/docker/Dockerfileis removed.deploy/compose.yamlalso runs the ANSI game, under theansiprofile, on its own port and volume. It now setsRYLWEEN_PUBLIC_URL, so the bitmap server prints the right link.release.ymlbuildsDockerfile.bitmap. The release'scompose.yamlcopy drops the ANSI service, since releases don't publish an ANSI image.deploy/README.mddocuments the command, with a table of the defaults. The root README and the runtime and web-common guides use the new commands.Testing
shellcheck deploy/rylweenandactionlintare clean../rylween(play):/bin/bash3.2;--name Strong;serveand--build../rylween serve --no-docker:--nameand with--lan;servereplaces the running server, andstopstops it../rylween serve: the bitmap and ANSI containers, built from the new layout through compose, using an isolated compose project name.backup --dataandbackup --volume, and invalid flag combinations.compose.yamldrops the ANSI service and volume.Not tested here:
./rylween serve --httpsagainst a real domain. It runs the samecompose.https.yamlsteps as #57's./deploy.sh --https.