sanctuary-beta/docs/building-beta009.md

# PROG-02B — Construction et vein building — beta.009

Branche : `codex/progression-vein-building`. Implémentation et export local
vérifiés le 13 septembre 2026 ; parcours graphique encore non validé, voir
ci-dessous. Cible : Minecraft 26.3-pre-2, Fabric et Java 25.

## Contrat préalable de migration

La progression personnelle passe du schéma 3 au schéma 4, en ajoutant
`building: 0`. Les schémas 1 et 2 passent d'abord par leurs migrations strictes
existantes. Les rangs, achats, dates, coûts, aptitudes et révisions sont
conservés sans achat fictif. L'historique accepte sept achats Construction
supplémentaires, soit 37 événements maximum ; chaque rang doit correspondre
exactement à ses achats. Les données invalides sont refusées sans remise à zéro.
La migration est idempotente et conserve l'identifiant `sanctuary:progression`.
La restauration réattache la représentation canonique, ensuite enregistrée par
la sauvegarde Minecraft normale. Mort, reconnexion et redémarrage conservent
les rangs. Aucun New Game+ n'est activé.

Les fichiers de configuration restent au schéma 2 : Construction utilise les
sept `statCosts`, par défaut 1, 2, 4, 8, 16, 32 et 64 niveaux. Aucun changement
des profils, couleurs, Atlas, Demeure, inventaire, génération ou chunks existants.
Client et serveur doivent utiliser beta.009 ensemble. Les versions antérieures
ne lisent pas le schéma 4 ; revenir en arrière exige une sauvegarde antérieure
des données de joueur. Aucun monde personnel n'est ouvert ou modifié ici.

## Contrat de jeu et valeurs d'essai

- Rang 0 : pose Minecraft individuelle. Sept achats débloquent les diamètres
  3, 5, 7, 9, 11, 13 et 15 (jusqu'à 225 emplacements dans un plan).
- La portée de visée et d'attaque reste celle de Minecraft. Seul le plan autour
  du point de départ s'agrandit ; aucune portée d'attaque supplémentaire.
- Une pose tous les deux ticks en survie ; lots bornés en créatif. Le statut
  opérateur en survie n'accorde ni matériaux gratuits ni cadence créative.
- R est la touche commune configurable : avec un bloc en main, aperçu de
  construction ; R + clic droit maintenus posent, R + molette règle le diamètre.
  R + clic gauche reste le minage. B reste le Blocodex.
- Plan déterminé par la face visée et l'orientation du joueur, ordre du centre
  vers l'extérieur. Le serveur recalcule et revalide les cibles, le stock et les
  permissions. Relâcher, changer d'objet, ouvrir un menu, mourir, s'éloigner ou
  perdre la connexion arrête le geste ; les poses déjà effectuées restent.
- Les poses passent par le placement natif pour les orientations, supports,
  collisions, contenus d'objets, consommation, statistiques et traces Demeure.
  Aucune récompense pour l'aperçu ou une pose refusée. Les surfaces ne remplacent
  pas les blocs occupés et n'ouvrent pas les contenants servant de support.
  Une dalle peut être fusionnée par son contexte Minecraft natif.
- Le plan couvre les emplacements dont le support existe déjà, comme le Builder
  historique. L'aperçu ne dessine que les poses valides ; il ne coûte aucun objet.
  La pile tenue fournit les matériaux, sans réapprovisionnement automatique.
- Portes, lits et plantes doubles gardent la pose individuelle, pour ne pas
  modifier une seconde case hors du plan validé. Échafaudages et nénuphars aussi :
  leurs placements natifs recherchent une autre cible. Les contextes déplacés
  et chunks non chargés sont refusés avant tout placement groupé.

## Vérifications

- `./gradlew :sanctuary:compileGametestJava check build assemblePack -PsanctuaryFocusedTests=progression,map,demeure,mining,building`
  **réussi en 3 min 55 s**, avec **28 tests serveur natifs obligatoires réussis**,
  dont dix scénarios Construction. Journal : `build/beta009-delivery-complete.log`.
- Les contrôles purs relisent les schémas 1, 2 et 3 et vérifient l'idempotence,
  les dates/coûts/rangs conservés, sept achats Construction, plafond et refus
  d'un rang sans historique. La configuration reste au schéma 2.
- Les tests serveur vérifient le passage par le placement natif, les six faces,
  les quatre orientations, les plans de 225 cases sans doublon, les coûts,
  l'absence d'extension de portée, les stocks courts, le créatif, les dalles
  simples/doubles/hautes et les escaliers. Les collisions avec un animal,
  contenants occupés, droits Fabric, mutation pendant un callback, concurrence,
  interruption et expiration du maintien sont couverts. Les statistiques,
  Blocodex et contributions Demeure proviennent des poses confirmées.
- Le test de progression sauvegarde/recharge le joueur et copie ses achats,
  dont Construction, lors d'une mort ordinaire. Le contrat de reprise est
  contrôlé sans ouvrir un monde personnel.
- Le parcours client `Building009ClientChecks` est écrit et compilé : achats
  par clic, aperçus 25/9, molette, arrêt, consommation, une seule couche par
  geste, reconfiguration et interruption par le Blocodex. **Son exécution
  reste non validée** : les deux lancements se sont bloqués avant le monde
  dans `Minecraft.<init>` / `SDL_GL_SwapWindow`. Le contrôle de bureau a
  confirmé que le Mac était verrouillé. Aucun résultat graphique beta.009
  ni capture en jeu n'est revendiqué. Les processus de test ont été arrêtés ;
  la valeur VSync du dossier de développement a été remise à sa valeur initiale.
  Journaux : `build/beta009-client.log`, `build/beta009-client-retry.log` ;
  piles : `build/beta009-client-threads.txt`, `build/beta009-client-retry-threads.txt`.

La sélection des tests serveur est limitée à
`progression,map,demeure,mining,building` ; ce ticket ne revendique pas la
correction des deux anciennes assertions de génération générales.

Référence historique en lecture seule : sélection, plan et session de
construction dans `../26.2/sanctuary`, GPL-3.0-or-later. Les appels natifs sont
vérifiés dans les classes de Minecraft 26.3-pre-2, dont `BlockItem.place`,
`ItemStack.useOn` et `ServerPlayerGameMode.useItemOn`. Le mixin commun contourne
seulement l'interaction du support comme le fait la pose accroupie ; les hooks
Fabric, le placement, les contenus d'objets, coûts et critères Minecraft restent
actifs. La revalidation a lieu après les callbacks et avant l'usage de l'objet.

## Artefact local

- [Sanctuary-beta.009.mrpack](../build/Sanctuary-beta.009.mrpack), **2 360 956 octets**.
- SHA-256 : `efa1ac7974b16e2f6169149518e08ed2bca4371b386b3413850b08618392da21`.
- Reçu : `build/building009-artifact.json` ; somme séparée :
  `build/Sanctuary-beta.009.mrpack.sha256`.
- ZIP et JSON vérifiés, identité du JAR construit et du JAR Demeure embarqué,
  versions internes, classes/mixins Construction, traductions FR/EN, six icônes
  originales, hash Fabric API et index packwiz. Aucune classe de test embarquée.
  Les exports beta.003 à beta.008 sont restés strictement identiques.

L'artefact est disponible pour essai local. Le canal packwiz n'a pas été publié
et aucune instance personnelle n'a été synchronisée.