Fichiers
vercora/NOTES-PHASE17.md
T
2026-10-11 01:54:18 +02:00

NOTES-PHASE17.md — Première empreinte environnementale

Session du 2026-08-25. Suite de la Phase 16 (besoins primaires). Objectif : que le monde GARDE UNE TRACE de ce que le joueur y fait, et que cette trace change ce qu'il y trouve — sans jamais le lui dire.

Ce fichier documente ce qui a été construit, les chiffres retenus et POURQUOI, les deux erreurs de réglage que seule une mesure sous Vulkan a révélées, et surtout ce qui n'est pas fait.


1. Ce qui existe maintenant

Fichier Rôle
src/world/Habitat.hpp/.cpp la mémoire locale du milieu : deux compteurs par cellule, montée, décroissance, oubli, seuils
src/world/Wildlife.hpp/.cpp la faune : semis par tirage-rejet, deux états, fuite, disparition, retour
src/world/AnimalMesh.hpp/.cpp le cervidé bas-poly, généré en code comme l'arbre et le galet
src/world/GroundCover.hpp l'interface par laquelle le semis d'herbe interroge l'état du sol
src/world/Vegetation.cpp un facteur de densité en plus dans gatherGrass — la seule ligne changée d'un système existant
src/main.cpp câblage : trois lignes dans la boucle, l'inscription de l'abattage, le dessin, le journal
tests/logic_tests.cpp sections « Phase 17 » : 97 assertions ajoutées (788 → 885)
tools/run_vulkan_check.ps1 scénario I : la faune et la fréquentation sous Vulkan, sur la dalle mesurée

Plus une option de jeu : --no-wildlife, qui coupe la faune et la mémoire du milieu et rend le comportement d'avant la phase. C'est un TÉMOIN, au même titre que --no-vegetation, et il a servi dès cette session (§5.3).

Rien n'a changé de comportement dans Forest, Ground, Needs, Camera, Bike, Climber, Paraglider ni dans l'éditeur. Forest en particulier n'a pas été touché : c'est main.cpp qui inscrit l'abattage dans le milieu, après un fell() réussi. L'abattage est une mécanique de la Phase 5 ; l'empreinte qu'il laisse est une lecture de la Phase 17, et les deux n'ont pas à se connaître.


2. Le modèle

2.1 Deux mémoires, et c'est le point de départ

fréquentation déforestation
ce qui la fait monter la présence du joueur, pondérée par le bruit de son activité un arbre abattu
vitesse de montée saturée en 60 s de marche sur place 3 arbres dans une cellule
vitesse de descente 4 min 15 min
ce qu'elle empêche la faune reste / revient la faune revient, ET le sol garde son couvert

Les fusionner aurait été une erreur de modèle : un dérangement CESSE quand on s'en va, un prélèvement NON. C'est la différence entre « il y a quelqu'un » et « il manque un arbre ».

Une cellule fait 32 m, et la grille est creuse : seules les cellules touchées existent, et une cellule revenue à neuf est oubliée. Sur 25 km² il y aurait 24 000 cellules ; une partie en touche quelques dizaines. C'est le même raisonnement que le semis à la demande de Vegetation.

2.2 Le bruit n'est pas l'effort

activityNoise (Habitat) est le pendant de activityEffort (Needs), et les deux échelles ne coïncident pas :

              effort (Ph.16)   bruit (Ph.17)
  repos            0,0             0,25
  marche           1,0             1,00
  vélo             1,8             2,00
  escalade         4,0             0,60
  parapente        0,3             0,15

L'escalade est le cas qui le prouve : c'est l'effort maximal du joueur et l'une des activités qui dérange le moins. Le repos n'est pas à zéro — un homme immobile est quand même là.

2.3 La pondération, et pourquoi elle est en carré

La présence dérange sur un rayon de 120 m, avec un poids 1 - (d/r)² où d est la distance au point le plus proche de la cellule (pas à son centre : la cellule où l'on se tient doit être pleinement dérangée quel que soit l'endroit où l'on y est tombé).

Une pondération linéaire ne marchait pas, et pas pour des raisons esthétiques : à la périphérie du rayon elle tombe en dessous du taux de décroissance, donc une cellule éloignée ne peut JAMAIS monter, quel que soit le temps passé. La deuxième mécanique demandée par le cahier des charges — « rester trop longtemps dans un rayon donné » — n'aurait tout simplement pas existé.

Corollaire assumé : au bord du rayon la pondération tend vers zéro, donc les cellules situées juste en deçà de 120 m restent presque intactes et acceptent encore une apparition de temps en temps. Un résidu d'un ou deux animaux à la limite est le comportement correct du modèle.

2.4 Le défaut qui rendait tout muet : l'époque de l'oubli

Premier run : rien ne montait. trackedCellCount valait zéro après une minute de présence.

La cause : au premier pas de temps une cellule ne contient que 0,0003 — donc moins que l'epsilon d'oubli (1e-3) — et update l'effaçait à l'image même où notePresence venait de la créer. La mécanique entière était annulée, en silence, sans le moindre message.

Corrigé sur deux points : une cellule occupée n'est jamais oubliée, et elle ne décroît pas non plus tant que le joueur y est (sans quoi montée et décroissance se retranchent, et une présence faible mais continue — le campement à distance — reste indéfiniment à zéro).


3. La faune

24 animaux au plus, semés par tirage-rejet autour du joueur, dans un anneau de 55 à 260 m. Un candidat est refusé s'il est hors emprise, sur une pente

0,9, sur un couvert LiDAR < 0,25, à moins de 14 m d'un autre animal, ou dans une cellule que le milieu refuse. Le nombre réellement présent est donc une conséquence du terrain et de l'état du milieu, jamais une consigne.

Deux états, deux déclencheurs de fuite :

  • le joueur passe à moins de 30 m → départ immédiat ;
  • le milieu a retenu une présence prolongée (wildlifeFlees) → départ, même si le joueur ne s'est jamais approché. C'est le déclencheur qui compte : un camp finit par vider son vallon.

La fuite est une ligne droite à 8 m/s, opposée au joueur, par pointes de 5 s renouvelées tant que l'animal n'est pas tranquille. Poursuivre ne mène nulle part, et c'est le propos.

Ce que la faune n'a pas

  • Aucune IA : pas de trajet, pas d'évitement d'obstacle, pas de troupeau.
  • Aucune collision : un animal traverse les troncs, et le joueur le traverse. Le CollisionSolver de la Phase 6 est là, l'y brancher serait mécanique — ce n'est pas fait.
  • Aucune persistance : ce ne sont pas des individus qu'on suit, c'est une population locale.
  • Une seule espèce, un seul mesh. La Phase 17 construit la BOUCLE, pas un bestiaire.

4. La dégradation par surexploitation

Trois arbres abattus dans la même cellule (32 m) la saturent. Deux conséquences, toutes deux observables en jouant, aucune annoncée :

  1. La faune n'y revient plus tant que le compteur est au-dessus de 0,40 — soit une bonne dizaine de minutes après deux arbres.
  2. Le sol se dénude : la densité d'herbe de Vegetation::gatherGrass est multipliée par le couvert rendu par l'Habitat, qui tombe jusqu'à 0,15 au pire. Mesuré par les tests : au pied d'une coupe saturée, plus de la moitié de l'herbe disparaît, et elle revient intégralement après vingt minutes.

Pourquoi l'herbe et pas le shader terrain

Le cahier des charges proposait « le sol devient plus nu dans le shader terrain existant ». Ce n'est pas la voie retenue, et c'est un arbitrage à connaître :

  • rendre la dégradation visible dans terrain.frag demande de porter les compteurs jusqu'au GPU — un binding de plus, une texture à téléverser et à ré-uploader quand elle change, donc un chantier de synchronisation Vulkan à part entière (et la leçon de la Phase 12 s'applique : les couches standard ne voient PAS les dépendances mémoire) ;
  • faire disparaître l'herbe donne le même signal visuel — un sol pelé au milieu d'un versant herbeux — pour zéro objet Vulkan nouveau, donc zéro risque de validation, et en réutilisant un système déjà mesuré.

Contrepartie honnête : là où il n'y a pas d'herbe, la dégradation ne se voit pas. Sur du lapiaz ou au-dessus de 2250 m, une coupe ne laisse aucune trace visuelle — seulement l'absence de faune. Le passage par le shader reste la bonne réponse à terme.

Autre choix assumé : les arbres de décor ne disparaissent pas. Ce sont les arbres ABATTABLES de Forest qui tombent, un par un, visiblement. Faire s'évaporer la futaie de Vegetation aurait effacé la coupe au lieu de la montrer.


5. Deux réglages faux que seule la mesure a révélés

Ils méritent d'être écrits parce que dans les deux cas le code était juste, les tests headless verts, et le résultat en jeu nul.

5.1 Deux rayons réglés séparément qui ne se recouvraient pas

noiseRadius valait 45 m (« un peu plus d'une cellule ») et spawnRadiusMin valait 90 m (« ne jamais apparaître dans le champ proche »). Chacun défendable seul. Ensemble : aucun animal ne se trouvait jamais dans le rayon dérangé.

Run du scénario I : 24 animaux au départ, 24 après deux minutes de présence continue, fréquentation locale à 100 %, zéro fuite. Le système marchait exactement comme écrit, et ne produisait rien.

Corrigé : noiseRadius = 120 m, et la condition est nommée dans l'en-tête — il faut que noiseRadius dépasse spawnRadiusMin, sans quoi la deuxième mécanique de la phase n'existe pas.

5.2 Le seuil d'apparition, et une faune qu'on ne voyait jamais

Même mesure, seconde lecture : à 90 m, un cervidé de 1,3 m est un point. La faune existait sans qu'on puisse la regarder. spawnRadiusMin est descendu à 55 m — au-dessus de la distance de fuite (30 m), donc rien n'apparaît sous le nez du joueur, et franchement en deçà du rayon dérangé.

Après correction, même scénario : 4 animaux à portée de vue au départ, 1 après quatre minutes de présence, deux en fuite au pic.

5.3 Un scénario voisin qui n'avait aucune marge (scénario F, escalade)

Troisième surprise, et elle ne vient pas du code de la phase : le scénario d'escalade a commencé à échouer, alors que rien de ce qu'il exerce n'a été touché.

Diagnostic, avec témoin : la faune coûte 6 % d'images par seconde (301 contre 320 FPS, mesuré sur la paroi du scénario F grâce à l'option --no-wildlife ajoutée exprès). C'est peu — et c'était assez. La trajectoire du grimpeur dépend du pas de temps : à chaque image sa commande est projetée sur la ligne de plus grande pente locale, donc deux cadences d'images ne suivent pas exactement le même chemin sur la paroi. Le scénario laissait 18 s de marge sur une montée de 57 s ; le grimpeur montait toujours aussi haut (41,5 m contre 41,4 m au témoin) mais n'annonçait plus le sommet avant l'échéance.

Corrigé côté harnais, pas côté jeu : l'échéance passe de 75 s à 140 s. Le harnais sort de la boucle dès que le sommet est annoncé, donc cette marge ne coûte rien quand tout va bien. Vérifié : sommet atteint, faune active.

--no-wildlife reste dans le jeu — il coupe la faune ET la mémoire du milieu, et rend le comportement d'avant la phase. Même rôle que --no-vegetation : sans témoin, on ne peut attribuer un écart à rien.

5.4 La leçon générale

C'est la même que celle de la Phase 14 (« savoir où il y a de la pente ne dit pas par où l'aborder ») sous un autre jour : deux constantes réglées chacune pour de bonnes raisons, dans deux fichiers différents, peuvent se rater complètement, et aucun test unitaire ne le dira — chacune est correcte. Il faut une mesure de bout en bout, et une métrique qui porte sur ce que le joueur VOIT (les animaux à portée de vue) et non sur ce qui est facile à compter (la population totale).


6. Aucune notification, et ce que ça coûte

Rien n'apparaît à l'écran : ni pop-up, ni compteur, ni ligne de titre. Le titre de la fenêtre porte toujours l'inventaire, les jauges et l'heure — rien de plus.

Le journal, lui, émet une ligne par seconde (population, fuites, animaux à portée de vue, fréquentation et déforestation locales, couvert au sol, cellules mémorisées, pointes). C'est un instrument de mesure, pas une interface : c'est la seule trace dépouillable par le harnais Vulkan, exactement comme la ligne de besoins de la Phase 16.

Conséquence assumée : un joueur peut très bien ne rien remarquer. Le système est observable, il n'est pas évident. C'est le prix de « pas de message moralisateur », et c'est le bon prix — mais il faudra un jour vérifier sur quelqu'un d'autre que soi que la boucle se lit.


7. Vérifications

  • Tests headless : tools\run_logic_tests.bat — 885 assertions (788 avant), dont 97 pour cette phase : les deux mémoires et leur asymétrie, l'oubli des cellules, les seuils et leur hystérésis, la robustesse du pas de temps, la convention du mesh d'animal et sa matrice d'instance, le semis et ses quatre filtres, le déterminisme, les deux déclencheurs de fuite, la disparition au loin, le refus de repeuplement d'une zone surfréquentée et son retour, et la chaîne complète coupe → sol nu → repousse.
  • Non-régression littérale : un Habitat vierge branché sur la Vegetation rend exactement le même nombre de touffes qu'avant la Phase 17. Ce n'est pas « presque pareil » — c'est le contrat total de GroundCoverSource, et c'est une assertion.
  • Vulkan : tools\run_vulkan_check.ps1, scénario I ajouté (neuf scénarios, onze processus). Zéro [Validation], zéro [ERROR], codes de sortie tous nuls, fermeture propre partout.

Un échec ANTÉRIEUR à cette phase, non corrigé (scénario E, vélo)

Le scénario du vélo échoue sur sa dernière étape : le « pied à terre » (touche B finale) n'est pas enregistré — aucune ligne de journal n'est émise, donc le front descendant de la touche n'a pas été vu. Ce n'est pas dû à la Phase 17 : rejoué deux fois avec --no-wildlife, c'est-à-dire dans le comportement exact d'avant la phase, il échoue de la même façon. La sonde montre par ailleurs que le vélo dévale encore à 31 km/h à ce moment-là, alors que le scénario vient de freiner 5 s — la descente scriptée ne se termine plus là où elle a été réglée.

C'est donc une dérive du scénario E (ou du pilotage par messages postés), pas du gameplay ; tout le reste du vélo est vert, y compris la télémétrie de pente, de vitesse et de dénivelé. Non corrigé : hors du périmètre de cette session, et le corriger à l'aveugle aurait été plus risqué que de le signaler.

Conséquence à connaître : la suite complète ne peut pas être verte tant que ce point n'est pas repris. Tout le reste l'est.

Un aléa d'automatisation, pas un blocage

Un run complet a aussi vu le processus G2 ne pas sortir dans les 20 s après WM_CLOSE. Vérifié : le scénario G rejoué trois fois de suite en isolation passe trois fois, faune active. C'est exactement la flakiness déjà décrite dans MEMORY.md (« WM_CLOSE lent à être traité »), pas un blocage à la fermeture — rien dans cette phase ne touche à l'arrêt : ni fil d'exécution, ni ressource GPU, ni synchronisation.


8. Ce qui n'est pas fait

  • Le couvert LiDAR réel n'est pas exercé sous Vulkan. La dalle de référence du harnais (LHD_0907_6440_1m.vchm) n'a pas de carte de canopée produite, donc le scénario I place la faune avec le couvert de substitut. Le filtre par couvert réel est couvert par les tests headless (carte synthétique) et par la zone de 25 km², qui a bien ses cartes — mais aucun scénario automatisé ne charge celle-ci.
  • Pas de collision entre le joueur et les animaux, dans aucun sens.
  • Pas de dégradation par piétinement : seul l'abattage dénude le sol. La fréquentation, elle, n'use pas les sentiers. C'était dans l'esprit du cahier des charges (« usure des sols ») et ce n'est pas fait.
  • Pas de sauvegarde : la mémoire du milieu meurt avec le processus. Une partie relancée retrouve un monde intact.
  • Une seule espèce, un seul mesh, aucun cycle jour/nuit dans le comportement, alors que GameClock existe depuis la Phase 16 — une faune crépusculaire serait le prolongement naturel.
  • Rien ne relie encore la faune aux besoins : on ne chasse pas, on ne mange pas ce qu'on voit fuir.