ES
games/dmmotor / BRIEF.md · commit 9d248a4
# dmmotorPorter en PHP (JumPHP) le moteur de jeu en vue subjective publié en GPL v2 par id Software (code source linuxdoom-1.10, github.com/id-Software/DOOM), sous le nom « dmmotor ». Contenu du jeu : Freedoom (BSD, freedoom.github.io), en priorité Freedoom Phase 1 (freedoom1.wad), le dépôt source Freedoom est dans ~/Projets/JumPHPGames/freeraytracepov/freedoom. Contraintes légales : le projet est sous GPL v2 (fichier LICENSE, mentions de copyright id Software conservées, modifications indiquées), crédits Freedoom (COPYING BSD + CREDITS) conservés ; ne jamais utiliser ni distribuer les WAD commerciaux ou shareware d'id Software ; ne pas utiliser le nom ni le logo « Doom » (marque déposée) : le jeu s'appelle dmmotor, « basé sur le code source GPL d'id Software et le contenu Freedoom ». Fonctionnalités visées : lecture du WAD (lumps, PLAYPAL, COLORMAP, patches, textures, flats, sprites), rendu BSP murs/sols/plafonds/sprites en 320x200 palette, déplacement et collisions du joueur, portes/ascenseurs, armes et monstres (logique P_* / thinkers), menus, HUD, sons. Commandes clavier/souris + tactile.## 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/dmmotor(category: Action).- The game is `games/dmmotor/`. 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/dmmotor/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 dmmotor` 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/dmmotor/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/dmmotor/assets/thumbnail.png`.- When the game is done: MCP `update_project` with `listed: true` shows it in the playground's directory.