19 KiB
NOTES-PHASE20.md — La collision cesse d'être une affaire d'arbres
Session du 2026-08-26, à la suite de la Phase 19.
La consigne était d'étendre la collision « à tous les objets du monde qui n'en ont pas encore ». L'inventaire réel du code a réduit ce périmètre à une seule lacune — et c'est le premier résultat de la phase, avant toute ligne écrite.
1. L'inventaire, avant de coder
| Catégorie | État trouvé dans le code | Décision de la Phase 20 |
|---|---|---|
Arbres, souches (Forest) |
Collision depuis la Phase 6 | Inchangé |
Objets posés par l'éditeur (EditorScene) |
Collision depuis la Phase 15, avec un drapeau solid par objet |
Inchangé |
Faune (Wildlife) |
Aucune collision | Corrigé |
Objets au sol (Ground : bûches, branches, pierres, éclats) |
Aucune collision | Laissé sans collision, délibérément (§4) |
1.1 Les objets d'éditeur avaient déjà tout ce que la consigne demandait
La consigne proposait de « décider d'une approche raisonnable (ex : un flag
solide par asset ou par instance placée) ». Cette décision avait déjà été prise
en Phase 15, et dans le sens le plus fin des deux : PlacedObject::solid est un
drapeau par instance, réglable en jeu par la touche K, sérialisé dans le
format .vcsc. La raison donnée à l'époque tient toujours et vaut mieux que
celle qu'on aurait inventée aujourd'hui : le même rocher peut être un obstacle
sur un sentier et un simple décor à flanc de falaise, et surtout un asset dont
l'empreinte cylindrique est fausse (l'abri, qui a un intérieur) doit pouvoir
être posé sans emmurer le joueur.
Rien n'a donc été touché de ce côté. Le vérifier était le travail ; le réécrire aurait été une régression déguisée en livraison.
1.2 L'architecture ne demandait aucune généralisation
La consigne demandait de « généraliser le système existant plutôt que d'écrire un système parallèle ». La généralisation était déjà faite, en deux temps :
- Phase 6 :
CollisionSolver(interface) +moveBody()(point d'entrée unique, qui vérifie le résultat du repoussement et refuse le déplacement quand aucune position libre n'existe) ; - Phase 15 :
CompositeCollisionSolver, qui implémente le même contrat et le délègue à une liste de sources.
Résultat : brancher la faune est une ligne dans main.cpp
(worldSolver.add(wildlife.get())), et cette ligne suffit pour les trois
activités qui se déplacent au sol. C'est la deuxième fois que l'interface de
la Phase 6 tient sa promesse, et cette fois sans qu'on ait eu à l'aménager.
2. Ce qui a été écrit
Wildlife implémente désormais CollisionSolver, exactement comme Forest et
EditorScene.
- Empreinte : cylindre vertical, rayon
0,65 m= demi-longueur du mesh de cervide (kAnimalLength / 2), multiplié parAnimal::scale; bande verticale[sabots ; sabots + 1,05 m × échelle]. - Géométrie : celle de
Forest::resolve— cercles dans le plan XZ, recouvrement d'intervalles en Y, repoussement jusqu'au contact, 4 passes avec sortie anticipée dès qu'une passe ne touche rien. Aucun second modèle de collision n'a été écrit : le monde doit se cogner partout de la même façon, sans quoi il y aurait deux comportements à régler, à tester et à garder d'accord. - Le lien mesh ↔ collision est tenu par une assertion de COMPILATION.
WildlifeParamsne peut pas inclureAnimalMesh.hppsans traîner tout le moteur derrière tout ce qui paramètre la faune, donc0,65y est écrit en clair. Unstatic_assertdansWildlife.cppvérifie que cette valeur reste la demi-longueur du mesh : le jour où le cervide changera de taille, ça échouera à la compilation au lieu de le rendre traversable par le flanc.
2.1 Pourquoi le cylindre CONTENANT, et ce qu'il coûte
Même convention que l'empreinte des objets d'éditeur, et pour la même raison : un collider plus petit que l'objet se traverse par les coins, ce qui est exactement le défaut qu'on vient corriger.
Contrepartie assumée, et elle est réelle : de face, le cervide ne fait que 0,42 m de large ; son cylindre de 0,65 m est donc trop généreux d'une vingtaine de centimètres de chaque côté. Un cylindre ne peut pas être juste dans les deux sens, et l'erreur qui bloque un peu tôt est moins choquante que celle qui laisse passer au travers d'un flanc.
2.2 Ce qui reste FAUX, et qui l'est volontairement
Un animal, lui, traverse toujours les troncs, les rochers posés et ses congénères. Ce n'est pas un oubli : c'est le corollaire du « aucune IA » de la Phase 17. La fuite est une ligne droite, sans évitement d'obstacle — un animal qui buterait sur un tronc y resterait collé, faute de savoir le contourner, et un cervide encastré dans un arbre serait plus laid que le problème résolu. Le sens qui compte pour le joueur est celui qui a été traité.
2.3 Un animal n'est pas un tronc : il bouge
Deux conséquences, toutes deux assumées et toutes deux déjà couvertes par
moveBody() :
- un animal peut venir se poser sur un joueur immobile — le joueur ne bouge
pas, donc aucun
moveBody()n'est appelé, donc rien ne l'écarte. Il sera repoussé au premier pas : c'est le cas dégénéré quemoveBody()traite déjà en dernier recours pour « un arbre planté sur le joueur » ; - la position « précédente » sur laquelle
moveBody()se replie a pu devenir occupée entre deux images. Le repli la teste avant de s'y poser, il n'y avait donc rien de particulier à écrire.
3. LA MESURE : témoin négatif et chiffre prédit
Méthode de la Phase 15 : deux mondes identiques à une option près, même graine, même semis, même animal à la même place. La seule différence est la collision.
Le témoin est WildlifeParams::solid = false, exposé en jeu par la nouvelle
option --no-animal-collision. C'est le témoin qui compte, et
--no-wildlife ne pouvait pas le remplacer : supprimer les animaux ne montre
pas qu'on traverse celui qui est là.
Marche de 20 m, droit sur un cervide isolé, par le même moveBody() que la
caméra :
| approche la plus proche | distance parcourue | |
|---|---|---|
Témoin, --no-animal-collision |
0,0010 m (le centre de l'animal) | 20,00 m |
| Avec collision | 1,0418 m | 13,20 m |
Et 1,0418 m est le chiffre prédit : rayon de collision de cet animal
(0,65 × échelle) + demi-largeur du joueur (0,35). Il est atteint au
millimètre près. C'est ce qui sépare « ça a l'air de bloquer » de « ça bloque
là où le modèle le dit ».
3.1 La première version de ce test avait tort, et la mesure l'a dit
Le test attendait un arrêt net à 10 − 1,0418 = 8,96 m. Mesure : 13,20 m
parcourus, et une sortie de l'autre côté de l'animal.
Ce n'est pas un défaut, c'est le glissement que le solveur par repoussement
produit exprès (CollisionSolver.hpp : « on longe un tronc au lieu de s'y
coller net »). Contre un obstacle convexe isolé, une poussée frontale n'est
jamais parfaitement frontale à l'arrondi près, et la composante latérale
accumulée finit par faire contourner l'animal — comme on contournerait un tronc.
La grandeur réellement prédite par le modèle n'est donc pas la distance d'arrêt, c'est le rayon de contact. C'est elle qui est vérifiée. La leçon est celle des phases précédentes, un cran plus loin : un chiffre attendu qui ne sort pas n'est pas forcément un bug — il faut d'abord savoir lequel des deux, du code ou de l'attente, décrit le modèle.
(La toute première version échouait pour une raison encore différente et plus
bête : avec la population par défaut — 24 animaux espacés d'au moins 14 m — un
trajet de 20 m en croise parfois un SECOND, et la marche s'arrêtait sur
celui-là. La collision marchait ; c'est la distance prédite qui parlait du
mauvais animal. Le test sème désormais maxAnimals = 1.)
3.2 Toutes les activités, pas seulement la marche
C'était une exigence explicite de la consigne. Réponse par activité :
- Marche (
Camera::resolveCollisions) : mesurée ci-dessus. - Vélo (
Bike::update) : mesuré à part, et c'est le cas qui compte le plus. Le vélo roule à 30 km/h, c'est-à-dire à la vitesse de fuite de l'animal (8 m/s) : c'est la seule activité qui peut réellement rattraper un cervide et lui rentrer dedans. À pied, on ne l'approche jamais — il part à 30 m. Résultat : le témoin passe à moins de 0,5 m du centre, le cycliste avec collision reste au-delà du rayon de contact. - Escalade (
Climber::update) : concernée au pied de la paroi, jamais dessus, et pour une raison de MODÈLE et non de code —WildlifeParams:: maxSlope(0,90) est inférieur àClimberParams::wallSlope(1,00), donc aucun animal ne peut se tenir sur une pente assez raide pour être grimpable. C'est le même genre de rapport entre deux constantes réglées séparément que la leçon de la Phase 17 (noiseRadiusvsspawnRadiusMin), sauf qu'ici le rapport est celui qu'on veut : une assertion le fige, pour qu'on ne le perde pas en retouchant l'une des deux. Un second test vérifie la bande verticale : un grimpeur à 2,4 m au-dessus des sabots n'est pas gêné. - Parapente : hors périmètre, inchangé, et cohérent avec la Phase 8, qui
documente déjà « pas de collision avec les arbres pendant le vol ». Le
parapente ne consomme aucun
CollisionSolver: lui en donner un serait une phase à part (un vol qui se cogne demande de décider ce qu'est un crash). À l'atterrissage, le joueur repasse en modeWalket retrouve la collision complète, faune comprise.
Aucune de ces trois classes n'a été modifiée. Elles reçoivent toutes le même
worldSolver.
4. DÉCISION : les objets au sol ne bloquent pas
Ground (bûches, branches, pierres, éclats) n'implémente pas CollisionSolver
et n'entre pas dans le solveur composite. C'est une décision, pas un oubli,
et elle repose sur trois faits mesurables :
- Ce sont des cibles de RAMASSAGE.
Ground::findNearestexige de s'en approcher. Un collider solide ferait lutter le joueur contre la mécanique même qui donne leur raison d'être à ces objets. - Ils sont sous le genou. Le plus haut est la pierre :
kStoneRadiusvaut 0,20 m, donc 0,40 m de haut posée. Un joueur enjambe ça ; le simuler demanderait une gestion de marche/step-up qui n'existe pas dans le moteur. - Un débitage en dépose 3 à 4 autour du joueur (
Forest::scheduleBucking). Les rendre solides pourrait l'emmurer dans le bois qu'il vient de produire — et le solveur n'a aucun moyen de l'en sortir, puisquemoveBody()refuse simplement le déplacement quand aucune position libre n'existe.
Le test headless fige cette décision plutôt que de la laisser au commentaire : il pose une pierre et une bûche sur le trajet et vérifie que le passage reste libre, en nommant la phase qui a tranché.
Ce qui rendrait la décision fausse un jour : un objet au sol nettement plus
gros (un rocher non ramassable, un tronc entier non débité). Le jour où
GroundItemKind en accueillera un, c'est un drapeau solide par nature d'objet
qu'il faudra — pas un collider pour toute la catégorie.
5. Vérification
5.1 Tests headless
935 assertions (902 avant la phase, +33), toutes passent, zéro
avertissement à /W4. Nouvelle section « Phase 20 : collision de la faune ».
Ce qu'elle couvre :
- le témoin négatif et le chiffre prédit (§3) ;
- cohérence
resolve/overlaps: la sortie deresolve()est libre, sans quoimoveBody()refuserait tout déplacement le long d'un animal au lieu de laisser glisser (c'est la raison de la marge d'un millimètre, la même que dansForestetEditorScene) ; - le cas dégénéré « joueur exactement sur l'axe de l'animal » : aucun NaN, écarté au contact ;
- la bande verticale (grimpeur au-dessus, joueur au sol) ;
- le rayon suit
Animal::scale, et le défaut est bien la demi-longueur du mesh ; - le solveur composite à trois sources : le tronc bloque toujours (Phase 6), le rocher posé bloque toujours (Phase 15), l'animal bloque désormais (Phase 20), et le passage libre le reste ;
- la décision du §4 (objets au sol traversables) ;
- le vélo et l'invariant d'escalade (§3.2) ;
- l'option
--no-animal-collisioncôté interface (overlapsfaux,resolverend la position telle quelle).
5.2 Build
tools\build.bat Debug : configuration et compilation propres, aucun
avertissement neuf. Trois unités recompilées (Wildlife.cpp,
TerrainStreamer.cpp, main.cpp) et l'édition de liens.
5.3 Vulkan
Voir §6.
5.4 Synchronisation
Pas de VK_LAYER_VALIDATE_SYNC=1 cette fois, et c'est justifié plutôt
qu'omis : cette phase ne touche aucun objet Vulkan, aucun thread, aucune
barrière, aucun téléversement. Les trois fichiers modifiés sont
world/Wildlife.{hpp,cpp} (géométrie pure, GLM seul) et le câblage dans
main.cpp. Le contrôle de synchronisation de la Phase 19 portait sur le chemin
de téléversement des tuiles, qui est rigoureusement inchangé. Le relancer aurait
produit un journal vide sans rien prouver de neuf — et la Phase 12 a établi
qu'un journal propre ne prouve rien tant qu'on n'a pas montré que l'outil
regarde au bon endroit.
6. Résultat du harnais run_vulkan_check.ps1
Joué en entier (scénarios A à I) sur le binaire final, puis le scénario B rejoué seul.
L'essentiel : zéro [Validation], zéro [ERROR] sur 5 510 lignes de
journal. Les 4 [WARN] sont les avertissements bénins habituels (pas de point
d'eau ni de faune sur certaines dalles) ; le harnais ne les compte pas comme des
erreurs.
6.1 Non-régression : les systèmes des Phases 15 à 19 sont intacts
| Vérification | Résultat |
|---|---|
| Éditeur (G), collision des objets posés | 0,28 m avec la scène contre 21,03 m sans (témoin) — la mesure de la Phase 15 est reproduite à l'identique |
| Éditeur : posés / supprimés / annulations / F5 / F9 / rechargés en jeu normal | 3 / 1 / 1 / 3 / 3 / 3 objets dont 3 solides |
| Sélection sans viser (F3/F4) | 3 sélections pour 3 touches envoyées |
| Faune (I), Phase 17 | 24 animaux, fréquentation 100 %, 4 animaux à portée au premier relevé → 1 au dernier — la zone se vide toujours |
| Besoins (H), Phase 16 | 2 points d'eau détectés, boire au point d'eau True, refus à 30 m True (témoin) |
| Escalade (F), Phase 14 | sommet atteint, +41,6 m, pente 63 à 154 % |
| Parapente (D), Phase 8 | décollage et atterrissage naturel |
| Dalle LiDAR réelle (C), Phase 7 | chargée, arbre visé et abattu, 5 objets ramassés |
| Streaming / LOD, Phases 10-12 et 19 | aucune erreur, fermeture propre partout |
Le point le plus important pour cette phase est la première ligne : la
collision des objets d'éditeur, mesurée par témoin, rend exactement le même
chiffre qu'avant. Ajouter une source au CompositeCollisionSolver n'a rien
changé aux deux autres.
6.2 Les deux points rouges, et ce qu'ils sont
-
Scénario E (vélo), « pied à terre »
False. Échec antérieur à cette phase, documenté depuis la Phase 17 puis dans les NOTES des Phases 18 et 19, laissé non corrigé pour cause de périmètre. La Phase 20 ne l'a ni causé ni aggravé : le reste du scénario E est vert (en selleTrue, 32,3 km/h en descente, 11 relevés à l'arrêt en côte au-delà de 23,6 % de pente). -
Scénario B, code de sortie −1, « l'arbre 7 n'a pas été abattu ». Celui-là ne pouvait pas être classé sans vérification, parce que le scénario B est le chemin de collision : c'est précisément ce que cette phase touche. Rejoué seul immédiatement après : vert — code de sortie 0, fermeture propre, « tronc debout PUIS souche poussés, sans erreur ni plantage », zéro
[Validation]. C'est la flakinessPostMessagedéjà documentée dans l'en-tête du script (scancodes, pas de vraie souris : cible d'abattage manquée de peu ouWM_CLOSElent), et le protocole du projet pour ce cas est justement de rejouer. Pas une régression.
7. Options ajoutées
| Ajout | Rôle |
|---|---|
--no-animal-collision |
La faune reste visible mais redevient traversable : comportement exact d'avant la Phase 20. Témoin de mesure, au même titre que --no-scene pour l'éditeur. --no-wildlife ne peut pas le remplacer — supprimer les animaux ne montre pas qu'on traverse celui qui est là. |
Journal Faune : collision ACTIVE/DÉSACTIVÉE |
Une ligne au démarrage, qui dit laquelle des deux configurations tourne et avec quel rayon. Sans elle, un run de mesure ne peut pas prouver après coup de quel côté du témoin il était. |
8. Ce qui n'est pas fait
- La faune ne se cogne à rien. Voir §2.2 : c'est le corollaire de l'absence d'IA, et le lever demande un évitement d'obstacle, donc un vrai déplacement, donc une session à part.
- Le cylindre reste faux de face (§2.1). Un collider orienté (capsule couchée le long du cap de l'animal) serait juste dans les deux sens — c'est la même limite que celle notée en Phase 15 pour les objets à intérieur, et la même réponse : un volume composé plutôt qu'un cylindre englobant.
- Aucune conséquence de gameplay au contact. Bousculer un cervide ne le fait pas fuir plus vite, ne blesse personne, ne coûte rien. La collision est physique, pas narrative.
- Aucun scénario Vulkan dédié (un « scénario J »). Le harnais ne pilote que
le clavier et la faune est semée aléatoirement autour du joueur : un
scénario reproductible demanderait de pouvoir poser un animal à une position
choisie, c'est-à-dire une entrée de débogage dans
Wildlife. La preuve de collision est donc headless et déterministe — ce qui est aussi le seul endroit où le témoin négatif est rigoureux. Le harnais complet a servi à la non-régression, pas à la mesure de cette phase. - Pas de mesure de coût, et l'argument est structurel, pas mesuré.
resolve/overlapsbalaient au plusmaxAnimals= 24 cylindres par appel de déplacement, contre plusieurs centaines d'arbres pourForestsur le même chemin : le poste ajouté est plus petit d'un ordre de grandeur qu'un poste déjà présent, et la Phase 19 a établi que l'image est limitée par le GPU (81 % du temps passé à attendre dansdrawFrame). Chiffrer ce poste demanderait une instrumentation neuve pour mesurer une fraction d'un temps d'attente. C'est une justification, pas une mesure : si la population de faune devait un jour croître d'un ordre de grandeur, il faudrait le chiffrer pour de bon.