winzik/docs/cpc.md
David Nurdin f2d9182e7a Rainbow Islands links: git.jumphp.net
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-11-07 10:01:07 +01:00

55 lines
3.3 KiB
Markdown

# 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](https://git.jumphp.net/jumphp/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) :
```bash
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 :
```bash
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).
1. **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).
2. **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-'`).
3. **Trouver les variables** (niveau, vies, caméra, musique demandée) : deux images mémoire (`-d`) et
`tools/cpc.py diff --from 3 --to 2`, puis `-w ADRESSE` montre le code qui les modifie.
4. **Piloter le jeu** : choisir le niveau (`-p PC:ADRESSE=VALEUR` au moment où le jeu le fixe), le rendre
immortel ou muet pour les captures (`-F trame:ADRESSE=VALEUR` une fois le code chargé).
5. **Extraire** : `tools/cpc.py palette / screen / tiles / gfx` (sprites en PNG, `--zigzag` si 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`).
6. **Dans JumPHP** : les éléments dans `games/<id>/assets/` (PNG, JSON, Ogg), les scripts d'extraction et
les adresses trouvées dans `games/<id>/tools/extract/` (un script qui refait `assets/` 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.