17 KiB
NOTES-PHASE16.md — Besoins primaires du joueur
Session du 2026-08-24. Suite de la Phase 15 (editeur de niveau). Objectif : donner au joueur quatre besoins primaires — faim, soif, fatigue, temperature — qui evoluent avec le temps et l'activite, qui ont des CONSEQUENCES sur ce qu'il peut faire, et qu'on puisse au moins partiellement satisfaire.
Ce fichier documente ce qui a ete construit, les chiffres retenus et POURQUOI, les decisions de design prises sans arbitrage exterieur, et surtout ce qui ne marche pas ou pas encore.
1. Ce qui existe maintenant
| Fichier | Role |
|---|---|
src/world/Needs.hpp/.cpp |
les quatre jauges, le climat, l'horloge de jeu, les coefficients de penalite |
src/world/WaterSource.hpp/.cpp |
detection des creux ou il est credible de boire, sur relief reel |
src/main.cpp |
cablage : contexte par image, application des penalites, touche T, titre, journal |
tests/logic_tests.cpp |
sections « Phase 16 » : 129 assertions ajoutees (659 → 788) |
tools/run_vulkan_check.ps1 |
scenario H : les jauges et le point d'eau sous Vulkan, sur la dalle reelle |
Rien dans Bike, Climber, Paraglider ou Camera n'a change de comportement.
La seule modification de Camera cote appelant est que sa vitesse de marche est
desormais reglee a chaque image au lieu d'une fois au demarrage.
2. Le modele, et les chiffres
Les quatre jauges vivent dans [0, 1], 1 = tout va bien pour les quatre.
C'est une uniformite voulue : « fatigue 100 % » se lirait a l'envers, d'ou le
libelle forme a l'affichage.
2.1 L'unite de temps est la SECONDE REELLE
Tous les taux sont par seconde reelle, pas par heure simulee. L'horloge de jeu
(§2.4) n'accelere que l'heure, donc l'ambiante — jamais les jauges. C'est le
point le plus facile a confondre en relisant NeedsParams.
Cible du cahier des charges : rien de perceptible en quelques minutes, un vrai enjeu sur 30 a 60 minutes. Valeurs retenues, jauges pleines, marche continue :
| Besoin | A l'arret | A la marche | Verifie par |
|---|---|---|---|
| faim | vide en 4 h | vide en 2 h 06 | 5 min de marche : la faim se voit a peine, 30 min… |
| soif | vide en 2 h 30 | vide en 1 h 05 | idem |
| forme | remonte (plein en 20 min) | vide en 1 h 30 | 45 min de marche : la moitie de la forme |
| temperature | depend du relief et de l'heure | idem | §2.3 |
A 5 minutes, les trois jauges sont encore au-dessus de 90 % ; a 30 minutes, la soif est sous 60 % et la forme sous 75 %. L'ordre est voulu : on a soif avant d'avoir faim, et c'est la soif qu'on peut etancher. La faim est deliberement la plus lente parce que c'est le seul besoin qu'on ne peut pas encore satisfaire.
2.2 L'effort est le seul curseur d'intensite
Une seule table (activityEffort), la marche valant 1 :
repos 0,0 marche 1,0 velo 1,8 escalade 4,0 parapente 0,3
Faim, soif, fatigue et chaleur produite en derivent toutes. Consequence mesuree : l'escalade fatigue exactement quatre fois plus vite que la marche (assertion dediee), le velo 1,8 fois.
L'escalade a deja sa jauge courte (Climber::stamina, quelques minutes). La
fatigue est l'enveloppe longue : elle n'empeche pas une paroi, elle empeche
d'en enchainer dix dans l'apres-midi.
Le repos est le seul etat qui refait la forme, et il exige l'immobilite
reelle : main.cpp lit le deplacement effectif de la camera entre deux images,
pas les touches. Un joueur qui pousse contre un rocher tient sa touche, n'avance
pas — et ne recupere pas non plus. Le mode vol libre (F) compte comme du repos :
ce n'est pas une facon de se deplacer dans le monde.
2.3 La temperature, et le lien avec heightAt()
ambiante = 15 °C (niveau de la mer)
+ 8·cos(2π(h − 15)/24) cycle diurne, max a 15 h
− 6,5 · altitude_km gradient adiabatique standard
+ 4 · adret · ensoleillement adret/ubac, nul la nuit
ressenti = ambiante + 1,5·effort − 3·(1 − forme) [− 6 en vol] [+ 5 a l'abri]
La jauge descend a 1/(1800·10) par degre et par seconde sous le confort
(12 °C) : dix degres en dessous la vident en 30 minutes, cinq degres en une
heure. Elle remonte trois fois plus vite qu'elle ne descend — se remettre d'un
coup de froid ne doit pas couter une demi-session.
Sur la dalle chargee (420 → 982 m), le gradient donne 3,7 °C d'ecart permanent entre le fond de vallee et la crete, et le cycle diurne 16 °C entre 3 h et 15 h. Marcher de nuit coute donc a peu pres autant que marcher 2400 m plus haut. Releve reel du scenario H : ambiante de 10 a 15 °C entre 9 h et ~10 h de jeu a 586 m.
L'adret/ubac est calcule, pas devine. terrainExposure() lit le gradient du
terrain : +Z va vers le sud (convention Heightmap::toProjected), donc un
versant qui descend vers +Z (dh/dz < 0) est un adret. L'exposition est
ponderee par la pente — sur du plat il n'y a ni adret ni ubac, sans quoi une
plaine bruitee produirait des expositions extremes et aleatoires d'un metre a
l'autre. La base de lecture est de 4 m, meme valeur et meme raison que
BikeParams::slopeSampleStep.
2.4 L'horloge
Le jeu n'avait aucune notion d'heure (le soleil des shaders est une direction
fixe). GameClock en ajoute une, au facteur 12 : une minute reelle vaut
douze minutes de jeu, donc une session d'une heure traverse reellement une
tombee de nuit. Rien dans le rendu ne change avec elle — voir §5.
2.5 Les consequences
Quatre coefficients multiplies, plancher absolu a 0,35 :
| Jauge | Seuil ou la penalite commence | Coefficient a jauge nulle |
|---|---|---|
| forme | 0,50 | 0,55 |
| faim | 0,25 | 0,70 |
| soif | 0,25 | 0,65 |
| froid | 0,25 | 0,70 |
Le produit brut des quatre a jauge nulle vaut 0,175 ; le plancher le remonte a 0,35. C'est la traduction chiffree de « pas de punition brutale » : au plus mal, le joueur avance encore a plus du tiers de sa vitesse, il n'est jamais immobilise loin de tout. Une assertion dediee verifie que ce plancher mord vraiment (le produit brut est bien en dessous) — sans quoi il serait decoratif.
Les manques s'aggravent entre eux : un joueur affame, assoiffe ou glace se fatigue exactement deux fois plus vite et recupere deux fois moins vite. Ce qui empeche de compenser indefiniment la soif par des pauses.
Un seul coefficient pour les quatre activites, applique en trois points de
main.cpp :
- marche :
camera.setMoveSpeed(kWalkSpeed × facteur); - velo : la commande de pedalage est multipliee par le facteur. Le modele du velo
n'a pas ete touche — il ecrete deja ses entrees dans
[0, 1], et une commande plus faible y produit exactement ce qu'on veut : moins d'acceleration, donc une vitesse d'equilibre plus basse, donc moins de distance et une pente franchissable plus faible. Un joueur epuise cale la ou il passait le matin ; - escalade : la commande de montee, meme mecanique. La desescalade est ralentie aussi (le facteur s'applique au signe compris) : une desescalade a pleine vitesse serait la faille evidente du systeme.
Les tests ne verifient pas que le coefficient est petit, ils verifient l'effet reel : distance parcourue a velo en une minute, et hauteur gagnee en 20 s d'escalade, mesurees avec et sans la penalite d'un joueur epuise.
3. Les points d'eau
Le jeu n'a pas d'eau : ni surface liquide, ni rendu, ni physique de fluide.
WaterSource ne pretend pas en ajouter. Il repond a une question etroite : ou,
sur un relief LiDAR reel, serait-il credible de boire ?
Reponse cherchee dans la forme du terrain : les points a la fois peu pentus et concaves. Le balayage se fait une seule fois au chargement.
3.1 Ce qui a ete essaye et ce qui a ete retenu
Premiere version : 4 sondes sur les axes a 25 m, pente ≤ 10 %, 3 sondes sur 4 plus hautes, balayage au pas de 50 m. Resultat sur la dalle reelle : zero point d'eau. Trois causes distinctes, toutes mesurees :
- Ce massif est raide. 562 m de denivele sur 1 km : au pas de 50 m, seuls 10 points sur 361 passent sous 10 % de pente. Seuil porte a 15 %, ce qui reste tres loin des 60 % typiques du versant.
- Le pas de balayage etait trop grossier. Le rayon utile d'un creux (celui
ou la pente reste sous le seuil tout en gardant assez de concavite) vaut une
vingtaine de metres. Un pas de 50 m passe simplement a cote. Ramene a 20 m
(62 500 candidats sur 25 km², ~800 000
heightAt, une seule fois). - Quatre sondes ne savent pas distinguer un talweg d'un col. Un talweg a deux sondes plus hautes (les versants) et deux plus basses (amont, aval) : exiger 3 sur 4 ne retient que les cuvettes fermees, qui n'existent pratiquement pas ici. Mais descendre a 2 sur 4 laisse passer les cols, qui ont exactement la meme signature et ou il n'y a rien a boire. → Huit directions (axes + diagonales), seuil a 5 sur 8 : un talweg a ses deux versants qui couvrent chacun plus d'une direction, un col n'en a que quatre. Le seuil passe entre les deux.
Parametres finaux : pas 20 m, sondes a 25 m, pente ≤ 15 %, concavite moyenne ≥ 1,0 m, 5 sondes sur 8 montantes, ecartement minimal 150 m, 64 points au plus.
Resultat sur la dalle du Gua : 2 points d'eau, a 3,27 m et 2,03 m de creux.
Le premier est en monde (−75, 285), soit E 907425 / N 6439215.
3.2 Ce que cette methode ne sait pas faire
- une source de versant ne passe pas (elle n'est ni plate ni concave) ;
- un replat de col assez ferme peut passer ;
- une cuvette placee entre deux points de la grille peut passer inapercue ;
- elle ne sait rien des saisons, du debit, ni du gel.
C'est une heuristique, elle est retenue parce qu'elle est verifiable, bon marche, et qu'elle donne un ancrage testable. La lecon de la Phase 14 vaut ici aussi : savoir ou l'eau pourrait etre ne dit pas qu'elle y est. Le jour ou le reseau hydrographique de l'IGN sera charge, c'est cette fonction qui disparaitra, pas ses appelants.
3.3 Boire
Touche T, portee 4 m a l'horizontale (un peu plus que le ramassage d'objet : un point d'eau est une zone, pas un objet pose au centimetre pres). Le refus est journalise avec la distance — sans elle, « trop loin » ne dit pas s'il faut faire deux pas ou deux kilometres.
4. Ce qui prouve que ca marche
4.1 Tests headless — 129 assertions (659 → 788)
tools\run_logic_tests.bat. Couvrent :
- l'etat de depart, et le fait qu'un
deltaTimenul ou negatif ne fait rien ; - les rythmes annonces : 5 min ≈ rien, 30 min ≈ enjeu, 45 min = demi-forme, 90 min = forme a plat. Le test de fatigue maintient faim et soif pleines, sans quoi il mesurerait en realite le couplage entre jauges et non la fatigue ;
- l'ordre des efforts entre les quatre activites, et le rapport exact de 4 entre escalade et marche ;
- le repos : recuperation en 20 min, et le fait qu'il ne rend ni faim ni soif — sans quoi s'arreter reglerait tout et le point d'eau ne servirait a rien ;
- l'aggravation croisee, verifiee au facteur exact (× 2 a manque total) ;
- les quatre coefficients, seuil par seuil, plancher par plancher, plus le controle que le plancher global mord ;
- le climat : gradient d'altitude au degre pres, denivele reel de la dalle, amplitude diurne, adret/ubac de jour et son absence de nuit ;
- l'exposition lue sur quatre reliefs : plat, est-ouest, adret franc, ubac franc,
pente douce ponderee. Un terrain penche selon Z a du etre ajoute pour ca :
SlopedTerrainpenche selon X, et un test d'exposition dessus passerait meme avec un signe inverse ; - la vitesse de refroidissement et de rechauffement, l'effet de l'effort, du vent de vol, de l'abri, et le fait qu'a 1000 m plus haut on se refroidit plus vite ;
- l'horloge : facteur 12, passage de minuit, reglages hors bornes ;
- les points d'eau : une cuvette trouvee au bon endroit, quatre controles negatifs (plat, versant raide, versant doux sans concavite, sommet de bosse), le retrait aux bords, l'emprise degeneree, l'ecartement, le determinisme, la recherche du plus proche en distance horizontale ;
- les consequences reelles : distance a velo et hauteur d'escalade, mesurees
avec et sans penalite, sur les vraies classes
BikeetClimber.
4.2 Vulkan reel — scenario H (8 scenarios, tous verts)
tools\run_vulkan_check.ps1. Depart sur un point d'eau que le jeu a lui-meme
detecte, puis :
- T au bord du creux →
Boire : soif etanchee au point d'eau (0.000000 m); - 30 m plus loin, T →
le point d'eau le plus proche est a N m. Les deux ensemble, jamais l'un seul : une portee infinie donnerait le premier message, une portee nulle le second ; - 160 s de marche puis 60 s d'immobilite complete. La telemetrie (une ligne par seconde) doit montrer la forme descendre puis remonter — les deux sens. Une jauge qui ne fait que descendre est une jauge sans repos ; une qui ne fait que monter ne coute rien.
Releve du run de reference : 236 echantillons, forme 100 → 98 → 100,
soif minimale 95 %, ambiante 10 à 15 °C, 2 points d'eau, zero [Validation],
fermeture propre. Les sept scenarios anterieurs sont inchanges et verts.
Deux pieges rencontres en ecrivant ce scenario, notes parce qu'ils se reproduiront :
- le scenario attendait d'abord
Boire : pas soifau point d'eau, en supposant la jauge encore exactement pleine. Elle ne l'est jamais : deux secondes de jeu l'ont deja fait descendre de quelques millioniemes, invisibles a l'affichage entier mais suffisants pour quedrink()reussisse ; - a 100 s de marche, la forme tombait a 99 % puis 98 % selon les runs — la marge tenait a un point d'arrondi. Portee a 160 s (~3 %). Une marche genee par le relief (le joueur bute, donc ne se fatigue plus) aurait autrement efface le signal.
5. Decisions prises seul, et ce qu'elles coutent
-
Aucune jauge ne tue. Pas de mort, pas d'ecran de fin, pas de degat. Coherent avec « pas de punition brutale », mais ca veut dire qu'un joueur peut rester indefiniment a zero partout, ralenti et rien de plus. C'est un choix, pas un oubli.
-
Les penalites sont appliquees aux ENTREES, pas dans les modeles.
Bike,ClimberetParagliderignorent tout des besoins. Avantage : leur physique, testee depuis deux phases, ne peut pas regresser. Inconvenient : la fatigue ne peut pas exprimer autre chose qu'« une commande plus faible » — un grimpeur epuise ne tremble pas, il monte lentement. -
Une horloge de jeu, mais aucun changement visuel. Le facteur 12 fait tomber la nuit pendant une session, et la temperature en tient compte, mais le soleil des shaders reste une direction fixe : il fait toujours jour a l'ecran. C'est incoherent visuellement et c'est assume — un cycle jour/nuit rendu est une phase a lui seul.
-
eat()existe sans aucun appelant. Le jeu ne produit rien de comestible (l'inventaire ne connait que buches, branches, pierres, eclats), et inventer une cueillette sans contexte narratif depassait le cadre. La fonction est ecrite et testee pour que le jour venu il n'y ait rien a inventer ici. La faim n'est donc, a ce stade, satisfaisable par rien — d'ou le choix d'en faire de loin le besoin le plus lent. -
NeedsContext::shelteredexiste sans aucun appelant non plus, pour la meme raison : aucun abri n'existe dans le jeu. Le champ est le point d'ancrage prevu pour l'artisanat, et les tests l'exercent deja. -
Le mode editeur gele les quatre jauges. C'est un outil de developpement : voir la fatigue tomber en survolant 25 km² n'aurait aucun sens. Elles reprennent exactement ou elles en etaient a la sortie (F2).
-
Affichage minimal, dans le titre de la fenetre, comme l'inventaire depuis la Phase 6 :
faim 87% soif 62% forme 44% chaud 91% - 14:35. Pourcentages entiers, et le titre n'est reecrit qu'une fois par seconde (au rythme du compteur de FPS) — le rafraichir soixante fois par seconde ferait soixante appels systeme pour montrer le meme texte. Le detail (temperatures, facteur de deplacement) va dans le journal, qui est ce que depouille le harnais Vulkan. -
Le seuil de soif liee a la chaleur est distinct du confort. Une premiere version reutilisait la temperature de confort (12 °C) comme seuil de « chaud », ce qui rendait le joueur assoiffe par une journee de printemps a 17 °C : la soif doublait, et cinq minutes de marche la faisaient deja tomber de 15 %. Deux seuils separes desormais, 12 °C pour le froid et 22 °C pour la soif.
6. Ce qui reste ouvert
- De quoi manger. C'est le trou beant du systeme. Cueillette, chasse ou reserves de depart : c'est une decision de cadrage, pas une decision technique.
- Un abri, qui donnerait un sens a
shelteredet un usage aux buches. - Le rendu du cycle jour/nuit, sans lequel l'horloge reste invisible.
- Le vrai reseau hydrographique (IGN), qui remplacerait l'heuristique de detection des creux.
- Le sommeil. Le repos refait la forme, mais rien ne distingue une pause d'une nuit.
- Le portage. L'inventaire n'a ni masse ni encombrement ; le jour ou il en
aura, la charge devrait entrer dans l'effort, donc dans
activityEffort.