Carte des règles de Corals 2Comment Claude et Codex travaillent sur le jeu : où sont les règles, qui fait quoi, comment on publie.

Avant de travailler, lire LEXIQUE.md : une expression d'Antoine mène à un seul terme ; en cas de doute, le lexique tranche. Un mot fixé ou précisé par Antoine s'ajoute dans src/standalone/lexicon/terms.ts (une expression = un terme, vérifié par tests/lexicon.test.ts), puis node tools/lexicon-md.ts refait LEXIQUE.md, puis on publie.

Ni Playwright, ni Chromium, ni Puppeteer, ni capture : la scène tourne en WebGL logiciel et cinq navigateurs ont saturé le serveur (charge 41 sur 8 cœurs). Valider par tsc, tests, build, curl et journaux ; Antoine vérifie le rendu sur l'adresse publique : dire à la fin quoi regarder et où. Le panneau Navigateur ouvert dans Archonse ne suffit pas. Exception : demande explicite d'Antoine dans son message, alors un seul navigateur sur tout le serveur (flock -w 300 /var/tmp/corals-browser.lock timeout 120 node script.mjs, browser.close() dans un finally).

Toute modification terminée et vérifiée part en production aussitôt par tools/publish.sh, sans demander ni mise en garde. Cette règle prime sur la règle générale « on ne publie que sur demande ». Une publication = une ligne dans docs/RELEASES.md, écrite par le script.

Chaque outil qui se donne a son domaine <nom>.playcorals.online servi à la racine : DNS Hostinger (A <nom> → 72.62.237.177, MCP hostinger-api, ne toucher que cet enregistrement), vhost sur le modèle de /etc/nginx/sites-available/world.playcorals.online (racine → sa page, ancienne adresse en 301, Service-Worker-Allowed: /, navigation vers la page d'un autre outil renvoyée sur le domaine de cet outil), certbot, origine ajoutée au drop-in 70-origins.conf, entrée dans APPS de src/standalone/app-root.ts, manifeste et icônes propres. Tout ce qui est partagé vit sur le serveur, commun à toutes les adresses ; les liens d'un outil à l'autre passent par appUrl (jamais la page d'un autre outil sur le domaine courant : stockage séparé) ; ce qu'un outil passe à un autre voyage par l'adresse ou le serveur (« Tester l'île » : LabOnline.settled, puis launch/sx/sz) ; une clé d'une autre application se lit par le pont en lecture seule public/app-bridge.html (bridgeGet, clés de ALLOWED). Garde-fous : tests/app-root.test.ts. Limite connue : la partie jouée sur le hub (autre site) n'est pas celle des applications.

Une publication arrive seule chez les joueurs : live-update.ts lit publication.json toutes les 20 s, précharge, attend un moment calme, garde l'image de l'écran et repart sur la nouvelle version (partie, sac, Village et position conservés) ; ne jamais dire aux joueurs de recharger. Vraies retenues : combat, cinématique (body.dataset.c2Cinema), saisie de texte, héros à terre, bateau, expédition ; retenues douces (conversation, outil, panneau, fenêtre) : 6 min au plus ; pastille « ✨ Nouvelle version · Mettre à jour » au bout de 15 s. Toute nouvelle fenêtre qui ne doit pas être coupée pose data-c2-modal. Corals World pareil, jamais avant que tout soit en ligne. Après une publication, la suivre : journalctl -u corals-2-web | grep maj-direct. Conséquences : chaque release a un publication.json neuf (le script s'en charge) ; toute release recharge les joueurs, donc on ne publie pas pour rien. Garde-fous : tests/live-update.test.ts.

Le bouton « Signaler » (F8) du jeu, des labos et de Corals World envoie l'écran, l'état de la partie et la phrase du joueur ; l'IA en fait un diagnostic, rangé dans Archonse (Phases › 🐞 Signalements du jeu, Knowledge). Dans une conversation : node tools/reports.mjs list (ce qui reste), show <n> (fiche, puis regarder l'image indiquée), et une fois corrigé et publié done <n> --commit <c> --note "…". Détail : docs/carte/socle.md.

Avant d'importer une fonctionnalité (DS2, DS3, Corals…), demander à Antoine si elle doit être une option (interrupteur dans Réglages, mémorisé, et en OFF plus aucun traitement) ou permanente.

Sept sortes de personnages au même corps (un vrai personnage du jeu : classe, niveau, tenue) mais au fonctionnement différent : héros (vous), joueur en ligne (un autre humain), joueur automatique ou Player (IA des clans de DS2 : clans Tideborn, Ironwake, Emberfang, escouade, pillards ; ni mémoire ni conversation), habitant (le Village : il parle, se souvient, donne des quêtes), ennemi (personnage hostile : le combat seul), créature (bestiaire ; faune si elle n'est pas hostile), PNJ du vrai jeu (sa boutique d'origine). Toujours nommer la bonne sorte et savoir qui fait agir un personnage avant d'y toucher ; « escouade » = les Tideborn des Players, « groupe » = les habitants qui suivent le héros, « groupe de joueurs » = de vrais joueurs. Une seule source : src/standalone/beings.ts (section « Qui est qui » du lexique avec ses illustrations, étiquettes et anneaux des repères de Corals World, camps de Players posés dans le world) ; une nouvelle sorte, un nouveau repère ou une nouvelle étiquette s'y ajoute, jamais en copie. Garde-fous : tests/beings.test.ts. Détail : https://lexique.playcorals.online/#qui-est-qui

Dans Signaler (F8), l'onglet « ⏱️ Capture (FPS) » envoie un moment de jeu mesuré, en données ou en vidéo (sonde perf/probe.ts, analyse perf/capture-core.ts, vidéo découpée en images par le serveur). Toute conversation qui touche aux performances commence par node tools/reports.mjs captures, puis show <n> (regarder la planche et les images d'à-coups indiquées). On optimise d'après les mesures, jamais à l'aveugle, la cause la plus rentable d'abord ; une optimisation qui change l'image se dit (option si Antoine le veut). Après publication : done <n> --note "<gain mesuré>" et demander une nouvelle capture au même endroit. Un nouveau système du moteur ou une nouvelle sorte d'objet dessiné entre dans la sonde (sections de hookEngine, noms de perf/categories.ts). Garde-fous : tests/perf-capture.test.ts. Détail : docs/carte/socle.md.

histoire globale du monde → arcs narratifs → îles et leur lore → mini-trame insulaire obligatoire → quêtes annexes. Un arc narratif, au sens des arcs de manga, réunit une ou plusieurs îles autour d'un enjeu majeur, de personnages ou factions récurrents et d'une progression commune (mise en place, montée des enjeux, point culminant, conséquences ou résolution). Chaque île possède systématiquement une quête principale obligatoire, qui forme sa mini-trame locale (éventuellement découpée en chapitres) avec une situation, un enjeu, une progression et une résolution propres. Cette mini-trame doit faire avancer, révéler ou faire résonner l'arc auquel l'île appartient, sans devoir résoudre l'arc à elle seule. Les quêtes annexes se rangent sous cette mini-trame et approfondissent ses habitants, lieux, factions, secrets ou conséquences. Aucune quête générique ou déconnectée : toute quête obligatoire ou annexe naît du lore de son île ; le lore de l'île sert son arc narratif, et chaque arc constitue une partie cohérente de l'histoire globale du monde. Les futurs outils, générateurs et ateliers d'histoire doivent conserver et rendre visible cette filiation ainsi que l'arc courant.

Ce vocabulaire est à employer tel quel.

1. Système d'interaction par quête : dès qu'un personnage est lié à une quête ou à une mission (quête principale, chapitre de l'histoire, quête obligatoire de l'île ou quête annexe qu'il porte : la règle questTalk / questOf, rôles decision, deliver, chapter, party, giver), le clic droit, la touche E, l'invite et l'appel depuis le bateau n'ouvrent pas le cercle des interactions : le héros va jusqu'à lui et la conversation s'ouvre directement, réduite à la quête, sur le modèle de l'arrivée avec l'hôte (Maëlle sur Port-Brise) : les échanges, le bandeau doré, les réponses de la quête et ses décisions en boutons ; ni champ libre, ni jauges, ni avis. Un bouton discret « Autre chose » mène au système basique.
2. Système basique : tout personnage sans interaction importante liée à une quête garde le cercle des interactions (gestes, cadeaux, romance, équipage, histoire, méchant) et la conversation complète.
3. Toute quête, mission ou chapitre conçu dans le World Lab ou ailleurs passe automatiquement par le système d'interaction par quête : il suffit que le personnage soit relié à la quête par la règle commune. Jamais d'interface de quête à part.
4. Code : openPieFor(v, at, full) de village.ts (sans full, un personnage de quête ouvre openTalk), data-quest-mode de la conversation (renderTalk, styles dans bonds/dialog.ts) ; garde-fou dans tests/quest-talk.test.ts.

Répliques, questions et choix en bulles au-dessus de ceux qui parlent ; une fenêtre seulement pour une vraie saisie (nom). Pas de narrateur ni de texte d'histoire plaqué à l'écran ; les bandeaux de suivi (« Chapitre accompli », pastille de l'acte) sont de l'interface, à garder discrets.

Chaque réplique est rangée et rechargée sous la clé de celui qui la dit, jamais sous celle du donneur de quête ; closer dit la réplique finale, et si cet acteur manque, la ligne attend. {hero} est résolu côté serveur. Une correction de provenance migre aussi les journaux déjà enregistrés.

L'icône va du donneur vers le Sac, une fiche montre le vrai objet (nom, niveau, classe), il entre dans l'inventaire et s'équipe si la trame le prévoit ; don idempotent, sac plein refusé proprement, testé avec les vraies règles du sac. Un choix d'arme ne propose que les armes du corps et décide de la classe.

Tout ce qui compte pour la partie ou le monde (île, constructions, Village, histoire, progression, or, objets, propriétés) vit sur le serveur ; le navigateur ne garde qu'une boîte d'envoi, un cache ou des réglages d'affichage. Une économie (or, échanges, maisons, boutiques) se conçoit d'abord pour plusieurs joueurs en même temps. L'or, les cristaux et les doublons vivent dans la bourse du serveur depuis le 21/10 (server/wallet.mjs, docs/carte/socle.md) : tout gain ou dépense passe par elle, avec une raison que le serveur sait refaire. Le personnage aussi (sac et équipement, niveau, compétences, corps…), lié au compte depuis le 21/10 (server/character.mjs, PARTS de character-sync/core.ts) : une nouvelle sauvegarde du héros s'y ajoute, jamais en stockage local seul. Reste à faire : les règles des objets côté serveur, voir docs/CHANTIERS.md.

Une retouche faite dans le jeu (Builder, outils admin) revient dans l'île de Corals World en ligne et dans sa version publiée, et inversement, sans rechargement. Ce qui dépend d'un objet le suit quand il bouge (« si je déplace, il faut que ça déplace la quête ») : quêtes, scènes, lieux, repaires. Chemin commun : live-builder.ts, island-api/lab/patch, world-live.ts.

« Tester l'île » et les labos lancent le jeu lui-même (game-entry.ts, mémoire isolée par playtest-session.ts) ; jamais un moteur de test construit à part. Familles de créatures et boss communes (mobs/families.ts).

Une fonctionnalité de gameplay se travaille dans le labo de son domaine mais s'écrit dans le module du jeu qui la gardera, déclarée dans FEATURES et branchée par feature(id) ; le jeu ne l'allume qu'une fois promue. Les outils de travail (téléporter, invincible…) restent au labo. Données qui changent de forme : une migration dans labs/migrations.ts. Procédure : knowledge/labos/README.md.

(labs/registry.ts, étape jeu), jamais en copie (19/10, « tout doit être unifié »).

une fonction du jeu utilisée par un outil (World Lab, labos) est la même, importée, jamais une seconde version (fiche des personnages, conversation, cercle des interactions, Atelier des îles…).

Le jeu est reconnu par isGamePage() d'app-root.ts (combat-sandbox.html sur le hub, « / » sur corals2.playcorals.online) : preview.ts en déduit le HUD minimal et la barre Desktop/Mobile/HUD. Ne pas renommer la page.

Un seul cerveau de combat pour tous les combattants (héros assisté, compagnons, habitants en rixe, Players, pillards, boss : combat/crew-brain.ts, IA DS2, boss-brain.ts), jamais une IA à part. En phase de combat : armes sorties puis rengainées après, frappe et compétence dès que la cible est à portée, même en courant ; aucune interaction (cercle, conversation, appel) tant que dure le combat. Les mécaniques viennent de Tales of Pirates (fiches et formules d'origine), pas d'une invention.

Son kit est tiré de sa graine parmi les vraies compétences de monstres (buildBossKit) : au moins une grosse zone annoncée, un contrôle, une attaque à distance, un rapprochement, des phases. Un nouveau boss passe par ce cerveau (mob.boss) et un nouveau rôle se teste dans tests/boss-brain.test.ts.

Chaque ville de Corals World porte un averageLevel : habitants, ennemis humains et Players naissent dans une petite tranche autour. Aucun personnage humain n'apparaît, ne garde ni ne donne une pièce au-dessus de son niveau (tenue calculée avant le premier affichage, atelier filtré, fouille contrôlée). Les créatures gardent leur fiche d'origine ; on choisit une espèce proche du niveau, on ne falsifie jamais sa fiche. Une exception se règle dans la trame.

Tout nouveau paramètre réglable va dans le panneau Réglages (src/standalone/settings/), dans la section de son domaine, avec les contrôles de ui.ts (curseur avec valeur, interrupteur, couleur, choix) et une remise à zéro de la section.

Toute interaction existe au doigt ; une interface nouvelle est vérifiée en quatre formats, 320 × 480, 360 × 320, 480 × 320 et 667 × 375 (tests de responsive.ts), sans rien de coupé ni de masqué.

Une texture peinte par matière, dans le style de l'herbe du jeu, liée aux biomes ; jamais l'herbe recolorée. Rien n'est posé par défaut qu'Antoine n'a pas choisi (« enlève les pierres que tu mets par défaut »).

une route qui écrit dans le monde passe par les droits d'admin (src/standalone/admin/rights.ts, tests/admin.test.ts) ; un texte affiché passe par la traduction (translate="no" pour ce qui ne se traduit pas, puis tools/i18n/extract.mjs et warm.mjs) ; un appel à un modèle est compté (featureOf, règle Coûts IA) ; un nouveau type de donnée du monde entre dans la sauvegarde GitHub (SOURCES de tools/github-backup-data.mjs, dossier partagé) ; un nouveau mot d'Antoine entre dans le lexique.

Un modèle (OpenAI, JEV) s'appelle depuis le serveur, jamais depuis le navigateur : le fetch du serveur est compté (server/ai-costs.mjs), chaque appel est chiffré et rattaché au joueur (save de l'adresse ou tag du corps), au jour et à la fonction. Une nouvelle fonction qui appelle l'IA ajoute sa clé dans src/standalone/costs/features.ts (featureOf), ou within({feature}) si elle tourne en arrière-plan ; un nouveau modèle ajoute son tarif dans PRICES. Garde-fous : tests/ai-costs.test.ts.

Retour en arrière : un commit par étape, tools/publish.sh --rollback pour la production.

1. Bateaux (option)
2. Atelier naval · la table des plans (22/10, option)

1. Biomes (outil)
2. Studio des biomes (page)
3. Studio des biomes dans Corals World (21/10)
4. Biomes · placement, sol, herbe, assistant (18/10)
5. Bibliothèque Sketchfab (18/10)

1. Mobs
2. Retour visuel des coups
3. Monstres d'origine (option)
4. Players (option)
5. Mobile · combat au doigt, phase de combat (20/10)
6. Labo de combat (page)
7. Mécaniques du Labo de combat passées dans le jeu
8. Adversaires de quête · IA commune (21/10)
9. Mêlée pendant les poursuites (21/10)
10. Compétences en mouvement (21/10)
11. Rivaux · relance, états natifs, XP et fouille (21/10)
12. Players recrutés · cerveau commun (21/10)
13. Visée des compétences au doigt (21/10)
14. Combat de Corals online (options)
15. Boss intelligents (19/10)
16. Personnage (fenêtre)
17. Compétences au doigt et PM (19/10)
18. Tenue selon le niveau (19/10)
19. Garde-robe complète (19/10)
20. Notes de conception reprises de la branche prod (21/10/2026)

1. Builder
2. Bâtiment génératif
3. Atelier naval · programme du bâtiment génératif (22/10)
4. Terrain
5. Routes & ports
6. Port d'Argent (procédural)
7. Sol Pelouse V8 (option)
8. Lieux (outil)
9. Lumières et effets des modèles (18/10)
10. Importés dans le Builder (branche islands-props)

1. Composition de Port-Brise (20/10, Codex)
2. Relief et matières de Port-Brise (21/10, Codex)
3. Atelier naval de Port-Brise (22/10)
4. Sol des îles · une texture par matière (21/10)
5. Sol des îles · haute définition et lien aux biomes (21/10)
6. Carte du monde · îles voisines (20/10)
7. Repères Players et étiquettes de type (21/10)
8. Atelier du personnage (World Lab)
9. World Lab · côtes, relief, construction (20/10)
10. Monde partagé · île de départ (20/10)
11. Story V2 · prologue de l'île de départ (20/10)
12. Arrivée dans le tonneau (20/10)
13. Îles partagées (Atelier des îles)
14. Notes de conception reprises de la branche prod (21/10/2026)

1. Qui est qui · les sortes de personnages (21/10)
2. Village · Histoire (option)
3. Clans et rixes du Village
4. Équipage (page)
5. Équipage · Mugiwara (cartes, postes)
6. Liens entre les personnages (20/10)
7. Cris de combat de l'équipage (20/10)
8. Fiche des personnages (20/10)
9. Conversations de quête (20/10)
10. Lore (outil)
11. Habitant qui vit dans un bâtiment (22/10)
12. Fiabilité de l’équipage (15/10/2026)
13. Notes de conception reprises de la branche prod (21/10/2026)
14. Sons des habitants · configuration dans Corals World (22/10)

1. Page
2. Code Corals
3. Cale sous-chemin
4. Releases figées
5. Ressources
6. Réglages
7. Écrans (responsive)
8. HUD · Gameplay, médaillons, fenêtres (18/10)
9. Outils du HUD
10. Application (installer)
11. Remise à zéro
12. Sauvegarde
13. Gomme d'origine
14. Île agrandie
15. Côte DS3
16. Mer stylisée et ciel d'été
17. Mise à l'échelle (option)
18. Ciel et shaders DS2
19. Banc de mesure (recherche)
20. Serveur
21. Service
22. Accroches et écarts avec Corals
23. Applications et domaines
24. Signalements (20/10)
25. Signalements capture (22/10)
26. Admins (21/10)
27. Coûts IA (20/10)
28. Langue du jeu (21/10)
29. Bêta (21/10)
30. Tout traduire, chargé intelligemment (21/10)
31. Comptes et connexion (21/10)
32. Le compte du joueur dans le jeu (21/10)
33. Bourse : or, cristaux et doublons sur le serveur (21/10)
34. Personnage lié au compte (21/10)
35. Sons DS2
36. Grandes îles (secteur de 512 m)
37. Labos (mécanisme, 19/10)
38. Notes de conception reprises de la branche prod (21/10/2026)
39. Fenêtre bêta et langue du compte (22/10)

1. Application
2. Habillage : changer une pièce portée (21/10/2026)
3. Code
4. API : un service à part
5. Tests