# ALIS — Silmarils engine Port 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//). 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 game This game is the port to PHP of an existing game whose source code exists (see above where it is). Keep its rules, levels and feel; translate its code into readable PHP in the JumPHP structure (scenes, entities), with its 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 playground This 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.