3.3 KiB
Refaire un jeu Amstrad CPC depuis sa disquette
Pour refaire en JumPHP un jeu CPC « avec les mêmes graphismes, la même musique », il y a dsk2jumphp : un petit émulateur CPC 6128 sans écran qui fait tourner le jeu original et note tout ce qu'il fait, et les outils qui en sortent les éléments du jeu. Le remake de Rainbow Islands a été fait ainsi : https://git.jumphp.net/jumphp/rainbow-island.
Installation
À côté du projet (pas dedans : on n'y met ni disquette, ni ROM, ni image mémoire) :
git clone https://git.jumphp.net/jumphp/dsk2jumphp.git ~/dsk2jumphp
make -C ~/dsk2jumphp # un compilateur C ; Python 3 avec Pillow et numpy ; ffmpeg pour les .ogg
make -C ~/dsk2jumphp test
Pour Claude Code, le skill fourni lui apprend la méthode et les outils :
mkdir -p .claude/skills && ln -s ~/dsk2jumphp/.claude/skills/dsk2jumphp .claude/skills/dsk2jumphp
Ensuite, il suffit de demander : « refais le jeu de ~/jeux/xyz.dsk ». Les consignes complètes pour les agents
sont dans AGENTS.md de dsk2jumphp (et la section 12 de celui de JumPHP).
La méthode en bref
On ne lit pas le jeu, on le fait tourner et on observe (détails : docs/method.md de dsk2jumphp).
- La disquette :
tools/dsk.py info(format, secteurs),files(fichiers AMSDOS : jeu lancé par le BASIC → démarrage avec les ROM),sectors disk.dsk 0 41(le secteur de boot d'un jeu qui se charge seul). - Le faire tourner :
emulator/cpc jeu.dsk run 1500 -S 50(une capture par seconde) ; avec les ROM de ta machine :-rom cpc6128.rom -urom 7:amsdos.rom -type '100:RUN"DISC\n'. Les touches se scriptent (-k '300:joy_fire+,320:joy_fire-'). - Trouver les variables (niveau, vies, caméra, musique demandée) : deux images mémoire (
-d) ettools/cpc.py diff --from 3 --to 2, puis-w ADRESSEmontre le code qui les modifie. - Piloter le jeu : choisir le niveau (
-p PC:ADRESSE=VALEURau moment où le jeu le fixe), le rendre immortel ou muet pour les captures (-F trame:ADRESSE=VALEURune fois le code chargé). - Extraire :
tools/cpc.py palette / screen / tiles / gfx(sprites en PNG,--zigzagsi une ligne sur deux est à l'envers),text(retrouve un texte quel que soit le codage des lettres), les cartes rebâties depuis les écritures dans la mémoire du jeu, la musique depuis le journal du processeur sonore (tools/psg.py render ... musique.ogg). - Dans JumPHP : les éléments dans
games/<id>/assets/(PNG, JSON, Ogg), les scripts d'extraction et les adresses trouvées dansgames/<id>/tools/extract/(un script qui refaitassets/depuis la disquette), puis le jeu en PHP lisible, à la taille d'écran d'origine (pixels du mode 0 doublés en largeur).
À savoir
- Les ROM du CPC ne sont pas fournies : celles d'un émulateur déjà installé suffisent (
cpc6128.rom,amsdos.rom). Beaucoup de jeux se chargent seuls et n'en ont pas besoin. - Ne publie que les scripts et les notes : la disquette, les ROM et les images mémoire restent chez toi ; les éléments extraits appartiennent aux auteurs du jeu.
- L'émulateur vise les jeux, pas les démos : pas de chronométrage au cycle près, pas de protections de disquette exotiques, pas de cassette.