sanctuary/masterkey/tools/PANORAMA.md

Outil de panorama Sanctuary

Les trois actions restent volontairement séparées. Une capture ne modifie jamais le menu à elle seule.

1. Capturer dans Minecraft

En jeu, avec la permission gamemaster :

/masterkey panorama capture

Sanctuary utilise les six orientations cubiques natives de Minecraft et produit un dossier horodaté sous screenshots/sanctuary-panorama/ :

• panorama_0.png à panorama_5.png : six faces couleur 1024×1024 directement compatibles avec le menu ;
• depth_0.png à depth_5.png : profondeur linéarisée, proche en blanc et lointain en noir ;
• depth_raw_0.png à depth_raw_5.png : buffer reverse-Z brut, utile pour un traitement spécialisé ;
• capture.json : dimension, position, orientation, ordre des faces et format.

Le rendu panoramique retire la main, le HUD et le contour de bloc. Le monde reste figé seulement pendant les six rendus haute définition.

2. Ouvrir et vérifier

En jeu :

/masterkey panorama folder

Ou depuis la racine 26.2/ :

./masterkey/tools/panorama list
./masterkey/tools/panorama open latest
./masterkey/tools/panorama check latest

check refuse une face absente, un PNG mal formé, une mauvaise résolution ou un ancien format de métadonnées.

3. Appliquer explicitement

Après validation visuelle :

./masterkey/tools/panorama apply latest

Le script sauvegarde les six faces actuelles sous build/panorama-backups/, copie seulement les six images couleur dans les ressources Sanctuary, construit le JAR puis remplace uniquement Sanctuary dans l'instance Prism locale. L'ancien JAR reste récupérable sous mods-backup/panorama-*.

Pour modifier uniquement les sources et construire sans toucher à Prism :

./masterkey/tools/panorama apply latest --source-only

Les variables SANCTUARY_CAPTURE_ROOT et SANCTUARY_INSTANCE_MINECRAFT permettent de viser un autre dossier de captures ou une autre instance.