# Exode — prj9

Un jeu de mine, de défense et d'ordres indirects : vue de côté en petits blocs, 3 androïdes à commander, un module à défendre la nuit, et un vaisseau de secours à construire pour sauver l'équipage resté en orbite.

Cette page est le **suivi du projet** : ce qui est fait, ce qui reste, ce qui n'est pas vérifié. Elle est rendue depuis `SUIVI.md` : pour la tenir à jour, modifie ce fichier (aucun redémarrage).

Dernière passe : 16 novembre 2026 (passe 1, mise en place de la V1).

![Le jeu de nuit, avec murs, tourelles, pieux et bobine](/captures/nuit.png)

## État en bref

- La V1 est **jouable de bout en bout** dans le navigateur : ordres, minage, dépôt, impression, pose, nuits, recherche, victoire ou défaite.
- Le vérificateur sans affichage **passe** : 12 parties automatiques gagnées sur 12, aucun contrôle en défaut.
- **Aucun humain n'a encore joué.** La souris et le clavier ont été essayés par événements simulés, pas à la main. L'équilibrage n'est pas réglé.

## Fait

- [x] Monde en petits blocs vu de côté, généré par graine : relief, terre, roche, grottes, fer, cristal en profondeur, arbres (160 × 64 cases).
- [x] Module spatial à défendre (500 PV), défaite s'il est détruit.
- [x] 3 androïdes (Iris, Onyx, Vega) commandés indirectement : zones à creuser, zones d'arbres à abattre, objets à monter, dépôt au module.
- [x] Ordre direct : clic droit, l'androïde va tenir un poste ; bouton Auto / Poste par androïde.
- [x] Tâches automatiques sans ordre, par priorité : se faire réparer, déposer, relever un camarade, monter un objet, traiter les zones marquées, récolter ce qui manque (arbres, filons à l'air libre), garder le module la nuit.
- [x] Les androïdes se défendent seuls (tir à 7 cases) et font rempart au contact.
- [x] Androïde hors service à 0 PV, il tombe au sol. Trois façons de le relever : un camarade (6 s), le module s'il est tombé tout près (15 s), un drone de dépannage imprimé.
- [x] Cycle jour (110 s) / nuit (65 s), ciel, soleil, lune, étoiles, épave en orbite, reliefs lointains.
- [x] Vagues la nuit, plus fortes chaque nuit. 3 ennemis : rampant, volant (à partir de la nuit 2), brute (nuit 4). Le soleil brûle les survivants à l'aube.
- [x] Fosses : les ennemis au sol y tombent et grimpent lentement (0,5 s par case pour un rampant, 1 s pour une brute).
- [x] Imprimante 3D du module : file de 8, coût payé à la mise en file, temps de production, annulation remboursée.
- [x] 6 objets à poser : mur en bois, mur en pierre, pieux, mine, tourelle, bobine à arc. Creuser un objet posé le démonte et le rend.
- [x] Arbre de recherche : Maçonnerie, Métallurgie, Blindage, Cristallographie, Astronautique.
- [x] Victoire : coque + moteur + carburant du vaisseau de secours, avec décollage à l'écran.
- [x] Visuels dessinés par le code : tuiles (4 variantes), sprites, éclairage sous terre, lampes des androïdes et du module, particules, tirs.
- [x] Interface : ressources, horloge, vie du module, cartes des androïdes, panneau d'impression, barre d'outils, carte réduite, vitesse ×1 ×2 ×4, pause, aide en jeu à l'ouverture.
- [x] Simulation en données pures, séparée de l'affichage, pas fixe de 0,05 s, déterministe par graine.
- [x] Vérificateur en une commande, service systemd utilisateur, git local.

## À faire

- [ ] Faire jouer un humain et régler l'équilibrage (voir « Non vérifié »).
- [ ] Sauvegarde de la partie (rien n'est gardé si on recharge la page ; seule la graine est dans l'adresse).
- [ ] Ordres directs plus fins : « creuse ici, toi », « répare-le, toi », priorité entre zones.
- [ ] Transport réel des objets : aujourd'hui un objet posé sort du stock sans que l'androïde passe le chercher au module.
- [ ] Son et musique (rien pour l'instant).
- [ ] Jeu au doigt (tablette, téléphone) : non prévu, souris et clavier seulement.
- [ ] Plus de variété : ennemi fouisseur, boss, météo, biomes, coffre de stockage, échelles.
- [ ] Annonce de la vague avant la nuit (composition, côté d'arrivée).
- [ ] Réglage de difficulté et écran de choix de planète.

## Non vérifié

- **Le jeu à la vraie souris.** Les gestes (tracer une zone, poser, sélectionner, clic droit, raccourcis, boutons) ont été déclenchés par événements simulés dans un navigateur sans écran, et ils donnent le bon résultat. Personne n'a joué à la main : confort, lisibilité des gestes et molette ne sont pas jugés.
- **L'équilibrage.** Le joueur automatique gagne entre le jour 11 et le jour 25, et dans les 12 parties le module ne perd **aucun** point de vie. Avec 8 tourelles et un puits profond, la défense est sans doute trop facile. À l'inverse, sans aucun ordre, le module tombe vers le jour 7 ou 8.
- **La durée d'une partie.** Environ 3 minutes par jour à vitesse ×1 ; une partie entière n'a jamais été jouée en temps réel.
- **L'écran de victoire et de défaite** : la fin est atteinte dans le vérificateur, mais ces deux écrans et le décollage n'ont pas été regardés en capture.
- **L'affichage** n'a été vu que dans le navigateur sans écran de la machine (1500 × 900). Petits écrans et autres navigateurs non essayés.
- **Les performances** sur une vraie machine : non mesurées.

## Résultat du vérificateur

Commande : `node verifier.mjs 12` (24 s). Dernier résultat, 16 novembre 2026 :

```
A. Déterminisme (graine 7, 6000 pas rejoués) : OK
B. Joueur automatique, 12 graines : 12/12 victoires, jour de victoire 11 à 25
C. Sans aucun ordre, 4 graines, 8 jours : aucun contrôle en défaut (défaite au jour 7 ou 8)
Bilan : tout passe
```

Contrôles à chaque pas : pas de nombre invalide, stocks jamais négatifs, androïdes jamais dans une case pleine ni hors du monde, aucune tâche sans progrès pendant 25 s, plus aucun ennemi 20 s après l'aube.

## Choix faits, révisables

- **Les androïdes grimpent et ont des propulseurs verticaux.** Ils avancent d'appui en appui (sol, paroi, corniche) et traversent le vide à la verticale. Raison : sans cela, un androïde tombé dans une grotte restait coincé (défaut trouvé par le vérificateur).
- **La nuit, les androïdes en automatique ne récoltent pas** : ils montent les objets, relèvent les camarades et gardent le module. Raison : sinon ils restaient au fond du puits pendant l'attaque.
- **Les tirs amis traversent les murs posés** (« meurtrières »), seul le terrain naturel les arrête. Raison : un mur de 2 de haut aveuglait les défenseurs.
- **Recherche et fabrication partagent la même file** de l'imprimante.
- **Les androïdes dépassent un peu leur charge** (sac 8, un arbre peut donner 6 bois d'un coup).
- **Les ennemis apparaissent à 38–46 cases** de chaque côté du module, pas au bord du monde.
- **La terre ne rapporte rien** ; pierre 1, fer 2, cristal 2 par case.
- **La carte réduite montre les filons** (le « scanner orbital »), alors que la vue principale est sombre sous terre.
- **Palette** : feuillage turquoise, sol rouille, roche bleu ardoise. La règle « pas de vert » du prj1 concernait les vaisseaux et n'a pas été demandée ici ; le turquoise s'en approche, à valider.
- **Technique** : JavaScript sans bibliothèque ni CDN, canvas 2D, serveur Node sans dépendance. Raison : rien à installer, tout se lit.
- **Nom « Exode »** : provisoire.

## Points à trancher

- Difficulté voulue : combien de nuits pour une partie, et faut-il que la première nuit soit dangereuse ?
- Les fosses très profondes neutralisent presque les ennemis au sol : garder (c'est l'idée d'origine), limiter, ou ajouter un ennemi qui creuse ?
- Faut-il un vrai transport des objets et des ressources par les androïdes (plus RimWorld), ou garder le raccourci actuel ?
- Les androïdes doivent-ils marcher seulement, sans grimper ni propulseurs (plus Terraria, avec échelles à fabriquer) ?
- La palette turquoise convient-elle, vu la règle « pas de vert » du prj1 ?
- Sauvegarde : dans le navigateur seulement, ou côté serveur (la machine est publique et sans comptes) ?

## Pour reprendre le projet

- Dossier : `/srv/projects/prj9`, port 4009, adresse `https://prj9.dev-01.cautere.cc`. Règles de la machine : `/srv/projects/README.md`. Le dossier a été créé à la main avec l'accord du propriétaire, car `dev-claim` aurait donné prj5.
- `jeu/sim.mjs` : toute la règle du jeu, sans navigateur. `creer(graine)`, `pas(s)`, `commande(s, ordre)`.
- `jeu/rendu.mjs` : l'affichage (tuiles, sprites, ciel, lumière). `jeu/main.mjs` : souris, clavier, panneaux. `jeu/index.html` : la page.
- `verifier.mjs` : parties automatiques. `server.mjs` : sert cette page et le jeu. `captures/` : images de contrôle.
- Dans la console du navigateur : `jeu.s` (l'état), `jeu.commande({...})`, `jeu.avancer(200)`. Adresse avec graine : `/jeu/?graine=3`.

```
cd /srv/projects/prj9
node verifier.mjs 12                      # doit finir par « tout passe »
systemctl --user status prj9-app          # le service
systemctl --user restart prj9-app         # après une modification de server.mjs
# s'il n'existe plus :
systemd-run --user --unit prj9-app --working-directory=/srv/projects/prj9 -p Restart=on-failure /usr/bin/env node server.mjs
# voir sans écran :
/srv/projects/prj1/tools/navigateur "http://localhost:4009/jeu/?graine=3" captures/essai.png 1500 900 1200 "jeu.fermerAide(); jeu.avancer(700)"
```

- Le service lancé par `systemd-run` survit à la session, mais **pas à un redémarrage de la machine** : il faudra le relancer avec la commande ci-dessus.
- Git local seulement, aucun push. Aucun secret ni vraie donnée dans ce dossier : tout est public.
