games/alis
/ BRIEF.md · commit 9c722cf
# ALIS — Silmarils enginePort en PHP (JumPHP) du moteur ALIS de maestun (https://github.com/maestun/alis, MIT, Olivier Huguenot & Vadim Kindl) : la machine virtuelle des jeux Silmarils. Au démarrage, le moteur propose la liste des jeux dont les données originales sont présentes (fichiers privés du projet, jamais dans le dépôt) ; premier jeu fourni : Robinson's Requiem version PC CD (VM v31, moteur 3D). Les gros fichiers (films, cartes) sont chargés à la demande (fichiers privés sous lazy/<jeu>/). Son : flux PCM via $engine->pcm() quand le moteur le fournit. Le code est déjà écrit localement (port C → PHP complet), il sera poussé dans ce dépôt.## A port of an existing gameThis game is the port to PHP of an existing game whose source code exists (see above where it is). Keep itsrules, levels and feel; translate its code into readable PHP in the JumPHP structure (scenes, entities), withits assets if their license allows them in a public repository (else: private files of the playground, MCP tool`upload_private_files` or Studio → the project → "Fichiers privés"). Credit the original authors and keep their license.---## The JumPHP playgroundThis project was made on the JumPHP playground: the game's page is https://jumphp.net/alis(category: Aventure).- The game is `games/alis/`. Read `AGENTS.md` (the JumPHP contract) first; replace the skeleton with the game described above; follow the definition of done (tests, screenshots you look at, browser build).- **Develop with game tests, visually**: for each mechanic, as you write it, a test in `games/alis/tests/` that extends `JumPHP\Testing\GameTestCase` and plays it ("the player jumps onto the platform", "the enemy dies when hit"; AGENTS.md "Game tests"); `bin/jumphp test alis` after each change. The user watches them play live in Claude Code (the `jumphp-live` pane) and, after a push, replays each test filmed in the studio (MCP `run_tests`).- **Publishing**: every push to `main` is online within a minute (Git webhook). The MCP tool `sync_project` (server `jumphp`) publishes at once and returns the errors: a commit with a PHP syntax error is not published (the previous version stays online).- The playground loads the game file by file with its shared engine: Composer packages other than `jumphp/engine` are not available there.- **The game's home page**: make `games/alis/site/` (AGENTS.md section 13: themed with the game's own graphics, SEO, a link to `play/`); it is the game's page on the playground. Also `games/alis/assets/thumbnail.png`.- When the game is done: MCP `update_project` with `listed: true` shows it in the playground's directory.