Record Sanctuary sources through beta.060 and Git validation

docs/companions-cosmetics-beta018.md

@@ -0,0 +1,153 @@
+# beta.018 — cases de familier, cape et cosmétique de tête
+
+Ticket du 13 septembre 2026, branche `codex/companions-cosmetics-beta018`.
+Contrat écrit avant les changements de stockage. Référence 26.2 consultée en
+lecture seule ; aucun pouvoir passif ou actif de familier n'est porté ici,
+sur décision explicite du créateur. Leur validation aura son ticket dédié.
+
+## Interface et objets
+
+L'en-tête de l'inventaire indique uniquement Inventaire / Inventory, sans
+compteur de rangées. La capacité reste lisible dans Progression et par les cases.
+Trois cases d'équipement distinctes rejoignent le panneau personnel, toujours
+disponibles : un œuf de familier, une cape, un objet cosmétique sur la tête.
+Chaque case contient un vrai objet, limité à une unité. Les clics et Maj-clics
+utilisent les menus synchronisés et respectent les rangées débloquées.
+De haut en bas : cosmétique de tête, cape, œuf de familier, main secondaire.
+Cet ordre est visuel ; les identifiants de stockage familier/cape/tête restent fixes.
+Maj-clic équipe automatiquement œufs et capes ; le cosmétique se place à la main.
+Le tri et le changement de hotbar ne déplacent pas cet équipement.
+Maj + clic gauche maintenu permet de parcourir les cases et d’exécuter leur
+Maj-clic natif successivement. Le geste part d’une case avec le curseur vide ;
+chaque case est visitée une seule fois, y compris lors d’un mouvement rapide.
+Relâcher le clic ou Maj termine le geste. Coffres, fours et autres conteneurs
+gardent leurs destinations et restrictions natives. Le catalogue créatif garde
+ses gestes d’origine ; l’inventaire personnel Sanctuary utilise ce raccourci.
+La touche de rangée fonctionne également en jeu sans écran : Tab avance,
+Maj + Tab recule. Elle reste configurable et garde la même sélection de rangée
+à la réouverture de l’inventaire. Seules les rangées débloquées sont parcourues.
+Une commutation interrompt l’utilisation de l’objet tenu, comme un changement
+de case de hotbar natif, et reste validée par le serveur.
+Les trois PNG fournis dans `../textures/{egg,cape,cosmetics}.png` sont copiés sans
+retouche dans le mod et dans les sources du resource pack.
+
+Un œuf d'apparition de mob équipé fait apparaître un petit compagnon temporaire
+qui se déplace réellement : navigation autour des obstacles, promenade proche
+et téléportation vers une place libre s'il est trop loin ou bloqué. Le suivi par
+apparition à côté du joueur de la 26.2 est remplacé. Le retirer le fait disparaître.
+Il est invincible et ne collisionne pas avec les autres entités. Le clic droit
+du propriétaire le caresse et émet des particules aux couleurs de son œuf.
+Une entité de familier dédiée utilise l'apparence du mob, afin de ne pas hériter
+de ses attaques ou comportements destructeurs. Les animations restent visuelles.
+Le familier n'est pas une source renouvelable de butin, d'XP ou de produits.
+Ses pouvoirs ne sont pas activés. Les œufs natifs restent disponibles pour les
+tests opérateur ; leur acquisition en survie n'est pas inventée dans ce ticket.
+
+`sanctuary:zero_cape` est une première cape de test, libellée Cape Zéro / Zero Cape,
+avec un visuel provisoire trouvé en ligne et une provenance documentée. Elle se
+teste depuis le créatif ou `/give`. Elle utilise le mouvement de cape natif ;
+elle ne modifie ni les élytres ni le compte Minecraft.
+
+Le cosmétique accepte tout objet/bloc. Il ne remplace pas le casque serveur et
+ne donne ni protection, ni effet, ni déclenchement d'objet. Les propriétés d'état
+de bloc sont utilisées pour le rendu lorsque possible. Un piston porté sur la
+tête s'étend brièvement quand le joueur reçoit des dégâts, uniquement en rendu :
+aucun bloc placé ou déplacé, aucun signal de redstone.
+
+## Sauvegarde, mort et New Game+
+
+Ajout d'un champ joueur `sanctuary:accessories`, schéma 1, contenant trois piles
+optionnelles dans l'ordre familier/cape/tête. Un ancien joueur beta.017 commence
+avec trois cases vides ; aucun déplacement ni changement des 54 cases existantes,
+du journal de progression ou de cycle. Les données inconnues/corrompues sont
+conservées et rendues non modifiables, sans remplacement silencieux.
+
+Les objets suivent la mort native : ils tombent si keepInventory est désactivé,
+sont conservés sinon. Le New Game+ les garde comme le reste de l'inventaire.
+La créature temporaire n'est jamais sauvegardée dans les chunks ; elle est
+recréée depuis l'œuf après reconnexion/changement de dimension, sans doublon.
+Les apparences cape/tête sont synchronisées par le serveur aux observateurs,
+y compris lors de l'arrivée d'un nouveau joueur. Aucun bonus serveur ne dépend
+de ces apparences. Nouveau contrat réseau `sanctuary:accessories_v1` : client et
+serveur beta.018 ensemble. Aucun monde personnel ou installation n'est modifié.
+
+## S’allonger et se reposer
+
+W est un geste de base gratuit. S’allonger disparaît des aptitudes achetables.
+Maj + W conserve le déblocage Se reposer et son coût. Le repos utilise le rendu
+natif de sommeil au lit, orienté selon le joueur, distinct de la posture mobile.
+Il ne déclenche pas le sommeil serveur, ne fixe pas de point de réapparition et
+ne fait pas avancer le temps. Les anciens champs et preuves d’achat `lying`
+sont conservés pour lire les sauvegardes beta.017 ; aucun nouvel achat n’est
+accepté et `lyingCost` devient un champ historique sans effet.
+
+## Validation
+
+### Sélections de minage et de construction
+
+Le retour d’essai ajouté pendant ce ticket fixe le groupe au premier clic
+maintenu avec R. Le client conserve l’origine, les cases et le palier ; le
+serveur valide la visée au démarrage puis poursuit le même travail sans exiger
+de regarder encore l’origine. Tourner la caméra ou bouger en restant à portée
+ne remet pas la charge à zéro. La construction garde son plan, sa face et ses
+directions de pose initiales, y compris pour les escaliers. Le contexte de pose
+est figé sans modifier la caméra ou la position réelle du joueur.
+
+La molette règle le palier avant le clic. Pendant le maintien, le groupe reste
+fixe, même après sa fin : il faut relâcher avant d’en choisir un autre. Les
+interruptions par changement d’outil, portée, menu, mort, droits, matériaux ou
+perte de maintien restent actives. Les interactions natives, durées, coûts et
+limites de blocs restent inchangés. Aucun nouveau format de sauvegarde ou paquet
+réseau n’est introduit pour ce verrouillage ; son état est temporaire.
+
+### Parcours client
+
+Le parcours automatisé du client Minecraft 26.3-pre-2, sur un monde de
+développement neuf de graine 42, passe avec le vrai clavier et la vraie souris :
+
+- Emplacements synchronisés et ordre visuel, inventaire à 1 et 6 rangées, FR/EN.
+- Maj-clic œuf/cape, placement manuel du cosmétique, piston avant/après un dégât
+  serveur et rendu d’épée, tête de joueur, coffre et piston.
+- Suivi vivant et caresse ; rendus loup, vache, perroquet, creeper, morue et ghast.
+- W gratuit, achat du repos, rendu de sommeil distinct et arrêt par déplacement.
+- Tab en jeu, Maj inverse, maintien sans répétition, autre touche configurée,
+  conservation des 54 positions visibles et de la colonne sélectionnée.
+- Balayage rapide dans les deux sens d’un coffre, destination pleine, une seule
+  visite par case, tri ingrédient/combustible du four, arrêt au relâchement de Maj,
+  équipement automatique œuf/cape et absence de cosmétique automatique.
+- Veine de huit blocs entièrement cassée après changement de visée et déplacement
+  à portée ; cible voisine conservée pendant le maintien, puis minée après
+  relâchement et nouveau clic. Molette sans effet sur la sélection verrouillée.
+- Surface de 25 escaliers terminée en regardant ailleurs et en bougeant, avec
+  orientation initiale et consommation exacte ; aucune nouvelle surface après
+  la fin tant que le clic est maintenu.
+
+Les captures sont dans `mods/sanctuary/build/run/clientGameTest/screenshots/` ;
+le journal complet final est `build/group-lock018-client.log` (1 min 46 s).
+`build/cosmetics018-client.log` conserve le premier parcours des accessoires
+et raccourcis, également réussi avant l’ajout des sélections verrouillées.
+
+Limites : les essais ne constituent pas une validation de toutes les espèces,
+de tous les modèles spéciaux d’objets/blocs, ni d’une session multijoueur sous
+latence. Le déplacement du compagnon reste terrestre, même pour une apparence
+aquatique ou volante. Les pouvoirs de familiers attendent leur ticket dédié.
+
+### Serveur et distribution
+
+`./gradlew check build assemblePack -PsanctuaryFocusedTests=accessories,progression,movement,inventory,inventoryflow,sorting,cycle,mining,building`
+passe en **4 min 51 s**, avec **67 tests serveur obligatoires réussis**, ainsi
+que les contrôles purs du dépôt. Journal : `build/cosmetics018-check-build.log`.
+Les tests couvrent les six capacités d’inventaire, équipement typé, destination
+pleine, mort, sauvegarde/rechargement, conservation au prestige, données futures
+préservées, navigation et invincibilité du familier, interruption de l’arc lors
+d’un changement de rangée, protections et coûts natifs du minage/construction.
+La durée de minage reste identique entre une caméra fixe et une caméra qui
+tourne ; le contexte de construction figé ne fuit pas dans la pose individuelle.
+
+Export local : [Sanctuary-beta.018.mrpack](../build/Sanctuary-beta.018.mrpack),
+**2 617 278 octets**. SHA-256 :
+`06997ae60f3306b9b973c4b5e83894ca302905fbdd337e1d0c36abf0fa4d9aba`.
+Reçu : `build/cosmetics018-artifact.json`. ZIP, versions, JAR Sanctuary et Demeure
+embarqués, ressources, libellés, index packwiz et dépendance Fabric API vérifiés.
+Les exports beta.003 à beta.017 restent identiques ; aucune installation
+personnelle ni canal publié n’a été modifié.