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.

Dans le jeu, Réglages contient les accès du compte et le confort du joueur : Compte, Interface, Sons, Image, En ligne et Application. La liste positive de settings/audience.ts fait foi ; une nouvelle option de moteur n'entre pas automatiquement dans le jeu. Les paramètres qui changent le monde, la progression, les personnages, le combat ou les données restent dans les laboratoires et les outils d'auteur, avec leurs droits existants. Les contrôles communs restent ceux de settings/ui.ts, avec remise à zéro par section. Ne pas réintroduire le choix technique du corps du héros ni les réglages artistiques du moteur dans les préférences du joueur.

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.

Les nouvelles interfaces de jeu reprennent les cadres et ornements SVG de src/standalone/hud-art/ et les valeurs communes de hud-atlas.css. Leur décoration ne recouvre jamais les zones de clic. Vérifier l'accès aux commandes en portrait et paysage, y compris sur un écran court : cibles tactiles d'au moins 44 px, contenu défilable, fermeture accessible, marges des encoches et retour du focus. responsive.ts garde la responsabilité du placement ; ne pas créer une nouvelle rangée de boutons ou un panneau fixe sans l'y intégrer. Le rendu en jeu reste à distinguer explicitement des planches de conception et des tests de géométrie.

Même à bas niveau, les Players et les adversaires de quête portent des skins assortis adaptés à leur classe et à leur faction, dès le premier affichage : looks/player-skins.ts réutilise l’assembleur commun. Les pillards du phare prennent leurs apparences dans une sélection de corsaires. Les skins restent des pièces décoratives sans niveau requis ; la vraie tenue, les armes et les statistiques suivent toujours le niveau. Un habitant garde son habillage propre et un choix explicite d’apparence reste prioritaire. Garde-fous : tests/player-skins.test.ts.

Une catégorie de bâtiments qui réunissent un lieu, un ou plusieurs personnages liés et une interaction spécifique. Registre commun builder/npc-building-types.ts, population persistante world-lab/npc-buildings.ts : poser crée les personnages, déplacer/refaire conserve leurs identifiants et leurs fiches, copier crée de nouvelles identités ; le serveur applique la même règle aux poses du Builder du jeu. Chaque nouveau type (atelier naval et restaurant aujourd’hui ; casino, magasins spécialisés, église ensuite) ajoute sa règle et son interaction au registre commun. Ce n’est pas une nouvelle sorte de personnages : le maître charpentier est un habitant, les PNJ du vrai jeu conservent leur nature. Voir docs/batiments-pnj.md et le lexique « Bâtiments PNJ ».

Les bâtiments PNJ sont des recettes réutilisables, configurables dans le World avant pose et après sélection : surface, proportions largeur/profondeur (plan allongé à surface conservée), forme et angles plus ou moins arrondis ; l’emprise en mètres comprend toit et perron. Chaque métier définit ses pièces, son mobilier, ses postes et ses personnages dans les modules communs, sans seconde version dans l’éditeur. Exemple : restaurant, grande salle, cuisine équipée, environ trente couverts et musiciens ; magasins spécialisés par armes et autres ateliers suivent ce contrat. La capacité réelle vient des places meublées accessibles, jamais d’un nombre affiché sans preuve. Changer les dimensions ou la forme conserve les identités et fiches ; copier crée de nouvelles identités. Les possibilités futures (joueur propriétaire, vente de repas, commerce spécialisé) se documentent séparément des fonctions réellement exécutées.

Dans le World Lab, chaque habitant peut avoir un métier, un lieu de travail et des créneaux travaillés parmi les six moments de la journée. Pendant son service, il rejoint le poste correspondant ; hors service, il suit les lieux et activités de sa journée. Le métier est distinct de la classe de combat (job) et du poste d’équipage. Un travail dans un bâtiment ne signifie pas y rester en permanence : « Où il vit » est un choix séparé, conservé pour Gustave et les personnages explicitement confinés. Scènes, quêtes, combats et conversations gardent la priorité. Registre partagé builder/professions.ts, édition world-lab/profession-editor.ts, exécution dans le Village et Inhabitants, sans second moteur dans le World. Conserver en base les horaires et les vrais lieux choisis, y compris pour les moments libres. Guide : docs/metiers-habitants.md.

Cuisinier, charpentier, serveur et musicien doivent mener à des lieux et à des postes que les joueurs pourront utiliser dans le jeu : cuisine et service d’un restaurant, chantier naval, scène de musique. Les habitants font vivre ces mêmes bâtiments avec leurs métiers et horaires. Réutiliser les modules communs, les vrais postes accessibles et le sac du héros ; documenter les boucles proposées séparément des services déjà exécutés. Le Grand Pavois sur l’île d’arrivée est le premier exemple de restaurant ; propositions et limites dans docs/restaurant-grand-pavois.md.

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)
3. Premier bateau de Port-Brise (23/10/2026)

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. Habitants de l'équipage contre les Players (22/10)
2. Défis entre joueurs en ligne (22/10)
3. Mobs
4. Retour visuel des coups
5. Monstres d'origine (option)
6. Players (option)
7. Mobile · combat au doigt, phase de combat (20/10)
8. Labo de combat (page)
9. Mécaniques du Labo de combat passées dans le jeu
10. Adversaires de quête · IA commune (21/10)
11. Mêlée pendant les poursuites (21/10)
12. Compétences en mouvement (21/10)
13. Rivaux · relance, états natifs, XP et fouille (21/10)
14. Players recrutés · cerveau commun (21/10)
15. Visée des compétences au doigt (21/10)
16. Combat de Corals online (options)
17. Boss intelligents (19/10)
18. Personnage (fenêtre)
19. Compétences au doigt et PM (19/10)
20. Tenue selon le niveau (19/10)
21. Garde-robe complète (19/10)
22. 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. Bâtiments PNJ (22/10)
5. Restaurant et dimensions des bâtiments PNJ (22/10, reprise)
6. Terrain
7. Routes & ports
8. Port d'Argent (procédural)
9. Sol Pelouse V8 (option)
10. Lieux (outil)
11. Lumières et effets des modèles (18/10)
12. Importés dans le Builder (branche islands-props)

1. Drapeau d’arrivée déplaçable (23/10, Codex)
2. PNJ du vrai jeu : poste, bâtiment et boutique (22/10, Codex)
3. Composition de Port-Brise (20/10, Codex)
4. Relief et matières de Port-Brise (21/10, Codex)
5. Atelier naval de Port-Brise (22/10)
6. Restaurant de Port-Brise · Le Grand Pavois (23/10)
7. Sol des îles · une texture par matière (21/10)
8. Sol des îles · haute définition et lien aux biomes (21/10)
9. Carte du monde · îles voisines (20/10)
10. Repères Players et étiquettes de type (21/10)
11. Atelier du personnage (World Lab)
12. World Lab · côtes, relief, construction (20/10)
13. Monde partagé · île de départ (20/10)
14. Story V2 · prologue de l'île de départ (20/10)
15. Arrivée dans le tonneau (20/10)
16. Îles partagées (Atelier des îles)
17. Notes de conception reprises de la branche prod (21/10/2026)
18. Studio visuel des voix (22/10/2026, Codex)

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. Compte dans les Réglages (22/10)
8. Écrans (responsive)
9. Priorité de lecture des interactions (22/10)
10. HUD · Atlas des marées (22/10)
11. Outils du HUD
12. Application (installer)
13. Remise à zéro
14. Sauvegarde
15. Gomme d'origine
16. Île agrandie
17. Côte DS3
18. Mer stylisée et ciel d'été
19. Mise à l'échelle (option)
20. Ciel et shaders DS2
21. Banc de mesure (recherche)
22. Serveur
23. Service
24. Accroches et écarts avec Corals
25. Applications et domaines
26. Signalements (20/10)
27. Signalements capture (22/10)
28. Admins (21/10)
29. Coûts IA (20/10)
30. Langue du jeu (21/10)
31. Bêta (21/10)
32. Tout traduire, chargé intelligemment (21/10)
33. Comptes et connexion (21/10)
34. Le compte du joueur dans le jeu (21/10)
35. Bourse : or, cristaux et doublons sur le serveur (21/10)
36. Personnage lié au compte (21/10)
37. Sons DS2
38. Grandes îles (secteur de 512 m)
39. Labos (mécanisme, 19/10)
40. Notes de conception reprises de la branche prod (21/10/2026)
41. 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