# dmmotor Porter 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 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/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.