341 lignes
17 KiB
Markdown
341 lignes
17 KiB
Markdown
# 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 :
|
||
|
||
1. **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.
|
||
2. **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).
|
||
3. **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 `deltaTime` nul 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 :
|
||
`SlopedTerrain` penche 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 `Bike` et `Climber`.
|
||
|
||
### 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 soif` au 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 que `drink()` 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
|
||
|
||
1. **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.
|
||
|
||
2. **Les penalites sont appliquees aux ENTREES, pas dans les modeles.**
|
||
`Bike`, `Climber` et `Paraglider` ignorent 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.
|
||
|
||
3. **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.
|
||
|
||
4. **`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.
|
||
|
||
5. **`NeedsContext::sheltered` existe 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.
|
||
|
||
6. **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).
|
||
|
||
7. **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.
|
||
|
||
8. **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 `sheltered` et 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`.
|