21 KiB
Phase 28 — Conception de l'artisanat diégétique (document de conception, aucun code)
Rédigé le 2026-09-27, en session sans supervision. Toutes les références
fichier:ligne ont été relues dans l'état actuel du dépôt (après
3faf930, fin de Phase 27). Aucune ligne de code n'a été modifiée ; aucun
build n'a été lancé.
Document de cadrage d'origine : introuvable. Il n'existe aucun fichier de
cadrage dans le dépôt ; il n'est connu que par citations (MEMORY.md:14,
MEMORY.md:1825, NOTES-PHASE22.md:106, « les trois matières du document de
cadrage qui manquaient »). Les exemples « outils primitifs, ligatures en fibres,
poix (résine + cendres), manches en bois dense » viennent donc de la consigne
de la Phase 28, pas d'une relecture du cadrage.
1. Inventaire vérifié
1.1 Le modèle d'objet commun : GroundItem + Ground + Inventory
| Élément | Référence | Ce qu'il fait |
|---|---|---|
enum class GroundItemKind : uint8_t |
src/world/GroundItem.hpp:13-28 |
8 valeurs : Log, Branch, Stone, Flake, Clay, Sand, Resin, Fiber |
kGroundItemKindCount = 8 |
GroundItem.hpp:30 |
Taille codée en dur de l'inventaire — à incrémenter avec chaque nouveau type |
groundItemRestRadius, groundItemLabel* |
GroundItem.hpp:34-46 |
Rayon de repos et libellés FR (sing./indéfini/pluriel), un switch par type dans Ground.cpp |
struct GroundItem {position, yaw, roll, kind} |
GroundItem.hpp:51-58 |
Objet couché, mesh à dimensions absolues, jamais mis à l'échelle |
Ground::drop(kind, x, z, yaw, roll) |
src/world/Ground.hpp:37 |
Pose à la surface (le Ground calcule Y) |
Ground::scatterStones |
Ground.hpp:43 |
Semis initial des pierres |
Ground::findNearest(pos, reach, vTol=3) |
Ground.hpp:53 |
Portée horizontale, un seul objet, tous types confondus |
Ground::pickUp(index, kindOut) |
Ground.hpp:58 |
Retire l'objet du monde |
Ground::items() |
Ground.hpp:60 |
Accès en lecture au vecteur — suffit pour une requête « objets de tel type dans un rayon » |
Inventory::add / count / remove / summary |
src/world/Inventory.hpp:20, 24, 31, 49 |
Simples compteurs par GroundItemKind, remove atomique (refuse sans rien toucher) |
Il n'existe aucun geste « reposer au sol » depuis l'inventaire (grep de
inventory.remove dans main.cpp : seul le taillage consomme). Il n'y a pas
de notion d'objet tenu distincte de l'inventaire : « porter » = être compté
dans Inventory. Pas de masse, pas d'encombrement (Inventory.hpp:1-17,
commentaire d'en-tête : « le jour où le portage à dos sera un vrai sujet, c'est
cette classe qui grossira »).
1.2 Les matériaux
| Matériau | GroundItemKind |
Récolte (touche) | Fichiers / fonctions |
|---|---|---|---|
| Bûche | Log |
Abattage E (kFellKey, main.cpp:185) : Forest::pickTree puis Forest::fell (main.cpp:3016-3043, Forest.hpp:136). Débitage différé : Forest::scheduleBucking (Forest.cpp:589), 2 à 4 bûches selon la hauteur (Forest.cpp:606), déposées par advancePendingDrops → ground_.drop (Forest.cpp:507). Habitat::recordFelling inscrit la coupe (main.cpp:3033) |
|
| Branche | Branch |
Même chaîne que la bûche (houppier), Forest::scheduleBucking |
|
| Pierre | Stone |
Semée par Ground::scatterStones ; ramassage R (main.cpp:3049-3062) |
|
| Éclat | Flake |
Taillage C (kKnapKey, main.cpp:187) : knapStones (src/world/Knapping.cpp:32-60) |
|
| Argile | Clay |
Creuser Y (kDigKey, main.cpp:260) près d'un gisement DepositKind::Clay : findMineralDeposits / nearestDeposit (src/world/Deposits.hpp:165, 180), portée kDigReach = 3,5 m (Deposits.hpp:175) ; dépôt au sol main.cpp:2343-2379 |
|
| Sable | Sand |
Idem, gisement DepositKind::Sand (loin de l'eau) |
|
| Résine | Resin |
Saigner U (kResinKey, main.cpp:261) : ResinStand::tap(treeIndex, species, now) (src/world/Resin.hpp:102) ; 600 s entre deux saignées, 3 par arbre ; dépôt au pied de l'arbre main.cpp:2385-2421 |
|
| Fibres | Fiber |
Arracher I (kFiberKey, main.cpp:262) : FiberPlants::pullNearest (src/world/FiberPlants.hpp:208), portée kPullReach = 2,5 m (:163), repousse 420 s (:129) ; main.cpp:2429-2451 |
Règle commune posée en Phase 6 et répétée en Phase 22 (Knapping.hpp:36-40,
GroundItem.hpp:18-23, main.cpp:2337-2342) : ce qui est produit tombe
d'abord au sol, jamais directement dans l'inventaire.
1.3 Le pattern Knapping (le modèle à généraliser)
knapStones(Inventory&, Ground&, playerPos, facing) (Knapping.hpp:43,
Knapping.cpp:32) :
- vérifie les ingrédients dans l'inventaire (
count(Stone) < 2,.cpp:34) ; - projette le regard à l'horizontale, teste la longueur avant de normaliser
(
.cpp:41-43) ; - consomme un seul ingrédient — le nucleus ; le percuteur est un outil
non consommé (
.cpp:47, justification.hpp:29-32) ; - dépose le produit à 1,1 m devant le joueur (
kDropDistance,.cpp:14,ground.drop.cpp:57) ; - renvoie un
enumde résultat +knapResultMessage(message FR journalisé). Aucune table de recettes « volontairement » (Knapping.hpp:26-27).
creuser (main.cpp:2343) duplique à la main la même projection + dépôt à
1,1 m : c'est un deuxième exemplaire du même geste, déjà factorisable.
1.4 Systèmes qu'un objet fabriqué peut influencer
| Système | Point d'ancrage réel | État |
|---|---|---|
| Needs — abri | NeedsContext::sheltered (src/world/Needs.hpp:126) ; effet shelterWarmthC = 5 °C (Needs.hpp:220), et annule le refroidissement éolien (Needs.cpp:184-191) |
Aucun appelant (MEMORY.md:1278) : main.cpp:2276-2299 ne le remplit jamais |
| Needs — température | NeedsContext::ambientTemperatureC rempli depuis WeatherSample::temperatureC (main.cpp:2284) ; NeedsParams::comfortTemperatureC, exertionWarmthCPerEffort |
Aucune source de chaleur locale n'existe |
| Needs — soif | Needs::drink() (Needs.cpp:269) remet la soif à 1 ; appelé seulement à kDrinkReach d'un point d'eau (main.cpp:2313-2322) |
Pas de contenant : on ne boit qu'au point d'eau |
| Needs — faim | Needs::eat(nutrition) (Needs.cpp:277) |
Aucun appelant, rien de comestible n'existe (MEMORY.md:1274) |
| Needs — vitesse | Needs::movementFactor() (Needs.hpp:375) module la marche |
— |
| Lumière / nuit | WeatherParams::nightAmbientFactor = 0,30 (src/world/Weather.hpp:405), sunLightFor (Weather.hpp:933) ; « à revoir avec le feu de camp » (MEMORY.md:2214) |
Aucune lumière ponctuelle dans le renderer (grep fire/feu/foyer : zéro) |
| Vitesse d'abattage | Forest::fell est instantané (main.cpp:3025) ; seul le débitage a un délai (PendingDrop::delay, Forest.hpp:163) ; portée kFellingReach = 40 m (main.cpp:170) |
Il n'y a pas de vitesse d'abattage ; et abattre ne demande aucun outil |
| Vitesse de taillage | knapStones est instantané |
Pas de durée non plus |
| Rendement | logCount = clamp(h/2,4, 2, 4) (Forest.cpp:606) |
Quantité modulable sans nouveau système |
| Sauvegarde | Aucune sauvegarde de partie. Seul F5 écrit la scène de l'éditeur (main.cpp:320, src/editor/SceneFile.cpp). « Rien n'est sauvegardé » (MEMORY.md:1957, NOTES-PHASE22.md fin) |
Inexistant |
| Tests headless | tests/logic_tests.cpp : testPickup (l.477), testStoneKnapping (l.652), testNeeds (l.5158), testMineralDeposits (l.6788), testResin (l.6999), testFiberPlants (l.7177) ; lancés par tools\run_logic_tests.bat |
3578 assertions (chiffre de la Phase 23) |
Conséquence de conception majeure : il n'existe ni feu, ni cendres, ni vitesse d'abattage/taillage, ni sauvegarde. La « poix (résine + cendres) » du brief suppose un foyer qui n'existe pas : le foyer doit donc être lui-même le premier objet fabriqué, et c'est lui qui produira les cendres.
2. Les objets fabricables (8), et la priorité
Convention : « posé » = objet Ground à portée de l'ouvrage ; « porté »
= compté dans Inventory ; « outil » = requis mais non consommé (règle du
percuteur, Knapping.hpp:29-32).
P1 — Foyer (GroundItemKind::Hearth, nouveau) — prioritaire
- Ingrédients : 3 pierres posées (consommées) + 2 branches posées (consommées).
- Interaction : le joueur pose lui-même pierres et branches au sol, se place au-dessus et fait le geste d'assemblage (touche d'artisanat, cf. §3.3). Pas d'allumage séparé cette phase : le foyer est allumé à la construction avec l'éclat comme outil (percussion pierre/éclat = étincelle, même geste que le Knapping, éclat porté, non consommé).
- Effet :
NeedsContext::ambientTemperatureC += hearthWarmthC(proposé 8 °C, décroissant linéairement jusqu'à 6 m) pendant la durée de combustion (proposée 1 h de jeu, prolongée d'1 h par branche ou bûche posée dans le foyer). Branché dansmain.cpp:2284, même calcul de température unique : on corrige l'ambiante locale, on ne crée pas une seconde formule. Produit 1 cendre (GroundItemKind::Ash, nouveau) à son extinction, posée au centre. - Lien matière : pierres = cercle de foyer, branches = combustible ; les bûches (trop grosses pour allumer) servent seulement à l'entretien.
- Lumière : pas cette phase (le renderer n'a pas de lumière ponctuelle). Décision documentée en §4.
P2 — Ligature de fibres (Cord, nouveau) — prioritaire
- Ingrédients : 3 fibres portées, consommées.
- Interaction : torsion à la main, geste identique au Knapping (depuis l'inventaire, produit déposé à 1,1 m devant). Aucun poste.
- Effet : aucun direct — c'est l'intermédiaire obligatoire de P3, P5 et P6. Le justifier comme objet et non comme étape cachée est ce qui rend la chaîne visible au sol.
- Lien matière : ortie et ronce sont des sources de fibres textiles réelles.
P3 — Hache emmanchée (Axe, nouveau) — prioritaire
- Ingrédients : 1 éclat + 1 branche + 1 ligature, posés ensemble (outil composite = assemblage au sol, pas en poche). Tous consommés.
- Interaction : assemblage au sol à la touche d'artisanat ; même dépôt que le Knapping.
- Effet : l'abattage n'ayant pas de durée, deux effets réels possibles ;
retenu : rendement —
Forest::scheduleBuckingdonne +1 bûche (clamp(…, 3, 5)au lieu de2, 4,Forest.cpp:606) si une hache est portée. Option non retenue : rendrefellimpossible sans hache (voir §4, risque de régression du scénario Vulkan A). - Lien matière : éclat = tranchant, branche = manche, fibre = ligature.
P4 — Poix (Pitch, nouveau) — prioritaire (dernier des quatre)
- Ingrédients : 2 résines + 1 cendre, posées près d'un foyer allumé.
- Interaction : le foyer est le poste : on pose résine et cendre à moins de 2 m d'un foyer en combustion et on fait le geste d'artisanat. Refus journalisé « il faut chauffer la résine » sinon.
- Effet : ingrédient de P5 et P6 (colle imperméable) ; remplace la ligature seule dans la hache renforcée (voir P5).
- Lien matière : la poix de résine + charbon/cendre est la colle préhistorique attestée.
P5 — Hache renforcée (poix) — secondaire
- 1 hache + 1 poix, posées. Effet : +2 bûches au lieu de +1. Pas d'usure cette phase, donc l'intérêt est modeste : secondaire.
P6 — Abri de branches (Shelter, nouveau) — secondaire, fort impact
- Ingrédients : 4 bûches + 6 branches + 2 ligatures, posés.
- Interaction : assemblage au sol ; l'abri devient un objet non ramassable du Ground (voir §3.4).
- Effet :
NeedsContext::sheltered = truequand le joueur est à moins de 2,5 m d'un abri — premier appelant de ce champ (Needs.hpp:126), +5 °C et vent annulé (Needs.cpp:184-191). C'est l'usage des bûches annoncé enMEMORY.md:1718. - Repoussé car il demande une collision (l'abri doit être solide) et un mesh.
P7 — Pot d'argile cuite (ClayPot, nouveau) — secondaire
- Ingrédients : 2 argiles + 1 sable (dégraissant), façonnés au sol, puis
cuits en restant posés 10 min de jeu à côté d'un foyer allumé
(transformation
RawPot → ClayPotpilotée par le temps, même horlogeelapsedSecondsqueResinStand). - Effet : rempli au point d'eau (touche T,
main.cpp:2313), il permet unNeeds::drink()hors de portée d'eau (une gorgée par remplissage). - Lien matière : le sable est le dégraissant qui empêche l'argile de se fendre à la cuisson.
P8 — Couteau à éclat emmanché — rejeté pour cette phase
Éclat + branche + ligature. Aucun système existant qu'il influencerait (pas de dépeçage, pas de nourriture) : écarté selon la règle « aucune mécanique déconnectée ». Listé pour mémoire.
Les 4 prioritaires cette session : Foyer (P1), Ligature (P2), Hache (P3), Poix (P4). P1 donne le premier effet réel sur Needs et produit la cendre ; P2 et P3 débloquent la chaîne outil ; P4 exerce le « poste » (foyer) et termine la chaîne cendre du brief.
3. Architecture : un craft générique qui étend Knapping, pas un système parallèle
3.1 Principe
Un nouveau module src/world/Crafting.hpp/.cpp, sans Vulkan, calqué sur
Knapping : une fonction libre qui prend Inventory&, Ground&, la position et
le regard, et renvoie un résultat + message. knapStones devient la recette
n°0 exprimée dans la table (le test testStoneKnapping doit rester vert sans
modification, garde-fou de non-régression). La touche C reste la touche
unique du geste de « façonner » : pas de nouvelle touche, pas de menu.
3.2 Structure d'une recette
struct Ingredient { GroundItemKind kind; uint8_t count; Source source; bool consumed; };
enum class Source : uint8_t { Carried, Placed, Either };
enum class Station : uint8_t { None, LitHearth };
struct Recipe {
const char* id; // "hearth", "cord", ... (stable, sert aux logs/tests)
std::array<Ingredient, 4> in; uint8_t inCount;
GroundItemKind out; uint8_t outCount;
Station station; // poste requis à portée
float stationReach; // 2 m
const char* successMessage; // FR, même rôle que knapResultMessage
};
inline constexpr std::array<Recipe, N> kRecipes = {...}; // constexpr, pas de fichier externe
Table constexpr dans le code : testable, sans parsing, cohérente avec la
philosophie « paramètres regroupés et documentés » (WeatherParams, NeedsParams).
3.3 Détection et déclenchement
CraftResult craftAt(Inventory&, Ground&, const CraftWorld&, pos, facing)
où CraftWorld expose les postes (foyers allumés = objets Hearth du Ground
avec combustion > 0).
- Collecte des objets posés : nouvelle méthode
Ground::indicesWithin(pos, reach=2,5 m, vTol)— même critère horizontal quefindNearest(Ground.hpp:53), mais renvoie tous les indices. - Sélection de la recette : on parcourt la table dans l'ordre de priorité décroissante de complexité (abri avant hache avant ligature avant percussion), et on prend la première satisfaite. Déterministe ; l'ordre est la seule règle, documentée. Le joueur choisit donc la recette en choisissant ce qu'il pose — c'est le geste diégétique.
- Refus : si aucune recette n'est satisfaite, message sur la recette « la plus
proche » (celle dont il manque le moins d'ingrédients) : « il manque une
ligature », sur le modèle du refus avec distance de
creuser(main.cpp:2349-2353).
3.4 Consommation et création
- Tout est vérifié avant tout retrait (atomicité, même discipline que
Inventory::remove,Inventory.hpp:28-30). Retraits Ground par indices triés décroissants (sinonpickUpdécale les indices). - Produit :
ground.drop(out, …)à 1,1 m devant (portée dekDropDistanceréutilisée) — ou, pour un produit d'assemblage au sol, au barycentre des ingrédients consommés : l'objet naît là où on l'a construit. - Objets fixes (
Hearth,Shelter) : ajout degroundItemIsPortable(kind)dansGroundItem.hpp;findNearestles ignore pour le ramassage. - État propre au foyer (combustion restante) : un
HearthSetséparé (indice d'objet → secondes restantes), sur le modèle deResinStandqui garde « la mémoire des arbres saignés » hors de la Forest.GroundItemreste un POD sans état. - Alimenter un foyer = poser une branche/bûche à moins de 1 m puis C : c'est
une recette
Branch(Placed) + Station LitHearth → rienavec effet+1 h. Pas de cas particulier.
3.5 Branchement des effets
- Chaleur : dans
main.cppà côté demain.cpp:2284,ambientTemperatureC += hearthSet.warmthAt(playerPosition). Fonction pure, testable. - Hache :
Forest::scheduleBuckingreçoit unbonusLogs(0 par défaut) — défaut = comportement actuel au bit près. - Abri (P6, plus tard) :
needsContext.sheltered = shelterNear(...).
3.6 Sauvegarde
Aucune sauvegarde de partie n'existe ; la Phase 28 n'en crée pas (décision
§4). Préparation : Recipe::id stables, et HearthSet exprimé en temps de
jeu, pour qu'un futur format texte (modèle SceneFile/.vcsc) puisse écrire
Ground::items() + l'état des foyers sans changer de structure.
3.7 Tests headless à prévoir (tests/logic_tests.cpp)
testCraftingRecipeTable: unicité desid, sorties hors ingrédients, ordre de priorité respecté.testCraftingKnapUnchanged: la recette n°0 reproduit exactementtestStoneKnapping(2 pierres, 1 consommée, éclat à 1,1 m, regard vertical → repli sans NaN).testCraftingAtomicity: ingrédient manquant ⇒ Inventory et Ground identiques octet pour octet.testCraftingPlacedVsCarried: un ingrédientPlacedhors portée (2,6 m) ne compte pas ; unCarriedau sol ne compte pas.testCraftingIndexRemoval: consommation de plusieurs objets Ground non contigus sans décalage.testHearth: chaleur maximale au centre, nulle à 6 m, extinction ⇒ cendre déposée, alimentation prolonge ; foyer non ramassable.testPitchNeedsLitHearth: refus sans foyer, refus foyer éteint, succès.testAxeYield:bonusLogs = 0⇒logCountidentique à avant ;= 1⇒ 3..5.testNeedsinchangé (garde-fou : ambiante non corrigée hors foyer).- Vulkan : un scénario K optionnel (pierres + branches semées au départ, C, vérifier le foyer dans le journal) — non bloquant cette phase.
4. Décisions prises par défaut et risques
| Décision | Justification |
|---|---|
| Foyer créé en P1 alors que le brief cite seulement la poix | La poix exige des cendres ; rien n'en produit. Inventer des cendres sans feu serait une mécanique déconnectée |
| Pas de lumière du foyer | Le renderer n'a aucune lumière ponctuelle ; l'ajouter est un chantier de rendu (UBO, 3 shaders) hors conception d'artisanat. nightAmbientFactor reste inchangé |
| Allumage inclus dans l'assemblage (éclat outil) | Évite un second geste et un état « foyer éteint neuf » sans usage |
| Hache = rendement, pas condition d'abattage | L'abattage est instantané et sans outil ; le rendre conditionnel casserait le scénario Vulkan A et le mode démo |
| Même touche C pour tout le façonnage | Zéro menu : la recette se choisit par ce qu'on pose, pas par une liste |
| Recettes en table constexpr | Testable, sans fichier de données à charger |
| Pas de sauvegarde | Aucune n'existe dans le jeu ; en créer une est une phase à part entière |
| Pas d'usure des outils | Aucune notion d'usure dans le jeu (MEMORY.md:774) |
| Couteau écarté | Aucun système à influencer |
Risques de régression
kGroundItemKindCount(GroundItem.hpp:30) et tous lesswitchdeGround.cpp(libellés, rayons) et des meshes (StoneMesh,TreeMesh,HarvestMesh) : chaque nouveau type doit y être ajouté, sinon mesh ou libellé manquant. Un test doit itérer sur tous les types.Inventory::summary()s'allonge (titre de fenêtre) : afficher seulement les compteurs non nuls.- Réécrire
knapStonesvia la table : risque surtestStoneKnappinget les scénarios A/B → garderknapStonescomme façade. findNearestmodifié pour ignorer les objets fixes : risque surtestPickup.- Chaleur du foyer ajoutée à l'ambiante : vérifier que
testNeedset le scénario H ne voient aucun foyer (valeur par défaut 0). - Mode démo (
main.cpp:3010-3014) : le façonnage doit rester coupé comme le taillage. - Portage : objets « posés » requis ⇒ il faut un geste pour reposer un objet porté (absent aujourd'hui). À ajouter en même temps (proposé : R maintenu = poser le dernier type ramassé), sinon P1 et P3 sont injouables.