Apply block texture palettes to workshop sculptures (beta.116)

docs/sculpture-materials-beta116.md

@@ -0,0 +1,87 @@
+# beta.116 — Sculptures à partir des textures de blocs
+
+Ticket sur `codex/sculpture-materials-beta116`, comprenant aussi le correctif
+Fourneau beta.115 dans la livraison commune.
+
+Le Clay Workshop accepte les objets-blocs comme matière. Le client prélève une
+palette bornée dans la texture du bloc issue du pack actif, avec sa teinte, puis
+le modèle conserve sa géométrie et transpose ses valeurs claires/sombres dans
+cette palette. L'aperçu et le résultat utilisent le même calcul. Un bloc est
+consommé par sculpture ; les neuf cases de hotbar restent les seules accessibles.
+
+## Contrat des données et du réseau
+
+Les sculptures existantes conservent exactement leurs voxels sauvegardés :
+schéma 1 inchangé, identifiants `sanctuary:*` stables. Les nouvelles sculptures
+stockent elles aussi leurs couleurs finales dans ce format. Aucun chargement
+ne recolore les objets ou constructions existants. Orientation et ancrage
+beta.113 inchangés, sans migration ni modification d'un monde personnel.
+
+La sélection du menu ajoute l'identité de la matière et une palette de 256
+couleurs opaques au maximum. Ce sont des données d'apparence fournies par le
+client, comme le modèle déjà importé ; elles n'octroient ni objets ni propriétés
+de bloc. Le serveur vérifie le menu, son jeton, l'accès à l'atelier, les limites
+et l'objet effectivement présent. Il applique lui-même la palette et facture
+chaque résultat. Un changement de matière invalide immédiatement l'ancien
+résultat jusqu'à réception de la sélection correspondante. Les deux côtés
+doivent utiliser beta.116. Aucun nouveau format de sauvegarde.
+
+## Vérifications natives
+
+`Sculpture116ClientChecks` passe en 1 min 7 s, sur un nouveau monde plat de
+Minecraft 26.3, graine 116, puis la régression complète de l'atelier :
+
+- Les 1 207 objets-blocs enregistrés ont une palette opaque, non vide et bornée.
+- Fabrication payée avec pierre, planches de chêne, or, laine rouge, verre,
+  feuilles de chêne, argile et ardoise ; aperçu identique au résultat serveur.
+- Conservation des tons clairs/sombres du modèle et de ses coordonnées, sans
+  convertir les 16 argiles colorées en une simple couleur unie.
+- Une matière différente efface aussitôt l'ancien résultat ; une sélection
+  périmée ou un jeton incorrect ne fabrique rien et ne consomme aucun objet.
+- Les conteneurs contenant des objets sont refusés ; ils peuvent servir de
+  matière une fois vidés. Les objets qui ne sont pas des blocs sont refusés.
+- Bornes et opacité des palettes, véritable rechargement des ressources,
+  neuf cases de hotbar, stock plein, consommation exacte et restitution.
+- Poses selon les quatre regards, accroche au bord, grille de voxels,
+  casse/repose, sauvegarde et reconnexion après suppression du fichier GLB.
+- Interface FR/EN aux échelles 2/3, génération de plan au Métabli inchangée.
+
+Marqueurs `SCULPTURE116_PALETTES`, `SCULPTURE116_MATERIALS_PASS`,
+`SCULPTURE116_PASS` et régressions 106/111/112/113 dans
+`build/sculpture116-client.log`. Captures relues dans
+`build/sculpture116-evidence/`. Un libellé est raccourci en « Bloc » pour éviter
+le contact avec « Sculpture » dans le cadre compact.
+
+La palette vient de la texture représentative du modèle de bloc du pack actif,
+avec la teinte locale ; une texture animée utilise sa première image. Les blocs
+sans texture lisible utilisent leur couleur de carte. Il s'agit d'un transfert
+de couleurs sur les voxels opaques, sans transparence, émission ou fonction
+spéciale du bloc d'origine. Les sculptures existantes gardent leurs couleurs.
+
+Essais natifs macOS avec serveur intégré ; pas de client Windows ni de test
+LAN à plusieurs joueurs. Le serveur dédié de GameTest reste exclu selon le
+refus antérieur de son EULA. Aucun monde personnel ouvert.
+
+La régression native du Fourneau passe également dans beta.116, en 42 s :
+`build/sculpture116-furnace.log`, captures FR/EN dans
+`build/sculpture116-furnace-evidence/`. Les 27 cases, le glisser-déposer, les
+combustibles et les états de cuisson restent conformes au ticket beta.115.
+
+## Construction et archives
+
+`check build assemblePack assembleTestPack -x :sanctuary:runGameTest` réussit
+en 2 min 23 s : 125 tâches, dont 105 exécutées. Sources Java concordantes avec
+les JAR sources, versions alignées et intégrité des deux MRpack vérifiées.
+Le JAR conserve à l'identique le correctif Fourneau beta.115 ; seuls les
+classes de matière de sculpture et libellés FR/EN changent dans la production.
+Les classes de test et modèles GLB de test sont absents des archives.
+
+- `Sanctuary-beta.116.mrpack` : 10189831 octets, SHA-256
+  `7df04a6e2a57e76a55ca57bd7520b05cbb573392690b401b868837498807d252`.
+- `Sanctuary-Test-beta.116.mrpack` : 10208754 octets, SHA-256
+  `f4c9293e20384b05366d092fc7ee1abea275940a02373ee4036f73f0caa43747`.
+- JAR Sanctuary :
+  `76a9205783c8b18506c32c9eef6c481d95fd3ba0746a2bdd558a194534a51a32`.
+
+Reçu local : `build/sculpture116-artifact.json`. Publication et synchronisation
+de l'instance en cours ; leurs résultats seront consignés après vérification.