Add colored dynamic lights and smooth hue-preserving fades for beta.140

README.md

@@ -20,11 +20,12 @@ La [vision complète](docs/vision.md) conserve les intentions ; le
 L’économie, les claims et les dimensions décrits dans la vision restent
 à implémenter.
 
-La version **beta.125** étend les sculptures au centre, aux bords et aux coins,
-en bas, au milieu ou en haut du bloc. Les éclats reprennent la couleur des voxels
-et le Clay Workshop propose les animaux déjà découverts, en plus des imports GLB.
-Le [ticket de livraison](docs/sculpture-placement-beta125.md) décrit le placement,
-la compatibilité des anciennes sculptures et les vérifications.
+La version **beta.140** relie les lumières colorées aux objets en main et sur
+la tête, renforce leur teinte et ajoute une distance réglable de 8 à 64 blocs
+avec apparition progressive. Activation par défaut à 30 % ; torches natives,
+option « Torches chaudes » désactivée, cuivre vert et redstone rouge saturé.
+Les frontières de saturation des lumières bleues s’atténuent progressivement.
+Le [ticket](docs/colored-dynamic-beta140.md) décrit le rendu et les vérifications.
 La [livraison précédente](docs/clay-workshop-integration-beta110.md) réunit déjà
 l’atelier, les œufs et la neige saisonnière dans l’instance **Sanctuary Beta**.
 Les [synchronisations antérieures](docs/git-sync-beta092.md) restent documentées.
@@ -35,11 +36,127 @@ La [carte native beta.005](docs/atlas-beta005.md) prend le relais après
 l’étude de Xaero et des alternatives libres.
 
 
+## beta.140 — Lumières portées et fondus
+
+Mains et tête, distances 8/16/32/64, fondus, cuivre vert, redstone rouge et
+option pour la chaleur des torches. Lumières colorées activées à 30 % par défaut.
+[Contrat et vérifications](docs/colored-dynamic-beta140.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.140/Sanctuary-beta.140.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.140/Sanctuary-Test-beta.140.mrpack).
+
+## beta.139 — Lumières colorées
+
+Teintes chaudes, sources des âmes bleues, redstone rouge, froglights et matériaux lumineux.
+Option désactivée initialement, intensité 35 % ; propagation locale avec obstacles.
+[Contrat et vérifications](docs/colored-lights-beta139.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.139/Sanctuary-beta.139.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.139/Sanctuary-Test-beta.139.mrpack).
+
+## beta.138 — Rayons et brouillard
+
+Densité automatique des rayons selon le brouillard et les précipitations.
+[Contrat et vérifications](docs/shader-beta138.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.138/Sanctuary-beta.138.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.138/Sanctuary-Test-beta.138.mrpack).
+
+## beta.137 — Rayons solaires
+
+Faisceaux volumétriques légers, intensité réglable et feuillage perméable.
+[Contrat et vérifications](docs/shader-beta137.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.137/Sanctuary-beta.137.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.137/Sanctuary-Test-beta.137.mrpack).
+
+## beta.136 — Lens flare rectangulaire
+
+Soleil et lune, reflets doux et intensité indépendante du bloom.
+[Contrat et vérifications](docs/shader-beta136.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.136/Sanctuary-beta.136.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.136/Sanctuary-Test-beta.136.mrpack).
+
+## beta.135 — SSGI près des surfaces
+
+Correction des coupures à courte distance, sans flouter les textures.
+[Contrat et vérifications](docs/shader-beta135.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.135/Sanctuary-beta.135.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.135/Sanctuary-Test-beta.135.mrpack).
+
+## beta.134 — PBR optionnel et SSGI filtré
+
+Relief et reflets des matériaux ; lissage de la lumière indirecte.
+[Contrat et vérifications](docs/shader-beta134.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.134/Sanctuary-beta.134.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.134/Sanctuary-Test-beta.134.mrpack).
+
+## beta.133 — SSGI renforcé
+
+Couleurs voisines plus visibles, même budget de rayons et de cibles GPU.
+[Contrat et vérifications](docs/shader-beta133.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.133/Sanctuary-beta.133.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.133/Sanctuary-Test-beta.133.mrpack).
+
+## beta.132 — SSGI : diffusion locale des couleurs
+
+Rebond diffus des couleurs visibles, intensité réglable et reconstruction
+préservant les silhouettes. Expérimental, initialement désactivé.
+[Contrat et vérifications](docs/shader-beta132.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.132/Sanctuary-beta.132.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.132/Sanctuary-Test-beta.132.mrpack).
+
+## beta.131 — Émissifs indépendants et précision étendue
+
+Bloom, émissifs et highlight activés initialement ; halo facultatif et cinq
+précisions communes de 8 à 128 pixels/bloc.
+[Contrat et vérifications](docs/shader-beta131.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.131/Sanctuary-beta.131.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.131/Sanctuary-Test-beta.131.mrpack).
+
+## beta.130 — Bloom, minerais émissifs et précision commune
+
+Halo réglable des sources lumineuses et inclusions des vingt textures de
+minerais ; réglages par défaut 32/128/16 et ombres activées.
+[Contrat et vérifications](docs/shader-beta130.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.130/Sanctuary-beta.130.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.130/Sanctuary-Test-beta.130.mrpack).
+
+## beta.129 — Reflets CTM et ombres jusqu'à 256 blocs
+
+Reflets connectés réglables, cinq portées indépendantes, soleil plein à midi
+et correction du réalignement cyclique de la grille d'ombres.
+[Contrat et vérifications](docs/shader-beta129.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.129/Sanctuary-beta.129.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.129/Sanctuary-Test-beta.129.mrpack).
+
+## beta.128 — Ombres stables, lune et feuillage
+
+Grille de réception stabilisée, contours nets des blocs, atténuation à midi,
+ombre lunaire légère et feuillage nuancé selon son épaisseur.
+[Contrat et vérifications](docs/shader-beta128.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.128/Sanctuary-beta.128.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.128/Sanctuary-Test-beta.128.mrpack).
+
+## beta.127 — Shader : ombres portées pixélisées
+
+Ombres solaires natives, finesse 8/16/32 pixels par bloc et portée 16/32/64 blocs.
+Option désactivée par défaut, réglable sans rechargement des ressources.
+[Contrat et vérifications](docs/shader-beta127.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.127/Sanctuary-beta.127.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.127/Sanctuary-Test-beta.127.mrpack).
+
+## beta.126 — Gemmes, argile et découvertes
+
+Rubis et saphir avec filons configurables, couleurs originales avec l'argile,
+commandes de découverte globales ou ciblées.
+[Contrat et vérifications](docs/gems-beta126.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.126/Sanctuary-beta.126.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.126/Sanctuary-Test-beta.126.mrpack).
+
 ## beta.125 — Sculptures : placement, éclats et animaux
 
 Coins et trois hauteurs sur la grille 1/16 ; particules issues des voxels ;
 modèles découverts disponibles dans le Clay Workshop.
-[Contrat et vérifications](docs/sculpture-placement-beta125.md).
+[Contrat et vérifications](docs/sculpture-placement-beta125.md) ·
+[Pack normal](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.125/Sanctuary-beta.125.mrpack) ·
+[Pack de test](https://git.botsu.net/koka/sanctuary-beta/releases/download/beta.125/Sanctuary-Test-beta.125.mrpack).
 
 ## beta.124 — Une boîte par sculpture
 

docs/colored-dynamic-beta140.md

@@ -0,0 +1,101 @@
+# LIGHT-140 — Lumières colorées portées et distance
+
+Socle beta.139 `c05c338`, branche `codex/colored-dynamic-beta140`.
+Minecraft 26.3 / Java 25. Livraison beta.140.
+
+## Contrat
+
+Relier les couleurs aux vraies sources de lumière dynamique : mains, tête,
+cosmétiques, objets au sol et feu, selon le système existant. Renforcer la
+teinte et activer les lumières colorées par défaut à 30 %. Ajouter une distance
+d'affichage de 8, 16, 32 ou 64 blocs (16 par défaut), indépendante de la portée
+native de chaque source. Augmenter la distance coûte davantage en mémoire et
+calcul ; aucun chargement forcé de chunk. Les choix sauvegardés sont conservés.
+
+Sources portées actualisées avec le système dynamique, sans reconstruire tout
+le champ statique à chaque mouvement. Aucun changement de monde ou de règle
+serveur. Vérifications natives OpenGL et Vulkan, puis construction et archives.
+
+## Couleurs et fondus
+
+Torches ordinaires : température native par défaut ; option « Torches chaudes »
+pour retrouver l'orangé. Glowstone jaune, lave jaune-rouge, redstone rouge saturé,
+cuivre vert (posé, en main ou sur la tête). Le cuivre est reconnu avant les
+familles génériques de torches et lanternes. Les palettes explicites restent
+indépendantes des packs ; le repli des autres matériaux suit leurs textures.
+
+Le rendu s'atténue sur le dernier quart de la distance choisie. Le champ précédent
+reste disponible pendant un fondu de 300 ms vers le nouveau champ ; l'activation
+et les sources dynamiques ont aussi un fondu. Le changement de distance est
+interpolé. Les sources mobiles utilisent la même sélection bornée et les mêmes
+intensités que la lumière dynamique existante, avec interpolation visuelle des
+positions et couleurs. Elles héritent de sa propagation radiale, y compris de
+ses limites d'occultation ; les blocs posés conservent leur propagation avec murs.
+
+Le volume varie réellement selon la distance (56, 72, 104 ou 168 blocs de côté,
+avec marge de propagation). Les grandes distances augmentent la mémoire et le
+délai de reconstruction ; la construction reste répartie entre les images.
+Deux champs coexistent brièvement pour le fondu. Seuls les chunks déjà chargés
+sont lus. La portée lumineuse native des torches n'est pas allongée.
+
+## Frontières de saturation
+
+Le stockage beta.139 tronquait les canaux faibles séparément en fin de portée :
+un bleu pouvait perdre son rouge avant son vert, puis devenir plus saturé sur
+une frontière visible. Le stockage logarithmique conserve maintenant une marge
+sous le niveau lumineux natif zéro. Le shader applique la coupure à l'énergie
+globale en conservant les rapports RGB. La réponse devient linéaire près du noir,
+sans amplification par racine quatrième des très faibles contributions.
+
+La transition des champs interpole le résultat colorimétrique rendu, pas une
+énergie ensuite amplifiée. Les sources mobiles ont une atténuation de fondu
+compensée pour la même réponse. Le test contrôle les rapports rouge/bleu et
+vert/bleu d'une torche des âmes de 1 à 9 blocs, jusqu'au bord de sa portée.
+
+## Vérifications natives
+
+Minecraft 26.3 / Java 25 sur Apple M1, mondes de test neufs de graine 122 :
+
+- OpenGL 4.1 Metal : **2 min 40 s**, `build/colored140-opengl.log`.
+- Vulkan / MoltenVK 1.4.2, profondeur 0–1 et transparence améliorée :
+  **2 min 26 s**, `build/colored140-vulkan.log`.
+
+Les deux exécutions passent `COLORED139_PASS` et `COLORED140_PASS` :
+propagation avec murs, sources hors champ, lampes allumées/éteintes, retrait,
+rechargement des ressources, cache, déplacement/retour de caméra, OFF/zéro,
+préférences et traductions FR/EN. Les nouveaux contrôles couvrent la teinte
+bleue jusqu'à neuf blocs, la torche native inchangée, l'option chaude, le cuivre
+vert et le rouge saturé, les deux mains et le cosmétique de tête, la position
+en troisième personne, les quatre distances et un fondu sans dépassement.
+
+Dans la même scène contrôlée, la somme d'écarts OFF/torche chaude à 30 % vaut
+3 926 093 / 3 926 092 sur OpenGL/Vulkan, contre 2 025 577 en beta.139 à 35 %.
+Cette mesure vérifie l'accentuation demandée, pas la performance. Le test fige
+uniquement le scintillement de la lightmap native ; cette sonde et les tests
+client ne sont pas distribués. Les captures finales sont conservées sous
+`build/colored140-opengl-screenshots/` et `build/colored140-vulkan-screenshots/`.
+Comparatif autonome : `build/Shader-beta.140-comparaison.html`.
+
+Pas de validation des pilotes Windows de l'utilisateur revendiquée. Les
+limites de beta.139 pour le rendu sous l'eau/lave et les panoramas restent
+ouvertes. Les sources dynamiques gardent l'occultation du système existant.
+Aucun monde personnel ouvert ni modifié.
+
+## Construction et archives
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 22 s**, 126 tâches. Le GameTest serveur dédié reste exclu
+conformément au refus EULA antérieur ; les tests clients ci-dessus sont exécutés
+séparément. Log : `build/shader140-build.log`.
+
+La comparaison avec beta.139 trouve **18 entrées de production modifiées**,
+limitées aux lumières dynamiques/colorées, options et aides FR/EN. Les sources
+des JAR correspondent aux fichiers du dépôt. Les archives normale/Test contiennent
+le même JAR Sanctuary ; la version, les dépendances exactes, les textures de
+gemmes et de la clé de Steve, l'absence de classes de test et le template complet
+sont vérifiés. Reçu : `build/shader140-artifact.json`.
+
+SHA-256 du JAR : `853284c1a61c7fce12edd2f7763717321eef56977290eb0e7c5db5e30bff442f`.
+
+- Sanctuary-beta.140.mrpack : `1b366746e4d6bebfbe0115c849524bdeb81c14eee89a2510f9dbe18808974d6a`.
+- Sanctuary-Test-beta.140.mrpack : `50c3cdf759117bb5286d41b4535fde15d9d84deaac833b7f8f61c4a0d29b72e7`.

docs/colored-lights-beta139.md

@@ -0,0 +1,107 @@
+# LIGHT-139 — Lumières colorées
+
+Socle beta.138 + vérification Vulkan `9d84a02`, Minecraft 26.3 / Java 25.
+Branche `codex/colored-lights-beta139`, livraison beta.139.
+
+## Contrat
+
+Option locale « Lumières colorées » avec intensité. Les vrais blocs émetteurs
+teintent discrètement leurs environs, y compris hors champ. Torches/lanternes,
+lave et feu chauds ; sources des âmes bleues ; redstone active rouge ;
+froglights par variante ; sources Sanctuary selon leur texture/matière.
+Les blocs éteints n'émettent pas. Le bloom et les inclusions émissives des
+minerais restent indépendants ; aucune lumière de gameplay n'est ajoutée.
+
+Propagation RGB dans un volume local de blocs chargés, obstacles et formes
+natives, construction répartie entre les images, cache des couleurs de
+matériaux. Aucun chargement forcé de chunk, accès aux mondes personnels,
+changement de sauvegarde, réseau ou règles serveur.
+
+## Réalisation
+
+Dans les options du shader : « Lumières colorées », désactivées initialement,
+et une intensité de 0 à 100 %, réglée à 35 %. Zéro ou OFF libère les ressources.
+Les préférences existantes sont conservées. Libellés et aides FR/EN.
+
+Les familles vanilla demandées ont une palette dédiée. Les autres émetteurs,
+y compris ceux de Sanctuary, utilisent la couleur des pixels lumineux de leurs
+textures de modèle, calculée puis mise en cache. Ce repli suit les packs de
+ressources ; les palettes dédiées vanilla restent constantes. Une texture
+illisible ou sans pixels exploitables utilise du blanc. Les blocs purement
+émissifs du bloom, sans émission lumineuse native, ne deviennent pas des lampes.
+
+Le champ couvre un cube de 64 blocs de côté autour de la caméra. Une marge de
+14 blocs réserve la propagation aux sources présentes dans le volume ; le rendu
+s'atténue progressivement sur 4 blocs à sa périphérie. C'est donc un effet de
+proximité, pas une illumination de tous les chunks visibles. Les formes et
+l'opacité natives règlent le passage de la lumière. Les canaux utilisent des
+maxima indépendants, sans addition illimitée des sources superposées.
+
+Le calcul CPU est réparti avec un budget visé de 2 ms par image, plus les
+allocations et chargements ponctuels de matériaux ; aucun chiffre de FPS n'est
+garanti. Un monde immobile réutilise son champ. Les changements rapides et les
+déplacements peuvent présenter un bref retard, le temps de publier un champ
+complet. Aucun chargement forcé de chunk. Une texture 512 × 512 contient le champ.
+La passe GPU teinte les surfaces visibles, atténue l'effet au soleil et dans le
+brouillard, puis laisse agir le SSGI et le bloom. Les sources tenues, entités,
+particules et le rendu sous l'eau/lave ne sont pas couverts par cette option.
+
+## Vérifications
+
+Essais client natifs réussis dans des mondes neufs (graine 122) sur Apple M1 :
+
+- OpenGL 4.1 Metal : **1 min 46 s**, `build/colored139-opengl.log`.
+- Vulkan / MoltenVK 1.4.2, profondeur 0–1 et transparence améliorée :
+  **1 min 30 s**, `build/colored139-vulkan.log`.
+
+Les deux journaux contiennent `COLORED139_PASS` et le backend réellement actif.
+Torche et torche des âmes hors champ, trois froglights, pierre lumineuse dont
+la couleur vient de sa texture, intensité 35/100, cache statique, déplacement
+et retour de caméra, mur fermé puis ouvert, lampe redstone allumée puis éteinte,
+retrait de source, rechargement des ressources et OFF/zéro vérifiés.
+Les préférences persistantes et les libellés FR/EN sont contrôlés ; une dernière
+capture active conjointement PBR, SSGI, bloom, ombres, highlights et rayons.
+
+Les sommes d'écart entre OFF et 35 % sont presque identiques entre backends :
+torche 2 025 577 / 2 025 576 ; âmes 964 200 / 964 201. Il s'agit de mesures
+sur les pixels de cette scène, pas d'un indice de performance.
+Comparatif autonome : `build/Shader-beta.139-comparaison.html`.
+Pas de validation du pilote Vulkan Windows de l'utilisateur revendiquée.
+Le test fige uniquement le scintillement vanilla des torches afin de comparer
+les images ; cette sonde est exclue du JAR distribué. Aucun monde personnel ouvert.
+
+## Diagnostic des essais
+
+La première comparaison de stabilité détectait le scintillement natif de la
+lightmap des torches, même avec un champ coloré inchangé. La sonde de test
+stabilise ce seul facteur ; aucune désactivation de scintillement en production.
+La pièce d'essai est désormais construite après le chargement de ses chunks,
+et l'absence de lumière du ciel est vérifiée avant les captures.
+
+## Construction et archives
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 22 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader139-build.log`.
+La comparaison à beta.138 trouve **13 entrées de production** modifiées,
+limitées au shader, à son menu et aux aides FR/EN. Les sondes de test sont
+absentes du JAR distribué. Sources, archives normale/Test et template complets
+vérifiés ; textures des gemmes et clé de Steve conservées à l'identique.
+Reçu local : `build/shader139-artifact.json`.
+
+JAR SHA-256 : `7b958f6576adbabb2b1af589b866cb52b1a65600ea2fa505b05dd283f8d595df`.
+
+- `Sanctuary-beta.139.mrpack` : 10450317 octets ; SHA-256 `13f3a283c260876d28ce0c6504615b4a8f4d575906badfbb2b39558f312e9fbb`.
+- `Sanctuary-Test-beta.139.mrpack` : 10469244 octets ; SHA-256 `c1e0b684dc2650950a0925c4625ef5eb4b78fb5f1c5680f5e302550424fa6d81`.
+
+## Publication et instance
+
+[Release beta.139](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.139)
+publiée depuis `dc33ffa54697f61cd8f579235e7cebdbf0765f7c`, tag exact `beta.139`.
+Canal packwiz : `9f10167b6acfece9c045573580e186aa72bc91dc`.
+Deux synchronisations isolées puis deux synchronisations de la même instance
+Prism réussissent. Un seul JAR Sanctuary beta.139 actif, empreinte identique
+à l'archive vérifiée ; les **923 fichiers personnels suivis** conservent leurs
+empreintes. Sauvegarde des fichiers gérés dans
+`sanctuary-backups/before-beta.139/`. Aucun monde personnel ouvert.
+Reçus : `build/shader139-isolated.json`, `build/shader139-prism.json`.

docs/gems-beta126.md

@@ -0,0 +1,152 @@
+# GEM-01 — Gemmes, argile et découvertes — beta.126
+
+Contrat du 17 septembre 2026, branche `codex/gems-beta126`, Minecraft 26.3.
+
+Deux gemmes natives complètent l'émeraude : `sanctuary:ruby` et
+`sanctuary:sapphire`. Chaque famille comprend un bloc de stockage, un minerai
+ordinaire et un minerai des abîmes. Les huit PNG du créateur sont copiés à
+l'identique ; leurs empreintes figurent dans `tools/gems-textures-beta126.json`.
+Les noms des fichiers français `saphir` sont associés aux identifiants anglais
+stables `sapphire`, sans modifier les pixels. Les deux items utilisent les fichiers de remplacement
+`Desktop/ruby.png` et `Desktop/saphir.png` fournis en fin de livraison.
+
+L'ordre créatif est émeraude, rubis, saphir : ingrédients, blocs de stockage,
+minerais ordinaires et minerais des abîmes dans leurs onglets natifs respectifs.
+Minage à la pioche de fer ou mieux, résistance et expérience comme l'émeraude,
+Fortune, Toucher de soie, cuisson/four à fusion et conversion 9 gemmes ↔ 1 bloc.
+Les blocs peuvent former un socle de balise et les gemmes servir de paiement.
+Les recettes rejoignent la collection actuelle de l'émeraude, sans ajouter de
+transactions de villageois. Libellés français et anglais, tags communs `c:`.
+
+## Génération procédurale et contrat de compatibilité
+
+Profil initial **gemmes 1 / beta.126** : quatre tentatives par chunk et par
+gemme, filons natifs de taille 3, hauteur uniforme Y0–256, probabilité de rejet
+au contact de l'air de 0,25. Ces nombres sont un réglage initial à équilibrer
+lors de la future refonte ; aucun quota de gemmes par chunk n'est garanti.
+Les variantes ordinaires remplacent les roches du tag vanilla
+`stone_ore_replaceables`, les variantes des abîmes celles de
+`deepslate_ore_replaceables`.
+
+Les fichiers `worldgen/feature/ore_<gemme>.json`,
+`worldgen/placed_feature/ore_<gemme>.json` et les tags de biomes
+`has_ore/<gemme>` séparent les cibles, la forme, la fréquence, la hauteur et
+les régions. Un datapack peut les remplacer sans recompiler le mod. Le code
+réutilise `OreFeature` et le hasard natif issu de la graine ; il limite ces
+filons aux mondes utilisant `SanctuaryChunkGenerator`. Les biomes vanilla
+partagés avec Sanctuary restent compatibles sans ajouter les gemmes aux
+mondes vanilla, au Nether ou à l'End.
+
+Cette évolution additive est autorisée pour les **nouveaux chunks uniquement**.
+Aucun remplissage rétrospectif, aucune régénération, aucun remplacement de chunk
+sauvegardé ni activation d'expansion. Les codecs du relief, les dimensions et
+le format des sauvegardes restent inchangés. Les filons suivent les protections
+existantes de la décoration native. Les anciens profils expérimentaux précédant
+le générateur Sanctuary unifié ne sont pas étendus.
+
+## Argile spéciale dans le Clay Workshop
+
+Le bloc d'argile vanilla conserve les couleurs échantillonnées sur le modèle
+original, animal découvert ou import GLB. Les argiles colorées et les autres
+blocs continuent à transférer leur palette de texture. Une même règle est
+appliquée à l'aperçu client et au résultat serveur. Le changement de matériau
+invalide le résultat même si les deux palettes sont identiques. Le texte de
+l'atelier explique l'exception en français et en anglais.
+
+Une sculpture coûte toujours un bloc ; aucune recette, découverte, donnée de
+sculpture déjà fabriquée ni règle de placement n'est modifiée.
+
+## Commande de découverte commune
+
+`/sanctuary discovery all` découvre tous les blocs, objets et espèces enregistrés.
+Les variantes `blocks all`, `items all` et `mobs all` ciblent une catégorie ;
+`block <identifiant>`, `item <identifiant>` et `mob <identifiant>` ciblent une
+entrée avec la complétion native. Un sélecteur de joueurs en fin de commande
+est facultatif ; sans cible, elle s'applique au joueur qui l'exécute.
+
+Exemples :
+
+```mcfunction
+/sanctuary discovery all
+/sanctuary discovery mobs all
+/sanctuary discovery block minecraft:stone
+/sanctuary discovery item minecraft:diamond
+/sanctuary discovery mob minecraft:cow
+/sanctuary discovery all @a
+```
+
+La permission suit « Autoriser les commandes » en solo et les droits opérateur
+sur serveur. La console doit préciser la cible. Les identifiants invalides,
+l'air et les types d'entités sans espèce découvrable sont refusés.
+
+Les blocs passent par le registre de découvertes et son événement existant ;
+les objets passent par `RecipeService.discover`. Les collections et recettes
+sont ensuite recalculées normalement. Les espèces rejoignent `seen_mobs`,
+la même donnée que l'observation naturelle, consommée par les familiers,
+le Métabli et le Clay Workshop. Il n'existe aucun drapeau de déblocage parallèle.
+Les catalogues déjà ouverts sont à rouvrir après la commande.
+
+La commande conserve les quantités possédées et les compteurs de combat,
+minage, pose et fabrication. Elle ne donne pas d'objets, n'achète pas les skills
+et n'attribue pas d'advancements. Les recettes réservées aux opérateurs gardent
+leurs règles. Les historiques personnels sont enrichis sans changer leur
+schéma ; la commande refuse les données illisibles plutôt que les remplacer.
+
+## Vérifications
+
+Client natif Minecraft 26.3 / Java 25, `Gems126ClientChecks`, réussi en
+1 min 08 s. Les mondes sont jetables, sans sauvegarde personnelle ouverte :
+
+- Les huit items et six blocs sont présents, avec les huit textures exactes.
+  Quatre groupes créatifs respectent émeraude → rubis → saphir, sans doublons.
+- Douze recettes natives, découverte du bloc de stockage, outil fer minimum,
+  Fortune III, Toucher de soie et balises passent les contrôles serveur.
+- Graine **126**, profil gemmes 1, 81 chunks autour de l'origine : 7 rubis dans
+  la pierre et 8 dans la roche des abîmes ; 15 saphirs dans la pierre et 10 dans
+  la roche des abîmes. La génération est refusée dans le monde plat vanilla.
+  Les minerais persistent à la reconnexion, et un minerai retiré ne réapparaît pas.
+- L'argile conserve exactement les couleurs des voxels d'une vache et d'un GLB
+  texturé. Bois et argile colorée transfèrent toujours leur palette. Le retour
+  à l'argile, l'égalité aperçu/résultat et le coût d'un bloc en survie sont vérifiés.
+- La commande native respecte « Autoriser les commandes », accepte une cible
+  et la console, refuse les identifiants invalides et permet une espèce, un
+  bloc, un objet, toutes les espèces ou tout le contenu. Les recettes liées
+  sont recalculées. La répétition est idempotente et les découvertes survivent
+  à la reconnexion sans inventer de compteurs de combat ou de possession.
+
+Logs et captures dans `build/gems126-client.log` et
+`mods/sanctuary/build/run/clientGameTest/screenshots/`. Le GameTest dédié
+reste exclu conformément au refus antérieur de son EULA. Le build complet et
+les archives sont vérifiés séparément avant publication.
+
+
+Build final `./gradlew check build assemblePack assembleTestPack
+-x :sanctuary:runGameTest` réussi en **2 min 10 s**, 126 tâches. Les contrôles
+natifs de gameplay précèdent uniquement le remplacement final des deux PNG
+d'items ; les huit fichiers livrés sont vérifiés à l'octet près contre les
+sources, tous en 16 × 16. Les JAR de sources correspondent aux sources courantes.
+L'audit entre les binaires beta.125 et beta.126 ne trouve que les 112 entrées
+de production prévues. Les archives normal/Test contiennent le même mod et
+le template reproduit exactement ses ressources exportables.
+
+| Artefact | SHA-256 |
+| --- | --- |
+| `Sanctuary-beta.126.mrpack` | `716221ce24549781ab91f5437ad2310497b198a4b61c43c40c67a27984365ae5` |
+| `Sanctuary-Test-beta.126.mrpack` | `bbf22d7dd72e6746538b4ec28686f699225d4a59372304e5db42140a80e88bd1` |
+| `sanctuary-beta.126.jar` | `85dbe1b41d98751029bb62e87d259522f8609758896c797b1e02fa7656ec0342` |
+
+## Publication et synchronisation
+
+[Release beta.126](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.126)
+publiée depuis `99860af312a1737d938812f3515fcc4acb4291b2` ; artefacts
+immuables retéléchargés et vérifiés. Canal packwiz : `31749b95d21ce5bced6b9e5759499da6f8a67e6e`.
+Deux synchronisations isolées, puis deux synchronisations de l'instance existante
+**Sanctuary Beta** ont réussi. Un seul JAR Sanctuary beta.126, correspondant
+à l'empreinte ci-dessus. Les **923 fichiers personnels** suivis sont conservés,
+sauvegardes restées fermées ; copie préalable dans
+`sanctuary-backups/before-beta.126/`.
+
+Packs normal/Test et template copiés et vérifiés dans
+`sanctuary-beta/build/`. Reçus locaux : `build/gems126-artifact.json`,
+`build/gems126-isolated.json`, `build/gems126-prism.json` et
+`build/gems126-publication.log`.

docs/packwiz.md

@@ -14,6 +14,170 @@ JAR Sanctuary sont des pièces jointes de releases Gitea. Aucun JAR de mod ou
 dépendance téléchargée n'entre dans l'historique Git. Le canal Beta est distinct
 de l'ancien pack 26.2.
 
+## beta.138 — Densité des rayons selon la météo
+
+Brouillard plus dense et diffus, précipitations et atténuation de l'orage.
+Réglage manuel conservé, aucune nouvelle option ni modification de sauvegarde.
+[Contrat et vérifications](shader-beta138.md).
+[Release beta.138](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.138)
+publiée ; canal `c049423de1971079b9d61874d83adeb6f1ad49f7`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.138/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.137 — Rayons solaires volumétriques
+
+Rayons à travers les ouvertures et le feuillage, activés à 35 %, indépendants
+du bloom et de l'affichage des ombres de surface. Carte solaire partagée.
+[Contrat et vérifications](shader-beta137.md).
+[Release beta.137](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.137)
+publiée ; canal `68cb39a5edbf5d34def02f670e2488ee852605b8`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.137/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.136 — Lens flare rectangulaire
+
+Rectangles à dégradé doux pour le soleil et la lune, activés à 30 % et
+réglables indépendamment du bloom. Occultation par les blocs et phases lunaires.
+[Contrat et vérifications](shader-beta136.md).
+[Release beta.136](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.136)
+publiée ; canal `dd5b545a7cfbb957f2c70e9dc17034b44caef98f`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.136/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.135 — SSGI en proximité et nouveaux défauts
+
+Normales stables près des surfaces, atténuation progressive du rebond au contact.
+Bloom à 20 %, PBR et SSGI activés par défaut, choix personnels existants conservés.
+[Contrat et vérifications](shader-beta135.md).
+[Release beta.135](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.135)
+publiée ; canal `5b0df577fcd036937c25be3a1f4580f9db3103a1`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.135/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.134 — PBR optionnel et SSGI filtré
+
+Normales procédurales en cache, rugosité/métallicité par famille et reflets
+directionnels. Filtrage SSGI et suppression de sa forte réinjection neutre.
+[Contrat et vérifications](shader-beta134.md).
+[Release beta.134](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.134)
+publiée ; canal `35ec0f6e145002f6367944df5b75e2703958eaef`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.134/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.133 — SSGI renforcé
+
+Diffusion des couleurs rendue visible au réglage 35, même budget de rayons
+et cibles GPU. [Contrat et vérifications](shader-beta133.md).
+[Release beta.133](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.133)
+publiée ; canal `9ceb5a5353c9d1b8bb7834a20e818fd65096ff98`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.133/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.132 — SSGI expérimental
+
+Diffusion locale des couleurs visibles, rayon 2,5 blocs, intensité réglable,
+initialement OFF. [Contrat et vérifications](shader-beta132.md).
+[Release beta.132](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.132)
+publiée ; canal `9edaaedc0205c525ecce9de66b5ca7827c56c28f`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis gardent leurs hashes. Aucun monde personnel ouvert ;
+sauvegarde préalable `sanctuary-backups/before-beta.132/`.
+Packs normal/Test/template vérifiés dans `sanctuary-beta/build/`.
+
+## beta.131 — émissifs indépendants et précision étendue
+
+Bloom, émissifs et highlight ON initialement. Couper le halo ou régler son
+intensité à zéro garde les inclusions lumineuses. Précisions 64/128 ajoutées,
+défaut 16 conservé. [Contrat et vérifications](shader-beta131.md).
+[Release beta.131](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.131)
+publiée ; canal `efb18c274d95d988a9566b8c52751469f002cdda`. Deux synchronisations isolées,
+puis deux dans la même instance Sanctuary Beta réussies. Les 923 fichiers
+personnels suivis sont conservés, préférences et sauvegardes comprises.
+Aucun monde personnel ouvert ; sauvegarde `sanctuary-backups/before-beta.131/`.
+Archives normal/Test/template vérifiées dans `sanctuary-beta/build/`.
+
+## beta.130 — bloom et précision commune
+
+Bloom réglable, masques sélectifs des vingt textures de minerais, précision
+commune aux ombres et au highlight. Réglages initiaux 32/128/16 et Pixel Shadows
+activé ; anciennes préférences conservées. [Contrat et vérifications](shader-beta130.md).
+[Release beta.130](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.130)
+publiée ; canal `68e06353bf880af04c1c72d4e3a159f11f94b619`. Deux synchronisations isolées
+puis deux dans la même instance **Sanctuary Beta** réussies. Les 923 fichiers
+personnels suivis, réglages de shaders compris, gardent leurs hashes. Aucun
+monde personnel ouvert ; sauvegarde préalable `sanctuary-backups/before-beta.130/`.
+Packs normal/Test et template vérifiés et copiés dans `sanctuary-beta/build/`.
+
+## beta.129 — reflets CTM et portées 16–256 blocs
+
+Reflets connectés entre tous les matériaux coplanaires, portée indépendante,
+ombres à 128/256 blocs, intensité rétablie à midi et correction du réalignement
+cyclique de la grille lumineuse. [Contrat et vérifications](shader-beta129.md).
+[Release beta.129](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.129)
+publiée ; canal `2eaa0130a4cd475c598beefdab40f48fc8681ab7`. Deux synchronisations isolées
+puis deux dans la même instance **Sanctuary Beta** réussies. Les 923 fichiers
+personnels suivis, réglages de shaders compris, sont conservés. Aucun monde
+personnel ouvert ; copie préalable dans `sanctuary-backups/before-beta.129/`.
+Packs normal/Test et template copiés et vérifiés dans `sanctuary-beta/build/`.
+
+## beta.128 — stabilité des ombres, lune et feuillage
+
+Ombres des blocs nettes et stabilisées, atténuation à midi, lune légère et
+feuillage nuancé selon son épaisseur. [Contrat et vérifications](shader-beta128.md).
+[Release beta.128](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.128)
+publiée ; canal `eba01726ee132a6e548d129fa7ee04f24c880917`. Deux synchronisations isolées
+puis deux dans la même instance **Sanctuary Beta** réussies. Les 923 fichiers
+personnels suivis, réglages de shaders compris, sont conservés. Aucun monde
+personnel ouvert ; copie préalable dans `sanctuary-backups/before-beta.128/`.
+Packs normal/Test et template copiés et vérifiés dans `sanctuary-beta/build/`.
+
+## beta.127 — shader et ombres pixélisées
+
+Ombres solaires optionnelles intégrées à Sanctuary · Vanilla Light, avec finesse
+et portée réglables. Socle beta.126 conservé. [Contrat et vérifications](shader-beta127.md).
+[Release beta.127](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.127)
+publiée ; canal `7fd24a43e01ee497a23311e3c78e1dd3dddd877a`. Deux synchronisations
+isolées puis deux dans la même instance **Sanctuary Beta** réussies.
+Les 923 fichiers personnels suivis, réglages de shaders compris, sont conservés.
+Aucun monde personnel ouvert ; copie préalable dans `sanctuary-backups/before-beta.127/`.
+Packs normal/Test et template copiés et vérifiés dans `sanctuary-beta/build/`.
+
+## beta.126 — gemmes, argile et découvertes
+
+Rubis et saphir, nouvelles textures d'items, argile conservant les couleurs
+originales et commandes de découverte communes aux recettes et catalogues.
+[Contrat et vérifications](gems-beta126.md).
+[Release beta.126](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.126)
+publiée ; canal `31749b95d21ce5bced6b9e5759499da6f8a67e6e`. Deux synchronisations
+isolées puis deux dans la même instance **Sanctuary Beta** réussies.
+Les 923 fichiers personnels et réglages suivis sont inchangés ; sauvegardes
+restées fermées. Copie préalable dans `sanctuary-backups/before-beta.126/`.
+Packs normal/Test et template copiés et vérifiés dans `sanctuary-beta/build/`.
+
+## beta.125 — placement, éclats et animaux sculptés
+
+Coins et trois hauteurs, particules de voxels et espèces découvertes au Clay
+Workshop. [Contrat et vérifications](sculpture-placement-beta125.md).
+[Release beta.125](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.125)
+publiée ; canal `47eb833911a96eef0b13805dafe65b2ab7b95c87`. Deux
+synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussies. Les 923 fichiers personnels et réglages suivis sont inchangés ;
+sauvegardes restées fermées. Copie préalable dans
+`sanctuary-backups/before-beta.125/`. Packs normal/Test et template copiés
+et vérifiés dans le dossier habituel `sanctuary-beta/build/`.
+
 ## beta.124 — une boîte par sculpture
 
 Une boîte ajustée commune à la sélection et aux collisions ; détails physiques

docs/pixel-shadows-source122.md

@@ -0,0 +1,128 @@
+# Préparation locale des ombres portées pixélisées (ancien numéro beta.122)
+
+Ticket du 17 septembre 2026, branche locale `codex/pixel-shadows-beta122`.
+Cette préparation n'a jamais été publiée sous le numéro beta.122, déjà utilisé
+par une autre livraison. Elle est intégrée au socle beta.126 et livrée en
+[beta.127](shader-beta127.md). Les chemins et mesures ci-dessous décrivent
+les essais historiques dans le dossier de préparation.
+Demande : ajouter aux réglages de Sanctuary · Vanilla Light des ombres portées
+pixélisées, avec une finesse et une distance réglables.
+
+## Utilisation
+
+Dans **Options → Shaders**, activer **Sanctuary · Vanilla Light**, puis
+**Ombres portées pixélisées**. L'option est désactivée par défaut pour conserver
+le coût et le rendu des installations existantes. Les choix sont :
+
+- finesse de **8, 16 ou 32 pixels par bloc**, défaut 16 ;
+- distance de **16, 32 ou 64 blocs**, défaut 32.
+
+Ces préférences sont conservées dans `config/sanctuary-shaders.json`, avec les
+anciens champs de couleur. Leurs valeurs numériques sont ramenées aux choix
+admis au chargement. Les libellés et explications sont disponibles en FR/EN.
+Les réglages s'appliquent sans recharger les ressources.
+
+## Rendu et périmètre
+
+Une carte de profondeur rend les formes d'occultation des blocs solides chargés
+autour de la caméra, indépendamment de leur présence à l'écran. Les dalles et
+escaliers conservent leurs formes. Le cache est invalidé par les changements de
+blocs, les paquets de chunks et les reconstructions du moteur natif.
+La direction solaire vient du ciel natif extrait par Minecraft, et respecte
+ainsi l'angle solaire de Sanctuary. L'effet s'atténue sous la pluie, à l'horizon,
+dans la brume et à la limite de sa portée. Il s'arrête la nuit, dans les dimensions
+sans soleil, dans les fluides et lorsqu'un moteur externe suspend Vanilla Light.
+
+La profondeur du monde est lue directement par le GPU après le rendu du monde,
+avant la main et l'interface. L'inverse de la projection réelle inclut les effets
+de caméra. Les points recevant l'ombre sont arrondis sur une grille ancrée dans
+le monde ; le plan de la face est conservé pour limiter les auto-ombres.
+La carte solaire utilise également une origine alignée sur ses texels.
+Le HUD, la main, les étoiles et les captures panoramiques techniques gardent leur
+chemin de rendu. Aucun niveau de lumière de gameplay, règle serveur, sauvegarde
+ou générateur n'est changé. Aucune dépendance de rendu n'est ajoutée.
+
+Cette première version couvre les **formes d'occultation des blocs** : les entités
+conservent leurs ombres natives ; les feuillages ajourés, modèles non occultants,
+block entities animés, eau et verre ne projettent pas de nouvelles silhouettes.
+Les transparences et particules déjà composées peuvent recevoir l'assombrissement
+du terrain derrière elles. Il n'y a pas d'ombres de lune ou de torches, ni de
+séparation de l'éclairage local émissif dans cette passe d'assombrissement.
+
+## Coût et cycle de vie
+
+Les maillages sont mis en cache par section de 16³, avec au plus quatre sections
+commencées par image et un budget souple de 3 ms pour leur construction. Les
+ombres apparaissent progressivement pendant la préparation après activation ou
+déplacement. Le volume des obstacles part de la portée choisie avec une marge de huit blocs,
+puis s’étend vers le soleil sur deux fois cette portée, arrondi aux sections.
+Les obstacles au-delà de ce volume ou dans des chunks non chargés ne sont pas
+représentés. Les mises à jour de lumière seule ne reconstruisent pas les formes.
+Le cache de sommets est plafonné à 96 Mio et omet les formes pathologiques qui
+dépassent ses limites. Les textures de profondeur font entre 512 et 4 096 pixels
+de côté selon finesse et portée. Le coût exact dépend de la scène et du GPU.
+
+Les ressources sont libérées à la désactivation, au changement de monde, à la
+reconstruction des ressources et à l'arrêt du client. Cette livraison est locale :
+aucun avancement du canal packwiz ni installation personnelle ne fait partie du
+ticket.
+
+## Vérification
+
+Validation native sur **Minecraft 26.3, Java 25, macOS / Apple M1, OpenGL 4.1**,
+dans un nouveau monde plat de développement, graine **122** :
+
+- Comparaison GPU activation/désactivation sur une plateforme blanche avec
+  pilier, dalle et escalier : **920 échantillons assombris**, 63 412 inchangés,
+  aucun éclairci sur les 64 332 échantillons de sol retenus.
+- Pilier entièrement hors du frustum : **42 048 échantillons** restent dans
+  son ombre. Le retrait du pilier restitue la lumière sur **42 048 / 42 048**
+  échantillons et préserve les 23 616 échantillons déjà éclairés. Sa repose
+  restitue la même ombre, sans désactiver le cache entre ces manipulations.
+- Les trois finesses et les trois portées sont appliquées en direct ; les cartes
+  GPU sont redimensionnées aux dimensions attendues. Désactiver l'option libère
+  la texture et ne soumet plus de passe d'ombres.
+- À minuit, activer ou désactiver l'option donne la même image et aucune passe
+  solaire n'est soumise. Au retour du jour, le rendu reprend.
+- Le rechargement des ressources restitue la même image. Les préférences
+  persistent à la relecture du fichier et leurs valeurs extrêmes sont bornées.
+- Menus FR/EN inspectés en capture ; les libellés tiennent dans les contrôles
+  natifs à la taille de test. Les vues de finesse 8/16/32 sont conservées.
+
+```sh
+./gradlew :sanctuary:runClientGameTest \
+  -PsanctuaryClientTests=true -PsanctuaryPixelShadows122ClientTests=true \
+  -PsanctuaryClientNoVsync=true -PsanctuaryQuickTests=true
+```
+
+Succès en **1 min 17 s**, marqueur `PIXEL_SHADOWS122_CLIENT_PASS` dans
+`build/pixel-shadows122-client.log`. Captures inspectées dans
+`build/pixel-shadows122-evidence/final/`. Les pixels sont relus uniquement dans
+le test ; le code de rendu de production n'effectue aucune lecture CPU de GPU.
+Les premiers démarrages ont permis de corriger les identifiants de pipelines,
+la directive GLSL `#include` attendue par 26.3 et deux libellés répétés du menu.
+
+La commande de livraison est :
+
+```sh
+./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest
+```
+
+Le serveur GameTest dédié est exclu, conformément au refus de son EULA déjà
+consigné dans les livraisons précédentes. Le test graphique utilise le serveur
+intégré de son monde neuf. Aucun monde personnel n'est ouvert.
+La construction finale **réussit en 2 min 18 s** (126 tâches), journal
+`build/pixel-shadows122-build-final.log`. Le contrôle des archives confirme
+**868 sources Java** et **1 869 classes** identiques aux sorties construites,
+les ressources GLSL/FR/EN exactes dans le JAR et le template, et le même JAR
+dans les profils packwiz normal et Test. Aucune fixture cliente n'est embarquée.
+Reçu : `build/pixel-shadows122-artifact.json`.
+
+Artefacts locaux : `mods/sanctuary/build/libs/sanctuary-beta.122.jar`,
+`build/packwiz/`, `build/packwiz-test/` et `build/Sanctuary-Template-beta.122.zip`.
+SHA-256 du JAR :
+`66987681cede1d2adc1dda449078e8fa85310eb2c3fecd7a905d772ce75739c9`.
+
+Pas de mesure de FPS, d'essai Windows/Vulkan, de pack Iris ni de silhouettes
+animées revendiqués. Le shader reste un assombrissement graphique appliqué au
+rendu opaque et déjà composé, avec les limites de transparence décrites plus haut.

docs/sculpture-placement-beta125.md

@@ -92,3 +92,17 @@ reproduit les ressources du mod et du pack intégré.
 
 Reçu local : `build/sculpture125-artifact.json`. Les deux packs et le template
 sont copiés et vérifiés dans le dossier habituel `sanctuary-beta/build/`.
+
+## Publication et installation
+
+La [release beta.125](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.125)
+est publiée depuis `4ec5b0d028a23a9f753770988ffba61015e2e49a`.
+Tag et artefacts immuables, téléchargements publics vérifiés. Canal packwiz :
+`47eb833911a96eef0b13805dafe65b2ab7b95c87`.
+
+Deux synchronisations isolées puis deux dans l'instance **Sanctuary Beta**
+réussissent. Un seul JAR Sanctuary beta.125 est actif, conforme au hash vérifié ;
+le second passage ne change rien. Les **923 fichiers personnels et réglages
+suivis** restent inchangés, sans ouverture de monde personnel. Copie préalable
+sous `sanctuary-backups/before-beta.125/`. Reçus :
+`build/sculpture125-isolated.json` et `build/sculpture125-prism.json`.

docs/shader-beta127.md

@@ -0,0 +1,88 @@
+# SHADER-127 — intégration des ombres portées pixélisées
+
+Demande du 17 septembre 2026 : livrer le shader dans **beta.127**.
+Branche `codex/shader-beta127`, socle publié beta.126, Minecraft 26.3 / Java 25.
+
+La préparation locale [des ombres pixélisées](pixel-shadows-source122.md) est
+intégrée sans écraser les changements non publiés du dossier d'origine.
+Les gemmes, dernières textures de rubis/saphir, l'argile spéciale et les
+commandes de découverte de beta.126 sont conservées.
+
+## Utilisation
+
+**Options → Shaders → Sanctuary · Vanilla Light → Ombres portées pixélisées**.
+L'option est désactivée par défaut ; son activation reste un choix du joueur.
+Finesse : 8/16/32 pixels par bloc ; portée : 16/32/64 blocs. Défauts : 16 et 32.
+Les paramètres FR/EN s'appliquent immédiatement et persistent dans
+`config/sanctuary-shaders.json`. La mise à jour préserve les réglages personnels.
+Le rendu est natif au mod : aucun pack Iris, téléchargement supplémentaire ou
+nouvelle dépendance de rendu.
+
+## Périmètre
+
+Ombres solaires des formes d'occultation des blocs chargés, incluant dalles,
+escaliers et obstacles hors écran. Carte de profondeur GPU, grille ancrée dans
+le monde, atténuation selon soleil, pluie et brume. L'effet s'arrête la nuit,
+dans les dimensions sans soleil, dans les fluides ou avec un moteur externe.
+Le HUD et la main ne passent pas dans cet effet. La lumière de gameplay,
+les règles serveur, les sauvegardes et la génération ne sont pas modifiées.
+
+La préparation limite le cache à 96 Mio et sa construction à quatre sections
+par image dans un budget souple de 3 ms. L'intégration supprime seulement une
+invalidation de bord exécutée deux fois à l'identique dans le cache de terrain.
+Les formes non occultantes, feuillages ajourés, eau/verre et entités animées ne
+projettent pas de nouvelles silhouettes. Les transparences déjà composées
+peuvent recevoir l'assombrissement du terrain situé derrière elles. Pas
+d'ombres de torches/lune ni de mesure de FPS revendiquée.
+
+## Vérifications et livraison
+
+Client natif Minecraft 26.3 / Java 25 sur macOS, monde neuf plat, graine 122 :
+`PixelShadows122ClientChecks` réussit sur la beta.127 en **1 min 26 s**.
+Le nom de cette fixture historique est conservé pour suivre la même scène.
+
+- Activation : 920 échantillons de sol assombris, 63 412 inchangés, aucun éclairci.
+- Pilier hors écran : 42 048 échantillons restent ombrés ; le retrait du pilier
+  restitue la lumière sur les 42 048 et conserve les 23 616 déjà éclairés.
+  La repose rétablit la même ombre sans désactiver le cache.
+- Trois finesses et trois portées, redimensionnement GPU, désactivation/libération,
+  arrêt nocturne, reprise diurne et rechargement des ressources vérifiés.
+- Préférences persistantes et bornées ; captures FR/EN inspectées, sans texte
+  tronqué. La scène pilier/dalle/escalier est également inspectée visuellement.
+
+Logs : `build/shader127-client.log`. Captures :
+`mods/sanctuary/build/run/clientGameTest/screenshots/`.
+Le serveur GameTest dédié reste exclu conformément au refus antérieur de son
+EULA. Aucun monde personnel n'est ouvert. Aucun essai Windows/Vulkan ou FPS
+n'est revendiqué ; la validation graphique est celle du client natif local.
+
+
+Build `./gradlew check build assemblePack assembleTestPack
+-x :sanctuary:runGameTest` réussi en **2 min 25 s**, 126 tâches. Les sources
+Java dans les archives correspondent aux sources du ticket. La comparaison
+avec le JAR beta.126 ne trouve que **21 entrées de production modifiées**,
+toutes liées au shader, à son initialisation, ses mixins et ses libellés.
+Les règles de jeu, données, textures de gemmes, sculptures et découvertes
+sont identiques. Normal et Test contiennent le même JAR ; le template exporte
+exactement les ressources du mod. Aucune fixture de test ni monde embarqué.
+
+| Artefact | SHA-256 |
+| --- | --- |
+| `Sanctuary-beta.127.mrpack` | `23fa6ca0c5d1f1033e13e5370d669491b398d5a99e13f8bd1e983f998a24a20a` |
+| `Sanctuary-Test-beta.127.mrpack` | `f185f3a743ba23cd6c024d1c1e46587706bf4f3edb5e14d7e5dee522a1ebf2c2` |
+| `sanctuary-beta.127.jar` | `3ef3fab67f4f703864a1acc9ae2395c636d206f3128d3399140eaf045a46d5f3` |
+
+## Publication et synchronisation
+
+[Release beta.127](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.127)
+publiée depuis `00be1eb0d0bfe042442d90255385033a7765092f` ; artefacts immuables retéléchargés
+et vérifiés. Canal packwiz : `7fd24a43e01ee497a23311e3c78e1dd3dddd877a`.
+Deux synchronisations isolées puis deux dans l'instance existante
+**Sanctuary Beta** ont réussi. Les **923 fichiers personnels** suivis,
+y compris les préférences de shaders, sont conservés. Aucun monde personnel
+ouvert ; copie préalable dans `sanctuary-backups/before-beta.127/`.
+
+Les packs normal/Test et le template sont aussi copiés et vérifiés dans
+`sanctuary-beta/build/`. Reçus locaux : `build/shader127-artifact.json`,
+`build/shader127-isolated.json`, `build/shader127-prism.json` et journal de
+publication `build/shader127-publication.log`.

docs/shader-beta128.md

@@ -0,0 +1,106 @@
+# SHADER-128 — stabilité, lune et feuillage
+
+Demandes du 17 septembre 2026 : réduire le jitter des bords et à midi, conserver
+des ombres de blocs nettes et un feuillage nuancé, ajouter une ombre lunaire
+fine et une transmission
+irrégulière du feuillage selon son épaisseur. Branche `codex/moon-foliage-beta128`,
+socle publié beta.127, Minecraft 26.3 / Java 25.
+
+## Résultat
+
+Les faces de voxels reçoivent l'ombre sur une grille fixe ; leur plan est
+stabilisé au 1/16 de bloc et les faces inclinées conservent leur normale. La
+carte de profondeur utilise un ancrage par 16 blocs avec alignement de ses
+texels. **Les ombres des blocs restent nettes** : le créateur a écarté leur
+adoucissement après l'essai visuel. Le filtrage est réservé au feuillage.
+Le soleil continue de se déplacer : ce mouvement naturel peut toujours faire
+avancer une ombre d'une case. L'objectif est de supprimer les oscillations
+liées à la caméra, pas de figer le temps.
+
+Entre une élévation solaire de 0,92 et le zénith, l'intensité diminue doucement
+jusqu'à 25 % de sa valeur habituelle : alpha maximal 0,095 au lieu de 0,38.
+La lune réutilise la même carte et son angle natif ; alpha maximal 0,10 selon
+sa phase, nul à la nouvelle lune. Horizon, pluie, portée et brume atténuent
+les deux lumières. Pas de seconde passe de carte lunaire simultanée.
+
+Les blocs du tag vanilla `leaves` projettent une couverture probabiliste fixe
+sur une grille de quart de bloc. Les faces internes restent présentes : plus
+le rayon traverse de couches, moins il a de chances de passer. Il s'agit d'une
+approximation statistique de l'épaisseur, pas d'un comptage des feuilles ni
+d'une lecture des trous de leur texture. Quatre échantillons bilinéaires sur
+un quart de bloc mélangent cette couverture
+en nuances, évaluées sur la grille pixélisée. Un masque R8 distingue feuilles
+et blocs dans la même passe de profondeur, pour garder les silhouettes opaques
+nettes. Les comparaisons suivent le plan récepteur pour éviter l'auto-ombrage
+sur les surfaces obliques. Le motif ne dépend ni du temps ni de la caméra et
+ne demande aucune lecture GPU côté CPU en production.
+Les budgets du cache restent 96 Mio, quatre sections et 3 ms souples par image.
+Le feuillage ajoute des faces ; son filtrage utilise seize comparaisons de
+profondeur et, selon le cas, autant de lectures du masque. Les ombres opaques
+pleines utilisent le chemin court. Le masque prend 4 Mio à la définition
+par défaut, 16 Mio au maximum ; aucune promesse de FPS n'est faite.
+
+Réglages existants et libellés FR/EN conservés/actualisés. Les ombres restent
+optionnelles et désactivées par défaut. Règles, éclairage de gameplay, mondes
+et génération inchangés. Les limitations de beta.127 concernant les entités,
+fluides, verre et autres formes non occultantes subsistent.
+
+## Vérifications
+
+`PixelShadows122ClientChecks`, fixture historique étendue, réussit en **1 min
+44 s** dans un monde neuf plat, graine 122, client natif macOS/OpenGL.
+
+- Soleil : 920 échantillons de sol ombrés et 63 412 inchangés ; retrait/repose
+  d'un pilier hors écran restitue puis rétablit son ombre.
+- Lune : ombre localisée mesurée ; arrêt des passes à la nouvelle lune.
+- Midi : ombre atténuée et **zéro échantillon de transition adoucie sur 65 664**
+  dans la scène de contrôle du contour opaque.
+- Caméra : petits déplacements autour de l'ancien ancrage entier et du nouvel
+  ancrage par 16 blocs, retour au point initial, petites rotations en vue
+  oblique, instants avant/après midi et passage de 5999 à 6001 ticks.
+  Comparaisons d'images avec tolérance de trois niveaux par canal et moins
+  de 1 % d'échantillons changés pour ces petits mouvements.
+- Vue oblique : 19 637 échantillons ombrés, 46 027 inchangés sur le sol blanc.
+- Feuillage : assombrissement moyen mesuré d'environ **18,6 %** pour une couche,
+  **31,7 %** pour quatre, contre **36,8 %** sous une couverture solide.
+  Motif fixe dans le temps ; modification des couches invalide le cache actif.
+- Trois finesses/trois portées, désactivation/libération GPU, préférences
+  persistantes, rechargement des ressources, textes FR/EN et captures inspectés.
+
+Commande native : `./gradlew :sanctuary:runClientGameTest
+-PsanctuaryClientTests=true -PsanctuaryPixelShadows122ClientTests=true
+-PsanctuaryClientNoVsync=true -PsanctuaryQuickTests=true` sous Java 25.
+Logs : `build/shader128-client.log` ; captures sous
+`mods/sanctuary/build/run/clientGameTest/screenshots/`.
+
+`./gradlew check build assemblePack assembleTestPack
+-x :sanctuary:runGameTest` réussit en **2 min 24 s**, 126 tâches.
+Les sources archivées correspondent au ticket. **13 entrées de production**
+diffèrent de beta.127, limitées aux classes du shader, GLSL et libellés FR/EN.
+Gemmes, sculptures, découvertes, données et règles de jeu restent identiques.
+Normal et Test embarquent le même JAR ; le template correspond exactement aux
+ressources exportables. Aucun monde ni fixture de test embarqué.
+Le serveur GameTest dédié reste exclu conformément au refus antérieur de son
+EULA. Aucun monde personnel utilisé. Aucun essai Windows/Vulkan revendiqué.
+
+## Artefacts vérifiés
+
+| Artefact | SHA-256 |
+| --- | --- |
+| `Sanctuary-beta.128.mrpack` | `84125b18366afde52c8cba4bc7007257b1c3d8b79d413338abe64d0e0ae8feaf` |
+| `Sanctuary-Test-beta.128.mrpack` | `6bfb10d8d63875bfb84e813d4f0a9faf5db30902cc0400deda0993c08b86e597` |
+| `sanctuary-beta.128.jar` | `c54cbae7efaa7059c8fd4d28801087983379958fe34eedff51682d106d649c6a` |
+
+## Publication et synchronisation
+
+[Release beta.128](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.128)
+publiée depuis `a4e96c0d99c976231d7ca92b1db6bdb6aa7083c6` ; les artefacts immuables ont été
+retéléchargés et vérifiés. Canal packwiz : `eba01726ee132a6e548d129fa7ee04f24c880917`.
+Deux synchronisations isolées puis deux dans l'instance existante
+**Sanctuary Beta** ont réussi. Les **923 fichiers personnels** suivis,
+y compris les réglages de shaders, sont conservés. Aucun monde personnel
+ouvert ; copie préalable dans `sanctuary-backups/before-beta.128/`.
+Packs normal/Test et template copiés et vérifiés dans `sanctuary-beta/build/`.
+
+Reçus locaux : `build/shader128-artifact.json`, `build/shader128-isolated.json`,
+`build/shader128-prism.json` ; journal : `build/shader128-publication.log`.

docs/shader-beta129.md

@@ -0,0 +1,119 @@
+# SHADER-129 — arêtes connectées et portées étendues
+
+Demandes du 17 septembre 2026 : highlight optionnel, puis raccordement CTM de
+tous les blocs coplanaires, portée indépendante 16–256 blocs, ombres à 128/256,
+suppression de l'atténuation au zénith et du réalignement cyclique des ombres.
+Branche `codex/edge-highlights-beta129`, socle beta.128, Minecraft 26.3 / Java 25.
+
+## Résultat
+
+Dans **Options → Shaders → Sanctuary · Vanilla Light**, les reflets sur les
+arêtes sont désactivés par défaut. L'intensité va de 0 à 100 ; la valeur 30
+éclaircit au maximum de 12 %. Leur portée se règle indépendamment des ombres :
+**16, 32, 64, 128 ou 256 blocs**. Les anciens réglages restent conservés.
+
+Le highlight raccorde les surfaces plates, y compris entre matériaux différents,
+sans dessiner les jonctions intérieures. Il suit les contours visibles du relief,
+y compris les dalles et escaliers. Il multiplie la couleur existante pour garder
+les pixels des textures et composer avec les ombres. Ce CTM géométrique utilise
+la profondeur déjà produite par Minecraft : aucune liste de blocs autorisés,
+aucun pack CTM à fournir, aucune exploration CPU du volume de 256 blocs.
+Une cassure/repose modifie le contour dès que le terrain natif est réaffiché.
+
+Le trait proche suit la grille de 1/16 de bloc. À distance, la couverture devient
+partielle pour limiter le scintillement des traits plus petits qu'un pixel.
+La portée choisie s'efface progressivement dans son dernier quart et respecte
+la brume ainsi que la distance de rendu. Une passe plein écran, quatre sondes
+de profondeur et un tampon uniforme de 176 octets ; aucun retour GPU vers CPU
+en production. L'arrêt de l'option ou une intensité nulle libèrent ce tampon.
+
+Ce n'est pas un remplacement des textures par des variantes CTM. Le calcul
+concerne les faces visibles alignées sur la grille : les faces hors écran,
+les surfaces transparentes absentes de la profondeur et les géométries
+arbitrairement inclinées ne sont pas reconstruites. À très grande distance,
+les détails plus petits qu'un pixel peuvent rester imperceptibles. Aucun
+chargement de chunk forcé, aucune promesse de FPS.
+
+Les ombres proposent les cinq mêmes portées. La carte reste plafonnée à
+4096 × 4096 : les grandes distances réduisent sa précision spatiale. Le cache
+garde ses limites de 96 Mio, quatre sections et 3 ms souples de construction
+par image ; la réconciliation des chunks est limitée aux ticks et changements
+de caméra/terrain plutôt qu'à toutes les images.
+
+L'intensité solaire reste pleine au zénith. Les contours opaques restent nets,
+le filtrage du feuillage et les ombres légères de la lune sont conservés.
+Le réalignement de la grille lumineuse a lieu au changement d'ancrage de la
+caméra, avec transfert de phase par texels entiers. La rotation du soleil ne
+réarrondit plus la projection de l'origine mondiale à chaque image, source
+de sauts périodiques amplifiés aux grandes coordonnées. Le soleil continue
+d'avancer ; une ombre pixélisée peut naturellement changer de case. Cette
+correction ne modifie pas l'horloge serveur ni sa cadence native.
+
+Textes FR/EN. Aucun changement de règles, sauvegardes, génération, gemmes,
+sculptures ou découvertes.
+
+## Vérifications et livraison
+
+Le client natif réussit en **2 min 41 s**, dans un monde neuf plat, graine 122,
+sur macOS / Apple M1 / OpenGL :
+
+- CTM : 596 échantillons éclaircis sur le contour et 65 068 conservés ; les
+  20 centres et 20 jonctions coplanaires ciblés restent intacts, y compris
+  au changement de matériau. L'intensité 90 produit environ trois fois le gain.
+- Ouverture d'un trou : 716 échantillons éclaircis ; la fermeture restitue
+  l'image connectée. Au-delà de 16 blocs, le réglage 16 supprime le contour ;
+  le réglage 64 le rétablit (254 échantillons éclaircis).
+- Cinq portées CTM et cinq portées d'ombres, persistance/clamp, migration des
+  anciennes préférences, arrêt/libération, rechargement, caméra et vue oblique
+  avec ombres. Captures françaises/anglaises inspectées ; suppression ensuite
+  d'un préfixe redondant dans le libellé de portée.
+- Soleil, lune, nouvelle lune, ombres opaques nettes à midi et transmission
+  du feuillage restent vérifiés. Casters hors écran et retrait/repose actifs.
+- 2 000 petits pas solaires aux coordonnées ±100 000 vérifient l'absence de
+  saut de translation de la carte ; changement d'ancrage par texels entiers.
+  La séquence du vrai service realtime suit 294 images : angle avancé de
+  0,000694 radian, aucun rebond dans les 65 664 échantillons de sol suivis.
+  Sur cette courte séquence, aucune case opaque n'a changé ; cela ne constitue
+  pas une mesure de mouvement visible sur une journée entière.
+
+La fixture initiale capturait parfois le terrain avant la fin de sa construction
+native : elle attend désormais la réception de toute la plateforme et la fin
+compilée des sections. Aucun changement de gameplay pour contourner ce problème.
+
+Commande : `./gradlew :sanctuary:runClientGameTest -PsanctuaryClientTests=true
+-PsanctuaryPixelShadows122ClientTests=true -PsanctuaryClientNoVsync=true
+-PsanctuaryQuickTests=true`. Log `build/shader129-client.log`, captures sous
+`mods/sanctuary/build/run/clientGameTest/screenshots/`.
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 17 s**, 126 tâches. Une dernière passe d’assemblage intègre
+la simplification du libellé de portée (2 min 18 s). Les archives sont vérifiées :
+**17 entrées de production** diffèrent de beta.128, limitées au shader et à ses
+interfaces. Même JAR dans normal/Test, sources archivées conformes, ressources
+du template exactes, assets des gemmes inchangés. Aucun monde ni test embarqué.
+Le serveur GameTest dédié
+reste exclu conformément au refus antérieur de son EULA. Aucun monde personnel
+utilisé pour les essais, aucun résultat Windows/Vulkan revendiqué.
+
+
+Archives vérifiées dans `build/` et recopiées dans le dossier de livraison
+habituel `sanctuary-beta/build/` :
+
+- Normal : 10 353 946 octets, SHA-256
+  `2c7735194faab8a699004e69ad543ce6e8fabdebe297b759bffd31fea2dcc2e8`.
+- Test : 10 372 872 octets, SHA-256
+  `cca572ee313d1d7e66ed745bb48bac62490998760d9b7bbfc7a1f6d60c430dce`.
+- JAR Sanctuary :
+  `ca3e2ff4e0717a3a54c1d57478d43aade39d001b71c4eec745d76f010f7def54`.
+
+[Release beta.129](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.129)
+publiée depuis `35103a7ea8635dc4ed26293f00e86d99aaacfca8`. Canal packwiz
+`2eaa0130a4cd475c598beefdab40f48fc8681ab7`. Deux synchronisations isolées puis deux synchronisations
+dans l'instance **Sanctuary Beta** ont réussi. Les **923 fichiers personnels**
+suivis, dont les réglages de shader, sont inchangés. Aucun monde personnel ouvert.
+Sauvegarde préalable des fichiers gérés : `sanctuary-backups/before-beta.129/`.
+Le JAR installé a le hash vérifié ci-dessus. Reçus locaux :
+`build/shader129-artifact.json`, `build/shader129-isolated.json` et
+`build/shader129-prism.json`. Le checkout initial avec ses modifications en
+cours a été préservé ; seule la copie des archives versionnées rejoint son
+répertoire `build/`.

docs/shader-beta130.md

@@ -0,0 +1,131 @@
+# SHADER-130 — bloom et précision commune
+
+Demandes du 17 septembre 2026 : bloom réglable du soleil et des sources
+lumineuses ; inclusions émissives du fer, cuivre, redstone, lapis, diamant,
+émeraude, rubis, saphir, quartz et or ; réglage commun « Précision » pour
+les ombres et le highlight. Branche `codex/bloom-beta130`, socle beta.129,
+Minecraft 26.3 / Java 25.
+
+## Résultat
+
+Dans **Options → Shaders → Sanctuary · Vanilla Light**, le bloom possède
+un interrupteur, une intensité et une diffusion réglables de 0 à 100.
+Les minerais ont leur propre interrupteur et intensité. Le bloom reste
+optionnel, désactivé initialement, avec une intensité préparée à 35, une
+diffusion à 50 et une émission des minerais à 50. Une intensité globale
+nulle arrête les passes et libère les ressources de cet effet.
+
+Les nouveaux réglages par défaut sont **Pixel Shadows activé**, distance
+des ombres **128 blocs**, highlight **32 blocs** et **Précision 16 pixels
+par bloc**. La précision unique propose 8, 16 et 32 et contrôle simultanément
+ombres et arêtes. La clé JSON historique `shadowPixels` est conservée :
+les préférences déjà personnalisées ne sont pas écrasées.
+
+Les vingt textures de minerais sont analysées depuis les ressources actives.
+La palette de pierre, de deepslate ou de netherrack est comparée aux pixels
+colorés des inclusions, avec un traitement du quartz et de l'or du Nether.
+Les reflets clairs accolés aux inclusions sont conservés. Le masque est
+calculé une fois par texture et conservé en cache jusqu'au rechargement des
+ressources. Une texture optionnelle `<nom>_e.png` peut préciser ce masque
+pour une texture candidate ; sa luminance maximale multipliée par l'alpha
+remplace la détection automatique. Les couleurs affichées viennent toujours
+de l'atlas Minecraft actif, y compris son animation.
+
+Les sources sont les faces visibles des modèles de blocs lumineux, la lave,
+le soleil et la lune. Les lampes éteintes ne produisent pas de halo. Le
+niveau lumineux natif pondère les sources ordinaires ; l'émission des minerais
+est purement graphique. La profondeur du terrain élimine les inclusions
+cachées et masque le soleil derrière les constructions. Le cœur émissif
+conserve ses pixels nets, tandis qu'un halo séparé est diffusé à résolution
+réduite puis composé sur l'image.
+
+Aucun niveau de lumière serveur, spawn, règle de jeu, format de sauvegarde,
+identifiant ou paramètre de génération ne change. Aucun monde personnel
+n'est ouvert pour les essais.
+
+## Coût et limites
+
+La géométrie suit uniquement les sections natives visibles et déjà chargées.
+Leur palette permet d'écarter rapidement les sections sans source ; le cache
+invalide les sections touchées lors des modifications. Construction répartie
+sur les images, au plus quatre sections démarrées et un budget souple de
+3 ms, cache GPU plafonné à 32 Mio et 16 384 faces par section. Une section
+qui dépasse les limites est omise. Aucun chargement de chunk forcé.
+
+Le masque GPU est plafonné à 256 textures, chacune échantillonnée au plus en
+64 × 64 ; les textures natives 16 × 16 conservent leurs texels. Les masques
+animés utilisent leur première image, tandis que la couleur reste animée.
+La carte d'émission est à la résolution de l'écran ; la diffusion séparable
+utilise deux cibles flottantes à 1/8 de largeur et de hauteur, sans retour
+GPU vers CPU en production. Les allocations sont libérées à l'arrêt, au
+rechargement et à la déconnexion, et recréées au changement de taille.
+
+Cette première version ne reconstruit pas les sources hors écran, les
+particules, les entités lumineuses ni les modèles dessinés exclusivement par
+un renderer de block entity. Les packs très différents peuvent demander un
+masque explicite. Les silhouettes des liquides sont approximées puis
+masquées par la profondeur native. Aucune promesse de FPS ni validation
+Windows/Vulkan ; les essais graphiques portent sur macOS / Apple M1 / OpenGL.
+
+## Vérifications
+
+Le test client ciblé réussit en **1 min 29 s**, dans un nouveau monde plat,
+graine 122. Il analyse les vingt textures, refuse les pixels gris de leur
+roche, mesure le gain nocturne et les variations réelles d'intensité/diffusion.
+Couvrir les minerais de pierre supprime toute source émissive. Retirer les
+blocs rétablit l'émission ; le rechargement des ressources fait de même.
+Torche, glowstone, lampe alimentée, lave et soleil sont vérifiés, ainsi que
+l'arrêt de la lampe et l'occultation du soleil par de la pierre. Les valeurs
+par défaut et la conservation d'anciens choix personnalisés passent.
+
+Log ciblé : `build/shader130-client-bloom.log` ; masques inspectables dans
+`mods/sanctuary/build/run/clientGameTest/bloom130-ore-masks.png` et son CSV.
+La suite shader complète réussit en **3 min 16 s** : casters hors écran,
+retrait/repose, trois précisions, cinq portées, lune, zénith, feuillage,
+realtime, caméra et rechargement restent vérifiés. Les arêtes CTM restent
+raccordées entre matériaux ; 1 295 échantillons du contour sont éclaircis
+à précision 8, 596 à 16 et 120 à 32. Les captures françaises/anglaises et
+le rendu des minerais/du soleil sont inspectés.
+
+Commandes natives : `./gradlew :sanctuary:runClientGameTest
+-PsanctuaryClientTests=true -PsanctuaryPixelShadows122ClientTests=true
+-PsanctuaryClientNoVsync=true -PsanctuaryQuickTests=true`. Le test ciblé utilise
+`-PsanctuaryBloom130ClientTests=true` à la place de la propriété PixelShadows.
+Log complet : `build/shader130-client-full.log` ; captures sous
+`mods/sanctuary/build/run/clientGameTest/screenshots/`.
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 24 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus antérieur de son EULA. La comparaison au binaire beta.129
+trouve **24 entrées de production** modifiées, toutes limitées au shader et à
+ses interfaces. Gameplay et textures des gemmes inchangés ; aucun test,
+monde ou modèle GLB embarqué. Les sources archivées correspondent aux sources
+Java, les packs normal/Test embarquent le même JAR et le template contient
+exactement les ressources prévues.
+
+Archives vérifiées dans `build/` et recopiées dans le dossier habituel
+`sanctuary-beta/build/` :
+
+
+- `Sanctuary-beta.130.mrpack` : 10386021 octets, SHA-256
+  `7a3fcd4e496fa136eb3e0896fa7b856ae91771123186fa8df13c8fb1e0cf3e9a`.
+
+- `Sanctuary-Test-beta.130.mrpack` : 10404944 octets, SHA-256
+  `8de094fcbc58a300cc24d64c8d1b7931fdb8db354c75defa6bf2a2aa4a123a23`.
+
+JAR : `1ac4d1b1339361fb665f03ca3bd359163db5037ffd90e684c5a461759f6076e7`.
+
+[Release beta.130](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.130)
+publiée depuis `534dfec4f88169a200702b50d1ba87d85c107bee`. Canal packwiz
+`68e06353bf880af04c1c72d4e3a159f11f94b619`. Les téléchargements publics sont vérifiés par SHA-256.
+Deux synchronisations isolées, puis deux dans la même instance **Sanctuary
+Beta**, réussissent. Un seul JAR Sanctuary beta.130 est actif. Les
+**923 fichiers personnels suivis** conservent leurs hashes, dont les mondes,
+packs et préférences de shaders. Sauvegarde préalable dans
+`sanctuary-backups/before-beta.130/` de l'instance. Aucun monde personnel ouvert.
+
+Reçus locaux ignorés : `build/shader130-artifact.json`,
+`build/shader130-isolated.json`, `build/shader130-prism.json` et
+`build/shader130-publication.log`. Le checkout original conserve ses
+modifications préexistantes ; seuls les trois artefacts versionnés vérifiés
+sont recopiés dans son dossier `build/`.

docs/shader-beta131.md

@@ -0,0 +1,91 @@
+# SHADER-131 — émissifs indépendants et réglages initiaux
+
+Demande : activer par défaut bloom, minerais émissifs et highlight ; garder
+les émissifs avec halo coupé ou intensité du bloom à zéro, sans bouton ajouté ;
+ajouter 64 et 128 pixels/bloc en options. Précision initiale 16, distances
+highlight 32 et ombres 128 conservées. Préférences personnalisées préservées.
+Branche `codex/emissive-beta131`, socle beta.130, Minecraft 26.3 / Java 25.
+
+Le futur effet demandé est une légère teinte diffusée depuis les blocs
+voisins, pas des reflets reconnaissables. Étude seulement pour ce ticket ;
+aucun SSR ou éclairage indirect expérimental activé.
+
+## Comportement et validation
+
+Le curseur à zéro et l'interrupteur Bloom coupent uniquement le halo.
+Le réglage existant des minerais contrôle leurs inclusions nettes séparément.
+Sans halo, les cibles de diffusion GPU sont libérées ; l'émission garde
+seulement les ressources nécessaires. Tout désactiver libère l'ensemble.
+La grille commune propose 8, 16, 32, 64 et 128, sans augmenter le plafond
+4096 de la carte d'ombres. Libellés FR/EN et essais clients natifs sur les
+inclusions, l'absence de halo, les transitions et les nouvelles précisions.
+Aucun changement de lumière serveur, de génération ou de sauvegardes.
+
+Le cœur émissif et le halo utilisent maintenant deux chemins indépendants.
+Les textures et leur analyse restent celles de beta.130. Avec le halo coupé,
+la carte d'émission est effacée avant les faces, le cœur net est composé,
+et les passes de ciel, réduction, diffusion et application du halo sont
+omises. Le retour au bloom recrée ses cibles. Aucun bouton ajouté, aides
+FR/EN adaptées et choix explicitement désactivés toujours conservés.
+
+## Vérifications
+
+Suite client native réussie en **3 min 46 s**, monde plat neuf de graine 122,
+macOS / Apple M1 / OpenGL. Cinq précisions sauvegardées et chargées, bornes
+et seuils de normalisation, carte d'ombres plafonnée et arêtes CTM rendues
+à 64/128. Le gain mesuré des traits diminue de 0,02778 à précision 32 à
+0,02094 à 64, puis 0,01013 à 128 dans la même scène.
+
+Les inclusions restent nettes sans halo : le rendu Bloom OFF correspond
+au rendu intensité zéro. Aucun gain mesuré hors du masque source, ressources
+de diffusion absentes ; couper aussi les émissifs libère l'ensemble et
+restitue l'image initiale. Réactiver le bloom restitue son image précédente.
+Captures OFF/zéro inspectées. Valeurs initiales ON vérifiées ; un ancien
+choix explicitement OFF reste OFF. Les essais beta.130 (vingt masques,
+occultation, sources, rechargement), lune, feuillage et realtime passent.
+
+Le premier essai rencontrait une assertion historique attendant le highlight
+OFF lorsqu'une clé était absente. Elle attend désormais la nouvelle valeur
+ON ; les cas de préférences explicitement désactivées restent testés.
+
+Commande : `./gradlew :sanctuary:runClientGameTest -PsanctuaryClientTests=true
+-PsanctuaryPixelShadows122ClientTests=true -PsanctuaryClientNoVsync=true
+-PsanctuaryQuickTests=true`. Log : `build/shader131-client-full.log` ; captures
+sous `mods/sanctuary/build/run/clientGameTest/screenshots/`.
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 30 s**, 126 tâches. Les archives normal/Test, leurs sources
+et le template sont vérifiés. Six entrées de production changent : moteur
+Bloom, préférences, interface et libellés. Gameplay, shaders GLSL et textures
+restent identiques à beta.130. Aucun résultat Windows/Vulkan
+revendiqué ; le serveur GameTest dédié reste exclu conformément au refus
+antérieur de son EULA.
+
+## Piste suivante — diffusion des couleurs
+
+Choix confirmé : légère teinte des surfaces voisines. Une estimation SSGI
+utilise la couleur et la profondeur visibles pour des rebonds diffus ; voir
+la [documentation primaire Unity](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/Override-Screen-Space-GI.html).
+Proposition à expérimenter : faible intensité, courte portée autour des
+surfaces, calcul réduit, rejet par profondeur pour ne pas teinter au travers
+des murs. Vérifier les bords de l'écran, les blocs hors champ, la stabilité
+en mouvement et les textures avant de fixer une qualité. Cette piste n'est
+pas implémentée dans beta.131.
+
+## Livraison
+
+- `Sanctuary-beta.131.mrpack` : 10386312 octets ; SHA-256 `e02067e424bf4f54512d5cfb1b5cde0fe232aa6bdadc0d38981cd15817a6387a`.
+- `Sanctuary-Test-beta.131.mrpack` : 10405238 octets ; SHA-256 `298387cce5a5b7cdc09b3a9d24859b674a736b25abcbafa7995b813757641265`.
+
+JAR : `87210da23f7781efccdbdbf5d4e2d3c1ff1857a7f326027b93d6a301c7dfdb0d`.
+
+Archives vérifiées recopiées dans `sanctuary-beta/build/`. [Release beta.131](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.131)
+publiée depuis `078d3e6833daa7de7f6c6d0e1a6c17d5dbefe075`. Canal packwiz
+`efb18c274d95d988a9566b8c52751469f002cdda`. Téléchargements publics vérifiés par hash.
+Deux synchronisations isolées, puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR Sanctuary beta.131 ; les **923 fichiers personnels
+suivis** conservent leurs hashes, dont les préférences de shaders et les mondes.
+Sauvegarde préalable `sanctuary-backups/before-beta.131/` ; aucun monde personnel
+ouvert. Reçus ignorés : `build/shader131-artifact.json`,
+`build/shader131-isolated.json`, `build/shader131-prism.json` et
+`build/shader131-publication.log`. Le checkout original conserve ses changements.

docs/shader-beta132.md

@@ -0,0 +1,106 @@
+# SHADER-132 — diffusion locale SSGI expérimentale
+
+Demande : légère teinte diffusée des surfaces voisines, sans reflets miroir
+ni shader d'eau. Branche `codex/ssgi-beta132`, socle beta.131, Minecraft 26.3 /
+Java 25. Aucun changement de génération, sauvegarde ou lumière serveur.
+
+## Résultat
+
+**Options → Shaders → SSGI · couleurs diffusées** active un rebond diffus
+local. L'effet expérimental est initialement OFF, avec une intensité préparée
+à **35 %** ; le curseur propose 0–100. À zéro ou OFF, ses cibles et uniformes
+GPU sont libérés. Les autres effets et leurs préférences sont conservés.
+
+La couleur d'une surface visible peut teinter les surfaces proches qui lui
+font face. Le calcul porte à **2,5 blocs** du récepteur et s'estompe entre
+24 et 32 blocs de la caméra. Il utilise une copie de la couleur native après
+les ombres, avec la profondeur et des normales reconstruites. Le premier
+obstacle arrête chaque rayon, même si son épaisseur empêche de retenir une
+intersection. Les plans coplanaires ne s'éclairent pas eux-mêmes.
+
+Douze directions hémisphériques fixes, au maximum dix étapes par rayon,
+sont évaluées à demi-résolution en largeur et hauteur. La reconstruction
+plein écran est guidée par la profondeur pour conserver les silhouettes et
+les détails des textures. Le cœur des émissifs, le highlight et le bloom
+sont composés ensuite : pas de halo réinjecté dans le rebond ni de boucle
+de rétroaction d'une image sur l'autre. Aucune lecture GPU vers CPU ni
+recherche de chunks en production. Pas de bruit temporel ou d'historique.
+
+Deux cibles, RGBA8 plein écran et RGBA16 flottant à demi-résolution, soit
+environ six octets par pixel de l'écran, plus 176 octets d'uniformes par
+segment du tampon natif. Redimensionnement, arrêt, déconnexion et
+rechargement libèrent/recréent les ressources possédées. Ce budget n'est
+pas une garantie de FPS ; le SSGI coûte davantage qu'un simple réglage de
+colorimétrie.
+
+## Limites de cette version
+
+L'estimation utilise seulement la couleur et la profondeur visibles. Les
+blocs hors champ ou cachés n'apportent pas leur couleur. Le résultat peut
+changer lorsqu'ils entrent ou sortent de l'image ; une atténuation près
+des bords limite la coupure. Les surfaces transparentes absentes de la
+profondeur ne sont pas reconstruites. Petits objets et intersections plus
+minces que l'échantillonnage peuvent manquer. Il s'agit d'une approximation
+diffuse locale, pas d'une simulation complète d'éclairage global ni de
+reflets spéculaires. Aucune modification de l'eau et aucune source hors
+champ déduite ou générée.
+
+## Vérifications
+
+Test ciblé natif réussi en **1 min** sur macOS / Apple M1 / OpenGL, nouveau
+monde plat de graine 122. À intensité 90, les échantillons du sol blanc
+montrent un gain rouge cumulé de 8 968 contre 20 bleu devant le mur rouge,
+puis 9 168 bleu contre 23 rouge devant le mur bleu. Le sol seul est inchangé.
+OFF/zéro restituent l'image de base et libèrent les cibles ; intensité 20
+réduit le gain. Changer la couleur du mur complètement occulté laisse
+l'image inchangée. Rechargement, caméra fixe, mouvement infinitésimal et
+retour à la caméra d'origine passent, sans accumulation de couleur.
+
+Deux ajustements de fixture ont précédé ce résultat : inclure dans les
+mesures le blanc légèrement bleuté par l'éclairage natif, et formater les
+petits angles de `/tp` en décimal car la commande refuse la notation
+scientifique. Aucun comportement du jeu modifié pour ces corrections.
+
+Log ciblé : `build/shader132-client-ssgi.log`. La suite complète réussit en
+**4 min 18 s** et vérifie aussi une fenêtre 961 × 541, le retour à sa taille
+initiale, le SSGI avec ombres/highlight/bloom/émissifs actifs, ainsi que
+l'arrêt global du shader. Les captures françaises et anglaises passent.
+Les contrôles précédents des cinq précisions, ombres, lune, feuillage, CTM,
+bloom et émissifs restent réussis. Log : `build/shader132-client-full.log`.
+
+Commandes : `./gradlew :sanctuary:runClientGameTest -PsanctuaryClientTests=true
+-PsanctuaryPixelShadows122ClientTests=true -PsanctuaryClientNoVsync=true
+-PsanctuaryQuickTests=true`. Pour le test ciblé, remplacer la propriété
+PixelShadows par `-PsanctuarySsgi132ClientTests=true`.
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 25 s**, 126 tâches. Les packs normal/Test contiennent le
+même JAR ; sources archivées et template de ressources correspondent aux
+sources. Comparaison avec beta.131 : **11 entrées de production** modifiées,
+limitées au SSGI, à ses options et à ses points d'appel. Gameplay et textures
+des gemmes inchangés, aucun monde ni test embarqué. Aucun résultat
+Windows/Vulkan revendiqué.
+Le serveur GameTest dédié reste exclu conformément au refus antérieur de
+son EULA. Les captures panoramiques et les milieux de brume sous l'eau/lave
+ou neige poudreuse suspendent cette passe, comme les autres effets de
+profondeur Sanctuary.
+
+## Livraison
+
+- `Sanctuary-beta.132.mrpack` : 10394026 octets, SHA-256 `a7c0823e00f36925919645e32e7792242ec1d01015b41bee5b4f6285b9fc533d`.
+- `Sanctuary-Test-beta.132.mrpack` : 10412949 octets, SHA-256 `9bc30a7d6d5834f9323f15f0c39d3f49d200e1a97d739266ab373c9e1ba4a8fd`.
+
+JAR : `83eb2d091a7acd85eaa8b3b6a00a40ea483f9eeb2a30c033bdf68b4d717c5142`.
+
+Archives vérifiées recopiées dans `sanctuary-beta/build/`. [Release beta.132](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.132)
+publiée depuis `7e21781a9a08c669c7d6b65653bd9d408887689c`. Canal packwiz
+`9edaaedc0205c525ecce9de66b5ca7827c56c28f` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées, puis deux dans la même instance **Sanctuary Beta**,
+réussissent. Un seul JAR beta.132 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences de shaders, gardent leurs hashes. Sauvegarde
+préalable `sanctuary-backups/before-beta.132/` ; aucun monde personnel ouvert.
+Le checkout original conserve ses changements préexistants.
+
+Reçus locaux ignorés : `build/shader132-artifact.json`,
+`build/shader132-isolated.json`, `build/shader132-prism.json`,
+`build/shader132-publication.log`.

docs/shader-beta133.md

@@ -0,0 +1,106 @@
+# SHADER-133 — SSGI visible au réglage courant
+
+Demande : le rebond diffus de beta.132 est trop discret pour être distingué.
+Branche `codex/ssgi-strength-beta133`, socle beta.132, Minecraft 26.3 / Java 25.
+
+## Changement
+
+La collecte conserve douze directions, dix étapes, une demi-résolution et
+un rayon de 2,5 blocs. L'atténuation spatiale devient linéaire plutôt que
+quadratique. Le mélange est reconstruit en lumière approximativement linéaire,
+puis réencodé une seule fois. Un gain artistique plus fort rend la couleur
+lisible et une courbe progressive évite de couper brutalement les canaux
+à blanc. Les surfaces sans rebond restent intactes. La force demeure réglable
+de 0 à 100, avec le même réglage initial de 35 ; aucune préférence enregistrée
+n'est écrasée. SSGI reste optionnel, initialement désactivé.
+
+Aucun rayon, cible GPU ou texture de matériau supplémentaire. La composition
+ajoute une exponentielle et une racine carrée par canal ; le coût exact en FPS
+reste à mesurer sur la machine du joueur. Les normales de géométrie orientent
+déjà le rebond. Pas de PBR ni de normales procédurales de textures ajoutés.
+
+## Piste matériaux
+
+Pour une étape distincte, des normales de faible amplitude calculées au
+chargement des textures, mises en cache, et une rugosité par famille de matériaux
+permettraient d'étudier du relief et des reflets orientés. Une simple conversion
+luminosité → hauteur ne connaît pas le relief réel : un motif peint peut devenir
+une bosse artificielle. Commencer sur pierre, briques et bois avec une amplitude
+réglable serait préférable à une génération aveugle pour tous les blocs.
+La passe actuelle ne possède ni atlas de normales, ni identifiants de matériaux,
+ni albédo non éclairé ; des images seules ne suffiraient pas à les exploiter.
+
+## Limites conservées
+
+Approximation diffuse à partir de la couleur déjà éclairée, pas un transport
+physique complet. Seules les surfaces visibles contribuent, avec variations
+possibles aux entrées/sorties d'écran. Premier obstacle bloquant, pas d'historique
+ni de bruit temporel ; aucune modification d'eau, monde ou lumière serveur.
+
+## Vérifications
+
+Suite client native complète réussie en **4 min 29 s**, sur macOS / Apple M1 /
+OpenGL, dans un monde de test plat (graine 122). Les comparaisons ON/OFF à 35 %
+mesurent, sur les pixels neutres du sol :
+
+| Mur | Pixels avec gain ≥ 8/255 | Pixels avec gain ≥ 16/255 | Gain cumulé du canal dominant |
+| --- | ---: | ---: | ---: |
+| Rouge | 16 487 | 7 311 | 305 221 |
+| Bleu | 14 954 | 7 328 | 309 991 |
+
+À 90 %, les gains dominants atteignent 654 683 et 655 867, contre 8 968 et
+9 168 au même réglage dans la fixture beta.132. Ce rapport concerne uniquement
+cette scène et ces pixels, pas une promesse de gain uniforme dans tous les mondes.
+Les captures confirment une bande colorée au pied du mur. Un premier réglage
+intermédiaire a été rejeté car aucun pixel du sol ne dépassait 8/255 à 35 % ;
+un second a passé les contrôles ciblés, puis la force a encore été augmentée
+après examen visuel. Les valeurs finales sont celles de la suite complète.
+
+Le test impose maintenant plus de 5 000 pixels à 8/255 et plus de 500 à 16/255
+au réglage 35, pour les deux couleurs. Intensité, OFF/zéro, absence de rebond
+coplanaire, occultation d'un mur changeant de couleur, caméra fixe, déplacement
+infinitésimal, retour de caméra, redimensionnement et rechargement passent.
+Ombres, lune, feuillage, CTM, cinq précisions, bloom, émissifs indépendants et
+interfaces FR/EN restent validés, y compris avec le SSGI actif.
+
+Commande : `./gradlew :sanctuary:runClientGameTest -PsanctuaryClientTests=true
+-PsanctuaryPixelShadows122ClientTests=true -PsanctuaryClientNoVsync=true
+-PsanctuaryQuickTests=true`. Log : `build/shader133-client-full.log`.
+Le nom de la propriété ciblée `sanctuarySsgi132ClientTests` est conservé.
+
+Comparateur local autonome : `build/SSGI-beta.133-comparaison.html`, captures
+natives OFF/35/90 des murs rouge/bleu, sans retouche. Pas de validation
+Windows/Vulkan ni de mesure de coût FPS revendiquée.
+
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 21 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader133-build.log`.
+Les archives normal/Test contiennent le même JAR ; sources archivées et template
+de ressources correspondent aux sources. Comparaison avec beta.132 : **5 entrées
+de production** changées (classe du compositeur, deux shaders, libellés FR/EN).
+Gameplay, textures, sauvegardes et dépendances inchangés.
+
+## Artefacts
+
+- `Sanctuary-beta.133.mrpack` : 10394282 octets, SHA-256 `0c90a070da7f969706abeeec1bdfb0830bb52244c20fccbca4fd876f3fbe0564`.
+- `Sanctuary-Test-beta.133.mrpack` : 10413204 octets, SHA-256 `e01f0355bf2cce18156fe94a069e142bedc498624ba0b6e2729ae0f23ea73e80`.
+
+JAR : `a01cae4a98606007b533ca09ec9f072f19a1db2e9b8de466f4ad075d5c1fc185`.
+
+
+## Livraison
+
+[Release beta.133](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.133)
+publiée depuis `216d3f75b576bd2ed531653012f9cc6c4801d87a`. Canal packwiz
+`9ceb5a5353c9d1b8bb7834a20e818fd65096ff98` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux synchronisations de la même instance
+**Sanctuary Beta** réussissent. Un seul JAR beta.133 actif ; les **923 fichiers
+personnels suivis**, dont sauvegardes et préférences, gardent leurs hashes.
+Sauvegarde préalable `sanctuary-backups/before-beta.133/`, aucun monde personnel
+ouvert. Le checkout original conserve ses changements préexistants.
+
+Les archives normal/Test/template et le comparateur natif sont également dans
+`sanctuary-beta/build/`. Reçus locaux ignorés : `build/shader133-artifact.json`,
+`build/shader133-isolated.json`, `build/shader133-prism.json` et
+`build/shader133-publication.log`.

docs/shader-beta134.md

@@ -0,0 +1,109 @@
+# SHADER-134 — PBR procédural optionnel et herbe SSGI
+
+Demande : ajouter en option des normales calculées à partir des textures actives,
+avec rugosité des matériaux et reflets orientés. Retour : le SSGI renforcé
+éclaire artificiellement l'intérieur de l'herbe ; vérifier et corriger ce cas.
+Branche `codex/pbr-beta134`, socle beta.133, Minecraft 26.3 / Java 25.
+
+## Contrat
+
+PBR initialement OFF, intensité 50 réglable 0–100. Cartes de normales à partir
+des différences de luminance, amplitude limitée ; rugosité/métallicité par
+famille de blocs, repli rugueux pour les types inconnus. Analyse des ressources
+actives conservée en cache jusqu'à désactivation ou rechargement ; pas de fichiers
+écrits dans le pack personnel, pas de GPU readback en production.
+
+Portée 32 blocs, sections visibles construites progressivement. Budget de maillage
+24 Mio, atlas de 4 096 matériaux en 16 × 16 avec bordures (1 280 × 1 280 RGBA8,
+6,25 Mio), copie RGBA8 de l'image courante et uniformes. Les textures de plus haute
+résolution sont échantillonnées à 16 × 16 ; première image des textures animées.
+La couleur et l'animation restent celles de l'atlas natif. Pas de parallax ni
+de géométrie ajoutée aux blocs ; les motifs clairs peuvent donner un faux relief.
+
+La passe utilise une réponse spéculaire GGX (normales, rugosité, métallicité,
+Fresnel) et module l'éclairage diffus déjà rendu. Elle ne remplace pas tout le
+pipeline Minecraft par un moteur PBR physique. Soleil/lune, exposition au ciel et
+carte d'ombres active limitent les reflets ; pas de reflets miroir, d'environnement
+SSR, ni de direction locale déduite pour chaque torche. Aucun rendu PBR d'eau,
+d'entités, d'items ou de modèles spéciaux hors maillage de terrain.
+
+## SSGI
+
+Les normales des faces presque axiales sont stabilisées sur leur axe. Deux passes
+spatiales filtrent la lumière indirecte à demi-résolution, avec rejet des voisins
+hors du plan du récepteur et interpolation de l'échantillonnage. Les textures de
+l'image restent nettes. Un tampon RGBA16F supplémentaire à demi-résolution porte
+le budget des cibles SSGI à environ 8 octets par pixel plein écran (contre 6).
+Pas d'historique temporel ni de rémanence ajoutés.
+
+Un parcours de 12 blocs a reproduit des bandes sur un mur et un éclaircissement
+artificiel d'herbe à 35 et 100. Le filtrage seul ne suffisait pas : la collecte
+réinjectait aussi trop fortement la lumière ambiante neutre. Elle conserve
+maintenant la composante chromatique de la source, en soustrayant son canal
+linéaire minimum. L'éclairage ambiant neutre reste celui de Minecraft. Ce réglage
+vise le transfert de couleur voulu, pas une simulation physique complète du
+rebond blanc. Les sources hors champ/cachées restent absentes du SSGI ; le résultat
+peut encore varier lors d'un déplacement important. PBR et SSGI restent indépendants.
+
+## Vérification
+
+Test PBR ciblé réussi en 1 min 13 s : relief éclairé/ombré, intensités 20/50/100,
+soleil matin/soir, cache stable, préférences, OFF/zéro, mouvement infinitésimal,
+redimensionnement, rechargement et combinaison des effets. Le premier parcours
+SSGI est conservé comme reproduction ; résultats finaux ci-dessous.
+
+
+Le parcours corrigé a réussi en **2 min 47 s** avec 13 positions réparties sur
+12 blocs, à 35 et 100, chaque fois comparées à OFF. Un mob immobile, des brins
+d'herbe et un mur figurent dans la scène. Retour au point initial sans rémanence.
+Sur les captures de ce parcours, le maximum du gain vert moyen mesuré dans
+l'herbe passe sous 9,73 niveaux à 35 et 24,51 à 100. Le test impose ensuite
+respectivement des limites de 12 et 30 à chaque position. L'essai reproduisant
+le défaut atteignait notamment 23,68 et 49,20 à l'extrémité droite.
+Ces mesures décrivent cette scène, pas une garantie d'absence d'artefacts
+dans tous les mondes ni sur toutes les cartes graphiques.
+
+
+La suite client complète réussit en **7 min** sur macOS / Apple M1 / OpenGL.
+Elle inclut le parcours latéral et ses seuils de gain, les deux couleurs de rebond,
+le PBR, les ombres, le feuillage, les cinq précisions, le CTM, les émissifs, le
+bloom, les préférences et les écrans FR/EN. Log : `build/shader134-client-full.log`.
+Le contrôle PBR final réussit en **1 min 19 s** : placement/retrait d'un toit,
+invalidations de lumière/maillage et rendu combiné avec les ombres actives. Les
+reflets utilisent maintenant la grille des ombres pour leur test de visibilité. Aucun résultat Windows/Vulkan ni
+mesure de FPS revendiqués.
+
+
+## Construction et artefacts
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 22 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader134-build.log`.
+Packs normal/Test : même JAR Sanctuary. Sources archivées et template identiques
+aux sources. Comparaison à beta.133 : **23 entrées de production** changées,
+limitées au rendu, à ses options et points d'appel. Gameplay et gemmes inchangés.
+
+- `Sanctuary-beta.134.mrpack` : 10421971 octets, SHA-256 `d5bc79acb1d56e7dcf83c976156fdb2fcde80c98e443bde8a6ab312d56887b7f`.
+- `Sanctuary-Test-beta.134.mrpack` : 10440898 octets, SHA-256 `04308ebb9adaf76b30a3cbf4fa32ab897e76842803fc8c8411cfa32952d1bdd5`.
+
+JAR : `a6e69622a5e6629f70dd19b7494ad3b00916bc02169b73635f0e2d563929b7fa`.
+
+Comparateur local : `build/Shader-beta.134-comparaison.html`. Il contient les
+captures natives PBR OFF/50/100 et le parcours SSGI de 12 blocs OFF/35/100.
+Le parcours est une succession de positions enregistrées, pas une mesure des FPS.
+
+
+## Livraison
+
+[Release beta.134](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.134)
+publiée depuis `fc4a0cb68ed2d89163c8e74773976df5bab4f3f1`. Canal packwiz
+`35ec0f6e145002f6367944df5b75e2703958eaef` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR beta.134 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences, gardent leurs hashes. Copie préalable dans
+`sanctuary-backups/before-beta.134/`, aucun monde personnel ouvert.
+
+Packs normal/Test/template et comparateur natif vérifiés également dans
+`sanctuary-beta/build/`. Le checkout original garde ses changements préexistants.
+Reçus locaux ignorés : `build/shader134-artifact.json`, `build/shader134-isolated.json`,
+`build/shader134-prism.json`, `build/shader134-publication.log`.

docs/shader-beta135.md

@@ -0,0 +1,116 @@
+# SHADER-135 — SSGI en contre-plongée et près des surfaces
+
+Demande : supprimer les déchirures horizontales sous une surface, notamment
+près de la lave, et atténuer proprement le rebond quand la caméra s'approche
+d'une source ou d'un mur. Branche `codex/shader-closeup-beta135`, socle beta.134.
+Minecraft 26.3 / Java 25 ; aucune modification de monde ou de gameplay.
+
+## Diagnostic et correction
+
+Le calcul des normales comparait l'aire du pixel en unités du monde à un seuil
+fixe. À courte distance ou à haute résolution, cette aire devient naturellement
+très petite : le rejet pouvait couper une surface continue. Les deux directions
+sont maintenant normalisées avant leur produit vectoriel. Les texels de bord
+sont bornés et les voisins sans profondeur ne créent plus de fausse surface.
+
+La composition utilise le centre exact du texel de profondeur. Le rebond
+s'atténue entre 0,4 et 0,06 bloc de distance au **plan** receveur, et lorsque la
+vue devient presque tangente. Cette distance évite une découpe circulaire sur
+un mur plat. L'image native reste nette ; aucune texture du décor n'est floutée.
+
+Les sondes sortant du volume de projection sont rejetées. Leur contribution
+s'atténue près du plan de caméra et de la limite d'épaisseur d'un impact, au lieu
+d'une contribution pleine jusqu'à cette limite. Trois ressources GLSL modifiées ;
+aucune passe, cible GPU, lecture CPU, histoire temporelle ou option ajoutée.
+Les 12 rayons × 10 pas et les deux passes de filtrage spatial restent inchangés.
+
+## Réglages initiaux
+
+Demande ajoutée pendant la livraison : **bloom 20 %**, **PBR ON** et **SSGI ON**.
+Les intensités PBR 50 et SSGI 35 restent inchangées. Les champs absents du fichier
+de préférences prennent ces nouvelles valeurs ; les choix explicites du joueur
+restent conservés. Aides françaises et anglaises mises à jour. Vérification
+native supplémentaire des préférences vierges, partielles et personnalisées.
+
+## Reproduction native
+
+Deux scènes isolées : stone au-dessus de la lave, puis coin à 0,5 bloc d'une
+paroi rouge. Caméra en contre-plongée, sept distances au plafond de 2 à 0,04 bloc,
+comparaisons OFF/35/100 avant/après. Dans la première scène, à 0,1 bloc et
+intensité 100, le saut maximal de gain rouge moyen entre lignes de pixels neutres
+passe de **14,88 à 0,052** niveaux sur 255. Dans le coin, à 0,4 bloc et intensité
+35, le rebond auparavant rejeté revient (gain moyen de **6,01** niveaux), puis
+s'atténue à l'approche du contact. Ces chiffres concernent ces scènes uniquement.
+
+Les deux essais ciblés corrigés réussissent en 1 min 18 s et 1 min 17 s sur
+Apple M1 / OpenGL. Images avant/après conservées dans `build/closeup-*` ;
+comparateur autonome `build/Shader-beta.135-comparaison.html`.
+
+## Régression et livraison
+
+Les contrôles natifs de la suite générale réussissent jusqu'au parcours SSGI :
+ombres, lune, feuillage, temps réel, CTM, émissifs/bloom, couleurs de rebond,
+occlusion, réglages, rechargement et déplacement latéral de 12 blocs à 35/100.
+Log : `build/shader135-client-main.log`. La suite n'est pas présentée comme
+entièrement réussie : elle s'est arrêtée sur une attente incorrecte du nouveau
+test, qui demandait du rebond alors que sa source était sortie du champ.
+
+Le scénario corrigé distingue la haute résolution avec source visible de la
+vue très relevée sans source visible. Le bassin possède un fond pour isoler la
+lave des essais suivants ; les particules du scénario précédent sont effacées
+avant la comparaison PBR statique. Une première tentative avait aussi rencontré
+le refus natif de remettre l'horloge à sa valeur actuelle ; la préparation de
+l'heure est désormais répétable. Ces changements concernent uniquement les tests.
+
+Le contrôle final ciblé **réussit en 2 min 52 s** : les deux scènes, 35/100,
+sept distances, 1280 × 720 avec source visible, source hors champ, mouvement
+minuscule, rendu combiné, puis contrôles PBR complets (cache, intensités,
+matériaux, soleil, toit, OFF/zéro, redimensionnement et rechargement).
+Log : `build/shader135-client-final.log` ; marqueurs `SSGI135_CLOSEUP_PASS` et
+`PBR134_PASS`. Les seuils de proximité et PBR sont conservés.
+Le contrôle supplémentaire des nouveaux défauts et du PBR **réussit en
+1 min 16 s** : préférences vierges, champs absents, valeurs personnelles conservées,
+puis rendu PBR et combinaison des effets. Log : `build/shader135-defaults-client.log`.
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 18 s**, 126 tâches. Le serveur GameTest dédié demeure exclu
+conformément au refus EULA antérieur. Les classes des scénarios clients compilent
+aussi après leur isolation explicite des effets activés par défaut.
+Log : `build/shader135-build.log` ; compilation : `build/shader135-test-compile.log`.
+
+## Archives vérifiées
+
+Comparaison à beta.134 : **6 entrées de production** modifiées, limitées aux
+trois ressources SSGI, aux valeurs initiales et aux aides FR/EN. Gameplay et
+textures des gemmes inchangés. Packs normal/Test : JAR Sanctuary identique ;
+archives de sources et template conformes aux sources. Reçu local ignoré :
+`build/shader135-artifact.json`.
+
+
+## Limites
+
+Le SSGI utilise seulement les surfaces visibles : les sources hors champ restent
+absentes et un grand changement de vue peut modifier le rebond. L'atténuation
+proche est volontaire ; ce n'est pas une simulation volumétrique. Le brouillard
+natif de submersion continue de suspendre le SSGI, comme en beta.134. Aucun
+résultat Windows/Vulkan ni mesure de FPS revendiqués.
+
+- `Sanctuary-beta.135.mrpack` : 10422391 octets ; SHA-256 `36ac278f9f5ecd2cefd69da16ea7d153ff44c5fc8e6bf0b3a3d6b71f5d767af6`.
+
+- `Sanctuary-Test-beta.135.mrpack` : 10441314 octets ; SHA-256 `e096374f7ea0856b20392e5d277e94f6c3d411723d7ffc10ceccdd9f0bf5c4d4`.
+
+JAR : `a68ccd04a92a962c46a76b26a80cb44a4faf7a13a562094dde51010ade594c10`.
+
+## Livraison
+
+[Release beta.135](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.135)
+publiée depuis `7fada570efb5ed579e6e4d7bc2b87079c7131b31`. Canal packwiz
+`5b0df577fcd036937c25be3a1f4580f9db3103a1` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR beta.135 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences, gardent leurs hashes. Copie préalable dans
+`sanctuary-backups/before-beta.135/`, aucun monde personnel ouvert.
+
+Packs normal/Test/template et comparateur natif également vérifiés dans
+`sanctuary-beta/build/`. Le checkout original garde ses changements préexistants.
+Reçus locaux ignorés : `build/shader135-artifact.json`, `build/shader135-isolated.json`,
+`build/shader135-prism.json`, `build/shader135-publication.log`.

docs/shader-beta136.md

@@ -0,0 +1,85 @@
+# SHADER-136 — Lens flare rectangulaire doux
+
+Demande : ajouter un lens flare avec des rectangles dégradés, exclusivement
+pour le soleil et la lune. Socle beta.135, branche `codex/lens-flare-beta136`.
+Minecraft 26.3 / Java 25. Aucun changement de gameplay ou de monde.
+
+## Contrat
+
+Effet activé initialement à **30 %**, intensité réglable 0–100, indépendant du halo de bloom.
+Rectangles translucides aux bords doux, suivant la position de l'astre à l'écran.
+La visibilité provient de l'image émissive céleste native, avant les blocs :
+les murs masquent l'effet, les sources de terrain ne le déclenchent pas.
+L'astre sortant du champ doit s'atténuer sans sauter sur le bord opposé.
+Pas d'historique, ni lecture GPU vers le CPU, ni texture générée sur disque.
+
+## Rendu et budget
+
+Trois rectangles à dégradé doux par astre : un halo horizontal près de sa
+position et deux reflets plus petits le long de l'axe passant par le centre de
+l'écran. Teinte solaire chaude, lunaire légèrement bleue. Intégration de la
+lumière réellement dessinée par le ciel natif ; phases de lune conservées.
+Atténuation aux bords de l'écran et à l'horizon, sans projection derrière la caméra.
+
+Le masque céleste est mesuré avant l'ajout des émissifs de terrain. Réduction
+vers une texture 2 × 1 RGBA16F (512 échantillons au maximum au total), puis une
+passe de composition avec deux lectures de cette texture et des dégradés analytiques.
+La cible d'émission plein écran existante est réutilisée. Quand seul le flare
+fonctionne, aucun maillage d'émissif de terrain ni tampon de flou n'est construit.
+OFF et zéro libèrent la cible du flare ; les autres effets gardent leur autonomie.
+
+## Vérification
+
+Le scénario client natif réussit en **1 min 52 s** sur macOS / Apple M1 / OpenGL.
+Soleil OFF/30/80, lune et nouvelle lune, mur occultant, source hors champ,
+glowstone exclue, image statique, redimensionnement et rechargement des ressources.
+Le flare reste actif sans bloom ; OFF/zéro libèrent ses ressources. Préférences
+vierges, partielles, personnalisées, bornage et libellés FR/EN vérifiés.
+Les contrôles existants du bloom et des minerais émissifs passent également.
+Log : `build/shader136-client-final.log`, marqueurs `EMISSIVE131_PASS` et
+`LENS_FLARE136_PASS`. Les captures natives restent dans le dossier de tests ; comparatif autonome
+`build/Shader-beta.136-comparaison.html` (soleil OFF/30/80 et lune OFF/30).
+
+Une première tentative s'est arrêtée sur l'attente d'un angle de caméra :
+Minecraft normalise 180° en −180°. Le scénario utilise maintenant un angle
+canonique ; ce changement concerne uniquement le test.
+
+## Limites
+
+Effet optique en espace écran : il s'atténue quand l'astre quitte le champ et
+à l'horizon. Le masque natif du ciel contrôle l'occultation ; la lune reste
+volontairement beaucoup plus discrète. Le brouillard de submersion suspend
+l'effet comme le bloom existant. Aucun essai Windows/Vulkan ni mesure de FPS
+revendiqués.
+
+
+## Construction et archives
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 29 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader136-build.log`.
+Comparaison à beta.135 : **9 entrées de production** modifiées, uniquement
+le rendu, ses préférences et ses libellés. Gameplay et textures des gemmes
+strictement conservés. JAR normal/Test identique, sources et template vérifiés.
+Reçu local : `build/shader136-artifact.json`.
+
+- `Sanctuary-beta.136.mrpack` : 10424821 octets ; SHA-256 `808006bf2b0cb3fe63d3e16ae3a0003d27ad0b7e793a3a05f25b5d73ae88bc8d`.
+
+- `Sanctuary-Test-beta.136.mrpack` : 10443744 octets ; SHA-256 `70f593ad16d1f4fd4305b276ce2727a63f87bcb84df45e55840c1427a314a1eb`.
+
+JAR : `086afede22903f8988889f6085631451f65d6d55c2e4c81f249d2234698e68e5`.
+
+## Livraison
+
+[Release beta.136](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.136)
+publiée depuis `71296a9cfb0f6b1a6e6f0c48145f3cc432c8afd0`. Canal packwiz
+`dd5b545a7cfbb957f2c70e9dc17034b44caef98f` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR beta.136 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences, gardent leurs hashes. Copie préalable dans
+`sanctuary-backups/before-beta.136/`, aucun monde personnel ouvert.
+
+Packs normal/Test/template et comparatif natif également vérifiés dans
+`sanctuary-beta/build/`. Le checkout original garde ses changements préexistants.
+Reçus locaux ignorés : `build/shader136-artifact.json`, `build/shader136-isolated.json`,
+`build/shader136-prism.json`, `build/shader136-publication.log`.

docs/shader-beta137.md

@@ -0,0 +1,96 @@
+# SHADER-137 — Rayons solaires volumétriques
+
+Demande validée : faisceaux légers découpés par les blocs, carte d'ombres partagée,
+feuillage perméable, rendu natif préservé, option et intensité indépendantes du bloom.
+Socle beta.136, branche `codex/sunshafts-beta137`, Minecraft 26.3 / Java 25.
+Aucun changement de monde ni de gameplay.
+
+## Contrat
+
+Soleil uniquement ; activé initialement à 35 %, intensité 0–100.
+Intégration de 16 segments par pixel à un quart de chaque dimension.
+Reconstruction guidée par la profondeur, sans historique ni bruit animé.
+Réutilisation du masque de feuillage déjà stable dans les ombres.
+La carte solaire peut fonctionner sans afficher les ombres sur les surfaces.
+Portée bornée à 64 blocs et à la moitié de la portée des ombres.
+Atténuation aux limites de la carte, à l'horizon et avec la météo.
+
+## Rendu et coût borné
+
+Deux passes : intégration dans une cible RGBA16F de largeur et hauteur divisées
+par quatre, puis reconstruction guidée par la profondeur. Seize segments
+quadratiques privilégient les premiers mètres ; quatre lectures fixes de la
+carte d'ombres par segment adoucissent seulement la lumière dans l'air.
+La dernière portion du rayon rétrécit continûment à l'approche d'une surface.
+La lumière utilise une teinte solaire chaude mélangée au brouillard natif.
+
+La carte d'ombres et ses maillages sont partagés, y compris les trous de
+transmission déterministes des feuilles. Aucune copie d'image plein écran,
+aucune duplication du terrain, aucune lecture GPU côté CPU ni accumulation
+entre images dans le rendu de production. OFF/zéro libèrent le volume ; la
+carte d'ombres reste seulement si les ombres de surface sont activées.
+Le soleil sous l'horizon et la submersion suspendent les rayons.
+
+## Vérifications
+
+Scénario natif réussi en **1 min 41 s** sur macOS / Apple M1 / OpenGL : pièce
+entièrement fermée, toit ajouré OFF/35/100, feuilles puis ciel ouvert, déplacement
+de quatre blocs et retour, caméra proche d'un mur à 0,5 puis 0,125 bloc,
+soleil hors champ, nuit, OFF/zéro, carte d'ombres partagée, effet combiné,
+redimensionnement à 961 × 541 et rechargement des ressources. Préférences
+vierges/partielles/personnelles, bornage et libellés FR/EN également vérifiés.
+Log : `build/shader137-client-final.log`, marqueur `SUNSHAFT137_PASS`.
+Comparatif autonome : `build/Shader-beta.137-comparaison.html`.
+
+La première tentative s'est arrêtée sur une comparaison de gain brut entre
+feuillage et ciel ouvert. La composition dispose de moins de marge sur un mur
+déjà clair : le test compare maintenant la contribution normalisée sur les mêmes
+surfaces, et les feuilles du scénario sont persistantes. Aucun seuil du rendu
+n'a été assoupli pour faire passer ce contrôle.
+
+Les contrôles natifs existants du bloom, des vingt textures de minerais émissifs
+et du lens flare réussissent également en **1 min 32 s**, avec leurs seuils
+inchangés. Log : `build/shader137-regression.log`, marqueurs `EMISSIVE131_PASS`
+et `LENS_FLARE136_PASS`. Les autres effets sont explicitement isolés dans les
+scénarios qui nécessitent une image témoin sans rayons.
+
+## Limites
+
+Le volume utilise les formes présentes dans la carte d'ombres existante :
+il n'ajoute pas de projection d'ombre des entités ou des nuages. Le feuillage
+reste une approximation par transmission déterministe. Portée maximale de
+64 blocs, atténuée à son extrémité. Le faible nombre de segments et la résolution
+réduite peuvent lisser les ouvertures très fines. Aucun résultat Windows/Vulkan
+ni mesure de FPS revendiqués.
+
+
+## Construction et archives
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 27 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader137-build.log`.
+Comparaison à beta.136 : **11 entrées de production** modifiées, uniquement
+le rendu, ses préférences et ses libellés. Gameplay et textures des gemmes
+strictement conservés. JAR normal/Test identique, sources et template vérifiés.
+Reçu local : `build/shader137-artifact.json`.
+
+- `Sanctuary-beta.137.mrpack` : 10431723 octets ; SHA-256 `6684d1dbe48cd3031b373a03d4380519fdbf5d841e1c7cb5e290dec63b5ba9f6`.
+
+- `Sanctuary-Test-beta.137.mrpack` : 10450650 octets ; SHA-256 `32b0cee60152b6a5c8f31b248391c79a5fdf47b649de74902b066457ad4785ef`.
+
+JAR : `f1fbc106b4b048753f9a669af37e9c12f92168af486d4072f514e86920c81faa`.
+
+## Livraison
+
+[Release beta.137](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.137)
+publiée depuis `2d7072b8a8febac53354e9d0063246ac1e843e37`. Canal packwiz
+`68cb39a5edbf5d34def02f670e2488ee852605b8` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR beta.137 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences, gardent leurs hashes. Copie préalable dans
+`sanctuary-backups/before-beta.137/`, aucun monde personnel ouvert.
+
+Packs normal/Test/template et comparatif natif également vérifiés dans
+`sanctuary-beta/build/`. Le checkout original garde ses changements préexistants.
+Reçus locaux ignorés : `build/shader137-artifact.json`, `build/shader137-isolated.json`,
+`build/shader137-prism.json`, `build/shader137-publication.log`.

docs/shader-beta138.md

@@ -0,0 +1,101 @@
+# SHADER-138 — Épaisseur des rayons et météo
+
+Demande : épaissir les sunshafts avec la météo, surtout le brouillard.
+Socle beta.137, branche `codex/sunshaft-weather-beta138`, Minecraft 26.3 / Java 25.
+Aucune modification des règles météo, des sauvegardes ou du gameplay.
+
+## Contrat
+
+Densité et diffusion liées au brouillard environnemental réellement rendu,
+indépendamment de la limite de distance de rendu. Pluie/neige natives :
+renforcement plus modéré ; orage : réduction supplémentaire du soleil.
+Transitions continues, mêmes deux passes et seize segments. Le réglage
+manuel conserve sa valeur, aucune nouvelle option.
+
+## Rendu
+
+Le brouillard utilise `FogData.environmentalEnd`, séparé de la distance de
+rendu native. Sa contribution croît en douceur entre 192 et 80 blocs de
+visibilité. La densité passe de ×1 à ×3,5 pour le brouillard seul ; la diffusion
+angulaire s'élargit et la lumière lointaine s'éteint plus vite. Les coefficients
+ne dépendent d'aucun bruit animé ni historique d'image.
+
+Pluie et neige utilisent le niveau natif de précipitation : densité jusqu'à
+×1,8, diffusion plus légère. La lumière disponible tombe progressivement à
+25 % sous une pluie maximale et à 8,75 % sous un orage maximal. La carte solaire
+reste disponible pour le volume même lorsque Minecraft cache entièrement
+son disque solaire ; les ombres sur les surfaces conservent leur comportement.
+Le brouillard et la météo continuent leurs transitions natives.
+
+Même cible au quart de chaque dimension, deux passes, seize segments et
+quatre lectures de la carte par segment. L'empreinte de l'ombre ne change pas :
+la météo ne crée pas d'ouverture artificielle à travers un mur.
+
+## Vérification
+
+Scénario client natif réussi en **3 min 29 s**, macOS / Apple M1 / OpenGL.
+Les contrôles des volumes beta.137 passent à nouveau : ouvertures, feuilles,
+pièce fermée, mouvement/retour, proximité, soleil hors champ, intensité,
+OFF/zéro/nuit, redimensionnement, rechargement, préférences et libellés FR/EN.
+
+La suite utilise ensuite les vraies commandes serveur de météo : clair,
+`weather fog`, pluie, orage et retour au clair, dans le même décor avec le
+curseur maintenu à 35. Transition progressive du brouillard, rechargement
+sous brouillard, absence d'éclairage d'une pièce fermée et restitution de
+l'image claire initiale vérifiés. La contribution normalisée du volume dans
+cette scène passe d'environ 0,0034 au clair à 0,0236 sous brouillard ; ce n'est
+pas un multiplicateur universel de luminosité. L'orage reste sous la pluie.
+
+Log : `build/shader138-client-final.log`, marqueurs `SUNSHAFT137_PASS` et
+`SUNSHAFT138_WEATHER_PASS`. Comparatif natif autonome :
+`build/Shader-beta.138-comparaison.html`.
+
+## Diagnostic de la pluie
+
+La première exécution native a validé le brouillard, puis s'est arrêtée en
+attendant des rayons sous une pluie maximale. Minecraft 26.3 fournit alors
+`rainBrightness = 1 - rainLevel`, soit zéro : beta.137 ne construisait plus la
+carte solaire. Le volume reçoit désormais son atténuation météo propre et
+conserve la carte nécessaire, sans réactiver les ombres de surface sous la
+pluie maximale. Log de diagnostic : `build/shader138-client-first.log`.
+
+## Limites
+
+Coefficients artistiques bornés, sans simulation physique de gouttes ni de
+nuages. Le brouillard environnemental est distinct de la simple distance
+d'affichage ; la pluie et la neige partagent le niveau natif de précipitation.
+Les limites des volumes beta.137 restent applicables : 64 blocs maximum,
+formes de la carte d'ombres et feuillage approximé. Pas de mesure de FPS ni
+de validation Windows/Vulkan revendiquée.
+
+
+## Construction et archives
+
+`./gradlew check build assemblePack assembleTestPack -x :sanctuary:runGameTest`
+réussit en **2 min 20 s**, 126 tâches. Le serveur GameTest dédié reste exclu
+conformément au refus EULA antérieur. Log : `build/shader138-build.log`.
+Comparaison à beta.137 : **6 entrées de production** modifiées, uniquement
+le rendu et les aides FR/EN. Gameplay et textures des gemmes strictement
+conservés. JAR normal/Test identique, sources et template vérifiés.
+Reçu local : `build/shader138-artifact.json`.
+
+- `Sanctuary-beta.138.mrpack` : 10432860 octets ; SHA-256 `67093d3a53e3d90c31e8fb940d709ccf41ad730595e358346fa27ad744b44460`.
+
+- `Sanctuary-Test-beta.138.mrpack` : 10451787 octets ; SHA-256 `1ff39158b47f44a831b6506c8c2636441b2bff02644d20b1698330097e5ff059`.
+
+JAR : `44b6dd14f0e962fcb6f1efd61e0e7bb2c8dbb033cef81598582ec16c46a46518`.
+
+## Livraison
+
+[Release beta.138](https://git.botsu.net/koka/sanctuary-beta/releases/tag/beta.138)
+publiée depuis `daf36fdeacca707930092363589c89984af78f3b`. Canal packwiz
+`c049423de1971079b9d61874d83adeb6f1ad49f7` ; téléchargements publics vérifiés par SHA-256.
+Deux synchronisations isolées puis deux dans la même instance **Sanctuary Beta**
+réussissent. Un seul JAR beta.138 actif ; les **923 fichiers personnels suivis**,
+dont sauvegardes et préférences, gardent leurs hashes. Copie préalable dans
+`sanctuary-backups/before-beta.138/`, aucun monde personnel ouvert.
+
+Packs normal/Test/template et comparatif natif également vérifiés dans
+`sanctuary-beta/build/`. Le checkout original garde ses changements préexistants.
+Reçus locaux ignorés : `build/shader138-artifact.json`, `build/shader138-isolated.json`,
+`build/shader138-prism.json`, `build/shader138-publication.log`.

docs/shader-vulkan-beta138.md

@@ -0,0 +1,99 @@
+# SHADER-139 — Compatibilité Vulkan du shader beta.138
+
+Socle **beta.138**, Minecraft **26.3**, Java **25**, branche
+`codex/vulkan-shaders-beta139`.
+
+Le signalement initial concernait un bloom invisible même à 100 %. Le joueur
+indique ensuite que le rendu fonctionne de nouveau sur Windows et demande
+la compatibilité Vulkan. Les changements expérimentaux d'intensité ont été
+retirés : les shaders et les valeurs par défaut restent ceux de beta.138.
+
+## Contrat
+
+Utiliser les mêmes pipelines RenderPearl sur OpenGL et Vulkan. Vérifier le
+backend réellement utilisé, car Minecraft peut retomber sur OpenGL lorsque
+Vulkan ne démarre pas. Tester les effets dans de nouveaux mondes ignorés,
+sans ouvrir de sauvegarde personnelle ni modifier le backend de l'instance Prism.
+
+Le lancement des tests accepte désormais `-PsanctuaryClientGraphicsBackend=vulkan`
+ou `opengl`. Les tests de shaders refusent tout repli silencieux et consignent
+le nom du backend, du GPU et du pilote. Cette option concerne uniquement
+le client de développement.
+
+## Reproduction
+
+```sh
+JAVA_HOME=/chemin/vers/jdk-25 ./gradlew :sanctuary:runClientGameTest \
+  -PsanctuaryClientTests=true -PsanctuaryPixelShadows122ClientTests=true \
+  -PsanctuaryClientGraphicsBackend=vulkan \
+  -PsanctuaryClientNoVsync=true -PsanctuaryQuickTests=true
+```
+
+Sur Windows, utiliser `gradlew.bat` avec les mêmes propriétés et Java 25.
+Ajouter `-PsanctuaryClientImprovedTransparency=true` pour tester la transparence
+améliorée ; le choix initial est restauré après le test.
+Pour les rayons et la météo, remplacer `sanctuaryPixelShadows122ClientTests`
+par `sanctuarySunshaft137ClientTests`. Pour isoler le bloom et le lens flare,
+utiliser `sanctuaryBloom130ClientTests`.
+
+## Diagnostic initial
+
+Le client Vulkan démarre ici sur **Apple M1 / MoltenVK 1.4.2**, API 1.2.350.
+Le test du bloom réussit en **2 min 19 s** : les masques des vingt minerais,
+les contrôles OFF/zéro, intensité/diffusion, l'occlusion, le rechargement,
+les torches, glowstone, lampes, lave, soleil et le lens flare sont vérifiés.
+Les mesures de référence du bloom sont identiques à celles d'OpenGL :
+14649 pixels de minerai, gain du halo faible 218131, fort 1970502,
+gain solaire 7708. Log : `build/shader139-vulkan-first.log`.
+
+Cela confirme cette combinaison précise ; ce n'est pas une validation des
+pilotes NVIDIA/AMD/Intel sous Windows. En cas de retour du problème, le
+`logs/latest.log` de la session Windows concernée est nécessaire pour relever
+le backend effectif, le GPU, le pilote et les éventuelles erreurs de pipeline.
+
+## Suite Vulkan
+
+`sanctuaryPixelShadows122ClientTests` réussit en **8 min 50 s**. Les contrôles
+couvrent ombres diurnes/nocturnes, feuillage, stabilité en temps réel,
+highlights CTM, bloom et lens flare, SSGI en déplacement et près des surfaces,
+PBR directionnel, rechargement, redimensionnement et interfaces FR/EN.
+Log : `build/shader139-vulkan-suite2.log`.
+
+Le bloom et le lens flare réussissent aussi avec
+`sanctuaryClientImprovedTransparency=true`, en **1 min 45 s**. Le backend
+est bien Vulkan, sa profondeur est en `[0, 1]` et l'option de transparence
+est active. Les mesures du bloom restent identiques.
+Log : `build/shader139-vulkan-transparency.log`.
+
+La suite météo/rayons beta.138 n'a pas été rejouée sous Vulkan dans ce ticket ;
+les résultats ci-dessus portent sur les effets explicitement listés.
+Le joueur confirme que le retour à OpenGL rétablit l'effet sur Windows.
+Ce défaut particulier reste à reproduire à partir d'un journal récent.
+
+Un premier lancement utilisait un nom de propriété incomplet et a exécuté
+la suite générale, échouant dans Blocodex avant les tests de shaders.
+Ce lancement n'est pas compté comme une validation Vulkan des shaders.
+La commande corrigée utilise `sanctuaryPixelShadows122ClientTests`.
+
+## Construction
+
+`./gradlew check build -x :sanctuary:runGameTest` réussit ; le serveur
+GameTest dédié reste exclu conformément au refus EULA antérieur.
+Log : `build/shader139-check-build.log`. Le JAR reconstruit est **strictement
+identique, octet pour octet**, au JAR Sanctuary de la release beta.138.
+La distribution ne change pas et ne nécessite donc pas de nouvel assemblage.
+
+## Distribution
+
+Ce ticket ajoute des options de lancement de tests et leur documentation.
+Les shaders de production et les réglages de beta.138 ne sont pas changés.
+Aucune nouvelle livraison binaire, aucun tag beta.139 ni mise à jour de
+l'instance personnelle n'est effectué pour une vérification seule.
+
+## Référence du moteur
+
+Minecraft 26.3 compile les shaders OpenGL et Vulkan via ShaderC et expose
+`RENDERPEARL_DEPTH_IS_ZERO_TO_ONE` pour la convention de profondeur.
+[Notes officielles Minecraft 26.3](https://feedback.minecraft.net/hc/en-us/articles/48913133328013-Minecraft-Java-Edition-26-3).
+Les effets Sanctuary transmettent déjà la convention du périphérique aux
+reconstructions de position ; aucun remplacement spéculatif n'est appliqué.

docs/shaders-beta040.md

@@ -102,3 +102,8 @@ client natif : témoin `SHADER040_CLIENT_PASS` dans
 `build/operator040-client-final.log`. Captures dans
 `build/operator040-evidence/final/`, reçu dans `build/operator040-artifact.json`.
 Les contrôles ne revendiquent pas un essai avec Iris ou un autre moteur externe.
+
+
+Les ombres portées pixélisées sont livrées dans [beta.127](shader-beta127.md),
+intégrées sur la beta.126. Leur préparation locale portait un numéro beta.122
+non publié ; la release beta.122 existante n'est pas remplacée.

gradle.properties

@@ -9,8 +9,8 @@ loom_version=1.17.20
 fabric_api_version=0.160.5+26.3
 
 # Release counter: beta.001, .002, .003, ... (see docs/versioning.md).
-mod_version=beta.125
-pack_version=beta.125
+mod_version=beta.140
+pack_version=beta.140
 resource_pack_version=beta.121
 maven_group=fr.koka.sanctuary
 jei_version=30.32.0-sanctuary.3

mods/sanctuary/build.gradle

@@ -25,6 +25,16 @@ if (clientRenderTests) {
         java.srcDir('src/clientGametest/java')
     }
     tasks.named('runClientGameTest') {
+        def graphicsBackend = providers.gradleProperty('sanctuaryClientGraphicsBackend')
+        if (graphicsBackend.isPresent()) {
+            args('--graphicsBackend', graphicsBackend.get())
+            systemProperty('sanctuary.test.graphicsBackend', graphicsBackend.get())
+        }
+        def improvedTransparency = providers.gradleProperty('sanctuaryClientImprovedTransparency')
+        if (improvedTransparency.isPresent()) {
+            systemProperty('sanctuary.test.improvedTransparency', improvedTransparency.get())
+        }
+        systemProperty('sanctuary.test.colored140', providers.gradleProperty('sanctuaryColored140ClientTests').getOrElse('false'))
         systemProperty('sanctuary.test.noVsync', providers.gradleProperty('sanctuaryClientNoVsync').getOrElse('false'))
         systemProperty('sanctuary.test.quick', providers.gradleProperty('sanctuaryQuickTests').getOrElse('false'))
         systemProperty('sanctuary.test.introVisualOnly', providers.gradleProperty('sanctuaryIntroVisualOnly').getOrElse('false'))
@@ -93,6 +103,35 @@ tasks.named('runGameTest') {
 }
 
 tasks.named('processGametestResources') {
+    def colored139Client = providers.gradleProperty('sanctuaryColored139ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuaryColored139ClientTests', colored139Client)
+    if (colored139Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.ColoredLights139ClientChecks') }
+
+    def pbr134Client = providers.gradleProperty('sanctuaryPbr134ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuaryPbr134ClientTests', pbr134Client)
+    if (pbr134Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.Pbr134ClientChecks') }
+    def ssgi132Client = providers.gradleProperty('sanctuarySsgi132ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuarySsgi132ClientTests', ssgi132Client)
+    if (ssgi132Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.Ssgi132ClientChecks') }
+    def closeup135Client = providers.gradleProperty('sanctuarySsgiCloseup135ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuarySsgiCloseup135ClientTests', closeup135Client)
+    if (closeup135Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.SsgiCloseup135ClientChecks') }
+
+    def sunshaft137Client = providers.gradleProperty('sanctuarySunshaft137ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuarySunshaft137ClientTests', sunshaft137Client)
+    if (sunshaft137Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.Sunshafts137ClientChecks') }
+    def bloom130Client = providers.gradleProperty('sanctuaryBloom130ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuaryBloom130ClientTests', bloom130Client)
+    if (bloom130Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.Bloom130ClientChecks') }
+
+    def shadows122Client = providers.gradleProperty('sanctuaryPixelShadows122ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuaryPixelShadows122ClientTests', shadows122Client)
+    if (shadows122Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks') }
+
+    def gems126Client = providers.gradleProperty('sanctuaryGems126ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('sanctuaryGems126ClientTests', gems126Client)
+    if (gems126Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.Gems126ClientChecks') }
+
     def sculpture125Client = providers.gradleProperty('sanctuarySculpture125ClientTests').map { it.toBoolean() }.getOrElse(false)
     inputs.property('sanctuarySculpture125ClientTests', sculpture125Client)
     if (sculpture125Client) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.Sculpture125ClientChecks') }

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/Clay126Checks.java

@@ -0,0 +1,42 @@
+package fr.koka.sanctuary.client;
+
+import fr.koka.sanctuary.companion.CompanionService;
+import fr.koka.sanctuary.plans.*;
+import java.nio.file.*;
+import java.util.*;
+import net.fabricmc.fabric.api.client.gametest.v1.context.*;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.entity.EntityTypes;
+import net.minecraft.world.inventory.ContainerInput;
+import net.minecraft.world.item.*;
+import net.minecraft.world.level.GameType;
+
+/** Native preview, server result and survival payment for the special plain-clay material. */
+final class Clay126Checks {
+    static void exercise(ClientGameTestContext c,TestServerContext server){
+        var pos=new BlockPos(4,1,4);
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();p.teleportTo(3,1,3);p.setGameMode(GameType.SURVIVAL);p.getAbilities().invulnerable=true;p.onUpdateAbilities();p.level().setBlockAndUpdate(pos,Statuary.WORKSHOP.defaultBlockState());CompanionService.save(p,CompanionService.record(p).note("seen_mobs","cow"));Statuary.open(p,pos);p.containerMenu.getSlot(0).set(new ItemStack(Items.CLAY,2));p.containerMenu.broadcastChanges();});
+        c.waitForScreen(ClayWorkshopScreen.class);c.runOnClient(m->{m.options.guiScale().set(2);m.getWindow().setWindowed(1280,800);m.resizeGui();((ClayWorkshopScreen)m.gui.screen()).load(EntityTypes.COW);});
+        c.waitFor(m->{var screen=(ClayWorkshopScreen)m.gui.screen();return !screen.busy()&&screen.selected()!=null&&screen.selected().equals(StatuaryEntity.sculpture(m.player.containerMenu.getSlot(1).getItem()));},250);
+        var cow=c.computeOnClient(m->((ClayWorkshopScreen)m.gui.screen()).selected());check(cow.cells().stream().map(VoxelSculpture.Cell::color).distinct().count()>3,"Cow source retains texture colors");
+        for(var material:List.of(Items.OAK_PLANKS,fr.koka.sanctuary.building.ColoredBricks.families().getFirst().clay().asItem(),Items.CLAY)){
+            server.runOnServer(s->{var menu=s.getPlayerList().getPlayers().getFirst().containerMenu;menu.getSlot(0).set(new ItemStack(material,2));menu.broadcastChanges();});
+            var expected=c.computeOnClient(m->ClayWorkshopMenu.appearance(cow,material,SculptureMaterialSampler.sample(new ItemStack(material))));
+            check(material==Items.CLAY?expected.equals(cow):!expected.equals(cow),"Only plain clay retains original colors");
+            c.waitFor(m->expected.equals(StatuaryEntity.sculpture(m.player.containerMenu.getSlot(1).getItem())),180);
+            c.runOnClient(m->check(ItemStack.matches(((ClayWorkshopScreen)m.gui.screen()).preview(),m.player.containerMenu.getSlot(1).getItem()),"Preview matches authoritative material switch"));
+        }
+        c.takeScreenshot("clay126-original-cow");
+        c.runOnClient(m->m.gameMode.handleContainerInput(m.player.containerMenu.containerId,1,0,ContainerInput.PICKUP,m.player));
+        server.waitFor(s->{var menu=s.getPlayerList().getPlayers().getFirst().containerMenu;return cow.equals(StatuaryEntity.sculpture(menu.getCarried()))&&menu.getSlot(0).getItem().getCount()==1;},100);
+        c.waitFor(m->cow.equals(StatuaryEntity.sculpture(m.player.containerMenu.getCarried()))&&m.player.containerMenu.getSlot(0).getItem().getCount()==1,100);
+        Path file=PlanClient.directory().resolve("clay126-"+UUID.randomUUID()+".glb");
+        try{Files.createDirectories(file.getParent());Files.write(file,Statuary106ClientChecks.fixture());var id=GlbModel.load(file).id();c.runOnClient(m->((ClayWorkshopScreen)m.gui.screen()).load(file));
+            c.waitFor(m->{var screen=(ClayWorkshopScreen)m.gui.screen();return !screen.busy()&&screen.selected()!=null&&screen.selected().modelId().equals(id)&&screen.selected().equals(StatuaryEntity.sculpture(m.player.containerMenu.getSlot(1).getItem()));},250);
+            c.runOnClient(m->{var screen=(ClayWorkshopScreen)m.gui.screen();check(screen.selected().cells().stream().map(VoxelSculpture.Cell::color).distinct().count()>1,"Imported textured GLB retains its original colors");check(ItemStack.matches(screen.preview(),m.player.containerMenu.getSlot(1).getItem()),"Imported preview equals native result");});
+        }catch(Exception e){throw new AssertionError(e);}finally{try{Files.deleteIfExists(file);}catch(Exception ignored){}}
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();p.closeContainer();p.setGameMode(GameType.CREATIVE);p.getAbilities().flying=true;p.onUpdateAbilities();});c.waitFor(m->m.gui.screen()==null,100);
+        System.out.println("CLAY126_PASS original animal and GLB colors, oak and colored clay palette transfer, switch back, matching previews and one clay paid in survival");
+    }
+    private static void check(boolean ok,String message){if(!ok)throw new AssertionError(message);}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/Discovery126Checks.java

@@ -0,0 +1,47 @@
+package fr.koka.sanctuary.client;
+
+import fr.koka.sanctuary.companion.*;
+import fr.koka.sanctuary.knowledge.*;
+import fr.koka.sanctuary.plans.*;
+import fr.koka.sanctuary.recipes.*;
+import java.util.*;
+import net.fabricmc.fabric.api.client.gametest.v1.context.*;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.stats.Stats;
+import net.minecraft.world.entity.EntityTypes;
+import net.minecraft.world.item.*;
+import net.minecraft.world.level.block.Blocks;
+
+final class Discovery126Checks {
+    static void exercise(ClientGameTestContext c,TestServerContext server){
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();var dispatcher=s.getCommands().getDispatcher();
+            var source=p.createCommandSourceStack();var root=dispatcher.getRoot().getChild("sanctuary").getChild("discovery");
+            s.getWorldData().setAllowCommands(false);check(!root.canUse(source),"Discovery commands respect native Allow Commands");
+            try{dispatcher.execute("sanctuary discovery all",source);throw new AssertionError("Denied command executed");}catch(com.mojang.brigadier.exceptions.CommandSyntaxException expected){}
+            s.getWorldData().setAllowCommands(true);
+            var before=CompanionService.record(p);var items=new TreeSet<>(RecipeService.knowledge(p).items);int kills=p.getStats().getValue(Stats.ENTITY_KILLED,EntityTypes.WITHER);
+            command(p,"mob minecraft:wither");check(StatueDiscoveries.known(p).contains("minecraft:wither"),"Precise species unlocks sculpture catalogue");check(CompanionService.record(p).notes().get("seen_mobs").contains("wither"),"Same actual seen_mobs record");check(RecipeService.knowledge(p).items.equals(items),"Mob discovery invents no unrelated item discovery");check(p.getStats().getValue(Stats.ENTITY_KILLED,EntityTypes.WITHER)==kills,"No fake kill stat");
+            command(p,"block minecraft:pink_glazed_terracotta");var block=BlockKnowledgeService.knowledge(p,Blocks.GLAZED_TERRACOTTA.pick(DyeColor.PINK));check(block.seen()&&!block.possessed()&&block.mined()==0&&block.placed()==0,"Precise block is seen without fabricated possession or stats");check(RecipeService.knowledge(p).items.contains("minecraft:pink_glazed_terracotta")&&RecipeService.knowledge(p).collections.contains("sanctuary:terracotta"),"Block event unlocks its normal recipe collection");
+            command(p,"item minecraft:amethyst_shard");check(RecipeService.knowledge(p).items.contains("minecraft:amethyst_shard")&&RecipeService.knowledge(p).recipes.contains("minecraft:spyglass"),"Precise item unlocks linked recipes");
+            String old=CompanionService.record(p).json();check(run(p,"mob minecraft:item")==0,"Nonmob type refused");check(CompanionService.record(p).json().equals(old),"Rejected request does not change discoveries");
+            try{dispatcher.execute("sanctuary discovery item sanctuary:missing_item",source);throw new AssertionError("Missing ID accepted");}catch(com.mojang.brigadier.exceptions.CommandSyntaxException expected){}
+            command(p,"mobs all");allSpecies(p);var pos=new BlockPos(4,1,4);Statuary.open(p,pos);check(((ClayWorkshopMenu)p.containerMenu).view.statues().equals(StatueDiscoveries.known(p)),"Workshop sees the shared full catalogue");p.closeContainer();
+            command(p,"all");all(p);String species=CompanionService.record(p).json(),recipes=RecipeService.knowledge(p).json();var blocks=BlockKnowledgeService.snapshot(p);command(p,"all @s");check(species.equals(CompanionService.record(p).json())&&recipes.equals(RecipeService.knowledge(p).json())&&blocks.equals(BlockKnowledgeService.snapshot(p)),"Repeated all with target selector is idempotent");
+            check(CompanionService.record(p).paid()==before.paid()&&CompanionService.record(p).unlocked()==before.unlocked(),"Discoveries do not fabricate paid skills");
+            try{check(dispatcher.execute("sanctuary discovery mob minecraft:cow "+p.getGameProfile().name(),s.createCommandSourceStack())==1,"Console can address an online player");}catch(Exception e){throw new AssertionError(e);}
+            System.out.println("DISCOVERY126_PASS native permissions, precise block/item/species, linked recipes, shared catalogue, all three categories, all, selector, console, idempotence and unchanged combat/ownership counters");
+        });
+        c.waitFor(m->m.gui.screen()==null,100);
+    }
+    static void all(ServerPlayer p){
+        allSpecies(p);check(BlockKnowledgeService.snapshot(p).stream().allMatch(BlockKnowledge::known),"All block discoveries");
+        var knowledge=RecipeService.knowledge(p);for(var item:BuiltInRegistries.ITEM)if(item!=Items.AIR)check(knowledge.items.contains(BuiltInRegistries.ITEM.getKey(item).toString()),"All registered items discovered");
+        check(knowledge.recipes.contains("minecraft:spyglass")&&knowledge.recipes.contains("sanctuary:ruby_block"),"Vanilla and Sanctuary recipes are derived from discoveries");
+    }
+    static void allSpecies(ServerPlayer p){check(StatueDiscoveries.known(p).size()==BuiltInRegistries.ENTITY_TYPE.stream().filter(t->SpawnEggItem.byId(t).isPresent()).count(),"All registered species discovered");}
+    static void command(ServerPlayer p,String args){check(run(p,args)==1,"Discovery command succeeds: "+args);}
+    private static int run(ServerPlayer p,String args){try{return p.level().getServer().getCommands().getDispatcher().execute("sanctuary discovery "+args,p.createCommandSourceStack());}catch(Exception e){throw new AssertionError(e);}}
+    private static void check(boolean ok,String message){if(!ok)throw new AssertionError(message);}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/Gems126ClientChecks.java

@@ -0,0 +1,88 @@
+package fr.koka.sanctuary.client;
+
+import com.mojang.blaze3d.platform.InputConstants;
+import fr.koka.sanctuary.SanctuaryMod;
+import fr.koka.sanctuary.gems.*;
+import fr.koka.sanctuary.gametest.Starter039TestSupport;
+import java.util.*;
+import java.util.concurrent.atomic.AtomicBoolean;
+import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientTickEvents;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.minecraft.client.gui.components.Button;
+import net.minecraft.client.gui.screens.worldselection.WorldCreationUiState;
+import net.minecraft.client.input.KeyEvent;
+import net.minecraft.core.*;
+import net.minecraft.core.registries.*;
+import net.minecraft.network.chat.contents.TranslatableContents;
+import net.minecraft.resources.ResourceKey;
+import net.minecraft.tags.*;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.item.*;
+import net.minecraft.world.item.crafting.*;
+import net.minecraft.world.item.enchantment.Enchantments;
+import net.minecraft.world.level.block.*;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.levelgen.GenerationStep;
+
+/** Actual native registration, recipes, drops, tab order and naturally decorated Sanctuary chunks. */
+public final class Gems126ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){
+        var intro=new AtomicBoolean(true);
+        c.runOnClient(m->{m.options.renderDistance().set(5);m.options.simulationDistance().set(5);m.options.pauseOnLostFocus=false;IntroClient.setQuickTestIntro(true);});
+        ClientTickEvents.END_CLIENT_TICK.register(m->{if(intro.get()&&m.gui.screen() instanceof HelloWorldScreen screen){
+            IntroClient.setQuickTestIntro(true);Starter039TestSupport.selectFirst(screen);var enter=new KeyEvent(InputConstants.KEY_RETURN,0,0);
+            screen.children().stream().filter(Button.class::isInstance).map(Button.class::cast).filter(b->b.getClass().getSimpleName().equals("ColorButton")).findFirst().orElseThrow().onPress(enter);
+            screen.children().stream().filter(Button.class::isInstance).map(Button.class::cast).filter(b->b.getMessage().getContents() instanceof TranslatableContents t&&t.getKey().equals("sanctuary.progression.enter")).findFirst().orElseThrow().onPress(enter);intro.set(false);
+        }});
+        try(var world=c.worldBuilder().adjustSettings(s->{s.setName("Gems126 registry "+UUID.randomUUID());s.setSeed("126");s.setAllowCommands(true);s.setGameMode(WorldCreationUiState.SelectedGameMode.CREATIVE);s.setWorldType(s.getNormalPresetList().stream().filter(e->e.preset()!=null&&e.preset().getRegisteredName().equals("sanctuary_test:flat")).findFirst().orElseThrow());}).create()){
+            c.waitFor(m->ProgressionClient.active()&&m.player!=null&&m.gui.screen()==null&&!IntroSpawnFlash.active(),1200);
+            world.getServer().runOnServer(s->{
+                var p=s.getPlayerList().getPlayers().getFirst();var l=p.level();var pos=new BlockPos(0,4,0);var iron=new ItemStack(Items.IRON_PICKAXE);var silk=iron.copy();silk.enchant(l.registryAccess().lookupOrThrow(Registries.ENCHANTMENT).getOrThrow(Enchantments.SILK_TOUCH),1);var fortune=iron.copy();fortune.enchant(l.registryAccess().lookupOrThrow(Registries.ENCHANTMENT).getOrThrow(Enchantments.FORTUNE),3);
+                for(var f:Gems.FAMILIES){
+                    for(var b:List.of(f.block(),f.ore(),f.deepslateOre())){var state=b.defaultBlockState();check(state.is(BlockTags.MINEABLE_WITH_PICKAXE)&&state.is(BlockTags.NEEDS_IRON_TOOL),"Native mining tags "+b);check(iron.isCorrectToolForDrops(state)&&!new ItemStack(Items.STONE_PICKAXE).isCorrectToolForDrops(state),"Iron tier enforced "+b);}
+                    drop(Block.getDrops(f.block().defaultBlockState(),l,pos,null,p,iron),f.block().asItem(),1);
+                    for(var ore:List.of(f.ore(),f.deepslateOre())){
+                        drop(Block.getDrops(ore.defaultBlockState(),l,pos,null,p,iron),f.gem(),1);drop(Block.getDrops(ore.defaultBlockState(),l,pos,null,p,silk),ore.asItem(),1);
+                        int max=0;for(int i=0;i<48;i++){var drops=Block.getDrops(ore.defaultBlockState(),l,pos,null,p,fortune);check(drops.size()==1&&drops.getFirst().is(f.gem()),"Fortune gem type");int n=drops.getFirst().getCount();check(n>=1&&n<=4,"Native Fortune III range");max=Math.max(max,n);}check(max>1,"Fortune increases gem yield");
+                        var input=new SingleRecipeInput(new ItemStack(ore));for(var type:List.of(RecipeType.SMELTING,RecipeType.BLASTING)){var recipe=s.getRecipeManager().getRecipeFor(type,input,l).orElseThrow().value();check(recipe.assemble(input).is(f.gem()),"Native furnace recipe");}
+                    }
+                    var input=CraftingInput.of(3,3,Collections.nCopies(9,new ItemStack(f.gem())));drop(List.of(s.getRecipeManager().getRecipeFor(RecipeType.CRAFTING,input,l).orElseThrow().value().assemble(input)),f.block().asItem(),1);
+                    input=CraftingInput.of(1,1,List.of(new ItemStack(f.block())));drop(List.of(s.getRecipeManager().getRecipeFor(RecipeType.CRAFTING,input,l).orElseThrow().value().assemble(input)),f.gem(),9);
+                    check(f.block().defaultBlockState().is(BlockTags.BEACON_BASE_BLOCKS)&&new ItemStack(f.gem()).is(ItemTags.BEACON_PAYMENT_ITEMS),"Native beacon compatibility");
+                    var feature=l.registryAccess().lookupOrThrow(Registries.FEATURE).getOrThrow(ResourceKey.create(Registries.FEATURE,SanctuaryMod.id("ore_"+f.id()))).value();check(feature instanceof GemOreFeature,"Data feature decoded");
+                    check(!feature.place(l,l.getChunkSource().getGenerator(),RandomSource.create(126),pos),"Gem veins do not run in ordinary flat/vanilla worlds");
+                    fr.koka.sanctuary.recipes.RecipeService.discover(p,f.gem());fr.koka.sanctuary.recipes.RecipeService.refresh(p);check(fr.koka.sanctuary.recipes.RecipeService.knowledge(p).recipes.contains("sanctuary:"+f.id()+"_block"),"Native discovery unlocks storage recipe");
+                }
+                int x=0;for(var block:List.of(Blocks.EMERALD_BLOCK,Gems.RUBY.block(),Gems.SAPPHIRE.block(),Blocks.EMERALD_ORE,Gems.RUBY.ore(),Gems.SAPPHIRE.ore(),Blocks.DEEPSLATE_EMERALD_ORE,Gems.RUBY.deepslateOre(),Gems.SAPPHIRE.deepslateOre())){l.setBlockAndUpdate(new BlockPos(x%3,1,x/3),block.defaultBlockState());x++;}
+                p.teleportTo(1.5,3,7);p.getAbilities().flying=true;p.onUpdateAbilities();p.getInventory().setItem(0,new ItemStack(Items.EMERALD));p.getInventory().setItem(1,new ItemStack(Gems.RUBY.gem()));p.getInventory().setItem(2,new ItemStack(Gems.SAPPHIRE.gem()));p.inventoryMenu.broadcastFullState();
+                System.out.println("GEMS126_SERVER_PASS eight registered items, six blocks, native loot/Fortune/Silk Touch, twelve recipes, mining tiers, beacons, discoveries and vanilla generation exclusion");
+            });
+            c.runOnClient(m->{CreativeModeTabs.tryRebuildTabContents(m.level.enabledFeatures(),true,m.level.registryAccess());order(CreativeModeTabs.INGREDIENTS,Items.EMERALD,Gems.RUBY.gem(),Gems.SAPPHIRE.gem());order(CreativeModeTabs.BUILDING_BLOCKS,Items.EMERALD_BLOCK,Gems.RUBY.block().asItem(),Gems.SAPPHIRE.block().asItem());order(CreativeModeTabs.NATURAL_BLOCKS,Items.EMERALD_ORE,Gems.RUBY.ore().asItem(),Gems.SAPPHIRE.ore().asItem());order(CreativeModeTabs.NATURAL_BLOCKS,Items.DEEPSLATE_EMERALD_ORE,Gems.RUBY.deepslateOre().asItem(),Gems.SAPPHIRE.deepslateOre().asItem());
+                for(var f:Gems.FAMILIES)for(var block:List.of(f.block(),f.ore(),f.deepslateOre())){var parts=new ArrayList<net.minecraft.client.renderer.block.dispatch.BlockStateModelPart>();m.getModelManager().getBlockStateModelSet().get(block.defaultBlockState()).collectParts(RandomSource.create(0),parts);check(!parts.isEmpty(),"Baked gem block model");for(var part:parts)for(var face:Direction.values())for(var quad:part.getQuads(face))check(!quad.materialInfo().sprite().contents().name().toString().contains("missingno"),"Native texture atlas resolves supplied gem PNG");}
+                System.out.println("GEMS126_CREATIVE_PASS emerald, ruby, sapphire adjacency in four groups; all six baked block models");
+            });
+            c.waitTicks(10);c.runOnClient(m->m.player.lookAt(net.minecraft.commands.arguments.EntityAnchorArgument.Anchor.EYES,new net.minecraft.world.phys.Vec3(1.5,1.5,1.5)));c.waitTicks(4);c.takeScreenshot("gems126-gallery");
+            Clay126Checks.exercise(c,world.getServer());
+            Discovery126Checks.exercise(c,world.getServer());
+        }
+        intro.set(true);net.fabricmc.fabric.api.client.gametest.v1.world.TestWorldSave saved;var found=new HashMap<BlockPos,BlockState>();
+        try(var world=c.worldBuilder().adjustSettings(s->{s.setName("Gems126 natural "+UUID.randomUUID());s.setSeed("126");s.setAllowCommands(true);s.setGenerateStructures(false);s.setGameMode(WorldCreationUiState.SelectedGameMode.CREATIVE);s.setWorldType(s.getNormalPresetList().stream().filter(e->e.preset()!=null&&e.preset().getRegisteredName().equals("sanctuary:sanctuary")).findFirst().orElseThrow());}).create()){
+            c.waitFor(m->m.player!=null&&m.gui.screen()==null&&ProgressionClient.active()&&!IntroSpawnFlash.active(),2400);
+            world.getServer().runOnServer(s->{var l=s.overworld();check(l.getChunkSource().getGenerator() instanceof fr.koka.sanctuary.worldgen.SanctuaryChunkGenerator,"Actual Sanctuary generator");
+                for(int cx=-4;cx<=4;cx++)for(int cz=-4;cz<=4;cz++){var chunk=l.getChunk(cx,cz);var cursor=new BlockPos.MutableBlockPos();for(int x=0;x<16;x++)for(int z=0;z<16;z++)for(int y=0;y<=256;y++){cursor.set(cx*16+x,y,cz*16+z);var state=chunk.getBlockState(cursor);if(state.is(Gems.RUBY.ore())||state.is(Gems.RUBY.deepslateOre())||state.is(Gems.SAPPHIRE.ore())||state.is(Gems.SAPPHIRE.deepslateOre()))found.put(cursor.immutable(),state);}}
+                for(var f:Gems.FAMILIES){long ordinary=found.values().stream().filter(b->b.is(f.ore())).count(),deep=found.values().stream().filter(b->b.is(f.deepslateOre())).count();System.out.println("GEMS126_NATURAL "+f.id()+" stone="+ordinary+" deepslate="+deep+" seed=126 chunks=81");check(ordinary+deep>0,"Both gems generate naturally without structure placement: "+f.id());}
+                var biome=l.getBiome(found.keySet().iterator().next()).value();var features=biome.getGenerationSettings().features().get(GenerationStep.Decoration.UNDERGROUND_ORES.ordinal());for(var f:Gems.FAMILIES)check(features.stream().anyMatch(h->h.is(ResourceKey.create(Registries.PLACED_FEATURE,SanctuaryMod.id("ore_"+f.id())))),"Native biome includes configurable gem placement");
+                Discovery126Checks.command(s.getPlayerList().getPlayers().getFirst(),"all");
+                var mined=found.keySet().iterator().next();l.setBlockAndUpdate(mined,Blocks.AIR.defaultBlockState());found.put(mined,Blocks.AIR.defaultBlockState());
+            });saved=world.getWorldSave();
+        }
+        try(var world=saved.open()){
+            c.waitFor(m->m.player!=null&&m.gui.screen()==null,2400);world.getServer().runOnServer(s->{Discovery126Checks.all(s.getPlayerList().getPlayers().getFirst());for(var e:found.entrySet())check(s.overworld().getBlockState(e.getKey())==e.getValue(),"Generated ores persist on reload without repopulation");});
+        }
+        System.out.println("GEMS126_PASS registry, recipes, drops, creative order, native models, natural Sanctuary generation seed 126 and save/reconnect");
+    }
+    private static void order(ResourceKey<CreativeModeTab> tab,Item anchor,Item ruby,Item sapphire){var items=new ArrayList<>(BuiltInRegistries.CREATIVE_MODE_TAB.getOrThrow(tab).value().getDisplayItems());int i=0;while(i<items.size()&&!items.get(i).is(anchor))i++;check(i+2<items.size()&&items.get(i+1).is(ruby)&&items.get(i+2).is(sapphire),"Emerald/ruby/sapphire order in "+tab);check(items.stream().filter(v->v.is(ruby)||v.is(sapphire)).count()==2,"No duplicate creative entries");}
+    private static void drop(List<ItemStack> drops,Item item,int n){check(drops.size()==1&&drops.getFirst().is(item)&&drops.getFirst().getCount()==n,"Native loot/craft expected "+n+" "+item+", got "+drops);}
+    private static void check(boolean ok,String message){if(!ok)throw new AssertionError(message);}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/Sculpture116ClientChecks.java

@@ -48,7 +48,7 @@ public final class Sculpture116ClientChecks implements FabricClientGameTest {
                 var rendered=new HashSet<VoxelSculpture>();
                 for(var item:List.of(Items.STONE,Items.OAK_PLANKS,Items.GOLD_BLOCK,Items.WOOL.pick(DyeColor.RED),Items.GLASS,Items.OAK_LEAVES,Items.CLAY,Items.DEEPSLATE)){
                     server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();p.getInventory().clearContent();var menu=(ClayWorkshopMenu)p.containerMenu;menu.getSlot(0).set(new ItemStack(item,2));check(menu.getSlot(1).getItem().isEmpty(),"Previous material result invalidates immediately");menu.broadcastChanges();});
-                    var expected=c.computeOnClient(m->SculptureMaterialSampler.sample(new ItemStack(item)).apply(source));rendered.add(expected);
+                    var expected=c.computeOnClient(m->ClayWorkshopMenu.appearance(source,item,SculptureMaterialSampler.sample(new ItemStack(item))));rendered.add(expected);
                     c.waitFor(m->expected.equals(StatuaryEntity.sculpture(m.player.containerMenu.getSlot(1).getItem())),180);
                     c.runOnClient(m->check(ItemStack.matches(((ClayWorkshopScreen)m.gui.screen()).preview(),m.player.containerMenu.getSlot(1).getItem()),"Preview equals server-owned result"));
                     check(StatuaryEntity.decode(StatuaryEntity.encode(expected)).equals(expected),"Palette colors persist in unchanged schema 1");

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/Statuary106ClientChecks.java

@@ -62,7 +62,7 @@ public final class Statuary106ClientChecks implements FabricClientGameTest {
             try(var world=c.worldBuilder().adjustSettings(s->{s.setName("Statuary106 "+UUID.randomUUID());s.setSeed("106");s.setAllowCommands(true);s.setGameMode(WorldCreationUiState.SelectedGameMode.CREATIVE);
                 s.setWorldType(s.getNormalPresetList().stream().filter(e->e.preset()!=null&&e.preset().getRegisteredName().equals("sanctuary_test:flat")).findFirst().orElseThrow());}).create()){
                 saved=world.getWorldSave();c.waitFor(m->ProgressionClient.active()&&m.player!=null&&m.gui.screen()==null&&!IntroSpawnFlash.active(),1200);
-                var source=c.computeOnClient(m->SculptureMaterialSampler.sample(new ItemStack(Items.CLAY)).apply(originalSource));
+                var source=originalSource;
                 var server=world.getServer();
                 server.runOnServer(s->{var p=player(s);p.teleportTo(.5,1,.5);p.getInventory().clearContent();p.setGameMode(GameType.SURVIVAL);for(int x=-7;x<=9;x++)for(int z=-5;z<=9;z++)p.level().setBlockAndUpdate(new BlockPos(x,0,z),Blocks.STONE.defaultBlockState());p.level().setBlockAndUpdate(WORKSHOP,Statuary.WORKSHOP.defaultBlockState());
                     var legacy=net.minecraft.nbt.NbtUtils.writeBlockState(Statuary.BLOCK.defaultBlockState());legacy.remove("properties");

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/Bloom130ClientChecks.java

@@ -0,0 +1,140 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import com.mojang.blaze3d.platform.NativeImage;
+import java.nio.file.*;
+import java.util.*;
+import java.util.concurrent.CompletableFuture;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.client.Screenshot;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.block.Blocks;
+
+/** Actual source texels, native GPU masks, occlusion and user controls in an isolated world. */
+public final class Bloom130ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){new PixelShadows122ClientChecks(true).runTest(c);}
+    static final List<String> ORES=ores();
+    private static List<String> ores(){var result=new ArrayList<String>();for(String name:List.of("iron","copper","redstone","lapis","diamond","emerald","ruby","sapphire","gold")){
+        String ns=name.equals("ruby")||name.equals("sapphire")?"sanctuary:":"minecraft:";result.add(ns+name+"_ore");result.add(ns+"deepslate_"+name+"_ore");}
+        result.add("minecraft:nether_quartz_ore");result.add("minecraft:nether_gold_ore");return List.copyOf(result);}
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);analyseTextures();VanillaLight.setSaturation(100);VanillaLight.setPixelShadows(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);});
+        server.runOnServer(s->{command(s,"time set 18000");
+            for(int x=4;x<=20;x++)for(int z=4;z<=20;z++){
+                s.overworld().setBlockAndUpdate(new BlockPos(x,64,z),Blocks.CONCRETE.black().defaultBlockState());
+                for(int y=65;y<=70;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),Blocks.AIR.defaultBlockState());
+            }
+            for(int i=0;i<ORES.size();i++){var state=BuiltInRegistries.BLOCK.getValue(Identifier.parse(ORES.get(i))).defaultBlockState();check(state.getLightEmission()==0,"Ores do not acquire server-side light: "+ORES.get(i));s.overworld().setBlockAndUpdate(orePos(i),state);}
+            s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.REDSTONE_LAMP.defaultBlockState());
+        });
+        camera(c,server,10.5,71,9.5,60);c.waitTicks(40);c.waitFor(m->m.levelRenderer.hasRenderedAllSections(),1200);
+        var off=capture(c,"bloom-ores-off");
+        c.runOnClient(m->{VanillaLight.setOreEmission(false);VanillaLight.setBloom(true);});frames(c);
+        check(luminous(emission(c))==0,"White/grey rock, ordinary surfaces and unlit lamps do not seed bloom");
+        unchanged(off,capture(c,"bloom-ores-disabled"),"Disabling ore emission leaves the original scene intact");
+        c.runOnClient(m->{VanillaLight.setOreEmission(true);VanillaLight.setOreIntensity(100);});frames(c);
+        var source=emission(c);int orePixels=luminous(source);check(orePixels>100,"Actual exposed ore inclusions enter the GPU mask: "+orePixels);
+        var on=capture(c,"bloom-ores-on");double oreGain=gain(off,on,null);check(oreGain>1000,"Ores visibly glow in the native night scene: "+oreGain);
+        c.runOnClient(m->VanillaLight.setBloom(false));frames(c);
+        var coreOnly=capture(c,"emissive-bloom-off");
+        check(gain(off,coreOnly,null)>1000,"Emissive cores survive bloom OFF");
+        check(gain(off,coreOnly,source)<1,"No halo outside source texels with bloom OFF");
+        c.runOnClient(m->check(!Bloom.haloAllocated(),"Bloom OFF frees blur targets and uniforms"));
+        c.runOnClient(m->{VanillaLight.setBloom(true);VanillaLight.setBloomIntensity(0);});frames(c);
+        unchanged(coreOnly,capture(c,"emissive-bloom-zero"),"Zero bloom matches OFF while retaining emissive cores");
+        c.runOnClient(m->check(!Bloom.haloAllocated(),"Zero bloom frees blur resources"));
+        c.runOnClient(m->VanillaLight.setOreEmission(false));c.waitTicks(8);
+        c.runOnClient(m->check(!Bloom.allocated()&&!Bloom.applied(),"Zero halo and disabled cores release everything"));
+        unchanged(off,capture(c,null),"Disabling both restores the original scene");
+        c.runOnClient(m->{VanillaLight.setOreEmission(true);VanillaLight.setBloomIntensity(35);});frames(c);
+        unchanged(on,capture(c,null),"Re-enabling bloom restores its original image");
+        c.runOnClient(m->VanillaLight.setBloomIntensity(10));frames(c);double low=gain(off,capture(c,null),source);
+        c.runOnClient(m->VanillaLight.setBloomIntensity(90));frames(c);double high=gain(off,capture(c,"bloom-strength-90"),source);
+        check(high>Math.max(30,low*2),"Bloom strength changes the halo outside source pixels: low="+low+" high="+high);
+        c.runOnClient(m->VanillaLight.setBloomRadius(0));frames(c);var tight=capture(c,"bloom-spread-0");
+        c.runOnClient(m->VanillaLight.setBloomRadius(100));frames(c);var wide=capture(c,"bloom-spread-100");
+        check(difference(tight,wide)>100,"Spread changes the real GPU halo");
+        c.runOnClient(m->VanillaLight.setOreIntensity(0));frames(c);check(luminous(emission(c))==0,"Zero ore strength suppresses both cores and halos");
+        unchanged(off,capture(c,null),"Zero ore strength restores the source image");
+        c.runOnClient(m->{VanillaLight.setOreIntensity(100);VanillaLight.setBloomIntensity(35);VanillaLight.setBloomRadius(50);});frames(c);
+        server.runOnServer(s->{for(int i=0;i<ORES.size();i++)s.overworld().setBlockAndUpdate(orePos(i).above(),Blocks.STONE.defaultBlockState());});c.waitTicks(25);frames(c);
+        check(luminous(emission(c))==0,"Covering veins with stone removes all emission: no through-wall ore glow");
+        capture(c,"bloom-covered-ores");
+        server.runOnServer(s->{for(int i=0;i<ORES.size();i++)s.overworld().setBlockAndUpdate(orePos(i).above(),Blocks.AIR.defaultBlockState());});c.waitTicks(25);frames(c);
+        check(luminous(emission(c))>100,"Removing covers reveals the genuine visible inclusion masks again");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();frames(c);
+        check(luminous(emission(c))>100,"Resource reload rebuilds emitter meshes and masks");
+        c.runOnClient(m->VanillaLight.setOreEmission(false));
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.TORCH.defaultBlockState()));c.waitTicks(25);frames(c);
+        int torch=luminous(emission(c));check(torch>3,"A native torch seeds bloom: "+torch);capture(c,"bloom-torch");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.GLOWSTONE.defaultBlockState()));c.waitTicks(25);frames(c);
+        check(luminous(emission(c))>torch,"A full luminous block contributes its real textured surface");capture(c,"bloom-glowstone");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.STONE.defaultBlockState()));c.waitTicks(25);frames(c);
+        check(luminous(emission(c))==0,"Replacing the light source removes its cached emission");
+        server.runOnServer(s->{s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.REDSTONE_LAMP.defaultBlockState());s.overworld().setBlockAndUpdate(new BlockPos(14,64,9),Blocks.REDSTONE_BLOCK.defaultBlockState());});
+        c.waitTicks(25);frames(c);check(luminous(emission(c))>10,"Powered lamp emits through its on-state texture");capture(c,"bloom-lamp-on");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(14,64,9),Blocks.CONCRETE.black().defaultBlockState()));
+        c.waitTicks(25);frames(c);check(luminous(emission(c))==0,"Unpowered lamp loses its glow after its native state update");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(14,65,9),Blocks.LAVA.defaultBlockState()));
+        c.waitTicks(25);frames(c);check(luminous(emission(c))>10,"Native visible lava seeds bloom");capture(c,"bloom-lava");
+        server.runOnServer(s->command(s,"time set 3000"));camera(c,server,10.5,90,9.5,70);
+        var direction=c.computeOnClient(m->PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle));
+        look(c,server,(float)Math.toDegrees(Math.atan2(-direction.x,direction.z)),-(float)Math.toDegrees(Math.asin(direction.y)));
+        c.runOnClient(m->VanillaLight.setBloom(false));c.waitTicks(8);var sunOff=capture(c,"bloom-sun-off");
+        c.runOnClient(m->VanillaLight.setBloom(true));frames(c);var sunMask=emission(c);
+        check(luminous(sunMask)>40,"The actual sun disc seeds bloom");
+        double sunlight=gain(sunOff,capture(c,"bloom-sun-on"),sunMask);check(sunlight>100,"Sun halo extends beyond its source disc: "+sunlight);
+        server.runOnServer(s->{var eye=s.getPlayerList().getPlayers().getFirst().getEyePosition();var center=BlockPos.containing(eye.x+direction.x*8,eye.y+direction.y*8,eye.z+direction.z*8);
+            for(int x=-4;x<=4;x++)for(int y=-4;y<=4;y++)for(int z=-4;z<=4;z++)s.overworld().setBlockAndUpdate(center.offset(x,y,z),Blocks.STONE.defaultBlockState());});
+        c.waitTicks(30);frames(c);check(luminous(emission(c))==0,"Solid terrain in front of the sun suppresses its bloom source");capture(c,"bloom-sun-occluded");
+        c.runOnClient(m->VanillaLight.setBloom(false));c.waitTicks(6);var coveredOff=capture(c,null);
+        c.runOnClient(m->{VanillaLight.setBloom(true);VanillaLight.setBloomIntensity(0);});c.waitTicks(6);c.runOnClient(m->check(!Bloom.applied()&&!Bloom.allocated(),"Zero bloom releases GPU resources"));
+        unchanged(coveredOff,capture(c,null),"Zero bloom leaves no residual glow");
+        c.runOnClient(m->{VanillaLight.setBloomIntensity(35);VanillaLight.setBloom(false);VanillaLight.setOreEmission(true);VanillaLight.setOreIntensity(50);});
+        System.out.println("EMISSIVE131_PASS independent cores with halo OFF/zero; blur resources released; defaults; masks for 20 ore textures; selective night glow; halo intensity/spread; no through-wall glow; live edits; torch/glowstone/lamp/lava/sun; resource reload; defaults/migration; orePixels="+orePixels+" oreGain="+oreGain+" haloLow="+low+" haloHigh="+high+" sunHalo="+sunlight);
+        LensFlare136ClientChecks.run(c,server);
+    }
+    private static BlockPos orePos(int i){return new BlockPos(8+i%5,65,8+i/5);}
+    private static void preferences(){try{
+        var path=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.deleteIfExists(path);forgetPreferences();
+        check(VanillaLight.pixelShadows()&&VanillaLight.shadowDistance()==128&&VanillaLight.shadowPixels()==16&&VanillaLight.edgeDistance()==32,"Fresh requested defaults: shadows ON, 128; highlights 32; shared precision 16");
+        check(VanillaLight.bloom()&&VanillaLight.oreEmission()&&VanillaLight.edgeHighlights()&&VanillaLight.bloomIntensity()==20&&VanillaLight.bloomRadius()==50,"Bloom, ore emission and edge highlights default to ON");
+        Files.writeString(path,"{\"bloom\":false,\"oreEmission\":false,\"edgeHighlights\":false,\"pixelShadows\":false,\"shadowDistance\":64,\"shadowPixels\":8,\"edgeDistance\":16}");forgetPreferences();
+        check(!VanillaLight.bloom()&&!VanillaLight.oreEmission()&&!VanillaLight.edgeHighlights()&&!VanillaLight.pixelShadows()&&VanillaLight.shadowDistance()==64&&VanillaLight.shadowPixels()==8&&VanillaLight.edgeDistance()==16,"Existing user choices are retained");
+        for(int n:new int[]{-10,0,35,100,400}){VanillaLight.setBloomIntensity(n);VanillaLight.setBloomRadius(n);VanillaLight.setOreIntensity(n);forgetPreferences();check(VanillaLight.bloomIntensity()==Math.clamp(n,0,100)&&VanillaLight.bloomRadius()==Math.clamp(n,0,100)&&VanillaLight.oreIntensity()==Math.clamp(n,0,100),"Persisted bloom controls are bounded");}
+        VanillaLight.setBloomIntensity(35);VanillaLight.setBloomRadius(50);VanillaLight.setOreIntensity(50);VanillaLight.setShadowPixels(16);
+    }catch(java.io.IOException e){throw new AssertionError(e);}}
+    private static void analyseTextures(){
+        var report=new StringBuilder("texture,selected,total,neutral_rock_selected\n");
+        try(var materials=new BloomMaterials();var sheet=new NativeImage(5*16*6,4*32*6,false)){
+            sheet.fillRect(0,0,sheet.getWidth(),sheet.getHeight(),0xFF16191E);
+            for(int index=0;index<ORES.size();index++){
+                var block=Identifier.parse(ORES.get(index));var id=block.withPath("block/"+block.getPath());
+                try(var image=BloomMaterials.read(id)){
+                    int w=image.getWidth(),h=image.getHeight();int[] pixels=new int[w*h];for(int y=0;y<h;y++)for(int x=0;x<w;x++)pixels[y*w+x]=image.getPixel(x,y);
+                    var mask=materials.mask(id,pixels,w,h,true,false);int count=0,grey=0;
+                    for(int i=0;i<mask.length;i++){if(mask[i]>0){count++;int c=pixels[i],r=c>>16&255,g=c>>8&255,b=c&255;if(r==g&&g==b&&r<215)grey++;}}
+                    check(count>=4&&count<w*h*.7,"Texture has a selective inclusion mask: "+id+" "+count+"/"+mask.length);
+                    if(!id.getPath().contains("quartz"))check(grey==0,"Neutral host rock never emits: "+id);
+                    report.append(id).append(',').append(count).append(',').append(mask.length).append(',').append(grey).append('\n');
+                    for(int y=0;y<32*6;y++)for(int x=0;x<16*6;x++){
+                        int source=(y/6%16)*w/16*w+(x/6)*w/16;int color=pixels[source];if(y>=16*6&&mask[source]==0)color=0xFF16191E;
+                        sheet.setPixel((index%5)*16*6+x,(index/5)*32*6+y,color);
+                    }
+                }
+            }
+            var root=FabricLoader.getInstance().getGameDir();sheet.writeToFile(root.resolve("bloom130-ore-masks.png"));Files.writeString(root.resolve("bloom130-ore-masks.csv"),report.toString());
+            System.out.println("BLOOM130_MASKS\n"+report);
+        }catch(java.io.IOException e){throw new AssertionError(e);}
+    }
+    private static void frames(ClientGameTestContext c){int before=c.computeOnClient(m->Bloom.renderedFrames());c.waitFor(m->Bloom.applied()&&Bloom.ready()&&Bloom.renderedFrames()>before+10,1200);c.waitTicks(8);}
+    private static Frame emission(ClientGameTestContext c){var result=new CompletableFuture<Frame>();c.runOnClient(m->Screenshot.takeScreenshot(Bloom.emissionTarget(),image->{try(image){result.complete(new Frame(image.getWidth(),image.getHeight(),image.getPixels()));}}));c.waitFor(m->result.isDone(),200);return result.join();}
+    private static int luminous(Frame frame){int count=0;for(int color:frame.pixels())if((color&0xFFFFFF)!=0)count++;return count;}
+    private static double gain(Frame off,Frame on,Frame source){double result=0;for(int i=0;i<off.pixels().length;i++)if(source==null||(source.pixels()[i]&0xFFFFFF)==0)result+=Math.max(0,brightness(on.pixels()[i])-brightness(off.pixels()[i]));return result;}
+    private static int difference(Frame a,Frame b){int n=0;for(int i=0;i<a.pixels().length;i++)if(channelDifference(a.pixels()[i],b.pixels()[i])>3)n++;return n;}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/ColoredLights139ClientChecks.java

@@ -0,0 +1,86 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import java.nio.file.Files;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.world.level.block.Block;
+import net.minecraft.network.chat.Component;
+
+/** Fresh native world: offscreen sources, true voxel occlusion and real GPU tint. */
+public final class ColoredLights139ClientChecks implements FabricClientGameTest {
+    private static final BlockPos SOURCE=new BlockPos(98,101,102),PROBE=new BlockPos(99,101,106);
+    public void runTest(ClientGameTestContext c){
+        System.setProperty("sanctuary.test.freezeBlockFlicker","true");
+        try{new PixelShadows122ClientChecks(false,false,false,false,false,true).runTest(c);}
+        finally{System.clearProperty("sanctuary.test.freezeBlockFlicker");}
+    }
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setWarmTorches(true);m.options.particles().set(net.minecraft.server.level.ParticleStatus.MINIMAL);VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setLensFlare(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setPixelShadows(false);VanillaLight.setSunshafts(false);VanillaLight.setColoredLights(false);VanillaLight.setColoredLightIntensity(35);});
+        camera(c,server,100.5,101,104.5,70);c.waitTicks(30);
+        server.runOnServer(s->{command(s,"time set 18000");
+            for(int x=88;x<=112;x++)for(int z=92;z<=116;z++)for(int y=100;y<=109;y++)
+                s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),(y==100||y==109||x==88||x==112||z==92||z==116)?Blocks.CONCRETE.white().defaultBlockState():Blocks.AIR.defaultBlockState());
+        });
+        look(c,server,0,35);c.waitTicks(30);
+        c.waitFor(m->m.level.getBrightness(net.minecraft.world.level.LightLayer.SKY,PROBE)==0,1200);
+        long warm=0;
+        for(var block:new Block[]{Blocks.TORCH,Blocks.SOUL_TORCH,Blocks.PEARLESCENT_FROGLIGHT,Blocks.VERDANT_FROGLIGHT,Blocks.OCHRE_FROGLIGHT,Blocks.GLOWSTONE}){
+            source(c,server,block);enable(c,false);var off=capture(c,"colored-"+name(block)+"-off");enable(c,true);var on=capture(c,"colored-"+name(block)+"-35");
+            int color=c.computeOnClient(m->ColoredLights.sample(PROBE));long delta=difference(off,on);
+            check(delta>250,"Offscreen source visibly tints native surfaces: "+name(block)+" "+delta);
+            int r=color>>16&255,g=color>>8&255,b=color&255;
+            if(block==Blocks.TORCH){check(r>g&&g>b,"Torch is warm");warm=delta;}
+            if(block==Blocks.SOUL_TORCH)check(b>g&&g>r,"Soul source is blue");
+            if(block==Blocks.SOUL_TORCH)for(int step=1;step<=9;step++){
+                final int distance=step;int sample=c.computeOnClient(m->ColoredLights.sample(SOURCE.offset(distance,0,0)));
+                int sr=sample>>16&255,sg=sample>>8&255,sb=sample&255;
+                double rr=sr==0?0:Math.pow(.8,(sb-sr)/8.0),gg=sg==0?0:Math.pow(.8,(sb-sg)/8.0);
+                check(Math.abs(rr-85/255.)<.02&&Math.abs(gg-189/255.)<.02,"Blue hue remains consistent at native distance "+step+" "+rr+" / "+gg);
+            }
+            if(block==Blocks.VERDANT_FROGLIGHT)check(g>r&&g>b,"Verdant froglight is green");
+            if(block==Blocks.PEARLESCENT_FROGLIGHT)check(r>g&&b>g,"Pearlescent froglight is pink");
+            if(block==Blocks.OCHRE_FROGLIGHT)check(r>g&&g>b,"Ochre froglight is warm");
+            if(block==Blocks.GLOWSTONE)check(r>b,"Other emitters derive their colour from the native texture");
+            System.out.println("COLORED139_SOURCE "+name(block)+" sample="+Integer.toHexString(color)+" delta="+delta);
+        }
+        source(c,server,Blocks.TORCH);enable(c,false);var base=capture(c,null);enable(c,true);var low=capture(c,null);
+        c.runOnClient(m->VanillaLight.setColoredLightIntensity(100));settle(c);var strong=capture(c,"colored-torch-100");check(difference(base,strong)>difference(base,low)*1.5,"Intensity increases colour, without changing native light");
+        int builds=c.computeOnClient(m->ColoredLights.builds());c.waitTicks(25);check(c.computeOnClient(m->ColoredLights.builds())==builds,"Stationary volume is cached");unchanged(strong,capture(c,null),"Static light is stable");
+        camera(c,server,104.5,101,104.5,70);look(c,server,0,35);settle(c);capture(c,"colored-moved");
+        camera(c,server,100.5,101,104.5,70);look(c,server,0,35);settle(c);unchanged(strong,capture(c,"colored-returned"),"Moving and returning preserves world-anchored light");
+        // A complete divider closes the room; light may not take a path around its edges.
+        server.runOnServer(s->{for(int y=101;y<109;y++)for(int z=93;z<116;z++)s.overworld().setBlockAndUpdate(new BlockPos(99,y,z),Blocks.STONE.defaultBlockState());});c.waitTicks(35);settle(c);
+        check((c.computeOnClient(m->ColoredLights.sample(new BlockPos(100,101,106)))&0xffffff)==0,"Opaque wall blocks colour propagation");
+        enable(c,false);var sealedOff=capture(c,null);enable(c,true);unchanged(sealedOff,capture(c,"colored-sealed"),"No coloured light crosses a sealed wall");
+        server.runOnServer(s->{for(int y=101;y<109;y++)for(int z=93;z<116;z++)s.overworld().setBlockAndUpdate(new BlockPos(99,y,z),Blocks.AIR.defaultBlockState());});c.waitTicks(35);settle(c);
+        check((c.computeOnClient(m->ColoredLights.sample(PROBE))&0xffffff)!=0,"Opening the wall restores light");
+        server.runOnServer(s->{s.overworld().setBlockAndUpdate(SOURCE,Blocks.REDSTONE_LAMP.defaultBlockState());s.overworld().setBlockAndUpdate(SOURCE.below(),Blocks.REDSTONE_BLOCK.defaultBlockState());});c.waitTicks(35);settle(c);
+        int red=c.computeOnClient(m->ColoredLights.sample(PROBE));check((red>>16&255)>(red>>8&255)&& (red>>16&255)>(red&255),"Powered redstone source is red");capture(c,"colored-redstone-on");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(SOURCE.below(),Blocks.CONCRETE.white().defaultBlockState()));c.waitTicks(35);settle(c);
+        check((c.computeOnClient(m->ColoredLights.sample(PROBE))&0xffffff)==0,"Unpowered lamp removes cached coloured light");
+        source(c,server,Blocks.SOUL_TORCH);var beforeReload=capture(c,null);
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();settle(c);unchanged(beforeReload,capture(c,"colored-reloaded"),"Resource reload rebuilds materials and light field");
+        source(c,server,Blocks.AIR);check((c.computeOnClient(m->ColoredLights.sample(PROBE))&0xffffff)==0,"Removing the source clears its light");
+        source(c,server,Blocks.SOUL_TORCH);enable(c,false);var off=capture(c,null);c.runOnClient(m->{VanillaLight.setColoredLights(true);VanillaLight.setColoredLightIntensity(0);});c.waitTicks(10);
+        c.runOnClient(m->check(!ColoredLights.allocated(),"Zero releases volume and GPU resources"));unchanged(off,capture(c,null),"Zero is identical to OFF");
+        c.runOnClient(m->{for(String locale:new String[]{"fr_fr","en_us"}){m.getLanguageManager().setSelected(locale);m.getLanguageManager().onResourceManagerReload(m.getResourceManager());for(String key:new String[]{"colored_lights","colored_lights_help","colored_light_intensity","colored_light_intensity_help"}){String full="sanctuary.shaders."+key;check(!Component.translatable(full).getString().equals(full),"Translated "+locale+" "+full);}}});
+        c.runOnClient(m->{VanillaLight.setColoredLightIntensity(35);VanillaLight.setPbr(true);VanillaLight.setSsgi(true);VanillaLight.setBloom(true);VanillaLight.setBloomIntensity(20);VanillaLight.setEdgeHighlights(true);VanillaLight.setPixelShadows(true);VanillaLight.setSunshafts(true);VanillaLight.setLensFlare(true);VanillaLight.setOreEmission(true);});
+        settle(c);c.waitFor(m->ProceduralPbr.applied()&&Bloom.applied(),1200);c.waitTicks(30);capture(c,"colored-with-shader-effects");
+        System.out.println("COLORED139_PASS warm="+warm+" offscreen sources, hues, native textured materials, intensity, cache, camera, walls, lamp updates, removal, reload, zero/OFF and FR/EN");
+    }
+    private static String name(Block b){return net.minecraft.core.registries.BuiltInRegistries.BLOCK.getKey(b).getPath();}
+    private static void source(ClientGameTestContext c,TestServerContext s,Block b){s.runOnServer(server->server.overworld().setBlockAndUpdate(SOURCE,b.defaultBlockState()));c.waitTicks(35);if(c.computeOnClient(m->VanillaLight.coloredLights()))settle(c);}
+    private static void enable(ClientGameTestContext c,boolean value){c.runOnClient(m->VanillaLight.setColoredLights(value));if(value)settle(c);else c.waitTicks(8);}
+    private static void settle(ClientGameTestContext c){int before=c.computeOnClient(m->ColoredLights.renderedFrames());c.waitFor(m->ColoredLights.applied()&&ColoredLights.settled()&&ColoredLights.renderedFrames()>before+8,1600);c.waitTicks(8);}
+    private static long difference(Frame a,Frame b){long sum=0;for(int i=0;i<a.pixels().length;i++)sum+=channelDifference(a.pixels()[i],b.pixels()[i]);return sum;}
+    private static void preferences(){try{
+        var path=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.deleteIfExists(path);forgetPreferences();check(VanillaLight.coloredLights()&&VanillaLight.coloredLightIntensity()==30,"New defaults are enabled at 30 percent");
+        Files.writeString(path,"{\"bloomIntensity\":20,\"ssgi\":false}");forgetPreferences();check(VanillaLight.coloredLights()&&VanillaLight.coloredLightIntensity()==30&&!VanillaLight.ssgi()&&VanillaLight.bloomIntensity()==20,"Old preferences keep their choices");
+        for(int n:new int[]{-1,0,35,100,400}){VanillaLight.setColoredLights(true);VanillaLight.setColoredLightIntensity(n);forgetPreferences();check(VanillaLight.coloredLights()&&VanillaLight.coloredLightIntensity()==Math.clamp(n,0,100),"Bounded persistent controls");}
+    }catch(java.io.IOException e){throw new AssertionError(e);}}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/ColoredLights140ClientChecks.java

@@ -0,0 +1,59 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import fr.koka.sanctuary.client.DynamicLightClient;
+import fr.koka.sanctuary.inventory.*;
+import fr.koka.sanctuary.cosmetics.AccessoryService;
+import net.fabricmc.fabric.api.client.gametest.v1.context.*;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.entity.EquipmentSlot;
+import net.minecraft.world.item.*;
+import net.minecraft.world.level.block.*;
+import net.minecraft.network.chat.Component;
+
+final class ColoredLights140ClientChecks {
+    private static final BlockPos SOURCE=new BlockPos(98,101,102),PROBE=new BlockPos(99,101,106);
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setLensFlare(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setPixelShadows(false);VanillaLight.setSunshafts(false);VanillaLight.setColoredLightIntensity(30);VanillaLight.setWarmTorches(false);VanillaLight.setColoredLightDistance(16);});
+        source(c,server,Blocks.TORCH);enable(c,false);var nativeTorch=capture(c,"torch-native-off");enable(c,true);unchanged(nativeTorch,capture(c,"torch-native-on"),"Normal torch preserves vanilla colour");
+        c.runOnClient(m->VanillaLight.setWarmTorches(true));settle(c);var warm=capture(c,"torch-warm-30");long accent=difference(nativeTorch,warm);check(accent>2_025_577,"30 percent exceeds beta139 warm tint at 35 percent: "+accent);
+        c.runOnClient(m->VanillaLight.setWarmTorches(false));settle(c);unchanged(nativeTorch,capture(c,null),"Warm torch option can restore native tint");
+        for(String name:new String[]{"copper_torch","copper_lantern"}){
+            var copper=BuiltInRegistries.BLOCK.getValue(Identifier.parse("minecraft:"+name));check(copper!=Blocks.AIR&&copper.defaultBlockState().getLightEmission()>0,"Native copper source exists "+name);
+            source(c,server,copper);int value=c.computeOnClient(m->ColoredLights.sample(PROBE));check((value>>8&255)>(value>>16&255)&&(value>>8&255)>(value&255),"Copper emits green");capture(c,name+"-green");
+        }
+        server.runOnServer(s->{s.overworld().setBlockAndUpdate(SOURCE,Blocks.REDSTONE_LAMP.defaultBlockState());s.overworld().setBlockAndUpdate(SOURCE.below(),Blocks.REDSTONE_BLOCK.defaultBlockState());});c.waitTicks(40);settle(c);
+        int red=c.computeOnClient(m->ColoredLights.sample(PROBE));check(Math.pow(.8,((red>>16&255)-(red>>8&255))/8.)<.04,"Redstone uses saturated red");capture(c,"redstone-red-30");
+        source(c,server,Blocks.AIR);server.runOnServer(s->s.overworld().setBlockAndUpdate(SOURCE.below(),Blocks.CONCRETE.white().defaultBlockState()));
+        // Actual carried sources, synchronized through native equipment and accessory packets.
+        server.runOnServer(s->{command(s,"gamemode creative @a");var p=s.getPlayerList().getPlayers().getFirst();p.setItemSlot(EquipmentSlot.MAINHAND,new ItemStack(Items.SOUL_TORCH));});
+        c.waitFor(m->DynamicLightClient.snapshot(m.level).size()==1,200);c.waitTicks(45);enable(c,false);var carriedOff=capture(c,"held-soul-off");enable(c,true);c.waitTicks(25);var carriedOn=capture(c,"held-soul-blue");check(difference(carriedOff,carriedOn)>1000&&c.computeOnClient(m->ColoredLights.dynamicCount())==1,"Held soul torch is visibly blue");
+        c.runOnClient(m->{var l=DynamicLightClient.snapshot(m.level).sources().iterator().next();check((l.color()&255)>(l.color()>>16&255),"Dynamic source has actual blue colour");});
+        c.runOnClient(m->m.options.setCameraType(net.minecraft.client.CameraType.THIRD_PERSON_BACK));c.waitTicks(25);
+        c.runOnClient(m->{var pos=ColoredLights.dynamicPosition(m.player.getId());check(pos!=null&&pos.distanceToSqr(m.player.getEyePosition())<1,"Third-person light follows player, not camera");});capture(c,"held-third-person");
+        c.runOnClient(m->m.options.setCameraType(net.minecraft.client.CameraType.FIRST_PERSON));c.waitTicks(20);settle(c);
+        int builds=c.computeOnClient(m->ColoredLights.builds());
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();p.setItemSlot(EquipmentSlot.MAINHAND,ItemStack.EMPTY);p.setItemSlot(EquipmentSlot.OFFHAND,new ItemStack(Items.SOUL_TORCH));});c.waitTicks(35);settle(c);check(c.computeOnClient(m->ColoredLights.builds())==builds,"Moving a light between hands does not rebuild static volume");capture(c,"offhand-soul-blue");
+        var copperItem=BuiltInRegistries.ITEM.getValue(Identifier.parse("minecraft:copper_torch"));
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();p.setItemSlot(EquipmentSlot.OFFHAND,ItemStack.EMPTY);AccessoryAccess.of(p).setItem(AccessoryContainer.HEAD,new ItemStack(copperItem));AccessoryService.publish(p);});c.waitTicks(45);settle(c);
+        c.runOnClient(m->{var l=DynamicLightClient.snapshot(m.level).sources().iterator().next();check((l.color()>>8&255)>(l.color()>>16&255)&&(l.color()>>8&255)>(l.color()&255),"Head cosmetic carries copper green");});capture(c,"head-copper-green");check(c.computeOnClient(m->ColoredLights.builds())==builds,"Dynamic colour updates preserve static cache");
+        server.runOnServer(s->{var p=s.getPlayerList().getPlayers().getFirst();AccessoryAccess.of(p).setItem(AccessoryContainer.HEAD,ItemStack.EMPTY);AccessoryService.publish(p);});c.waitFor(m->DynamicLightClient.snapshot(m.level).size()==0&&ColoredLights.dynamicCount()==0,200);c.waitTicks(25);
+        server.runOnServer(s->command(s,"gamemode spectator @a"));
+        camera(c,server,100.5,108,104.5,70);look(c,server,0,18);c.waitTicks(25);
+        server.runOnServer(s->{for(int x=88;x<=112;x++)for(int z=117;z<=155;z++)s.overworld().setBlockAndUpdate(new BlockPos(x,100,z),Blocks.CONCRETE.white().defaultBlockState());
+            for(int x=88;x<=112;x++)for(int y=101;y<=109;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,116),Blocks.AIR.defaultBlockState());
+            s.overworld().setBlockAndUpdate(new BlockPos(100,101,140),Blocks.VERDANT_FROGLIGHT.defaultBlockState());});c.waitTicks(50);
+        c.runOnClient(m->VanillaLight.setColoredLightDistance(8));settle(c);var shortRange=capture(c,"distance-8");int small=c.computeOnClient(m->ColoredLights.volumeSide());check(c.computeOnClient(m->ColoredLights.sample(new BlockPos(100,101,141)))==0,"Far field omitted at short distance");
+        int before=c.computeOnClient(m->ColoredLights.builds());c.runOnClient(m->VanillaLight.setColoredLightDistance(64));c.waitFor(m->ColoredLights.builds()>before&&ColoredLights.blend()>0&&ColoredLights.blend()<1,1600);var transition=capture(c,"distance-fade");settle(c);var longRange=capture(c,"distance-64");
+        check(c.computeOnClient(m->ColoredLights.volumeSide())>small,"Distance changes actual field allocation");check((c.computeOnClient(m->ColoredLights.sample(new BlockPos(100,101,141)))&0xffffff)!=0,"Far light retained at long distance");check(difference(shortRange,longRange)>1000,"Far light is visibly rendered");check(difference(transition,longRange)>100&&difference(shortRange,transition)<difference(shortRange,longRange),"Transition is an intermediate rendered frame without overshoot");
+        for(int distance:new int[]{8,16,32,64}){c.runOnClient(m->{VanillaLight.setColoredLightDistance(distance);forgetPreferences();check(VanillaLight.coloredLightDistance()==distance,"Persisted distance "+distance);});settle(c);}
+        c.runOnClient(m->{for(String locale:new String[]{"fr_fr","en_us"}){m.getLanguageManager().setSelected(locale);m.getLanguageManager().onResourceManagerReload(m.getResourceManager());for(String key:new String[]{"warm_torches","warm_torches_help","colored_light_distance","colored_light_distance_help","colored_light_distance_value"}){String full="sanctuary.shaders."+key;check(!Component.translatable(full,16).getString().equals(full),"Translated "+locale+" "+key);}}});
+        System.out.println("COLORED140_PASS accent="+accent+" native/warm torches, copper green, saturated red, main/offhand/head, dynamic cache, 8/16/32/64 distance, fade and FR/EN");
+    }
+    private static void source(ClientGameTestContext c,TestServerContext s,Block b){s.runOnServer(server->server.overworld().setBlockAndUpdate(SOURCE,b.defaultBlockState()));c.waitTicks(35);settle(c);}
+    private static void enable(ClientGameTestContext c,boolean value){c.runOnClient(m->VanillaLight.setColoredLights(value));if(value)settle(c);else c.waitTicks(10);}
+    private static void settle(ClientGameTestContext c){c.waitFor(m->ColoredLights.applied()&&ColoredLights.settled(),2000);c.waitTicks(12);}
+    private static long difference(Frame a,Frame b){long total=0;for(int i=0;i<a.pixels().length;i++)total+=channelDifference(a.pixels()[i],b.pixels()[i]);return total;}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/EdgeHighlights129ClientChecks.java

@@ -0,0 +1,222 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+
+import java.nio.file.Files;
+import java.util.ArrayList;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import org.joml.Matrix4f;
+import org.joml.Vector4f;
+
+/** Native GPU checks sharing the isolated flat-world fixture and its preference backup. */
+final class EdgeHighlights129ClientChecks {
+    static void run(ClientGameTestContext c, TestServerContext server) {
+        c.runOnClient(m -> preferences());
+        server.runOnServer(s -> {
+            for (int x=10;x<=14;x++) for (int z=6;z<=10;z++) {
+                s.overworld().setBlockAndUpdate(new BlockPos(x,65,z),
+                        (Math.floorMod(x,8)<4 ? Blocks.STONE : Blocks.OAK_PLANKS).defaultBlockState());
+            }
+        });
+        camera(c,server,12.5,72,8.5,60);
+        c.waitTicks(35);
+        shadows(c,false);
+        edge(c,false);
+        var off=capture(c,"edges-flat-off");
+        c.waitTicks(6);
+        unchanged(off,capture(c,null),"Highlight OFF control is stable");
+        edge(c,true);
+        var on=capture(c,"edges-flat-on-30");
+        var low=measure(off,on);
+        check(low.brighter>100 && low.stable>low.samples*.55 && low.darker<low.samples*.005,
+                "Highlight brightens local strips, preserves face interiors: "+low);
+        grid(c,off,on);
+        c.runOnClient(m -> VanillaLight.setShadowPixels(8));frames(c);
+        var coarse=measure(off,capture(c,"edges-shared-precision-8"));
+        c.runOnClient(m -> VanillaLight.setShadowPixels(32));frames(c);
+        var fine=measure(off,capture(c,"edges-shared-precision-32"));
+        check(coarse.brighter()>low.brighter()*1.4 && fine.brighter()<low.brighter()*.8,
+                "One precision setting controls the visible highlight width: coarse="+coarse+" middle="+low+" fine="+fine);
+        for(int pixels:new int[]{64,128}){
+            c.runOnClient(m -> VanillaLight.setShadowPixels(pixels));frames(c);
+            var finer=measure(off,capture(c,"edges-shared-precision-"+pixels));
+            check(finer.meanGain()<fine.meanGain() && finer.darker()==0,"High precision refines CTM without darkening: "+pixels+" "+finer);
+        }
+        c.runOnClient(m -> VanillaLight.setShadowPixels(16));frames(c);
+
+        for (int distance : new int[]{16,32,64,128,256}) {
+            c.runOnClient(m -> VanillaLight.setEdgeDistance(distance));
+            frames(c);
+            check(c.computeOnClient(m -> VanillaLight.edgeDistance())==distance,"All CTM ranges are available");
+            unchanged(on,capture(c,null),"Near CTM contours unchanged at range "+distance);
+        }
+        c.runOnClient(m -> VanillaLight.setEdgeDistance(32));
+        c.runOnClient(m -> {
+            check(PixelShadows.shadowMap()==null,"Highlight works without allocating a cast-shadow map");
+            VanillaLight.setEdgeIntensity(90);
+        });
+        frames(c);
+        var high=measure(off,capture(c,"edges-flat-on-90"));
+        check(high.meanGain>low.meanGain*1.8,"Intensity changes visible brightness: low="+low+" high="+high);
+        c.runOnClient(m -> VanillaLight.setEdgeIntensity(0));
+        c.waitTicks(6);
+        c.runOnClient(m -> check(!EdgeHighlights.applied() && !EdgeHighlights.allocated(),"Zero intensity frees its uniform buffer"));
+        unchanged(off,capture(c,"edges-zero"),"Zero intensity reproduces OFF exactly");
+        c.runOnClient(m -> VanillaLight.setEdgeIntensity(30));
+        frames(c);
+        camera(c,server,11.99999,72,8.5,60);
+        var anchor=capture(c,null);
+        camera(c,server,12.00001,72,8.5,60);
+        unchanged(anchor,capture(c,"edges-anchor-crossing"),"Grid remains stable across an integer camera anchor");
+        camera(c,server,12.5,72,8.5,60);
+        unchanged(on,capture(c,null),"Returning to the camera restores the same grid");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);
+        c.waitFor(m -> reload.isDone() && m.gui.overlay()==null,1200);
+        reload.join();
+        c.runOnClient(m -> {
+            forgetPreferences();
+            check(VanillaLight.edgeHighlights() && VanillaLight.edgeIntensity()==30,"Highlight preferences survive reload and disk reread");
+        });
+        frames(c);
+        unchanged(on,capture(c,"edges-after-reload"),"Resource reload retains the highlight image");
+        edge(c,false);
+        unchanged(off,capture(c,"edges-off-restored"),"Disabling leaves no residual highlight");
+
+        // A new hole creates a connected boundary immediately; filling it removes that boundary.
+        server.runOnServer(s -> s.overworld().setBlockAndUpdate(new BlockPos(12,65,8),Blocks.AIR.defaultBlockState()));
+        c.waitTicks(20);
+        var holeOff=capture(c,null);
+        edge(c,true);
+        var hole=measure(holeOff,capture(c,"edges-ctm-hole"));
+        check(hole.brighter>low.brighter+20,"Removing an interior block creates a new CTM contour");
+        server.runOnServer(s -> s.overworld().setBlockAndUpdate(new BlockPos(12,65,8),Blocks.STONE.defaultBlockState()));
+        c.waitTicks(20);
+        unchanged(on,capture(c,null),"Filling the hole reconnects the flat surface");
+        // The actual radius gates a visible contour, independently of shadow range.
+        camera(c,server,12.5,88,8.5,30);
+        edge(c,false);
+        var farOff=capture(c,null);
+        c.runOnClient(m -> VanillaLight.setEdgeDistance(16));
+        edge(c,true);
+        unchanged(farOff,capture(c,"edges-beyond-16"),"CTM beyond selected 16-block radius is absent");
+        c.runOnClient(m -> {VanillaLight.setEdgeDistance(64);VanillaLight.setEdgeIntensity(90);});
+        frames(c);
+        var far=measure(farOff,capture(c,"edges-inside-64"));
+        check(far.brighter>40,"Extending the CTM radius restores a distant contour: "+far);
+        c.runOnClient(m -> {VanillaLight.setEdgeDistance(32);VanillaLight.setEdgeIntensity(30);});
+        edge(c,false);
+
+        server.runOnServer(s -> {
+            for (int x=9;x<=13;x+=2) for(int y=65;y<=67;y++)
+                s.overworld().setBlockAndUpdate(new BlockPos(x,y,12),
+                        (x==9 ? Blocks.CONCRETE.red() : x==11 ? Blocks.STONE_BRICKS : Blocks.OAK_PLANKS).defaultBlockState());
+            s.overworld().setBlockAndUpdate(new BlockPos(10,65,11),Blocks.STONE_SLAB.defaultBlockState());
+            s.overworld().setBlockAndUpdate(new BlockPos(12,65,11),Blocks.OAK_STAIRS.defaultBlockState());
+        });
+        camera(c,server,12.5,72,7.5,70);
+        look(c,server,15,55);
+        shadows(c,true);
+        var reliefOff=capture(c,"edges-relief-with-shadows-off");
+        edge(c,true);
+        var reliefOn=capture(c,"edges-relief-with-shadows-on");
+        var relief=measure(reliefOff,reliefOn);
+        check(relief.brighter>100 && relief.stable>relief.samples*.5 && relief.darker<relief.samples*.01,
+                "Highlight composes with cast shadows and coloured textured blocks: "+relief);
+        look(c,server,15.00002f,55.00002f);
+        unchanged(reliefOn,capture(c,null),"Tiny oblique camera rotation keeps highlights stable");
+        c.runOnClient(m -> VanillaLight.setEnabled(false));
+        c.waitTicks(6);
+        c.runOnClient(m -> check(!EdgeHighlights.applied() && !EdgeHighlights.allocated(),"Main shader OFF also releases highlight resources"));
+        c.runOnClient(m -> VanillaLight.setEnabled(true));
+        frames(c);
+        edge(c,false);
+        System.out.println("EDGE_HIGHLIGHTS129_PASS connected contours and unchanged flat joins; independent shadows; intensity; zero/OFF release; "
+                +"camera anchors; oblique textured scene; resource reload; legacy preference migration; low="+low+" high="+high+" relief="+relief);
+    }
+
+    private static void preferences() {
+        var path=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");
+        try {
+            // Real prior-version JSON, without either new field. Preserve its existing settings.
+            Files.writeString(path,"{\"enabled\":true,\"saturation\":100,\"pixelShadows\":true,\"shadowPixels\":16,\"shadowDistance\":32}");
+            forgetPreferences();
+            check(VanillaLight.edgeHighlights() && VanillaLight.edgeIntensity()==30 && VanillaLight.edgeDistance()==32,"Missing preference uses the new highlight ON default at intensity 30");
+            check(VanillaLight.pixelShadows() && VanillaLight.saturation()==100,"Migration retains existing shader choices");
+            for(int value:new int[]{-100,0,30,100,1000}) {
+                VanillaLight.setEdgeIntensity(value);forgetPreferences();
+                check(VanillaLight.edgeIntensity()==Math.clamp(value,0,100),"Saved intensity is bounded");
+            }
+            for(int[] pair:new int[][]{{-1,16},{24,32},{48,64},{96,128},{192,256},{9999,256}}) {
+                VanillaLight.setEdgeDistance(pair[0]);forgetPreferences();
+                check(VanillaLight.edgeDistance()==pair[1],"Saved CTM distance is bounded and normalized");
+            }
+            VanillaLight.setEdgeDistance(32);
+            VanillaLight.setEdgeIntensity(30);
+            VanillaLight.setEdgeHighlights(true);forgetPreferences();
+            check(VanillaLight.edgeHighlights(),"Toggle persists independently");
+            VanillaLight.setEdgeHighlights(false);
+            VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);
+            VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);
+            VanillaLight.setPbr(false);VanillaLight.setSsgi(false);
+        } catch(java.io.IOException e) { throw new AssertionError(e); }
+    }
+
+    private static void edge(ClientGameTestContext c,boolean enabled) {
+        c.runOnClient(m -> VanillaLight.setEdgeHighlights(enabled));
+        if(enabled)frames(c);
+        else {
+            c.waitTicks(6);
+            c.runOnClient(m -> check(!EdgeHighlights.applied() && !EdgeHighlights.allocated(),"OFF frees resources"));
+        }
+    }
+
+    private static void frames(ClientGameTestContext c) {
+        int before=c.computeOnClient(m -> EdgeHighlights.renderedFrames());
+        c.waitFor(m -> EdgeHighlights.applied() && EdgeHighlights.renderedFrames()>before+8,200);
+        c.waitTicks(6);
+    }
+
+    private record Difference(int samples,int brighter,int stable,int darker,double meanGain) { }
+    private static Difference measure(Frame off,Frame on) {
+        int samples=0,brighter=0,stable=0,darker=0;double gain=0;
+        for(int y=off.height()/10;y<off.height()*9/10;y+=2) for(int x=off.width()/10;x<off.width()*9/10;x+=2) {
+            int i=y*off.width()+x,a=off.pixels()[i],b=on.pixels()[i];
+            int delta=brightness(b)-brightness(a);samples++;gain+=delta;
+            if(delta>=4)brighter++;
+            if(delta<=-4)darker++;
+            if(channelDifference(a,b)<=2)stable++;
+        }
+        var result=new Difference(samples,brighter,stable,darker,gain/samples);
+        System.out.println("EDGE_HIGHLIGHTS129_PIXELS "+result);
+        return result;
+    }
+
+    private static void grid(ClientGameTestContext c,Frame off,Frame on) {
+        var samples=c.computeOnClient(m -> {
+            var camera=m.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+            var vp=new Matrix4f(camera.projectionMatrix).mul(camera.viewRotationMatrix);
+            var result=new ArrayList<int[]>();
+            for(int x=11;x<=14;x++) for(int z=6;z<=10;z++) for(int edge=0;edge<2;edge++) {
+                var p=vp.transform(new Vector4f((float)(x+(edge==0?.5:1.0/32)-camera.pos.x),
+                        (float)(66-camera.pos.y),(float)(z+.5-camera.pos.z),1));
+                int px=(int)((p.x/p.w*.5+.5)*off.width());
+                int py=(int)((.5-p.y/p.w*.5)*off.height());
+                if(px>=10 && px<off.width()-10 && py>=10 && py<off.height()-10)result.add(new int[]{py*off.width()+px,edge});
+            }
+            return result;
+        });
+        int centers=0,unchanged=0,edges=0,bright=0;
+        for(var sample:samples) {
+            int a=off.pixels()[sample[0]],b=on.pixels()[sample[0]];
+            if(sample[1]==0){centers++;if(channelDifference(a,b)<=2)unchanged++;}
+            else {edges++;if(brightness(b)-brightness(a)>=4)bright++;}
+        }
+        check(centers>=15 && unchanged>centers*.95 && edges>=15 && bright==0,
+                "Connected block centers and coplanar joins remain untouched: centers="+unchanged+"/"+centers+" edges="+bright+"/"+edges);
+        System.out.println("EDGE_HIGHLIGHTS129_GRID centers="+unchanged+"/"+centers+" edges="+bright+"/"+edges);
+    }
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/LensFlare136ClientChecks.java

@@ -0,0 +1,70 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import java.nio.file.Files;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.network.chat.Component;
+
+/** Native sky image, not a generated mockup; explicit independent effect controls. */
+final class LensFlare136ClientChecks {
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setPixelShadows(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);});
+        server.runOnServer(s->{command(s,"time add 1");command(s,"time set 3000");});
+        camera(c,server,100.5,130,100.5,70);aim(c,server,false);
+        var off=capture(c,"flare-sun-off");enable(c,true);var on=capture(c,"flare-sun-30");
+        long low=gain(off,on);check(low>1000,"Default sun flare is visible: "+low);
+        c.runOnClient(m->check(!Bloom.haloAllocated()&&Bloom.flareAllocated(),"Flare runs without bloom blur targets"));
+        unchanged(on,capture(c,null),"Static rectangular flare has no animated noise");
+        c.runOnClient(m->VanillaLight.setLensFlareIntensity(80));frames(c);var high=capture(c,"flare-sun-80");
+        check(gain(off,high)>low*1.5,"Flare intensity changes native pixels");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();frames(c);
+        unchanged(high,capture(c,"flare-reloaded"),"Flare recovers after resource reload");
+        int width=c.computeOnClient(m->m.getWindow().getScreenWidth()),height=c.computeOnClient(m->m.getWindow().getScreenHeight());
+        c.runOnClient(m->m.getWindow().setWindowed(961,541));c.waitFor(m->m.gameRenderer.mainRenderTarget().width!=off.width(),200);frames(c);
+        enable(c,false);var smallOff=capture(c,null);enable(c,true);check(gain(smallOff,capture(c,"flare-resized"))>1000,"Flare survives odd-sized targets");
+        c.runOnClient(m->m.getWindow().setWindowed(width,height));c.waitFor(m->m.gameRenderer.mainRenderTarget().width==off.width(),200);frames(c);
+        var direction=c.computeOnClient(m->PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle));
+        var eye=c.computeOnClient(m->m.player.getEyePosition());var center=BlockPos.containing(eye.x+direction.x*8,eye.y+direction.y*8,eye.z+direction.z*8);
+        cover(server,center,true);c.waitTicks(35);frames(c);var hiddenOn=capture(c,"flare-sun-covered");enable(c,false);
+        unchanged(hiddenOn,capture(c,null),"Occluded sun produces no rectangular flare through a wall");
+        cover(server,center,false);c.waitTicks(35);aim(c,server,false);
+        c.runOnClient(m->{VanillaLight.setBloom(true);VanillaLight.setBloomIntensity(20);VanillaLight.setLensFlareIntensity(30);});enable(c,true);capture(c,"flare-bloom-combined");
+        c.runOnClient(m->VanillaLight.setBloom(false));look(c,server,0,80);enable(c,false);var away=capture(c,null);enable(c,true);unchanged(away,capture(c,"flare-away"),"Behind-camera celestial sources produce no reflected screen edge");
+        server.runOnServer(s->s.overworld().setBlockAndUpdate(new BlockPos(100,129,104),Blocks.GLOWSTONE.defaultBlockState()));
+        look(c,server,0,35);c.waitTicks(25);enable(c,false);var lampOff=capture(c,null);enable(c,true);unchanged(lampOff,capture(c,"flare-glowstone-excluded"),"Visible glowstone does not create a celestial flare");
+        server.runOnServer(s->command(s,"time set 15000"));c.waitTicks(20);aim(c,server,true);
+        enable(c,false);var moonOff=capture(c,"flare-moon-off");enable(c,true);long moon=gain(moonOff,capture(c,"flare-moon-30"));
+        check(moon>200,"Native visible moon creates its own subtle flare: "+moon);
+        server.runOnServer(s->command(s,"time set 111000"));c.waitFor(m->m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.moonPhase.index()==4,200);aim(c,server,true);
+        enable(c,false);var newOff=capture(c,null);enable(c,true);check(gain(newOff,capture(c,"flare-new-moon"))<moon*.1,"Dark new moon does not retain full moon flare");
+        c.runOnClient(m->VanillaLight.setLensFlareIntensity(0));c.waitTicks(8);c.runOnClient(m->check(!Bloom.flareAllocated()&&!Bloom.allocated(),"Zero frees all resources with other effects OFF"));
+        unchanged(newOff,capture(c,null),"Zero flare restores source image");
+        c.runOnClient(m->{VanillaLight.setLensFlareIntensity(30);VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);});
+        for(String locale:new String[]{"fr_fr","en_us"})c.runOnClient(m->{
+            m.getLanguageManager().setSelected(locale);m.getLanguageManager().onResourceManagerReload(m.getResourceManager());
+            for(String suffix:new String[]{"lens_flare","lens_flare_help","lens_flare_intensity","lens_flare_intensity_help"}){
+                String key="sanctuary.shaders."+suffix;check(!Component.translatable(key).getString().equals(key),"Localized flare control: "+locale+" "+key);
+            }
+        });
+        System.out.println("LENS_FLARE136_PASS sunGain="+low+" moonGain="+moon+" visibility, resize, reload, strength, independent bloom, zero, preferences, FR/EN");
+    }
+    private static void cover(TestServerContext server,BlockPos center,boolean on){server.runOnServer(s->{for(int x=-4;x<=4;x++)for(int y=-4;y<=4;y++)for(int z=-4;z<=4;z++)s.overworld().setBlockAndUpdate(center.offset(x,y,z),on?Blocks.STONE.defaultBlockState():Blocks.AIR.defaultBlockState());});}
+    private static void aim(ClientGameTestContext c,TestServerContext server,boolean moon){
+        var direction=c.computeOnClient(m->PixelShadows.sunDirection(moon?m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.moonAngle:m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle));
+        look(c,server,net.minecraft.util.Mth.wrapDegrees((float)Math.toDegrees(Math.atan2(-direction.x,direction.z))+12),-(float)Math.toDegrees(Math.asin(direction.y))+8);
+    }
+    private static void frames(ClientGameTestContext c){int before=c.computeOnClient(m->Bloom.renderedFrames());c.waitFor(m->Bloom.applied()&&Bloom.ready()&&Bloom.renderedFrames()>before+10,1200);c.waitTicks(8);}
+    private static void enable(ClientGameTestContext c,boolean value){c.runOnClient(m->VanillaLight.setLensFlare(value));if(value)frames(c);else c.waitTicks(8);}
+    private static long gain(Frame off,Frame on){long sum=0;for(int i=0;i<off.pixels().length;i++)for(int shift:new int[]{0,8,16})sum+=Math.max(0,(on.pixels()[i]>>shift&255)-(off.pixels()[i]>>shift&255));return sum;}
+    private static void preferences(){try{
+        var path=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.writeString(path,"{\"bloom\":false,\"bloomIntensity\":20}");forgetPreferences();
+        check(VanillaLight.lensFlare()&&VanillaLight.lensFlareIntensity()==30&&!VanillaLight.bloom()&&VanillaLight.bloomIntensity()==20,"Flare defaults preserve bloom choices");
+        VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);VanillaLight.setLensFlareIntensity(73);forgetPreferences();check(!VanillaLight.lensFlare()&&VanillaLight.lensFlareIntensity()==73,"Saved custom flare retained");
+        for(int n:new int[]{-10,0,30,100,150}){VanillaLight.setLensFlareIntensity(n);forgetPreferences();check(VanillaLight.lensFlareIntensity()==Math.clamp(n,0,100),"Flare intensity persists and clamps");}
+        VanillaLight.setLensFlareIntensity(30);
+    }catch(java.io.IOException e){throw new AssertionError(e);}}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/Pbr134ClientChecks.java

@@ -0,0 +1,75 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import java.nio.file.Files;
+import java.util.Arrays;
+
+public final class Pbr134ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){new PixelShadows122ClientChecks(false,false,true).runTest(c);}
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);materials();VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setPixelShadows(false);});
+        server.runOnServer(s->{command(s,"time set 1000");for(int x=-5;x<=24;x++)for(int z=-5;z<=24;z++){
+            s.overworld().setBlockAndUpdate(new BlockPos(x,64,z),(x<10?Blocks.BRICKS:x<17?Blocks.OAK_PLANKS:Blocks.IRON_BLOCK).defaultBlockState());
+            for(int y=65;y<=102;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),Blocks.AIR.defaultBlockState());
+        }});
+        camera(c,server,10.5,69,5.5,65);look(c,server,0,40);settle(c);
+        // The preceding lava/mob fixture may leave animated particles after its blocks are removed.
+        c.runOnClient(m->m.particleEngine.clearParticles());c.waitTicks(2);
+        var off=capture(c,"pbr-off");enable(c,true);var on=capture(c,"pbr-50");
+        var delta=difference(off,on);System.out.println("PBR134_DIFF "+delta);check(delta.changed>500&&delta.brighter>100&&delta.darker>100,"Texture relief has lit and shaded pixels: "+delta);
+        int analyses=c.computeOnClient(m->ProceduralPbr.analyses());c.waitTicks(20);
+        c.runOnClient(m->check(analyses==ProceduralPbr.analyses()&&ProceduralPbr.materialCount()>0,"Source textures are cached, not regenerated every frame"));
+        unchanged(on,capture(c,null),"Static PBR has no animated noise");
+        look(c,server,.00002f,40.00002f);frames(c);unchanged(on,capture(c,null),"PBR tiny camera motion");look(c,server,0,40);frames(c);
+        c.runOnClient(m->VanillaLight.setPbrIntensity(20));frames(c);var low=difference(off,capture(c,"pbr-20"));
+        check(delta.total>low.total*1.3,"PBR strength affects actual GPU output");
+        c.runOnClient(m->VanillaLight.setPbrIntensity(100));frames(c);var high=difference(off,capture(c,"pbr-100"));check(high.total>delta.total*1.2,"Strong PBR visibly increases relief");
+        c.runOnClient(m->VanillaLight.setPbrIntensity(0));c.waitTicks(8);unchanged(off,capture(c,null),"PBR zero restores native image");
+        c.runOnClient(m->check(!ProceduralPbr.allocated()&&ProceduralPbr.materialCount()==0,"Zero releases targets and material cache"));
+        c.runOnClient(m->VanillaLight.setPbrIntensity(50));frames(c);
+        server.runOnServer(s->command(s,"time set 11000"));settle(c);enable(c,false);var eveningOff=capture(c,null);enable(c,true);var eveningOn=capture(c,"pbr-evening");
+        int directions=0;for(int i=0;i<on.pixels().length;i++){int am=(on.pixels()[i]>>16&255)-(off.pixels()[i]>>16&255),pm=(eveningOn.pixels()[i]>>16&255)-(eveningOff.pixels()[i]>>16&255);if(Math.abs(am-pm)>5)directions++;}
+        check(directions>500,"Relief follows the moving sun: "+directions);
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();frames(c);unchanged(eveningOn,capture(c,"pbr-reloaded"),"Resource reload rebuilds consistent cached materials");
+        // Live geometry and light invalidation: an enclosing roof removes exposure to the sky.
+        server.runOnServer(s->{for(int x=-8;x<=28;x++)for(int z=-8;z<=28;z++)s.overworld().setBlockAndUpdate(new BlockPos(x,73,z),Blocks.STONE.defaultBlockState());});
+        settle(c);frames(c);var roofOn=capture(c,"pbr-roof-on");enable(c,false);var roofOff=capture(c,"pbr-roof-off");
+        unchanged(roofOff,roofOn,"Roof prevents outdoor highlights on enclosed floor");enable(c,true);
+        server.runOnServer(s->{for(int x=-8;x<=28;x++)for(int z=-8;z<=28;z++)s.overworld().setBlockAndUpdate(new BlockPos(x,73,z),Blocks.AIR.defaultBlockState());});
+        settle(c);frames(c);unchanged(eveningOn,capture(c,"pbr-roof-removed"),"Removing roof restores material light without stale meshes");
+        int oldWidth=c.computeOnClient(m->m.getWindow().getScreenWidth()),oldHeight=c.computeOnClient(m->m.getWindow().getScreenHeight());
+        c.runOnClient(m->m.getWindow().setWindowed(961,541));c.waitFor(m->m.gameRenderer.mainRenderTarget().width!=on.width(),200);frames(c);capture(c,"pbr-resized");
+        c.runOnClient(m->m.getWindow().setWindowed(oldWidth,oldHeight));c.waitFor(m->m.gameRenderer.mainRenderTarget().width==on.width(),200);frames(c);
+        c.runOnClient(m->{VanillaLight.setPixelShadows(true);VanillaLight.setSsgi(true);VanillaLight.setBloom(true);VanillaLight.setOreEmission(true);VanillaLight.setEdgeHighlights(true);});
+        c.waitFor(m->PixelShadows.applied()&&PixelShadows.ready()&&ScreenSpaceGI.applied()&&Bloom.applied()&&EdgeHighlights.applied()&&ProceduralPbr.applied(),1200);frames(c);capture(c,"pbr-combined");
+        c.runOnClient(m->VanillaLight.setEnabled(false));c.waitTicks(8);c.runOnClient(m->check(!ProceduralPbr.allocated()&&ProceduralPbr.materialCount()==0,"Global OFF releases PBR"));
+        c.runOnClient(m->{VanillaLight.setEnabled(true);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);});
+        System.out.println("PBR134_PASS normals; profiles; texture cache; directional lighting; intensity; OFF/zero; tiny camera; reload; resize; combined; default="+delta+" high="+high+" directional="+directions);
+    }
+    private static void materials(){
+        int[] flat=new int[16];Arrays.fill(flat,0xFF808080);var profile=PbrMaterials.profile("bricks");
+        for(int p:PbrMaterials.generate(flat,4,4,profile))check((p>>8&0xFFFF)==0x8080,"Flat source has neutral normal");
+        flat[5]=0xFFFFFFFF;var slope=PbrMaterials.generate(flat,4,4,profile);check((slope[4]>>16&255)<128&&(slope[6]>>16&255)>128,"Height gradients produce opposite normal slopes");
+        check(PbrMaterials.profile("iron_block").metal()>.8&&PbrMaterials.profile("iron_ore").metal()==0,"Metal block profile does not turn ore host rock into metal");
+        check(PbrMaterials.profile("oak_planks").roughness()>PbrMaterials.profile("polished_andesite").roughness(),"Wood remains rougher than polished stone");
+    }
+    private static void preferences(){try{
+        var p=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.writeString(p,"{\"ssgi\":true,\"ssgiIntensity\":35,\"bloom\":false}");forgetPreferences();
+        check(VanillaLight.pbr()&&VanillaLight.pbrIntensity()==50&&VanillaLight.ssgi()&&!VanillaLight.bloom(),"Missing PBR setting defaults ON while preserving explicit old choices");
+        for(int n:new int[]{-1,0,50,100,101}){VanillaLight.setPbr(true);VanillaLight.setPbrIntensity(n);forgetPreferences();check(VanillaLight.pbr()&&VanillaLight.pbrIntensity()==Math.clamp(n,0,100),"PBR preference persistence/clamp");}
+        VanillaLight.setPbrIntensity(50);
+    }catch(Exception e){throw new AssertionError(e);}}
+    private record Delta(int changed,int brighter,int darker,long total){}
+    private static Delta difference(Frame off,Frame on){int changed=0,bright=0,dark=0;long total=0;for(int i=0;i<off.pixels().length;i++){
+        int a=off.pixels()[i],b=on.pixels()[i],delta=(b>>16&255)-(a>>16&255);total+=Math.abs(delta);if(Math.abs(delta)>3)changed++;if(delta>3)bright++;if(delta< -3)dark++;
+    }return new Delta(changed,bright,dark,total);}
+    private static void settle(ClientGameTestContext c){c.waitTicks(35);c.waitFor(m->m.levelRenderer.hasRenderedAllSections(),1200);c.waitTicks(10);}
+    private static void enable(ClientGameTestContext c,boolean on){c.runOnClient(m->VanillaLight.setPbr(on));if(on)frames(c);else c.waitTicks(8);}
+    private static void frames(ClientGameTestContext c){int start=c.computeOnClient(m->ProceduralPbr.renderedFrames());c.waitFor(m->ProceduralPbr.applied()&&ProceduralPbr.ready()&&ProceduralPbr.renderedFrames()>start+10,1200);c.waitTicks(8);}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/PixelShadows122ClientChecks.java

@@ -0,0 +1,691 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.platform.InputConstants;
+import fr.koka.sanctuary.client.HelloWorldScreen;
+import fr.koka.sanctuary.client.IntroClient;
+import fr.koka.sanctuary.client.IntroSpawnFlash;
+import fr.koka.sanctuary.client.ProgressionClient;
+import fr.koka.sanctuary.gametest.Starter039TestSupport;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.atomic.AtomicBoolean;
+import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientTickEvents;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.client.CameraType;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.Screenshot;
+import net.minecraft.client.gui.components.Button;
+import net.minecraft.client.gui.screens.worldselection.WorldCreationUiState;
+import net.minecraft.client.input.KeyEvent;
+import net.minecraft.client.renderer.culling.Frustum;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.network.chat.Component;
+import net.minecraft.network.chat.contents.TranslatableContents;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.world.level.block.StairBlock;
+import net.minecraft.world.level.gamerules.GameRules;
+import net.minecraft.world.phys.AABB;
+import net.minecraft.world.phys.Vec3;
+
+/** Real terrain/depth-map checks on a new flat seed 122 world; GPU readback is test-only. */
+public final class PixelShadows122ClientChecks implements FabricClientGameTest {
+    private final boolean bloomOnly,ssgiOnly,pbrOnly,closeupOnly,sunshaftOnly,coloredOnly;
+    public PixelShadows122ClientChecks(){this(false);}
+    PixelShadows122ClientChecks(boolean bloomOnly){this(bloomOnly,false);}
+    PixelShadows122ClientChecks(boolean bloomOnly,boolean ssgiOnly){this(bloomOnly,ssgiOnly,false);}
+    PixelShadows122ClientChecks(boolean bloomOnly,boolean ssgiOnly,boolean pbrOnly){this(bloomOnly,ssgiOnly,pbrOnly,false);}
+    PixelShadows122ClientChecks(boolean bloomOnly,boolean ssgiOnly,boolean pbrOnly,boolean closeupOnly){this(bloomOnly,ssgiOnly,pbrOnly,closeupOnly,false);}
+    PixelShadows122ClientChecks(boolean bloomOnly,boolean ssgiOnly,boolean pbrOnly,boolean closeupOnly,boolean sunshaftOnly){this(bloomOnly,ssgiOnly,pbrOnly,closeupOnly,sunshaftOnly,false);}
+    PixelShadows122ClientChecks(boolean bloomOnly,boolean ssgiOnly,boolean pbrOnly,boolean closeupOnly,boolean sunshaftOnly,boolean coloredOnly){this.coloredOnly=coloredOnly;this.sunshaftOnly=sunshaftOnly;this.bloomOnly=bloomOnly;this.ssgiOnly=ssgiOnly;this.pbrOnly=pbrOnly;this.closeupOnly=closeupOnly;}
+    private static final int FLOOR = 64;
+    private static final AABB PILLAR = new AABB(0, FLOOR + 1, 0, 2, FLOOR + 9, 2);
+    private static final BlockPos SLAB = new BlockPos(5, FLOOR + 3, -5);
+    private static final BlockPos STAIR = new BlockPos(5, FLOOR + 3, 5);
+    private static final int DARK_DELTA = 8;
+
+    @Override
+    public void runTest(ClientGameTestContext c) {
+        c.runOnClient(m -> {
+            var info = com.mojang.blaze3d.systems.RenderSystem.getDevice().getDeviceInfo();
+            String expected = System.getProperty("sanctuary.test.graphicsBackend", "");
+            check(expected.isEmpty() || info.backendName().equalsIgnoreCase(expected),
+                    "Requested graphics backend must not silently fall back: " + expected + " / " + info.backendName());
+            System.out.println("SHADER139_BACKEND " + info.backendName() + " / " + info.name()
+                    + " / " + info.driverInfo() + " / zeroToOne=" + info.isZZeroToOne());
+        });
+        var path = FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");
+        final byte[] originalPreferences;
+        try {
+            originalPreferences = Files.exists(path) ? Files.readAllBytes(path) : null;
+        } catch (IOException e) {
+            throw new AssertionError("Cannot back up shader preferences", e);
+        }
+        var originalOptions = c.computeOnClient(Options::capture);
+        var onboarding = new AtomicBoolean(true);
+        ClientTickEvents.END_CLIENT_TICK.register(m -> {
+            if (onboarding.get() && m.gui.screen() instanceof HelloWorldScreen screen) {
+                // Public test support works across packages; enter through the native widgets.
+                IntroClient.setQuickTestIntro(true);
+                if (!screen.starterChoices().isEmpty()) Starter039TestSupport.selectFirst(screen);
+                screen.children().stream().filter(Button.class::isInstance).map(Button.class::cast)
+                        .filter(b -> b.getClass().getSimpleName().equals("ColorButton"))
+                        .findFirst().orElseThrow().onPress(enter());
+                screen.children().stream().filter(Button.class::isInstance).map(Button.class::cast)
+                        .filter(b -> b.getMessage().getContents() instanceof TranslatableContents t
+                                && t.getKey().equals("sanctuary.progression.enter"))
+                        .findFirst().orElseThrow().onPress(enter());
+                onboarding.set(false);
+            }
+        });
+        try {
+            c.runOnClient(m -> {
+                m.options.renderDistance().set(6);
+                m.options.simulationDistance().set(5);
+                m.options.bobView().set(false);
+                m.options.pauseOnLostFocus = false;
+                m.options.setCameraType(CameraType.FIRST_PERSON);
+                String transparency = System.getProperty("sanctuary.test.improvedTransparency");
+                if (transparency != null) m.options.improvedTransparency().set(Boolean.parseBoolean(transparency));
+                System.out.println("SHADER139_TRANSPARENCY " + m.options.improvedTransparency().get());
+                checkPreferences();
+            });
+            try (var world = c.worldBuilder().adjustSettings(s -> {
+                s.setName("PixelShadows122 " + UUID.randomUUID());
+                s.setSeed("122");
+                s.setAllowCommands(true);
+                s.setGameMode(WorldCreationUiState.SelectedGameMode.CREATIVE);
+                s.setWorldType(s.getNormalPresetList().stream().filter(e -> e.preset() != null
+                        && e.preset().getRegisteredName().equals("sanctuary_test:flat"))
+                        .findFirst().orElseThrow());
+            }).create()) {
+                world.getConnection().waitForChunksDownload(2400);
+                c.waitFor(m -> m.player != null && ProgressionClient.active()
+                        && m.gui.screen() == null && !IntroSpawnFlash.active(), 1200);
+                c.getInput().pressKey(InputConstants.KEY_F1);
+                var server = world.getServer();
+                server.runOnServer(s -> {
+                    command(s, "sanctuary time vanilla");
+                    command(s, "sanctuary weather vanilla");
+                    command(s, "weather clear 100000");
+                    if (s.getGlobalGameRules().get(GameRules.ADVANCE_TIME))
+                        command(s, "gamerule " + GameRules.ADVANCE_TIME.id() + " false");
+                    check(!s.getGlobalGameRules().get(GameRules.ADVANCE_TIME), "Native daylight rule is frozen");
+                    command(s, "time set 3000");
+                    command(s, "gamemode spectator @a");
+                    if (s.getGlobalGameRules().get(GameRules.SPAWN_MOBS))
+                        command(s, "gamerule " + GameRules.SPAWN_MOBS.id() + " false");
+                    var level = s.overworld();
+                    var entities = new java.util.ArrayList<net.minecraft.world.entity.Entity>();
+                    level.getAllEntities().forEach(entities::add);
+                    entities.stream().filter(e -> !(e instanceof net.minecraft.server.level.ServerPlayer))
+                            .forEach(net.minecraft.world.entity.Entity::discard);
+                    // The elevated platform isolates the samples from grass, mobs and flat-world lighting.
+                    for (int x = -24; x <= 24; x++) for (int z = -24; z <= 24; z++) {
+                        level.setBlockAndUpdate(new BlockPos(x, FLOOR, z), Blocks.CONCRETE.white().defaultBlockState());
+                    }
+                    pillar(s, true);
+                    // Coloured casters cannot be mistaken for neutral white receiving ground.
+                    level.setBlockAndUpdate(SLAB, Blocks.RED_SANDSTONE_SLAB.defaultBlockState());
+                    level.setBlockAndUpdate(STAIR, Blocks.RED_SANDSTONE_STAIRS.defaultBlockState()
+                            .setValue(StairBlock.FACING, Direction.WEST));
+                });
+                camera(c, server, -2, FLOOR + 18, 1, 70);
+                c.waitFor(m -> m.level.getBlockState(new BlockPos(0, FLOOR + 8, 0)).is(Blocks.CONCRETE.red())
+                        && m.level.getBlockState(SLAB).is(Blocks.RED_SANDSTONE_SLAB)
+                        && m.level.getBlockState(STAIR).is(Blocks.RED_SANDSTONE_STAIRS), 200);
+                c.waitFor(m -> {
+                    for(int x=-24;x<=24;x+=8) for(int z=-24;z<=24;z+=8)
+                        if(!m.level.getBlockState(new BlockPos(x,FLOOR,z)).is(Blocks.CONCRETE.white()))return false;
+                    return m.levelRenderer.hasRenderedAllSections();
+                },1200);
+                c.waitTicks(40);
+                c.runOnClient(m -> check(VanillaLight.active(), "Native Sanctuary shader is active without an external engine"));
+                float morning = c.computeOnClient(m -> m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle);
+
+                if(coloredOnly){ColoredLights139ClientChecks.run(c,server);if(Boolean.getBoolean("sanctuary.test.colored140"))ColoredLights140ClientChecks.run(c,server);return;}
+                if(sunshaftOnly){Sunshafts137ClientChecks.run(c,server);return;}
+                if(closeupOnly){SsgiCloseup135ClientChecks.run(c,server);Pbr134ClientChecks.run(c,server);return;}
+                if(pbrOnly){Pbr134ClientChecks.run(c,server);return;}
+                if(ssgiOnly){Ssgi132ClientChecks.run(c,server);return;}
+                if(bloomOnly){Bloom130ClientChecks.run(c,server);return;}
+                // Keep VanillaLight enabled for both frames: changing its fog/grade would invalidate this oracle.
+                shadows(c, false);
+                var off = capture(c, "day-off");
+                c.waitTicks(6);
+                unchanged(off, capture(c, null), "Fixed camera/daylight OFF control");
+                shadows(c, true);
+                var on = capture(c, "day-on-pillar-slab-stair");
+                var day = compare(off, on);
+                localShadow(day, "Pillar/slab/stair daylight ground", .70);
+                c.runOnClient(m -> {
+                    check(Float.compare(morning, m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle) == 0,
+                            "Native rule actually freezes the rendered sun angle");
+                    check(PixelShadows.shadowMap() != null, "Daylight allocates a real shadow target");
+                    check(PixelShadows.shadowMap().width == PixelShadows.mapSize(32, 16), "Shadow map follows selected quality");
+                });
+                for (int pixels : new int[]{8, 32, 64, 128, 16}) {
+                    c.runOnClient(m -> VanillaLight.setShadowPixels(pixels));
+                    activeFrames(c);
+                    c.runOnClient(m -> check(PixelShadows.shadowMap().width == PixelShadows.mapSize(32, pixels),
+                            "Live pixel density reallocates the correct depth map"));
+                    capture(c, "precision-" + pixels);
+                }
+                for (int distance : new int[]{16, 64, 128, 256, 32}) {
+                    c.runOnClient(m -> VanillaLight.setShadowDistance(distance));
+                    activeFrames(c);
+                    c.runOnClient(m -> check(PixelShadows.shadowMap().width == PixelShadows.mapSize(distance, 16),
+                            "Live distance reallocates the correct depth map"));
+                }
+                shadows(c, false);
+                unchanged(off, capture(c, "day-off-restored"), "Disabling removes the shadow without residual grading");
+
+                // Aim at the shadow's far end, with its entire caster outside the actual camera frustum.
+                shadows(c, true);
+                double shadowX = c.computeOnClient(m -> {
+                    var sun = PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle);
+                    check(sun.y > .2f && Math.abs(sun.x / sun.y) > .5f, "Morning has an oblique sun for offscreen casting");
+                    return 1.0 - 7.0 * sun.x / sun.y;
+                });
+                camera(c, server, shadowX, FLOOR + 5, 1, 30);
+                c.runOnClient(m -> {
+                    var state = m.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+                    var frustum = new Frustum(state.viewRotationMatrix, state.projectionMatrix);
+                    frustum.prepare(state.pos.x, state.pos.y, state.pos.z);
+                    check(!frustum.isVisible(PILLAR), "Whole pillar is outside the receiver camera frustum");
+                    check(!frustum.isVisible(new AABB(SLAB)) && !frustum.isVisible(new AABB(STAIR)),
+                            "Slab and stair are also outside the offscreen capture");
+                });
+                shadows(c, false);
+                var offscreenOff = capture(c, "offscreen-off");
+                shadows(c, true);
+                var offscreenOn = capture(c, "offscreen-on");
+                localShadow(compare(offscreenOff, offscreenOn), "Offscreen pillar still casts onto visible ground", .20);
+
+                // Do not toggle/release/rebuild the renderer here: real server edits must invalidate its live cache.
+                server.runOnServer(s -> pillar(s, false));
+                c.waitFor(m -> m.level.getBlockState(new BlockPos(0, FLOOR + 8, 0)).isAir(), 200);
+                activeFrames(c);
+                var removed = capture(c, "offscreen-caster-removed");
+                restoredGround(offscreenOff, offscreenOn, removed);
+                server.runOnServer(s -> pillar(s, true));
+                c.waitFor(m -> m.level.getBlockState(new BlockPos(0, FLOOR + 8, 0)).is(Blocks.CONCRETE.red()), 200);
+                activeFrames(c);
+                var replaced = capture(c, "offscreen-caster-replaced");
+                localShadow(compare(offscreenOff, replaced), "Replacing caster restores its shadow", .20);
+                unchanged(offscreenOn, replaced, "Same caster restores the same ground shadow");
+
+                // beta.128: the moon now casts a weaker shadow using its native celestial angle.
+                server.runOnServer(s -> command(s, "time set 15000"));
+                c.waitFor(m -> PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle).y < 0, 200);
+                camera(c, server, -2, FLOOR + 18, 1, 70);
+                shadows(c, false);
+                var moonOff = capture(c, "moon-off");
+                shadows(c, true);
+                var moonOn = capture(c, "moon-on");
+                var moonStats = opacity(moonOff, moonOn);
+                check(moonStats.dark > 100 && moonStats.maximum > .025 && moonStats.maximum < .14,
+                        "Moon creates localized subtle shadows: " + moonStats);
+                unchanged(moonOn, capture(c, null), "Frozen moon shadow is stable");
+                server.runOnServer(s -> command(s, "time set 111000"));
+                c.waitFor(m -> m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.moonPhase.index() == 4
+                        && !PixelShadows.applied(), 200);
+                c.waitTicks(6);
+                int newMoonFrames = c.computeOnClient(m -> PixelShadows.renderedFrames());
+                c.waitTicks(6);
+                c.runOnClient(m -> check(PixelShadows.renderedFrames() == newMoonFrames, "New moon submits no shadow pass"));
+                noonAndFoliage(c, server);
+
+                c.waitFor(m -> PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle).y > .2f,
+                        200);
+                shadows(c, true);
+                camera(c, server, -2, FLOOR + 18, 1, 70);
+                c.waitTicks(30);
+                var beforeReload = capture(c, "before-reload");
+                var reload = c.computeOnClient(Minecraft::reloadResourcePacks);
+                c.waitFor(m -> reload.isDone() && m.gui.overlay() == null, 1200);
+                reload.join();
+                c.runOnClient(m -> {
+                    forgetPreferences();
+                    check(VanillaLight.enabled() && VanillaLight.pixelShadows()
+                            && VanillaLight.shadowPixels() == 16 && VanillaLight.shadowDistance() == 32,
+                            "Resource reload and disk reread retain enabled shadow preferences");
+                });
+                activeFrames(c);
+                unchanged(beforeReload, capture(c, "after-reload"), "Resource reload preserves the rendered ground shadow");
+                RealtimeShadows129ClientChecks.run(c, server);
+                EdgeHighlights129ClientChecks.run(c, server);
+                Bloom130ClientChecks.run(c, server);
+                Ssgi132ClientChecks.run(c, server);
+                Pbr134ClientChecks.run(c, server);
+                c.getInput().pressKey(InputConstants.KEY_F1);
+                for (String locale : new String[]{"fr_fr", "en_us"}) {
+                    c.runOnClient(m -> {
+                        m.getLanguageManager().setSelected(locale);
+                        m.getLanguageManager().onResourceManagerReload(m.getResourceManager());
+                        for (String key : new String[]{"pixel_shadows", "shadow_pixels", "shadow_distance", "edge_highlights", "edge_intensity", "edge_distance", "precision", "ssgi", "ssgi_intensity", "bloom", "bloom_radius", "ore_emission"}) {
+                            String fullKey = "sanctuary.shaders." + key;
+                            check(!Component.translatable(fullKey).getString().equals(fullKey), "Translated " + locale + " " + key);
+                        }
+                        m.gui.setScreen(new ShaderOptionsScreen(null));
+                        widgets(m.gui.screen()).filter(net.minecraft.client.gui.components.CycleButton.class::isInstance)
+                                .map(net.minecraft.client.gui.components.AbstractWidget.class::cast).forEach(button -> {
+                                    check(m.font.width(button.getMessage()) < button.getWidth() - 8,
+                                            "Localized shader cycle fits: " + button.getMessage().getString());
+                                });
+                    });
+                    c.waitTicks(3);
+                    c.takeScreenshot("sanctuary-beta140-shader-options-" + locale);
+                }
+                c.runOnClient(m -> m.gui.setScreen(null));
+            }
+            System.out.println("PIXEL_SHADOWS122_CLIENT_PASS: bounded saved preferences; native GPU ON/OFF ground; "
+                    + "offscreen caster; live removal/replacement; subtle moon; full-strength noon; foliage density; camera stability; resource reload; FR/EN screenshots");
+        } finally {
+            onboarding.set(false);
+            c.runOnClient(m -> {
+                PixelShadows.release();
+                originalOptions.restore(m);
+                IntroClient.setQuickTestIntro(false);
+                try {
+                    if (originalPreferences == null) Files.deleteIfExists(path);
+                    else Files.write(path, originalPreferences);
+                } catch (IOException e) {
+                    throw new AssertionError("Cannot restore shader preferences", e);
+                } finally {
+                    forgetPreferences();
+                }
+            });
+        }
+    }
+
+    private static void noonAndFoliage(ClientGameTestContext c, TestServerContext server) {
+        // Overhead caster keeps a visible noon shadow while the camera sits below it.
+        server.runOnServer(s -> {
+            pillar(s, false);
+            s.overworld().setBlockAndUpdate(SLAB, Blocks.AIR.defaultBlockState());
+            s.overworld().setBlockAndUpdate(STAIR, Blocks.AIR.defaultBlockState());
+            canopy(s, 1, false, 3);
+            command(s, "time set 6000");
+        });
+        camera(c, server, .99999, FLOOR + 5, 1, 70);
+        c.waitTicks(30);
+        shadows(c, false);
+        var noonOff = capture(c, "noon-off");
+        shadows(c, true);
+        var noonOn = capture(c, "noon-on");
+        var noonStats = opacity(noonOff, noonOn);
+        crispEdge(noonOff, noonOn);
+        check(noonStats.dark > 100 && noonStats.maximum > .34 && noonStats.maximum < .42,
+                "Noon shadow keeps its full daytime strength: " + noonStats);
+        camera(c, server, 1.00001, FLOOR + 5, 1, 70);
+        unchanged(noonOn, capture(c, "noon-camera-subpixel"), "Noon tiny motion across former integer anchor");
+        camera(c, server, .99999, FLOOR + 5, 1, 70);
+        unchanged(noonOn, capture(c, null), "Noon camera return");
+        look(c, server, 35, 60);
+        shadows(c, false);
+        var obliqueOff = capture(c, "noon-oblique-off");
+        shadows(c, true);
+        var obliqueNoon = capture(c, "noon-oblique");
+        localShadow(compare(obliqueOff, obliqueNoon), "Oblique noon camera sees actual white receiving ground", .10);
+        look(c, server, 35.00002f, 60.00002f);
+        unchanged(obliqueNoon, capture(c, null), "Subpixel rotation with an oblique receiver");
+        // Both sides of noon, frozen individually: no frame-to-frame edge flicker.
+        for (int time : new int[]{5990, 6010}) {
+            server.runOnServer(s -> command(s, "time set " + time));
+            c.waitTicks(10);
+            var stable = capture(c, "noon-" + time);
+            c.waitTicks(10);
+            unchanged(stable, capture(c, null), "Frozen near-noon " + time);
+        }
+        server.runOnServer(s -> command(s, "time set 5999"));
+        c.waitTicks(10);
+        var beforeNoon = capture(c, null);
+        server.runOnServer(s -> command(s, "time set 6001"));
+        c.waitTicks(10);
+        unchanged(beforeNoon, capture(c, "noon-crossing"), "Continuous passage through noon has no large flip");
+        server.runOnServer(s -> {
+            canopy(s, 1, true, 16);
+            command(s, "time set 3000");
+        });
+        camera(c, server, 0, FLOOR + 5, 0, 60);
+        c.waitTicks(30);
+        shadows(c, false);
+        var thinOff = capture(c, "leaves-thin-off");
+        shadows(c, true);
+        var thinOn = capture(c, "leaves-thin-on");
+        var thin = opacity(thinOff, thinOn);
+        c.waitTicks(8);
+        unchanged(thinOn, capture(c, null), "Leaf noise is independent of frame/time");
+        // Keep the live cache: adding inner leaf layers must invalidate it too.
+        server.runOnServer(s -> canopy(s, 4, true, 16));
+        c.waitTicks(30);
+        activeFrames(c);
+        var thickOn = capture(c, "leaves-thick-on");
+        shadows(c, false);
+        var thickOff = capture(c, "leaves-thick-off");
+        var thick = opacity(thickOff, thickOn);
+        server.runOnServer(s -> canopy(s, 4, false, 16));
+        c.waitTicks(30);
+        var solidOff = capture(c, "canopy-solid-off");
+        shadows(c, true);
+        var solid = opacity(solidOff, capture(c, "canopy-solid-on"));
+        check(thin.mean > .02 && thick.mean > thin.mean + .025 && solid.mean > thick.mean + .01,
+                "Depth increases foliage opacity, bounded by solid: thin=" + thin + " thick=" + thick + " solid=" + solid);
+        check(thin.dark > 100 && thin.lit > 100, "Thin foliage has both light holes and shadows: " + thin);
+        server.runOnServer(s -> {
+            for (int x=-16;x<=16;x++) for(int z=-16;z<=16;z++) for(int y=FLOOR+10;y<FLOOR+13;y++)
+                s.overworld().setBlockAndUpdate(new BlockPos(x,y,z), Blocks.AIR.defaultBlockState());
+            canopy(s, 1, true, 16);
+        });
+        c.waitTicks(30);
+        // Crossing a 16-block origin boundary must preserve the same world shadow.
+        camera(c, server, 7.99999, FLOOR + 5, 0, 60);
+        activeFrames(c);
+        var boundary = capture(c, null);
+        camera(c, server, 8.00001, FLOOR + 5, 0, 60);
+        activeFrames(c);
+        unchanged(boundary, capture(c, "anchor-boundary"), "Subpixel motion across 16-block anchor");
+        System.out.println("SHADOWS128_PASS moon/noon plus stable anchors; foliage thin=" + thin + " thick=" + thick + " solid=" + solid);
+        server.runOnServer(s -> {
+            for (int x=-16;x<=16;x++) for(int z=-16;z<=16;z++) for(int y=FLOOR+9;y<FLOOR+13;y++)
+                s.overworld().setBlockAndUpdate(new BlockPos(x,y,z), Blocks.AIR.defaultBlockState());
+            pillar(s, true);
+        });
+    }
+
+    private static void canopy(MinecraftServer s, int layers, boolean leaves, int radius) {
+        var state = leaves ? Blocks.OAK_LEAVES.defaultBlockState().setValue(net.minecraft.world.level.block.LeavesBlock.PERSISTENT, true)
+                : Blocks.CONCRETE.red().defaultBlockState();
+        for (int x=-radius;x<=radius;x++) for(int z=-radius;z<=radius;z++) for(int y=FLOOR+9;y<FLOOR+9+layers;y++)
+            s.overworld().setBlockAndUpdate(new BlockPos(x,y,z), state);
+    }
+
+    private static void crispEdge(Frame off, Frame on) {
+        int samples = 0, intermediate = 0;
+        for (int y=off.height/10;y<off.height*9/10;y+=2) for (int x=off.width/10;x<off.width*9/10;x+=2) {
+            int i=y*off.width+x;
+            if (!whiteGround(off.pixels[i])) continue;
+            samples++;
+            double ratio=(brightness(off.pixels[i])-brightness(on.pixels[i]))/(double)brightness(off.pixels[i]);
+            if (ratio > .015 && ratio < .32) intermediate++;
+        }
+        check(samples > 1000 && intermediate < samples / 200,
+                "Opaque noon edge stays crisp, no foliage smoothing: " + intermediate + "/" + samples);
+        System.out.println("SHADOWS128_CRISP intermediate=" + intermediate + "/" + samples);
+    }
+
+    private record Opacity(int samples, int dark, int lit, double mean, double maximum) { }
+    private static Opacity opacity(Frame off, Frame on) {
+        sameSize(off,on);
+        int samples=0,dark=0,lit=0;double sum=0,maximum=0;
+        for(int y=off.height/10;y<off.height*9/10;y+=2) for(int x=off.width/10;x<off.width*9/10;x+=2) {
+            int i=y*off.width+x,a=off.pixels[i],b=on.pixels[i];
+            int r=a>>16&255,g=a>>8&255,blue=a&255;
+            if(Math.min(r,Math.min(g,blue))<24 || Math.max(r,Math.max(g,blue))-Math.min(r,Math.min(g,blue))>64)continue;
+            double ratio=(brightness(a)-brightness(b))/(double)brightness(a);
+            samples++;sum+=ratio;maximum=Math.max(maximum,ratio);
+            if(ratio>.02)dark++;else if(Math.abs(ratio)<.01)lit++;
+        }
+        check(samples>1000,"White concrete (including blue moonlight) available for shadow opacity");
+        var result=new Opacity(samples,dark,lit,sum/samples,maximum);
+        System.out.println("SHADOWS128_OPACITY " + result);
+        return result;
+    }
+
+    private static java.util.stream.Stream<net.minecraft.client.gui.components.events.GuiEventListener> widgets(
+            net.minecraft.client.gui.components.events.ContainerEventHandler root) {
+        return root.children().stream().flatMap(widget -> widget instanceof net.minecraft.client.gui.components.events.ContainerEventHandler child
+                ? java.util.stream.Stream.concat(java.util.stream.Stream.of(widget), widgets(child)) : java.util.stream.Stream.of(widget));
+    }
+
+    private static void checkDefaults135() {
+        try {
+            var path=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");
+            Files.deleteIfExists(path);forgetPreferences();
+            check(VanillaLight.bloom()&&VanillaLight.bloomIntensity()==20&&VanillaLight.pbr()&&VanillaLight.ssgi(),"Fresh defaults: bloom20, PBR and SSGI ON");
+            check(VanillaLight.pbrIntensity()==50&&VanillaLight.ssgiIntensity()==35,"Existing effect strengths retained");
+            Files.writeString(path,"{\"pbr\":false,\"ssgi\":false,\"bloomIntensity\":73}");forgetPreferences();
+            check(!VanillaLight.pbr()&&!VanillaLight.ssgi()&&VanillaLight.bloomIntensity()==73,"Explicit personal toggles and intensity survive changed defaults");
+            Files.writeString(path,"{\"bloom\":false}");forgetPreferences();
+            check(!VanillaLight.bloom()&&VanillaLight.bloomIntensity()==20&&VanillaLight.pbr()&&VanillaLight.ssgi(),"Missing fields get new defaults without replacing explicit values");
+            System.out.println("SHADER135_DEFAULTS_PASS fresh, partial and personal preferences");
+        } catch(IOException e){throw new AssertionError(e);}
+    }
+
+    private static void checkPreferences() {
+        checkDefaults135();
+        VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);
+        VanillaLight.setPbr(false);
+        VanillaLight.setSsgi(false);
+        VanillaLight.setBloom(false);
+        VanillaLight.setOreEmission(false);
+        VanillaLight.setEnabled(true);
+        VanillaLight.setEdgeHighlights(false);
+        VanillaLight.setSaturation(100);
+        for (int[] pair : new int[][]{{Integer.MIN_VALUE, 8}, {11, 8}, {12, 16}, {16, 16}, {23, 16}, {24, 32}, {47,32}, {48,64}, {64,64}, {95,64}, {96,128}, {128,128}, {Integer.MAX_VALUE,128}}) {
+            VanillaLight.setShadowPixels(pair[0]);
+            forgetPreferences();
+            check(VanillaLight.shadowPixels() == pair[1], "Persisted pixel density rounds/clamps " + pair[0]);
+        }
+        for (int[] pair : new int[][]{{Integer.MIN_VALUE, 16}, {23, 16}, {24, 32}, {32, 32}, {47, 32}, {48, 64}, {95,64}, {96,128}, {191,128}, {192,256}, {256,256}, {Integer.MAX_VALUE, 256}}) {
+            VanillaLight.setShadowDistance(pair[0]);
+            forgetPreferences();
+            check(VanillaLight.shadowDistance() == pair[1], "Persisted shadow distance rounds/clamps " + pair[0]);
+        }
+        for (boolean enabled : new boolean[]{true, false}) {
+            VanillaLight.setPixelShadows(enabled);
+            forgetPreferences();
+            check(VanillaLight.pixelShadows() == enabled && VanillaLight.enabled(), "Saved shadow toggle is independent of main shader");
+        }
+        VanillaLight.setShadowPixels(16);
+        VanillaLight.setShadowDistance(32);
+    }
+
+    static void forgetPreferences() {
+        try {
+            var field = VanillaLight.class.getDeclaredField("preferences");
+            field.setAccessible(true);
+            field.set(null, null);
+        } catch (ReflectiveOperationException e) {
+            throw new AssertionError("Cannot reread actual shader preferences", e);
+        }
+    }
+
+    static void camera(ClientGameTestContext c, TestServerContext server, double x, double y, double z, int fov) {
+        server.runOnServer(s -> {
+            var p = s.getPlayerList().getPlayers().getFirst();
+            command(s, "tp @a " + x + " " + y + " " + z + " 0 90");
+            p.setDeltaMovement(Vec3.ZERO);
+        });
+        c.waitFor(m -> m.player.position().distanceToSqr(new Vec3(x, y, z)) < .0001
+                && Math.abs(m.player.getXRot() - 90) < .001, 200);
+        c.runOnClient(m -> {
+            m.options.fov().set(fov);
+            m.player.setYRot(0);
+            m.player.yRotO = 0;
+            m.player.setXRot(90);
+            m.player.xRotO = 90;
+            m.player.setDeltaMovement(Vec3.ZERO);
+        });
+        c.waitTicks(15);
+    }
+
+    static void look(ClientGameTestContext c, TestServerContext server, float yaw, float pitch) {
+        server.runOnServer(s -> {
+            var p = s.getPlayerList().getPlayers().getFirst();
+            command(s, "tp @a " + p.getX() + " " + p.getY() + " " + p.getZ() + String.format(java.util.Locale.ROOT," %.8f %.8f",yaw,pitch));
+        });
+        c.waitFor(m -> Math.abs(m.player.getXRot() - pitch) < .00001
+                && Math.abs(m.player.getYRot() - yaw) < .00001, 200);
+        c.waitTicks(15);
+    }
+
+    private static void pillar(MinecraftServer s, boolean present) {
+        for (int x = 0; x < 2; x++) for (int z = 0; z < 2; z++) for (int y = FLOOR + 1; y <= FLOOR + 8; y++) {
+            s.overworld().setBlockAndUpdate(new BlockPos(x, y, z),
+                    (present ? Blocks.CONCRETE.red() : Blocks.AIR).defaultBlockState());
+        }
+    }
+
+    static void command(MinecraftServer s, String command) {
+        try {
+            // Dispatcher exceptions fail the fixture instead of leaving an ignored command error in chat.
+            s.getCommands().getDispatcher().execute(command, s.createCommandSourceStack());
+        } catch (com.mojang.brigadier.exceptions.CommandSyntaxException e) {
+            throw new AssertionError("Fixture command failed: " + command, e);
+        }
+    }
+
+    static void shadows(ClientGameTestContext c, boolean enabled) {
+        c.runOnClient(m -> VanillaLight.setPixelShadows(enabled));
+        if (enabled) activeFrames(c);
+        else {
+            c.waitTicks(6);
+            int frames = c.computeOnClient(m -> {
+                check(!PixelShadows.applied() && PixelShadows.shadowMap() == null, "OFF releases the GPU shadow target");
+                return PixelShadows.renderedFrames();
+            });
+            c.waitTicks(3);
+            c.runOnClient(m -> check(PixelShadows.renderedFrames() == frames, "OFF submits no shadow frames"));
+        }
+    }
+
+    static void activeFrames(ClientGameTestContext c) {
+        int before = c.computeOnClient(m -> PixelShadows.renderedFrames());
+        c.waitFor(m -> PixelShadows.applied() && PixelShadows.ready() && PixelShadows.renderedFrames() > before + 12, 200);
+        // Allow the bounded terrain cache and native light/chunk uploads to settle before reading pixels.
+        c.waitTicks(30);
+    }
+
+    static Frame capture(ClientGameTestContext c, String name) {
+        if (name != null) c.takeScreenshot("sanctuary-beta140-shader-" + name);
+        var result = new CompletableFuture<Frame>();
+        c.runOnClient(m -> Screenshot.takeScreenshot(m.gameRenderer.mainRenderTarget(), image -> {
+            try (image) {
+                result.complete(new Frame(image.getWidth(), image.getHeight(), image.getPixels()));
+            } catch (Throwable e) {
+                result.completeExceptionally(e);
+            }
+        }));
+        c.waitFor(m -> result.isDone(), 200);
+        return result.join();
+    }
+
+    record Frame(int width, int height, int[] pixels) { }
+    private record Difference(int sampled, int ground, int dark, int stable, int brighter) { }
+
+    private static Difference compare(Frame before, Frame after) {
+        sameSize(before, after);
+        int sampled = 0, ground = 0, dark = 0, stable = 0, brighter = 0;
+        // Skip borders and sample every other pixel; no PNG decoding, image libraries or golden screenshot dependency.
+        for (int y = before.height / 10; y < before.height * 9 / 10; y += 2) {
+            for (int x = before.width / 10; x < before.width * 9 / 10; x += 2) {
+                sampled++;
+                int a = before.pixels[y * before.width + x], b = after.pixels[y * after.width + x];
+                if (!whiteGround(a)) continue;
+                ground++;
+                int delta = brightness(a) - brightness(b);
+                if (delta >= DARK_DELTA) dark++;
+                if (delta <= -DARK_DELTA) brighter++;
+                if (channelDifference(a, b) <= 3) stable++;
+            }
+        }
+        return new Difference(sampled, ground, dark, stable, brighter);
+    }
+
+    private static void localShadow(Difference d, String label, double minimumStable) {
+        System.out.println("PIXEL_SHADOWS122_PIXELS " + label + ": " + d);
+        check(d.ground > d.sampled * .50, label + ": a majority of samples must be actual white receiving ground: " + d);
+        check(d.dark >= Math.max(24, d.ground / 1000), label + ": measurable cast-shadow darkening: " + d);
+        check(d.stable > d.ground * minimumStable, label + ": unshadowed ground stays unchanged; reject a global tint: " + d);
+        check(d.brighter < Math.max(12, d.ground / 100), label + ": shadows must not brighten ground: " + d);
+    }
+
+    static void unchanged(Frame before, Frame after, String label) {
+        sameSize(before, after);
+        int sampled = 0, changed = 0;
+        for (int y = before.height / 10; y < before.height * 9 / 10; y += 2) {
+            for (int x = before.width / 10; x < before.width * 9 / 10; x += 2) {
+                sampled++;
+                int i = y * before.width + x;
+                if (channelDifference(before.pixels[i], after.pixels[i]) > 3) changed++;
+            }
+        }
+        check(sampled > 0 && changed <= sampled / 100, label + ": changed=" + changed + "/" + sampled);
+    }
+
+    private static void restoredGround(Frame off, Frame on, Frame removed) {
+        sameSize(off, on);
+        sameSize(off, removed);
+        int shadow = 0, restored = 0, lit = 0, stable = 0;
+        for (int y = off.height / 10; y < off.height * 9 / 10; y += 2) {
+            for (int x = off.width / 10; x < off.width * 9 / 10; x += 2) {
+                int i = y * off.width + x;
+                if (!whiteGround(off.pixels[i])) continue;
+                if (brightness(off.pixels[i]) - brightness(on.pixels[i]) >= DARK_DELTA) {
+                    shadow++;
+                    if (brightness(removed.pixels[i]) - brightness(on.pixels[i]) >= DARK_DELTA
+                            && channelDifference(off.pixels[i], removed.pixels[i]) <= 4) restored++;
+                } else if (channelDifference(off.pixels[i], on.pixels[i]) <= 3) {
+                    lit++;
+                    if (channelDifference(on.pixels[i], removed.pixels[i]) <= 3) stable++;
+                }
+            }
+        }
+        check(shadow >= 24 && restored > shadow * .85,
+                "Removing offscreen caster relights its former shadow: " + restored + "/" + shadow);
+        check(lit >= 24 && stable > lit * .98,
+                "Removing caster preserves already sunlit ground: " + stable + "/" + lit);
+        System.out.println("PIXEL_SHADOWS122_EDIT restored=" + restored + "/" + shadow + " litStable=" + stable + "/" + lit);
+    }
+
+    private static boolean whiteGround(int color) {
+        int r = color >> 16 & 255, g = color >> 8 & 255, b = color & 255;
+        return Math.min(r, Math.min(g, b)) > 100 && Math.max(r, Math.max(g, b)) - Math.min(r, Math.min(g, b)) < 24;
+    }
+
+    static int brightness(int color) {
+        return ((color >> 16 & 255) + (color >> 8 & 255) + (color & 255)) / 3;
+    }
+
+    static int channelDifference(int a, int b) {
+        return Math.max(Math.abs((a >> 16 & 255) - (b >> 16 & 255)),
+                Math.max(Math.abs((a >> 8 & 255) - (b >> 8 & 255)), Math.abs((a & 255) - (b & 255))));
+    }
+
+    private static void sameSize(Frame a, Frame b) {
+        check(a.width == b.width && a.height == b.height && a.pixels.length == b.pixels.length,
+                "GPU comparison requires the same framebuffer dimensions");
+    }
+
+    private record Options(int distance, int simulationDistance, int fov, boolean bob,
+                           boolean pause, CameraType camera, String language, boolean improvedTransparency) {
+        static Options capture(Minecraft m) {
+            return new Options(m.options.renderDistance().get(), m.options.simulationDistance().get(), m.options.fov().get(),
+                    m.options.bobView().get(), m.options.pauseOnLostFocus,
+                    m.options.getCameraType(), m.getLanguageManager().getSelected(), m.options.improvedTransparency().get());
+        }
+
+        void restore(Minecraft m) {
+            m.options.renderDistance().set(distance);
+            m.options.simulationDistance().set(simulationDistance);
+            m.options.fov().set(fov);
+            m.options.bobView().set(bob);
+            m.options.pauseOnLostFocus = pause;
+            m.options.setCameraType(camera);
+            m.options.improvedTransparency().set(improvedTransparency);
+            m.getLanguageManager().setSelected(language);
+            m.getLanguageManager().onResourceManagerReload(m.getResourceManager());
+        }
+    }
+
+    private static KeyEvent enter() { return new KeyEvent(InputConstants.KEY_RETURN, 0, 0); }
+    static void check(boolean ok, String message) { if (!ok) throw new AssertionError(message); }
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/RealtimeShadows129ClientChecks.java

@@ -0,0 +1,115 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+
+import fr.koka.sanctuary.realtime.RealtimeService;
+import java.time.Clock;
+import java.time.Duration;
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicReference;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.fabric.api.client.rendering.v1.level.LevelRenderEvents;
+
+final class RealtimeShadows129ClientChecks {
+    private static void projectionContinuity() {
+        // Far coordinates amplify the old per-frame rounding failure. Moving the sun must not
+        // add a periodic translation to the shadow raster while the camera remains stationary.
+        var grid=new ShadowProjection();
+        float last=0; int jumps=0; float greatest=0;
+        for(int i=0;i<2000;i++) {
+            var matrix=grid.matrix(PixelShadows.sunDirection(.7f+i*.000001f),32,2048,100000,64,-100000,false);
+            if(i>0){float step=Math.abs(matrix.m31()-last);greatest=Math.max(greatest,step);if(step>1e-6f)jumps++;}
+            last=matrix.m31();
+        }
+        check(jumps==0,"Slow light rotation has no cyclical raster translation far from spawn: "+greatest);
+        // Recentring transfers the phase modulo integral texels, preserving the sampled grid.
+        var sun=PixelShadows.sunDirection(.71f);
+        var before=grid.matrix(sun,32,2048,100000,64,-100000,false);
+        var after=grid.matrix(sun,32,2048,100016,64,-100000,false);
+        var a=before.transform(new org.joml.Vector4f(4,1,2,1));
+        var b=after.transform(new org.joml.Vector4f(-12,1,2,1));
+        for(float value:new float[]{(b.x-a.x)*1024,(b.y-a.y)*1024})
+            check(Math.abs(value-Math.rint(value))<.001,"Camera recentering moves only whole shadow texels");
+    }
+
+    static void run(ClientGameTestContext c, TestServerContext server) {
+        projectionContinuity();
+        var enabled=new AtomicBoolean(false);
+        var trace=Collections.synchronizedList(new ArrayList<double[]>());
+        LevelRenderEvents.END_EXTRACTION.register(context -> {
+            if(enabled.get() && trace.size()<4096)trace.add(new double[]{System.nanoTime()/1e9,context.levelState().skyRenderState.sunAngle});
+        });
+        var original=new AtomicReference<Clock>();
+        try {
+            server.runOnServer(s -> {
+                var session=RealtimeService.session(s);
+                check(session!=null,"Isolated world has the actual real-time service");
+                try {
+                    var field=session.getClass().getDeclaredField("clock");field.setAccessible(true);
+                    original.set((Clock)field.get(session));
+                    var morning=session.sample().day().noon().minusSeconds(3*3600);
+                    field.set(session,Clock.offset(Clock.systemUTC(),Duration.between(Instant.now(),morning)));
+                    check(RealtimeService.setMode(s,true),"Real-time mode enabled through actual server service");
+                } catch(ReflectiveOperationException e) {throw new AssertionError(e);}
+                catch(Exception e) {throw new AssertionError(e);}
+            });
+            c.waitFor(m -> PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle).y>.2,200);
+            c.waitTicks(40);
+            double shadowX=c.computeOnClient(m -> {
+                var sun=PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle);
+                return 1-7*sun.x/sun.y;
+            });
+            camera(c,server,shadowX,69,1,30);
+            shadows(c,false);
+            var off=capture(c,null);
+            shadows(c,true);
+            enabled.set(true);
+            var frames=new ArrayList<Frame>();
+            for(int i=0;i<24;i++) {c.waitTicks(6);frames.add(capture(c,i==0?"realtime-start":i==23?"realtime-end":null));}
+            c.runOnClient(m -> enabled.set(false));
+            double travel=Math.IEEEremainder(trace.getLast()[1]-trace.getFirst()[1],Math.PI*2);
+            int reverse=0;double largest=0;
+            for(int i=1;i<trace.size();i++) {
+                double delta=Math.IEEEremainder(trace.get(i)[1]-trace.get(i-1)[1],Math.PI*2)*Math.signum(travel);
+                if(delta<-.0000001){reverse++;largest=Math.max(largest,-delta);}
+            }
+            int samples=0,changed=0,rebound=0;
+            for(int y=off.height()/10;y<off.height()*9/10;y+=2) for(int x=off.width()/10;x<off.width()*9/10;x+=2) {
+                int index=y*off.width()+x,a=off.pixels()[index];
+                int r=a>>16&255,g=a>>8&255,b=a&255;
+                if(Math.min(r,Math.min(g,b))<100 || Math.max(r,Math.max(g,b))-Math.min(r,Math.min(g,b))>24)continue;
+                samples++;int flips=0;
+                boolean last=brightness(a)-brightness(frames.getFirst().pixels()[index])>=8;
+                for(var frame:frames) {
+                    boolean dark=brightness(a)-brightness(frame.pixels()[index])>=8;
+                    if(last!=dark)flips++;
+                    last=dark;
+                }
+                if(flips>0)changed++;
+                if(flips>1)rebound++;
+            }
+            check(trace.size()>30 && Math.abs(travel)>.00001,"Real-time shadows actually remain dynamic");
+            check(rebound<Math.max(8,samples/1000),"Real-time opaque contours must not repeatedly rebound: "+rebound);
+            System.out.println("REALTIME129_PASS frames="+trace.size()+" rawTravel="+travel+" reversals="+reverse+" largestReverse="+largest
+                    +" pixels="+samples+" changed="+changed+" rebound="+rebound);
+            try {
+                var out=new StringBuilder("seconds,raw_angle\n");
+                for(var sample:trace)out.append(sample[0]).append(',').append(sample[1]).append('\n');
+                java.nio.file.Files.writeString(net.fabricmc.loader.api.FabricLoader.getInstance().getGameDir().resolve("shadow129-clock.csv"),out);
+            }catch(java.io.IOException e){throw new AssertionError(e);}
+        } finally {
+            enabled.set(false);
+            server.runOnServer(s -> {
+                try {
+                    RealtimeService.setMode(s,false);
+                    if(original.get()!=null){var session=RealtimeService.session(s);var field=session.getClass().getDeclaredField("clock");field.setAccessible(true);field.set(session,original.get());}
+                    command(s,"time set 3000");
+                }catch(Exception e){throw new AssertionError(e);}
+            });
+        }
+    }
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/Ssgi132ClientChecks.java

@@ -0,0 +1,126 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.world.level.block.state.BlockState;
+import java.nio.file.Files;
+
+public final class Ssgi132ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){new PixelShadows122ClientChecks(false,true).runTest(c);}
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setSunshafts(false);VanillaLight.setLensFlare(false);VanillaLight.setPbr(false);VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setPixelShadows(false);VanillaLight.setEdgeHighlights(false);});
+        server.runOnServer(s->{command(s,"time set 6000");for(int x=-5;x<=24;x++)for(int z=-5;z<=24;z++){
+            s.overworld().setBlockAndUpdate(new BlockPos(x,64,z),Blocks.CONCRETE.white().defaultBlockState());
+            for(int y=65;y<=102;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),Blocks.AIR.defaultBlockState());
+        }});
+        camera(c,server,10.5,69,5.5,65);look(c,server,0,40);settle(c);
+        var flatOff=capture(c,"ssgi-flat-off");enable(c,true);unchanged(flatOff,capture(c,"ssgi-flat-on"),"Coplanar ground does not bounce light onto itself");
+        wall(server,12,Blocks.CONCRETE.red().defaultBlockState());settle(c);enable(c,false);var redOff=capture(c,"ssgi-red-off");
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(35));
+        enable(c,true);var defaultRed=measure(redOff,capture(c,"ssgi-red-default-35"));
+        System.out.println("SSGI133_DEFAULT "+defaultRed);
+        check(defaultRed.visible>5000&&defaultRed.strong>500,"Default intensity produces 8/255 gain over 5000 pixels and 16/255 over 500 pixels: "+defaultRed);
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(90));frames(c);
+        var redOn=capture(c,"ssgi-red-on");var red=measure(redOff,redOn);System.out.println("SSGI133_RED "+red);
+        check(red.changed>30&&red.red>red.blue*1.5+20,"Visible red wall tints neutral ground: "+red);
+        unchanged(redOn,capture(c,null),"Stationary SSGI has no animated noise or accumulating feedback");
+        look(c,server,0.00002f,40.00002f);frames(c);unchanged(redOn,capture(c,null),"Subpixel motion keeps actual red bounce stable");
+        look(c,server,5,40);frames(c);capture(c,"ssgi-camera-turned");
+        look(c,server,0,40);frames(c);unchanged(redOn,capture(c,null),"Returning the camera leaves no temporal color trails");
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(20));frames(c);var low=measure(redOff,capture(c,"ssgi-strength-20"));
+        check(red.red>low.red*1.5,"Intensity adjusts native color bounce: "+red+" / "+low);
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(0));c.waitTicks(6);unchanged(redOff,capture(c,null),"Zero intensity restores source image");
+        c.runOnClient(m->check(!ScreenSpaceGI.allocated()&&!ScreenSpaceGI.applied(),"Zero frees SSGI targets"));
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(90));frames(c);
+        int oldWidth=c.computeOnClient(m->m.getWindow().getScreenWidth()),oldHeight=c.computeOnClient(m->m.getWindow().getScreenHeight());
+        c.runOnClient(m->m.getWindow().setWindowed(961,541));
+        c.waitFor(m->m.gameRenderer.mainRenderTarget().width!=redOn.width(),200);frames(c);
+        enable(c,false);var resizedOff=capture(c,null);enable(c,true);var resized=measure(resizedOff,capture(c,"ssgi-resized"));
+        check(resized.changed>30&&resized.red>resized.blue*1.5+20,"Resizing reallocates a working SSGI pass: "+resized);
+        c.runOnClient(m->m.getWindow().setWindowed(oldWidth,oldHeight));
+        c.waitFor(m->m.gameRenderer.mainRenderTarget().width==redOn.width(),200);frames(c);
+        wall(server,12,Blocks.CONCRETE.blue().defaultBlockState());settle(c);enable(c,false);var blueOff=capture(c,"ssgi-blue-off");enable(c,true);var blue=measure(blueOff,capture(c,"ssgi-blue-on"));
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(35));frames(c);
+        var defaultBlue=measure(blueOff,capture(c,"ssgi-blue-default-35"));
+        check(defaultBlue.visible>5000&&defaultBlue.strong>500&&defaultBlue.blue>defaultBlue.red*1.5+20,"Default blue bounce is visible too: "+defaultBlue);
+        c.runOnClient(m->VanillaLight.setSsgiIntensity(90));frames(c);
+        System.out.println("SSGI133_BLUE "+blue+" default="+defaultBlue);check(blue.changed>30&&blue.blue>blue.red*1.5+20,"Live blue wall changes bounced hue: "+blue);
+        wall(server,11,Blocks.CONCRETE.white().defaultBlockState());settle(c);enable(c,false);var coveredOff=capture(c,null);enable(c,true);var covered=capture(c,"ssgi-covered-blue");
+        wall(server,12,Blocks.CONCRETE.red().defaultBlockState());settle(c);unchanged(covered,capture(c,"ssgi-covered-red"),"Hidden wall color cannot pass through foreground wall");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();frames(c);unchanged(covered,capture(c,"ssgi-reloaded"),"Resource reload restores SSGI");
+        look(c,server,0.00002f,40.00002f);frames(c);unchanged(covered,capture(c,null),"Subpixel camera movement keeps bounce stable");
+        look(c,server,0,40);frames(c);enable(c,false);unchanged(coveredOff,capture(c,null),"OFF leaves no residual tint");
+        c.runOnClient(m->check(!ScreenSpaceGI.allocated(),"OFF frees SSGI resources"));
+        c.runOnClient(m->{VanillaLight.setSsgiIntensity(35);VanillaLight.setPixelShadows(true);VanillaLight.setEdgeHighlights(true);VanillaLight.setBloom(true);VanillaLight.setOreEmission(true);});
+        enable(c,true);c.waitFor(m->PixelShadows.applied()&&PixelShadows.ready()&&EdgeHighlights.applied()&&Bloom.applied(),1200);
+        capture(c,"ssgi-combined-shader");
+        c.runOnClient(m->VanillaLight.setEnabled(false));c.waitTicks(8);
+        c.runOnClient(m->check(!ScreenSpaceGI.allocated(),"Main shader OFF releases SSGI too"));
+        c.runOnClient(m->VanillaLight.setEnabled(true));frames(c);enable(c,false);
+        motion(c,server);
+        SsgiCloseup135ClientChecks.run(c,server);
+        System.out.println("SSGI133_PASS red/blue diffuse bounce; intensity; flat rejection; foreground occlusion; static stability; tiny camera motion; resize; reload; combined shader; OFF/zero; preferences; red="+red+" blue="+blue);
+    }
+    private static void motion(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setPixelShadows(false);VanillaLight.setEdgeHighlights(false);});
+        wall(server,11,Blocks.AIR.defaultBlockState());
+        server.runOnServer(s->{
+            command(s,"summon minecraft:cow 8.5 65 9.5 {NoAI:1b,Silent:1b,NoGravity:1b,Invulnerable:1b,Tags:[\"ssgi134_test\"]}");
+            for(int x=11;x<=13;x++)for(int z=8;z<=10;z++){
+                s.overworld().setBlockAndUpdate(new BlockPos(x,64,z),Blocks.GRASS_BLOCK.defaultBlockState());
+                s.overworld().setBlockAndUpdate(new BlockPos(x,65,z),Blocks.SHORT_GRASS.defaultBlockState());
+            }
+        });settle(c);
+        for(int intensity:new int[]{35,100}){
+            c.runOnClient(m->VanillaLight.setSsgiIntensity(intensity));
+            Frame start=null;double worstGrass=0;
+            for(int step=0;step<=12;step++){
+                double x=4.5+step;camera(c,server,x,66.5,5.5,65);
+                look(c,server,(float)Math.toDegrees(Math.atan2(x-10.5,6.5)),10);
+                enable(c,false);var base=capture(c,"ssgi-motion-"+intensity+"-"+step+"-off");
+                enable(c,true);var frame=capture(c,"ssgi-motion-"+intensity+"-"+step+"-on");
+                double grass=grassGain(base,frame);worstGrass=Math.max(worstGrass,grass);
+                check(grass<(intensity==35?12:30),"Lateral view avoids excessive grass brightening at "+intensity+" / "+step+": "+grass);
+                if(step==0)start=frame;
+            }
+            System.out.println("SSGI134_GRASS intensity="+intensity+" maxMeanGreenGain="+worstGrass);
+            camera(c,server,4.5,66.5,5.5,65);look(c,server,(float)Math.toDegrees(Math.atan2(-6,6.5)),10);frames(c);
+            unchanged(start,capture(c,null),"Twelve-block lateral movement returns without stale SSGI history at "+intensity);
+        }
+        enable(c,false);c.runOnClient(m->VanillaLight.setSsgiIntensity(35));
+        server.runOnServer(s->command(s,"kill @e[tag=ssgi134_test]"));
+        System.out.println("SSGI134_MOTION_PASS 12-block lateral sweep, grass/cow/blocks, OFF/ON at35 and100, return without history");
+    }
+    private static double grassGain(Frame off,Frame on){
+        int count=0;long gain=0;
+        for(int i=0;i<off.pixels().length;i++){
+            int a=off.pixels()[i],r=a>>16&255,g=a>>8&255,b=a&255;
+            if(g>r*1.15&&g>b*1.3&&g>45){count++;gain+=Math.max(0,(on.pixels()[i]>>8&255)-g);}
+        }
+        check(count>500,"Motion fixture includes visible vegetation");return gain/(double)count;
+    }
+    private static void wall(TestServerContext server,int z,BlockState state){server.runOnServer(s->{for(int x=6;x<=15;x++)for(int y=65;y<=(z==11?72:69);y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),state);});}
+    private static void settle(ClientGameTestContext c){c.waitTicks(30);c.waitFor(m->m.levelRenderer.hasRenderedAllSections(),1200);c.waitTicks(8);}
+    private static void enable(ClientGameTestContext c,boolean enabled){c.runOnClient(m->VanillaLight.setSsgi(enabled));if(enabled)frames(c);else c.waitTicks(8);}
+    private static void frames(ClientGameTestContext c){int start=c.computeOnClient(m->ScreenSpaceGI.renderedFrames());c.waitFor(m->ScreenSpaceGI.applied()&&ScreenSpaceGI.renderedFrames()>start+10,1200);c.waitTicks(6);}
+    private static void preferences(){try{
+        var p=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.writeString(p,"{\"bloom\":false,\"shadowPixels\":128}");forgetPreferences();
+        check(VanillaLight.ssgi()&&VanillaLight.ssgiIntensity()==35&&!VanillaLight.bloom()&&VanillaLight.shadowPixels()==128,"Legacy choices preserved; missing SSGI setting defaults ON at 35");
+        for(int i:new int[]{-10,0,35,90,140}){VanillaLight.setSsgiIntensity(i);VanillaLight.setSsgi(true);forgetPreferences();check(VanillaLight.ssgi()&&VanillaLight.ssgiIntensity()==Math.clamp(i,0,100),"SSGI persists and clamps");}
+        VanillaLight.setSsgiIntensity(90);
+    }catch(Exception e){throw new AssertionError(e);}}
+    private record Gain(int changed,int visible,int strong,double red,double green,double blue){}
+    private static Gain measure(Frame off,Frame on){int count=0,visible=0,strong=0;double r=0,g=0,b=0;for(int i=0;i<off.pixels().length;i++){
+        int a=off.pixels()[i],ar=a>>16&255,ag=a>>8&255,ab=a&255;
+        if(Math.max(ar,Math.max(ag,ab))-Math.min(ar,Math.min(ag,ab))>25||ar<60||ar>245)continue;
+        int z=on.pixels()[i];int dr=(z>>16&255)-ar,dg=(z>>8&255)-ag,db=(z&255)-ab;
+        if(Math.max(dr,Math.max(dg,db))>=16)strong++;
+        if(Math.max(dr,Math.max(dg,db))>=8)visible++;
+        if(Math.max(dr,Math.max(dg,db))>1)count++;r+=Math.max(0,dr);g+=Math.max(0,dg);b+=Math.max(0,db);
+    }return new Gain(count,visible,strong,r,g,b);}
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/SsgiCloseup135ClientChecks.java

@@ -0,0 +1,78 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+
+/** Native low-angle and near-plane regression fixture; never opens a personal world. */
+public final class SsgiCloseup135ClientChecks implements net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){new PixelShadows122ClientChecks(false,false,false,true).runTest(c);}
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setSsgi(false);VanillaLight.setPbr(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setPixelShadows(false);VanillaLight.setEdgeHighlights(false);});
+        server.runOnServer(s->{
+            // Minecraft 26.3 rejects setting a clock to its existing value.
+            command(s,"time add 1");command(s,"time set 6000");
+            for(int x=-5;x<=24;x++)for(int z=-5;z<=24;z++){
+                // Contain lava: no flow below the platform into the following PBR fixture.
+                s.overworld().setBlockAndUpdate(new BlockPos(x,63,z),Blocks.STONE.defaultBlockState());
+                for(int y=64;y<=102;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),y==64?Blocks.STONE.defaultBlockState():Blocks.AIR.defaultBlockState());
+                if(x>=5&&x<=16&&z>=4&&z<=14)s.overworld().setBlockAndUpdate(new BlockPos(x,64,z),Blocks.LAVA.defaultBlockState());
+                if(x>=5&&x<=16&&z>=8&&z<=14)s.overworld().setBlockAndUpdate(new BlockPos(x,68,z),Blocks.STONE.defaultBlockState());
+                if(x>=5&&x<=16&&z==12)for(int y=65;y<=67;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),Blocks.CONCRETE.red().defaultBlockState());
+            }
+        });c.waitTicks(40);c.waitFor(m->m.levelRenderer.hasRenderedAllSections(),1200);
+        for(int scene=0;scene<2;scene++)for(int intensity:new int[]{35,100}){
+            c.runOnClient(m->VanillaLight.setSsgiIntensity(intensity));
+            for(int step=0;step<7;step++){
+                // Eye approaches the underside, crossing the old fixed normal-area threshold.
+                double gap=new double[]{2.0,1.0,.65,.4,.2,.1,.04}[step];
+                camera(c,server,10.5,68-gap-1.62,scene==0?9.5:11.5,65);look(c,server,0,-25);
+                c.runOnClient(m->VanillaLight.setSsgi(false));c.waitTicks(8);
+                var off=capture(c,"closeup-"+scene+"-"+intensity+"-"+step+"-off");
+                c.runOnClient(m->VanillaLight.setSsgi(true));c.waitFor(m->ScreenSpaceGI.applied(),1200);c.waitTicks(12);
+                var on=capture(c,"closeup-"+scene+"-"+intensity+"-"+step+"-on");
+                var stats=rowJump(off,on);
+                System.out.println("SSGI135_CLOSEUP scene="+scene+" intensity="+intensity+" gap="+gap+" "+stats);
+                if(scene==0&&gap<=.1)check(stats.jump<2&&stats.gain<.1,"Near-plane bounce fades without a horizontal bright strip: "+stats);
+                if(scene==1&&gap==.4)check(stats.rows>30&&stats.gain>1,"Close corner retains actual bounce instead of rejecting small world pixels: "+stats);
+                if(gap==.04)check(stats.gain<.05,"At contact, indirect light fades to the source image: "+stats);
+            }
+        }
+        int width=c.computeOnClient(m->m.getWindow().getScreenWidth()),height=c.computeOnClient(m->m.getWindow().getScreenHeight());
+        camera(c,server,10.5,65.98,11.5,65);look(c,server,0,-25);
+        c.runOnClient(m->{VanillaLight.setSsgiIntensity(100);m.getWindow().setWindowed(1280,720);});
+        c.waitFor(m->m.gameRenderer.mainRenderTarget().width!=width,200);c.waitTicks(15);
+        c.runOnClient(m->VanillaLight.setSsgi(false));c.waitTicks(8);var largeOff=capture(c,"closeup-large-off");
+        c.runOnClient(m->VanillaLight.setSsgi(true));c.waitTicks(15);var large=capture(c,"closeup-large-on");
+        var largeStats=rowJump(largeOff,large);check(largeStats.rows>30&&largeStats.gain>1,"High resolution with a visible source retains bounce: "+largeStats);
+        look(c,server,.00002f,-25.00002f);c.waitTicks(10);unchanged(large,capture(c,null),"Closeup has no subpixel normal threshold flicker");
+        look(c,server,0,-65);c.runOnClient(m->VanillaLight.setSsgi(false));c.waitTicks(8);var steepOff=capture(c,"closeup-offscreen-source-off");
+        c.runOnClient(m->VanillaLight.setSsgi(true));c.waitTicks(15);unchanged(steepOff,capture(c,"closeup-offscreen-source-on"),"Looking away from the source does not invent hidden light");
+        c.runOnClient(m->m.getWindow().setWindowed(width,height));c.waitFor(m->m.gameRenderer.mainRenderTarget().width==width,200);c.waitTicks(15);
+        c.runOnClient(m->{VanillaLight.setPbr(true);VanillaLight.setBloom(true);VanillaLight.setOreEmission(true);VanillaLight.setPixelShadows(true);VanillaLight.setEdgeHighlights(true);});
+        c.waitFor(m->ProceduralPbr.applied()&&ProceduralPbr.ready()&&Bloom.applied()&&PixelShadows.applied()&&PixelShadows.ready(),1200);
+        c.waitTicks(15);capture(c,"closeup-combined");
+        c.runOnClient(m->{VanillaLight.setSsgi(false);VanillaLight.setSsgiIntensity(35);VanillaLight.setPbr(false);});
+        System.out.println("SSGI135_CLOSEUP_PASS low-angle lava/stone and seven camera distances at 35/100");
+    }
+    private record Rows(double jump,double gain,int rows){}
+    private static Rows rowJump(Frame a,Frame b){
+        double previous=0,max=0,gain=0;int rows=0;
+        for(int y=a.height()/8;y<a.height()*7/8;y++){
+            double sum=0;int count=0;
+            for(int x=a.width()/4;x<a.width()*3/4;x++){
+                int i=y*a.width()+x,pa=a.pixels()[i],pb=b.pixels()[i];
+                int r=pa>>16&255,g=pa>>8&255,blue=pa&255;
+                if(Math.max(r,Math.max(g,blue))-Math.min(r,Math.min(g,blue))<12&&g>15){
+                    sum+=Math.max(0,(pb>>16&255)-r);count++;
+                }
+            }
+            if(count<a.width()/8)continue;
+            double mean=sum/count;if(rows>0)max=Math.max(max,Math.abs(mean-previous));
+            previous=mean;gain+=mean;rows++;
+        }
+        return new Rows(max,gain/Math.max(rows,1),rows);
+    }
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/SunshaftWeather138ClientChecks.java

@@ -0,0 +1,39 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import static fr.koka.sanctuary.client.shader.Sunshafts137ClientChecks.*;
+import fr.koka.sanctuary.client.WeatherClient;
+import fr.koka.sanctuary.weather.DailyWeather;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+
+/** Actual server weather -> native atmospheric fog -> shader scattering, same scene and manual strength. */
+final class SunshaftWeather138ClientChecks {
+    static void run(ClientGameTestContext c,TestServerContext server){
+        check(Sunshafts.fogDensity(1024)==0&&Sunshafts.fogDensity(192)==0&&Sunshafts.fogDensity(80)==1,"Clear and full fog endpoints");
+        float previous=0;for(int end=192;end>=80;end--){float d=Sunshafts.fogDensity(end);check(d>=previous&&d-previous<.014,"Fog density is bounded, smooth and monotonic");previous=d;}
+        check(Sunshafts.fogDensity(Float.POSITIVE_INFINITY)==0&&Sunshafts.fogDensity(Float.NaN)==0,"Invalid fog distance cannot create NaN shafts");
+        c.runOnClient(m->{VanillaLight.setSunshafts(false);VanillaLight.setSunshaftIntensity(35);VanillaLight.setPixelShadows(false);VanillaLight.setBloom(false);VanillaLight.setLensFlare(false);VanillaLight.setOreEmission(false);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setEdgeHighlights(false);});
+        roof(server,1);camera(c,server,100.5,101,110.5,70);aim(c,server);
+        profile(c,server,DailyWeather.Kind.CLEAR);enable(c,false);var clearOff=capture(c,"weather-shafts-clear-off");enable(c,true);var clear=capture(c,"weather-shafts-clear-35");double clearEnergy=energy(clearOff,clear);
+        server.runOnServer(s->command(s,"weather fog"));c.waitFor(m->WeatherClient.state().kind()==DailyWeather.Kind.FOG,200);
+        float[] transition=new float[12];for(int i=0;i<transition.length;i++){c.waitTicks(20);transition[i]=c.computeOnClient(m->Sunshafts.fogDensity(m.gameRenderer.gameRenderState().levelRenderState.cameraRenderState.fogData.environmentalEnd));if(i>0)check(transition[i]>=transition[i-1]-.002&&transition[i]-transition[i-1]<.4,"Live fog transition has no abrupt density jump");}
+        c.runOnClient(m->{check(m.gameRenderer.gameRenderState().levelRenderState.cameraRenderState.fogData.environmentalEnd<=80.01,"Fog command reaches actual native FogData");check(Sunshafts.applied(),"Atmospheric fog does not disable rays");});
+        enable(c,false);var fogOff=capture(c,"weather-shafts-fog-off");enable(c,true);var fog=capture(c,"weather-shafts-fog-35");double fogEnergy=energy(fogOff,fog);
+        check(fogEnergy>clearEnergy*1.7,"Fog visibly thickens scattering at the same intensity: "+clearEnergy+" -> "+fogEnergy);unchanged(fog,capture(c,null),"Stable fog adds no animated noise");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();settle(c);unchanged(fog,capture(c,"weather-shafts-fog-reload"),"Weather coupling survives shader reload");
+        roof(server,0);settle(c);enable(c,false);var sealedOff=capture(c,null);enable(c,true);unchanged(sealedOff,capture(c,"weather-shafts-fog-sealed"),"Dense fog cannot illuminate a sealed room through walls");roof(server,1);settle(c);
+        profile(c,server,DailyWeather.Kind.RAIN);enable(c,false);var rainOff=capture(c,"weather-shafts-rain-off");enable(c,true);double rainEnergy=energy(rainOff,capture(c,"weather-shafts-rain-35"));check(rainEnergy>0&&rainEnergy<fogEnergy,"Rain stays visible but below thick fog: "+rainEnergy);
+        profile(c,server,DailyWeather.Kind.THUNDER);enable(c,false);var stormOff=capture(c,"weather-shafts-storm-off");enable(c,true);double stormEnergy=energy(stormOff,capture(c,"weather-shafts-storm-35"));check(stormEnergy<rainEnergy*.8,"Storm clouds reduce available sunlight: "+stormEnergy+" / "+rainEnergy);
+        profile(c,server,DailyWeather.Kind.CLEAR);enable(c,true);var restored=capture(c,"weather-shafts-restored-clear");unchanged(clear,restored,"Returning to clear restores the original rays without accumulated brightness");
+        c.runOnClient(m->check(VanillaLight.sunshaftIntensity()==35,"Weather never changes the player's intensity setting"));
+        c.runOnClient(m->VanillaLight.setSunshaftIntensity(0));c.waitTicks(10);c.runOnClient(m->check(!Sunshafts.allocated(),"Zero still frees atmospheric scattering"));
+        System.out.println("SUNSHAFT138_WEATHER_PASS clear="+clearEnergy+" fog="+fogEnergy+" rain="+rainEnergy+" storm="+stormEnergy+" smooth transitions, native fog, closed room, reload, restored clear and manual setting");
+    }
+    private static void profile(ClientGameTestContext c,TestServerContext server,DailyWeather.Kind kind){
+        server.runOnServer(s->command(s,"sanctuary weather "+kind.key()));
+        c.waitFor(m->WeatherClient.state().active()&&WeatherClient.state().kind()==kind,200);
+        c.waitFor(m->(kind.raining()?m.level.getRainLevel(1)>.999:m.level.getRainLevel(1)<.001)&&(kind.thundering()?m.level.getThunderLevel(1)>.999:m.level.getThunderLevel(1)<.001),600);
+        c.waitTicks(240);
+    }
+}

mods/sanctuary/src/clientGametest/java/fr/koka/sanctuary/client/shader/Sunshafts137ClientChecks.java

@@ -0,0 +1,64 @@
+package fr.koka.sanctuary.client.shader;
+
+import static fr.koka.sanctuary.client.shader.PixelShadows122ClientChecks.*;
+import java.nio.file.Files;
+import net.fabricmc.fabric.api.client.gametest.v1.FabricClientGameTest;
+import net.fabricmc.fabric.api.client.gametest.v1.context.ClientGameTestContext;
+import net.fabricmc.fabric.api.client.gametest.v1.context.TestServerContext;
+import net.fabricmc.loader.api.FabricLoader;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.network.chat.Component;
+import net.minecraft.util.Mth;
+
+/** Native solar volume in a sealed room, a slotted roof and a leaf canopy. */
+public final class Sunshafts137ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext c){new PixelShadows122ClientChecks(false,false,false,false,true).runTest(c);}
+    static void run(ClientGameTestContext c,TestServerContext server){
+        c.runOnClient(m->{preferences();VanillaLight.setEnabled(true);VanillaLight.setSaturation(100);VanillaLight.setPbr(false);VanillaLight.setSsgi(false);VanillaLight.setBloom(false);VanillaLight.setOreEmission(false);VanillaLight.setLensFlare(false);VanillaLight.setEdgeHighlights(false);VanillaLight.setPixelShadows(false);VanillaLight.setSunshafts(false);VanillaLight.setShadowDistance(64);});
+        server.runOnServer(s->{command(s,"time add 1");command(s,"time set 3000");
+            for(int x=76;x<=124;x++)for(int z=76;z<=124;z++){
+                s.overworld().setBlockAndUpdate(new BlockPos(x,96,z),Blocks.STONE_BRICKS.defaultBlockState());
+                if(x==76||x==124||z==76||z==124)for(int y=97;y<=113;y++)s.overworld().setBlockAndUpdate(new BlockPos(x,y,z),Blocks.STONE_BRICKS.defaultBlockState());
+            }
+        });
+        roof(server,0);camera(c,server,100.5,101,110.5,70);aim(c,server);c.waitTicks(50);
+        var closedOff=capture(c,"shafts-closed-off");enable(c,true);var closed=capture(c,"shafts-closed-on");
+        check(gain(closedOff,closed)<300,"Sealed room receives no sunlight through opaque blocks: "+gain(closedOff,closed));
+        c.runOnClient(m->check(!PixelShadows.applied()&&PixelShadows.depthReady()&&!Bloom.allocated(),"Volume alone shares depth without surface shadows or bloom"));
+        roof(server,1);settle(c);enable(c,false);var off=capture(c,"shafts-slots-off");enable(c,true);var on=capture(c,"shafts-slots-35");long low=gain(off,on);
+        check(low>1000,"Roof openings form visible shafts: "+low);unchanged(on,capture(c,null),"Static shafts have no animated sampling noise");
+        c.runOnClient(m->VanillaLight.setSunshaftIntensity(100));settle(c);var strong=capture(c,"shafts-slots-100");check(gain(off,strong)>low*1.5,"Intensity increases volume energy");
+        camera(c,server,104.5,101,110.5,70);aim(c,server);settle(c);capture(c,"shafts-moved-four-blocks");
+        camera(c,server,100.5,101,110.5,70);aim(c,server);settle(c);unchanged(strong,capture(c,"shafts-returned"),"Moving and returning leaves no history or trailing light");
+        var reload=c.computeOnClient(net.minecraft.client.Minecraft::reloadResourcePacks);c.waitFor(m->reload.isDone()&&m.gui.overlay()==null,1200);reload.join();settle(c);unchanged(strong,capture(c,"shafts-reloaded"),"Volume recovers after resource reload");
+        int w=c.computeOnClient(m->m.getWindow().getScreenWidth()),h=c.computeOnClient(m->m.getWindow().getScreenHeight());
+        c.runOnClient(m->m.getWindow().setWindowed(961,541));c.waitFor(m->m.gameRenderer.mainRenderTarget().width!=off.width(),200);settle(c);
+        enable(c,false);var small=capture(c,null);enable(c,true);check(gain(small,capture(c,"shafts-resized"))>1000,"Bilateral volume survives odd dimensions");
+        c.runOnClient(m->m.getWindow().setWindowed(w,h));c.waitFor(m->m.gameRenderer.mainRenderTarget().width==off.width(),200);settle(c);
+        roof(server,2);settle(c);enable(c,false);var leafOff=capture(c,null);enable(c,true);var leafOn=capture(c,"shafts-leaves");long leaf=gain(leafOff,leafOn);double leafEnergy=energy(leafOff,leafOn);check(leaf>1000,"Leaf canopy transmits light: "+leaf);
+        roof(server,3);settle(c);enable(c,false);var openOff=capture(c,null);enable(c,true);var openOn=capture(c,"shafts-open");long open=gain(openOff,openOn);double openEnergy=energy(openOff,openOn);check(openEnergy>leafEnergy,"Leaf canopy attenuates normalized scattering on identical walls: "+leafEnergy+" / "+openEnergy);
+        look(c,server,0,0);settle(c);enable(c,false);var sideOff=capture(c,null);enable(c,true);check(gain(sideOff,capture(c,"shafts-sun-offscreen"))>1000,"Volume persists with sun outside the viewport");
+        long[] close=new long[2];int index=0;
+        for(double z:new double[]{123.5,123.875}){camera(c,server,100.5,101,z,70);look(c,server,0,0);settle(c);enable(c,false);var nearOff=capture(c,null);enable(c,true);close[index++]=gain(nearOff,capture(c,"shafts-wall-"+z));}
+        check(close[1]<=close[0]+100,"Approaching wall attenuates scattering instead of increasing it: "+close[0]+" / "+close[1]);
+        c.runOnClient(m->VanillaLight.setSunshaftIntensity(0));c.waitTicks(10);c.runOnClient(m->check(!Sunshafts.allocated()&&PixelShadows.shadowMap()==null,"Zero frees volume and unneeded shared map"));
+        c.runOnClient(m->VanillaLight.setSunshaftIntensity(35));enable(c,true);
+        server.runOnServer(s->command(s,"time set 18000"));c.waitTicks(30);c.runOnClient(m->check(!Sunshafts.allocated()&&!Sunshafts.applied(),"Solar volume stops at night"));
+        server.runOnServer(s->command(s,"time set 3000"));camera(c,server,100.5,101,110.5,70);aim(c,server);settle(c);
+        c.runOnClient(m->{VanillaLight.setPixelShadows(true);VanillaLight.setPbr(true);VanillaLight.setSsgi(true);VanillaLight.setBloom(true);VanillaLight.setLensFlare(true);VanillaLight.setEdgeHighlights(true);});activeFrames(c);capture(c,"shafts-combined");
+        c.runOnClient(m->{VanillaLight.setSunshafts(false);});c.waitTicks(10);c.runOnClient(m->check(!Sunshafts.allocated()&&PixelShadows.applied(),"OFF preserves independently enabled surface shadows"));
+        for(String locale:new String[]{"fr_fr","en_us"})c.runOnClient(m->{m.getLanguageManager().setSelected(locale);m.getLanguageManager().onResourceManagerReload(m.getResourceManager());for(String suffix:new String[]{"sunshafts","sunshafts_help","sunshaft_intensity","sunshaft_intensity_help"}){String key="sanctuary.shaders."+suffix;check(!Component.translatable(key).getString().equals(key),"Localized volume controls: "+locale);}});
+        System.out.println("SUNSHAFT137_PASS slotGain="+low+" leafGain="+leaf+" openGain="+open+" closed room, offscreen sun, camera return, proximity, reload/resize, shared map, zero/night, preferences, FR/EN");
+        SunshaftWeather138ClientChecks.run(c,server);
+    }
+    static void roof(TestServerContext server,int mode){server.runOnServer(s->{for(int x=76;x<=124;x++)for(int z=76;z<=124;z++)s.overworld().setBlockAndUpdate(new BlockPos(x,113,z),(mode==3||mode==1&&Math.floorMod(z,8)<3?Blocks.AIR:mode==2?Blocks.OAK_LEAVES:Blocks.OAK_PLANKS).defaultBlockState().trySetValue(net.minecraft.world.level.block.state.properties.BlockStateProperties.PERSISTENT,true));});}
+    static void aim(ClientGameTestContext c,TestServerContext server){var d=c.computeOnClient(m->PixelShadows.sunDirection(m.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle));look(c,server,Mth.wrapDegrees((float)Math.toDegrees(Math.atan2(-d.x,d.z))+25),-12);}
+    static void settle(ClientGameTestContext c){int before=c.computeOnClient(m->Sunshafts.renderedFrames());c.waitFor(m->Sunshafts.applied()&&PixelShadows.ready()&&Sunshafts.renderedFrames()>before+10,1200);c.waitTicks(30);}
+    static void enable(ClientGameTestContext c,boolean enabled){c.runOnClient(m->VanillaLight.setSunshafts(enabled));if(enabled)settle(c);else c.waitTicks(10);}
+    private static long gain(Frame off,Frame on){long sum=0;for(int i=0;i<off.pixels().length;i++)for(int shift:new int[]{0,8,16})sum+=Math.max(0,(on.pixels()[i]>>shift&255)-(off.pixels()[i]>>shift&255));return sum;}
+    // Screen blending has less headroom on a brighter vanilla wall. Remove that factor
+    // before comparing roofs, and exclude the roof itself where geometry changes.
+    static double energy(Frame off,Frame on){double sum=0;int n=0;for(int y=off.height()/3;y<off.height();y++)for(int x=0;x<off.width();x++){int i=y*off.width()+x;for(int shift:new int[]{0,8,16}){int a=off.pixels()[i]>>shift&255,b=on.pixels()[i]>>shift&255;if(a<240){sum+=Math.max(0,b-a)/(255.0-a);n++;}}}return sum/Math.max(1,n);}
+    private static void preferences(){try{var p=FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");Files.writeString(p,"{\"bloom\":false,\"pixelShadows\":false}");forgetPreferences();check(VanillaLight.sunshafts()&&VanillaLight.sunshaftIntensity()==35&&!VanillaLight.bloom()&&!VanillaLight.pixelShadows(),"Missing shaft settings preserve existing choices");VanillaLight.setSunshafts(false);VanillaLight.setSunshaftIntensity(73);forgetPreferences();check(!VanillaLight.sunshafts()&&VanillaLight.sunshaftIntensity()==73,"Custom shafts persist");for(int n:new int[]{-10,0,35,100,150}){VanillaLight.setSunshaftIntensity(n);forgetPreferences();check(VanillaLight.sunshaftIntensity()==Math.clamp(n,0,100),"Intensity clamps and persists");}VanillaLight.setSunshaftIntensity(35);}catch(java.io.IOException e){throw new AssertionError(e);}}
+}

mods/sanctuary/src/gametest/java/fr/koka/sanctuary/gametest/mixin/Colored139LightmapProbeMixin.java

@@ -0,0 +1,17 @@
+package fr.koka.sanctuary.gametest.mixin;
+
+import net.minecraft.client.renderer.Lightmap;
+import net.minecraft.client.renderer.state.LightmapRenderState;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+/** Freeze only vanilla torch flicker for image comparisons; never packaged in the mod. */
+@Mixin(Lightmap.class)
+public abstract class Colored139LightmapProbeMixin {
+    @Inject(method="render",at=@At("HEAD"))
+    private void stableBlockLight(LightmapRenderState state,CallbackInfo ci){
+        if(Boolean.getBoolean("sanctuary.test.freezeBlockFlicker")){state.blockFactor=1;state.needsUpdate=true;}
+    }
+}

mods/sanctuary/src/gametest/resources/sanctuary-gametest.mixins.json

@@ -10,6 +10,7 @@
     "defaultRequire": 1
   },
   "client": [
+    "Colored139LightmapProbeMixin",
     "Fourneau094ParticleProbeMixin",
     "Tooltip093FontProbeMixin",
     "ClientVsync046Mixin",

mods/sanctuary/src/main/java/fr/koka/sanctuary/SanctuaryMod.java

@@ -44,6 +44,7 @@ public final class SanctuaryMod implements ModInitializer {
     @Override
     public void onInitialize() {
         fr.koka.sanctuary.building.ColoredBricks.register();
+        fr.koka.sanctuary.gems.Gems.register();
         fr.koka.sanctuary.sky.VortexClouds.register();
         fr.koka.sanctuary.loading.PreloadProgress.register();
         fr.koka.sanctuary.progression.SanctuaryGameplay.register();

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/ClayWorkshopScreen.java

@@ -14,6 +14,7 @@ import net.minecraft.network.chat.Component;
 import net.minecraft.resources.Identifier;
 import net.minecraft.world.entity.player.Inventory;
 import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.item.Items;
 
 /** File selection is local; the two ordinary inventory slots and every crafted item are server-owned. */
 public final class ClayWorkshopScreen extends AbstractContainerScreen<ClayWorkshopMenu> {
@@ -91,9 +92,9 @@ public final class ClayWorkshopScreen extends AbstractContainerScreen<ClayWorksh
         if(previewSource!=source||changedMaterial){
             previewSource=source;lastMaterial=material.copy();sampledResources=resources;
             if(changedMaterial)palette=SculptureMaterialSampler.sample(material);
-            var colored=source==null?null:palette==null?source:palette.apply(source);
+            var colored=source==null?null:palette==null?source:ClayWorkshopMenu.appearance(source,material.getItem(),palette);
             preview=colored==null?ItemStack.EMPTY:StatuaryEntity.item(colored);pending=true;
-            if(source!=null&&!busy)status=palette==null?text("choose_material"):text("material_ready",material.getHoverName());
+            if(source!=null&&!busy)status=palette==null?text("choose_material"):material.is(Items.CLAY)?text("clay_ready"):text("material_ready",material.getHoverName());
         }
         // Retry a selection that raced the input packet or server rate limit. The result is the
         // acknowledgement; never predict consumption or manufacture an item on the client.

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/DynamicLightClient.java

@@ -27,6 +27,15 @@ public final class DynamicLightClient {
     private static DynamicLightConfig config;
     private static final Map<Item,Integer> overrides=new IdentityHashMap<>();
     private static int ticks;
+    private static boolean invalidatingSections;
+    private static final fr.koka.sanctuary.client.shader.ColoredLightMaterials colors=new fr.koka.sanctuary.client.shader.ColoredLightMaterials();
+    private static Object models;
+    public static boolean invalidatingSections(){return invalidatingSections;}
+    private static final class ColorMix {
+        double r,g,b;
+        void add(int light,int color){if(light<=0)return;double energy=Math.pow(.8,15-light);r=Math.max(r,(color>>16&255)*energy);g=Math.max(g,(color>>8&255)*energy);b=Math.max(b,(color&255)*energy);}
+        int result(){double m=Math.max(1e-8,Math.max(r,Math.max(g,b)));return (int)Math.round(r/m*255)<<16|(int)Math.round(g/m*255)<<8|(int)Math.round(b/m*255);}
+    }
     private DynamicLightClient() {}
     public static void register(KeyMapping.Category category) {
         config=DynamicLightConfig.load();
@@ -50,7 +59,7 @@ public final class DynamicLightClient {
     }
     public static int pendingSections() {return field.pendingCount();}
     private static void reset(ClientLevel level) {
-        field=new DynamicLightField();view=new View(level,field.snapshot());ticks=0;
+        field=new DynamicLightField();view=new View(level,field.snapshot());ticks=0;colors.clear();models=null;
     }
     private static int emission(ItemStack stack) {return overrides.getOrDefault(stack.getItem(),-1)>=0?overrides.get(stack.getItem()):ItemLightEmission.of(stack);}
     private static void tick(Minecraft m) {
@@ -59,6 +68,8 @@ public final class DynamicLightClient {
         if(ticks++%config.updateIntervalTicks==0) {
             List<DynamicLightField.Source> sources=List.of();
             if(config.enabled) {
+                var currentModels=m.getModelManager().getBlockStateModelSet();if(models!=currentModels){colors.clear();models=currentModels;}
+                boolean tinted=fr.koka.sanctuary.client.shader.VanillaLight.coloredLights();
                 var eye=m.getCameraEntity().getEyePosition();
                 var collect=new DynamicLightField.Collector(config.dropClusterSize);
                 double distance=config.range*config.range;
@@ -66,23 +77,26 @@ public final class DynamicLightClient {
                     if(entity.isRemoved() || entity.distanceToSqr(eye)>distance)continue;
                     boolean drop=entity instanceof ItemEntity;
                     int light=entity.isOnFire()?15:0;
+                    var mix=new ColorMix();if(light>0)mix.add(light,0xFFAB55);
                     double y=entity.getY()+entity.getBbHeight()*.5;
-                    if(entity instanceof ItemEntity item)light=Math.max(light,emission(item.getItem()));
+                    if(entity instanceof ItemEntity item){int emitted=emission(item.getItem());light=Math.max(light,emitted);if(emitted>0&&tinted)mix.add(emitted,colors.color(item.getItem()));}
                     else if(entity instanceof LivingEntity living) {
                         if(living instanceof Player p && p.isSpectator())continue;
-                        light=Math.max(light,Math.max(emission(living.getMainHandItem()),emission(living.getOffhandItem())));
-                        light=Math.max(light,emission(living.getItemBySlot(EquipmentSlot.HEAD)));
-                        light=Math.max(light,emission(HeadCosmeticService.appearance(living)));
+                        for(var stack:new ItemStack[]{living.getMainHandItem(),living.getOffhandItem(),living.getItemBySlot(EquipmentSlot.HEAD),HeadCosmeticService.appearance(living)}){
+                            int emitted=emission(stack);light=Math.max(light,emitted);if(emitted>0&&tinted)mix.add(emitted,colors.color(stack));
+                        }
                         y=entity.getEyeY();
                     }
-                    if(light>0)collect.add(entity.getId(),drop,entity.getX(),y,entity.getZ(),light);
+                    if(light>0)collect.add(entity.getId(),drop,entity.getX(),y,entity.getZ(),light,tinted?mix.result():0xFFFFFF);
                 }
                 sources=collect.finish(config.maxSources,eye.x,eye.y,eye.z,m.player==null?-1:m.player.getId());
             }
             if(field.update(sources))view=new View(m.level,field.snapshot());
         }
         // Native renderer marks only resident sections; it neither loads chunks nor rebuilds the whole world.
-        field.drain(config.sectionUpdatesPerTick,key->m.levelExtractor.setSectionDirty(
-                DynamicLightField.sectionX(key),DynamicLightField.sectionY(key),DynamicLightField.sectionZ(key)));
+        invalidatingSections=true;
+        try{field.drain(config.sectionUpdatesPerTick,key->m.levelExtractor.setSectionDirty(
+                DynamicLightField.sectionX(key),DynamicLightField.sectionY(key),DynamicLightField.sectionZ(key)));}
+        finally{invalidatingSections=false;}
     }
 }

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/SanctuaryKnowledgeClient.java

@@ -19,6 +19,8 @@ public final class SanctuaryKnowledgeClient implements ClientModInitializer {
     public static void registerClient() {
         SanctuaryResourcePack.register();
         VortexCloudRenderer.register();
+        fr.koka.sanctuary.client.shader.PixelShadows.register();
+        fr.koka.sanctuary.client.shader.EdgeHighlights.register();
         ProgressionClient.register();
         StarClient.register();
         WeatherClient.register();

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/Bloom.java

@@ -0,0 +1,165 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.buffers.GpuBufferSlice;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import com.mojang.renderpearl.api.textures.GpuTextureView;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.BindGroupLayouts;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.client.renderer.texture.TextureAtlas;
+import net.minecraft.core.BlockPos;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.dimension.DimensionType;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+import org.joml.Vector3f;
+import org.joml.Vector4f;
+
+/** Selective emissive bloom. No brightness threshold on ordinary world blocks, no scene-copy or readback. */
+public final class Bloom {
+    private static Identifier id(String path){return Identifier.parse("sanctuary:"+path);}
+    private static final BindGroupLayout SCENE=BindGroupLayout.builder().withUniform("BloomScene",UniformType.UNIFORM_BUFFER)
+            .withUniform("WorldDepth",UniformType.COMBINED_IMAGE_SAMPLER).build();
+    private static final RenderPipeline EMITTERS=RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(id("pipeline/bloom_emitters")).withVertexShader(id("core/bloom_emitters")).withFragmentShader(id("core/bloom_emitters"))
+            .withBindGroupLayout(BindGroupLayouts.DYNAMIC_TRANSFORMS).withBindGroupLayout(SCENE)
+            .withBindGroupLayout(BindGroupLayout.builder().withUniform("BlockAtlas",UniformType.COMBINED_IMAGE_SAMPLER).withUniform("EmissionMasks",UniformType.COMBINED_IMAGE_SAMPLER).build())
+            .withVertexBinding(0,BloomTerrain.FORMAT).withPrimitiveTopology(PrimitiveTopology.QUADS).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.empty(),GpuFormat.RGBA8_UNORM,ColorTargetState.WRITE_ALL))
+            .withDepthStencilState(Optional.empty()).build());
+    private static RenderPipeline screen(String name,BlendFunction blend,boolean scene,boolean blur){
+        var layout=BindGroupLayout.builder().withUniform("InputTexture",UniformType.COMBINED_IMAGE_SAMPLER);
+        if(blur)layout.withUniform("BlurParams",UniformType.UNIFORM_BUFFER);
+        var builder=RenderPipeline.builder().withLocation(id("pipeline/"+name)).withVertexShader("core/screenquad").withFragmentShader(id("core/"+name)).withBindGroupLayout(layout.build());
+        if(scene)builder.withBindGroupLayout(SCENE);
+        return RenderPipelines.register(builder.withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+                .withColorTargetState(new ColorTargetState(Optional.ofNullable(blend),name.equals("bloom_blur")||name.equals("bloom_downsample")||name.equals("lens_flare_source")?GpuFormat.RGBA16_FLOAT:GpuFormat.RGBA8_UNORM,blend==null?ColorTargetState.WRITE_ALL:ColorTargetState.WRITE_COLOR)).withDepthStencilState(Optional.empty()).build());
+    }
+    private static final RenderPipeline SKY=screen("bloom_sky",null,true,false);
+    private static final RenderPipeline DOWNSAMPLE=screen("bloom_downsample",null,false,false);
+    private static final RenderPipeline BLUR=screen("bloom_blur",null,false,true);
+    private static final RenderPipeline CORE=screen("bloom_core",new BlendFunction(BlendFactor.ONE,BlendFactor.ONE_MINUS_SRC_ALPHA,BlendFactor.ZERO,BlendFactor.ONE),false,false);
+    private static final RenderPipeline APPLY=screen("bloom_apply",new BlendFunction(BlendFactor.ONE,BlendFactor.ONE_MINUS_SRC_COLOR,BlendFactor.ZERO,BlendFactor.ONE),true,false);
+    private static final RenderPipeline FLARE_SOURCE=screen("lens_flare_source",null,true,false);
+    private static final RenderPipeline FLARE=screen("lens_flare",new BlendFunction(BlendFactor.ONE,BlendFactor.ONE_MINUS_SRC_COLOR,BlendFactor.ZERO,BlendFactor.ONE),true,false);
+    private static final BloomTerrain TERRAIN=new BloomTerrain();
+    private static final Matrix4f projection=new Matrix4f();
+    private static TextureTarget emission,small,ping,flareSource;
+    private static MappableRingBuffer scene,horizontal,vertical;
+    private static int frames;
+    private static boolean applied;
+    private Bloom(){}
+    public static void captureProjection(Matrix4f matrix){projection.set(matrix);}
+    public static void dirtyBlock(BlockPos pos){TERRAIN.dirty(pos);}
+    public static void dirtyChunk(int x,int z){TERRAIN.dirtyChunk(x,z);}
+    public static void render(){
+        applied=false;var mc=Minecraft.getInstance();
+        boolean halo=VanillaLight.bloom()&&VanillaLight.bloomIntensity()>0;
+        boolean flare=VanillaLight.lensFlare()&&VanillaLight.lensFlareIntensity()>0;
+        boolean cores=VanillaLight.oreEmission()&&VanillaLight.oreIntensity()>0;
+        if(!VanillaLight.active()||(!halo&&!cores&&!flare)||mc.level==null){release();return;}
+        if(PanoramaCapture.rendering())return;
+        var state=mc.gameRenderer.gameRenderState().levelRenderState;var camera=state.cameraRenderState;
+        if(camera.fogType!=FogType.NONE)return;
+        var main=mc.gameRenderer.mainRenderTarget();
+        if(emission==null||emission.width!=main.width||emission.height!=main.height){
+            targetsClose();emission=target("emission",main.width,main.height);
+        }
+        if(scene==null)scene=uniforms("bloom scene",192);
+        if(halo){
+            if(small==null){small=target("bloom low",Math.max(1,main.width/8),Math.max(1,main.height/8));ping=target("bloom ping",small.width,small.height);}
+            if(horizontal==null){horizontal=uniforms("bloom horizontal",16);vertical=uniforms("bloom vertical",16);}
+        }else haloClose();
+        if(flare){if(flareSource==null)flareSource=target("lens flare sources",2,1);}else flareClose();
+        // A celestial-only flare never needs to scan or mesh terrain emitters.
+        var entries=(halo||cores)?TERRAIN.update():List.<BloomTerrain.Entry>of();
+        if(!halo&&!cores)TERRAIN.close();
+        var atlas=TERRAIN.materials.atlas();
+        var vp=new Matrix4f(projection).mul(camera.viewRotationMatrix);var inverse=new Matrix4f(vp).invert();
+        var sun=PixelShadows.sunDirection(state.skyRenderState.sunAngle);var moon=PixelShadows.sunDirection(state.skyRenderState.moonAngle);
+        float celestial=state.skyRenderState.skybox==DimensionType.Skybox.OVERWORLD?state.skyRenderState.rainBrightness:0;
+        var flareSun=projectFlare(vp,sun,celestial);
+        var flareMoon=projectFlare(vp,moon,celestial*.35f);
+        var fog=camera.fogData;scene.rotate();
+        try(var mapped=scene.currentBuffer().map(false,true)){
+            Std140Builder.intoBuffer(mapped.data()).putMat4f(inverse)
+                    .putVec4(VanillaLight.oreEmission()?VanillaLight.oreIntensity()/100f:0,RenderSystem.getDevice().getDeviceInfo().isZZeroToOne()?1:0,VanillaLight.bloomIntensity()/50f,0)
+                    .putVec4(sun.x,sun.y,sun.z,celestial).putVec4(moon.x,moon.y,moon.z,celestial*.35f)
+                    .putVec4(fog.renderDistanceStart,fog.renderDistanceEnd,fog.environmentalStart,fog.environmentalEnd).putVec4(fog.color.w,0,0,0)
+                    .putVec4(flareSun).putVec4(flareMoon).putVec4(flare?VanillaLight.lensFlareIntensity()/100f:0,(float)main.width/main.height,0,0);
+        }
+        if(halo){
+            float radius=.25f+VanillaLight.bloomRadius()*.0075f;
+            horizontal.rotate();try(var mapped=horizontal.currentBuffer().map(false,true)){Std140Builder.intoBuffer(mapped.data()).putVec4(radius/small.width,0,0,0);}
+            vertical.rotate();try(var mapped=vertical.currentBuffer().map(false,true)){Std140Builder.intoBuffer(mapped.data()).putVec4(0,radius/small.height,0,0);}
+        }
+        // Gather transforms before opening any pass (the native dynamic ring may resize).
+        var transforms=new ArrayList<GpuBufferSlice>(entries.size());int max=0;
+        for(var entry:entries){var pos=entry.origin();var offset=new Vector3f((float)(pos.getX()-camera.pos.x),(float)(pos.getY()-camera.pos.y),(float)(pos.getZ()-camera.pos.z));
+            transforms.add(RenderSystem.getDynamicUniforms().writeTransform(new Matrix4f(vp).translate(offset),new Vector4f(1,1,1,1),offset,new Matrix4f()));max=Math.max(max,entry.indices());}
+        var indices=RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS);indices.requestIndexCount(max);
+        var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        if(halo||flare)screen(SKY,emission.getColorTextureView(),main.getColorTextureView(),true,null);
+        else try(var clear=RenderSystem.getDevice().createCommandEncoder().createRenderPass(()->"Sanctuary clear emission",emission.getColorTextureView(),Optional.of(new Vector4f(0,0,0,0)))){ }
+
+        // Reduce the celestial-only mask before drawing any torch, ore or other terrain emitter.
+        if(flare)screen(FLARE_SOURCE,flareSource.getColorTextureView(),emission.getColorTextureView(),true,null);
+        if(atlas!=null&&!entries.isEmpty())try(var pass=RenderSystem.getDevice().createCommandEncoder().createRenderPass(()->"Sanctuary visible emitters",emission.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(EMITTERS));pass.setUniform("BloomScene",scene.currentBuffer());pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);
+            pass.setUniform("BlockAtlas",mc.getTextureManager().getTexture(TextureAtlas.LOCATION_BLOCKS).getTextureView(),nearest);pass.setUniform("EmissionMasks",atlas.getTextureView(),nearest);
+            pass.setIndexBuffer(indices.getBuffer(),indices.type());
+            for(int i=0;i<entries.size();i++){var entry=entries.get(i);pass.setUniform("DynamicTransforms",transforms.get(i));pass.setVertexBuffer(0,entry.vertices().slice());pass.drawIndexed(entry.indices(),1,0,0,0);}
+        }
+        if(halo){
+            screen(DOWNSAMPLE,small.getColorTextureView(),emission.getColorTextureView(),false,null);
+            screen(BLUR,ping.getColorTextureView(),small.getColorTextureView(),false,horizontal);
+            screen(BLUR,small.getColorTextureView(),ping.getColorTextureView(),false,vertical);
+        }
+        if(cores)screen(CORE,main.getColorTextureView(),emission.getColorTextureView(),false,null);
+        if(halo)screen(APPLY,main.getColorTextureView(),small.getColorTextureView(),true,null);
+        if(flare)screen(FLARE,main.getColorTextureView(),flareSource.getColorTextureView(),true,null);
+        applied=true;frames++;
+    }
+    private static Vector4f projectFlare(Matrix4f vp,Vector3f direction,float strength){
+        var clip=vp.transform(new Vector4f(direction,0));
+        if(clip.w<=.05f||direction.y<=0||strength<=0)return new Vector4f(0,0,0,0);
+        float x=clip.x/clip.w*.5f+.5f,y=clip.y/clip.w*.5f+.5f;
+        // Actual sprite light is measured on GPU. This is only its projected sampling region.
+        float radius=Math.min(.3f,Math.abs(projection.m11())*.08f/clip.w);
+        float horizon=Math.clamp(direction.y/.08f,0,1);
+        return new Vector4f(x,y,radius,strength*horizon*horizon*(3-2*horizon));
+    }
+    private static void flareClose(){if(flareSource!=null){flareSource.destroyBuffers();flareSource=null;}}
+    private static void screen(RenderPipeline pipeline,GpuTextureView output,GpuTextureView input,boolean useScene,MappableRingBuffer blur){
+        try(var pass=RenderSystem.getDevice().createCommandEncoder().createRenderPass(()->"Sanctuary bloom",output,Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(pipeline));pass.setUniform("InputTexture",input,RenderSystem.getSamplerCache().getClampToEdge(pipeline==CORE||pipeline==SKY?FilterMode.NEAREST:FilterMode.LINEAR));
+            if(useScene){pass.setUniform("BloomScene",scene.currentBuffer());pass.setUniform("WorldDepth",Minecraft.getInstance().gameRenderer.mainRenderTarget().getDepthTextureView(),RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST));}
+            if(blur!=null)pass.setUniform("BlurParams",blur.currentBuffer());pass.draw(3,1,0,0);
+        }
+    }
+    private static TextureTarget target(String name,int w,int h){return new TextureTarget("Sanctuary "+name,w,h,name.equals("emission")?GpuFormat.RGBA8_UNORM:GpuFormat.RGBA16_FLOAT,null);}
+    private static MappableRingBuffer uniforms(String name,int size){return new MappableRingBuffer(()->"Sanctuary "+name,GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,size);}
+    private static void haloClose(){
+        if(small!=null){small.destroyBuffers();ping.destroyBuffers();small=ping=null;}
+        if(horizontal!=null){horizontal.close();vertical.close();horizontal=vertical=null;}
+    }
+    private static void targetsClose(){haloClose();flareClose();if(emission!=null){emission.destroyBuffers();emission=null;}}
+    public static void release(){TERRAIN.close();targetsClose();if(scene!=null){scene.close();scene=null;}applied=false;}
+    static TextureTarget flareTarget(){return flareSource;}
+    static boolean flareAllocated(){return flareSource!=null;}
+    static boolean haloAllocated(){return small!=null||horizontal!=null;}
+    static boolean applied(){return applied;}
+    static boolean allocated(){return emission!=null;}
+    static boolean ready(){return TERRAIN.settled();}
+    static int renderedFrames(){return frames;}
+    static TextureTarget emissionTarget(){return emission;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/BloomMaterials.java

@@ -0,0 +1,111 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.platform.NativeImage;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.texture.DynamicTexture;
+import net.minecraft.client.renderer.texture.TextureAtlasSprite;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.block.state.BlockState;
+
+/** Analyse source texels once per resource reload, never rendered frames or GPU pixels. */
+final class BloomMaterials implements AutoCloseable {
+    static final int TILE=68, INNER=64, SIZE=TILE*16, MAX_SPRITES=256;
+    record Slot(int x,int y,boolean empty) {
+        float u(float local){return (x+2+Math.clamp(local,0,1)*INNER)/SIZE;}
+        float v(float local){return (y+2+Math.clamp(local,0,1)*INNER)/SIZE;}
+    }
+    private final Map<String,Slot> slots=new HashMap<>();
+    private final Map<BlockState,Boolean> ores=new IdentityHashMap<>();
+    private final Map<Identifier,int[]> hosts=new HashMap<>();
+    private DynamicTexture atlas;
+    private boolean dirty;
+    private static final Set<String> ORES=Set.of("iron","copper","redstone","lapis","diamond","emerald","ruby","sapphire","quartz","gold");
+
+    boolean ore(BlockState state){return ores.computeIfAbsent(state,s->{
+        var id=BuiltInRegistries.BLOCK.getKey(s.getBlock());
+        if(!id.getNamespace().equals("minecraft")&&!id.getNamespace().equals("sanctuary"))return false;
+        String name=id.getPath().replaceFirst("^(deepslate_|nether_)","");
+        return name.endsWith("_ore")&&ORES.contains(name.substring(0,name.length()-4));
+    });}
+    boolean candidate(BlockState state){return ore(state)||state.getLightEmission()>0||state.emissiveRendering();}
+
+    Slot slot(TextureAtlasSprite sprite,boolean ore,boolean fullEmission){
+        String key=sprite.contents().name()+":"+ore+":"+fullEmission;
+        var cached=slots.get(key);if(cached!=null)return cached;
+        if(slots.size()>=MAX_SPRITES)return new Slot(0,0,true);
+        int index=slots.size(),x=(index%16)*TILE,y=(index/16)*TILE;
+        if(atlas==null){atlas=new DynamicTexture("Sanctuary emissive masks",SIZE,SIZE,false);atlas.getPixels().fillRect(0,0,SIZE,SIZE,0);}
+        boolean any=false;
+        var id=sprite.contents().name();
+        try(var image=read(id)){
+            int frameWidth=Math.min(image.getWidth(),sprite.contents().width()),frameHeight=Math.min(image.getHeight(),sprite.contents().height());
+            int w=Math.min(INNER,frameWidth),h=Math.min(INNER,frameHeight);
+            int[] colors=new int[w*h];for(int iy=0;iy<h;iy++)for(int ix=0;ix<w;ix++)colors[iy*w+ix]=image.getPixel(ix*frameWidth/w,iy*frameHeight/h);
+            int[] mask=mask(id,colors,w,h,ore,fullEmission);
+            // Standard optional _e texture takes precedence, including in personal resource packs.
+            var override=Minecraft.getInstance().getResourceManager().getResource(texture(id.withSuffix("_e")));
+            if(override.isPresent())try(var stream=override.get().open();var explicit=NativeImage.read(stream)){
+                for(int iy=0;iy<h;iy++)for(int ix=0;ix<w;ix++){
+                    int c=explicit.getPixel(ix*explicit.getWidth()/w,iy*Math.min(explicit.getHeight(),frameHeight)/h);
+                    mask[iy*w+ix]=(c>>>24)*Math.max((c>>16)&255,Math.max((c>>8)&255,c&255))/255;
+                }
+            }
+            for(int iy=0;iy<TILE;iy++)for(int ix=0;ix<TILE;ix++){
+                int value=mask[Math.clamp((iy-2)*h/INNER,0,h-1)*w+Math.clamp((ix-2)*w/INNER,0,w-1)];
+                any|=value>0;atlas.getPixels().setPixel(x+ix,y+iy,0xFF000000|value*0x010101);
+            }
+        }catch(java.io.IOException exception){
+            fr.koka.sanctuary.SanctuaryMod.LOGGER.warn("Cannot analyse emissive texture {}",id,exception);
+        }
+        var result=new Slot(x,y,!any);slots.put(key,result);dirty=true;return result;
+    }
+
+    int[] mask(Identifier id,int[] colors,int width,int height,boolean ore,boolean fullEmission){
+        int[] result=new int[colors.length];String name=id.getPath();
+        boolean quartz=name.contains("quartz"),nether=name.contains("nether_gold")||quartz;
+        int[] host=ore?host(nether?"netherrack":name.contains("deepslate")?"deepslate":"stone"):new int[0];
+        boolean structural=!ore&&!fullEmission&&(name.contains("furnace_side")||name.contains("furnace_top")
+                ||name.contains("smoker_side")||name.contains("smoker_top")||name.contains("smoker_bottom")
+                ||name.contains("campfire_log")&&!name.contains("lit")||name.contains("respawn_anchor_side")
+                ||name.contains("respawn_anchor_bottom"));
+        for(int i=0;i<colors.length;i++){
+            int c=colors[i],r=c>>16&255,g=c>>8&255,b=c&255,max=Math.max(r,Math.max(g,b)),min=Math.min(r,Math.min(g,b));
+            if((c>>>24)<128||structural)continue;
+            if(ore){
+                int difference=255;
+                for(int base:host){int br=base>>16&255,bg=base>>8&255,bb=base&255;
+                    difference=Math.min(difference,Math.max(Math.abs(r-br),Math.max(Math.abs(g-bg),Math.abs(b-bb))));}
+                boolean inclusion=nether?(quartz?g>r*.65&&b>r*.5&&max>110:r>110&&g>75&&g>b*1.45):max-min>=10;
+                if(inclusion&&difference>=10)result[i]=255;
+            }else{
+                // Luminosity is tied to the block state; cold/off variants never enter this path.
+                // Dark casings/wood are suppressed; live atlas colours and animation stay native.
+                float value=fullEmission?1:Math.clamp((max-100)/110f,0,1);
+                if(name.contains("torch")||name.contains("furnace")||name.contains("smoker")||name.contains("campfire"))
+                    value*=Math.clamp((max-min-35)/65f,0,1);
+                result[i]=Math.round(value*255);
+            }
+        }
+        if(ore&&!nether){
+            // Retain pale/white highlights touching coloured inclusions, without growing into grey rock.
+            int[] seed=result.clone();
+            for(int y=0;y<height;y++)for(int x=0;x<width;x++)if(seed[y*width+x]==0){
+                int c=colors[y*width+x],r=c>>16&255,g=c>>8&255,b=c&255;
+                if((c>>>24)<128||Math.min(r,Math.min(g,b))<215)continue;
+                for(int dy=-1;dy<=1;dy++)for(int dx=-1;dx<=1;dx++)if(x+dx>=0&&x+dx<width&&y+dy>=0&&y+dy<height&&seed[(y+dy)*width+x+dx]>0)result[y*width+x]=255;
+            }
+        }
+        return result;
+    }
+    private int[] host(String name){return hosts.computeIfAbsent(Identifier.withDefaultNamespace("block/"+name),id->{
+        try(var image=read(id)){var values=new LinkedHashSet<Integer>();for(int y=0;y<Math.min(64,image.getHeight());y++)for(int x=0;x<Math.min(64,image.getWidth());x++)values.add(image.getPixel(x*image.getWidth()/Math.min(64,image.getWidth()),y*image.getHeight()/Math.min(64,image.getHeight())));return values.stream().mapToInt(Integer::intValue).toArray();}
+        catch(java.io.IOException exception){return new int[0];}
+    });}
+    static Identifier texture(Identifier id){return Identifier.fromNamespaceAndPath(id.getNamespace(),"textures/"+id.getPath()+".png");}
+    static NativeImage read(Identifier id)throws java.io.IOException{try(var stream=Minecraft.getInstance().getResourceManager().getResourceOrThrow(texture(id)).open()){return NativeImage.read(stream);}}
+    DynamicTexture atlas(){if(dirty){atlas.upload();dirty=false;}return atlas;}
+    int count(){return slots.size();}
+    public void close(){if(atlas!=null){atlas.close();atlas=null;}slots.clear();ores.clear();hosts.clear();dirty=false;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/BloomTerrain.java

@@ -0,0 +1,147 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.blaze3d.vertex.BufferBuilder;
+import com.mojang.blaze3d.vertex.ByteBufferBuilder;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.PrimitiveTopology;
+import com.mojang.renderpearl.api.vertex.VertexFormat;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.model.geom.builders.UVPair;
+import net.minecraft.client.renderer.block.dispatch.BlockStateModelPart;
+import net.minecraft.client.renderer.texture.TextureAtlas;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.core.SectionPos;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.level.chunk.LevelChunkSection;
+import net.minecraft.world.level.chunk.status.ChunkStatus;
+import net.minecraft.world.phys.Vec3;
+
+/** Native visible sections only, palette rejection and bounded incremental emitter meshing. */
+final class BloomTerrain implements AutoCloseable {
+    static final VertexFormat FORMAT=VertexFormat.builder(0).addAttribute("Position",GpuFormat.RGB32_FLOAT)
+            .addAttribute("Color",GpuFormat.RGBA8_UNORM).addAttribute("UV0",GpuFormat.RG32_FLOAT)
+            .addAttribute("UV3",GpuFormat.RG32_FLOAT).build();
+    private static final long MAX_BYTES=32L*1024*1024;
+    private final Map<Long,Section> sections=new HashMap<>();
+    final BloomMaterials materials=new BloomMaterials();
+    private Build building;
+    private long bytes;
+    private Object models,level;
+    private List<Section> visible=List.of();
+    record Entry(BlockPos origin,GpuBuffer vertices,int indices){}
+    List<Entry> update(){
+        var mc=Minecraft.getInstance();var current=mc.getModelManager().getBlockStateModelSet();
+        if(models!=current||level!=mc.level){close();models=current;level=mc.level;}
+        long frame=mc.level.getGameTime();var active=new ArrayList<Section>();
+        for(var render:mc.levelRenderer.visibleSections()){
+            long key=render.getSectionNode();var pos=render.getRenderOrigin();
+            var chunk=mc.level.getChunkSource().getChunk(pos.getX()>>4,pos.getZ()>>4,ChunkStatus.FULL,false);
+            if(chunk==null)continue;
+            var storage=chunk.getSection(mc.level.getSectionIndex(pos.getY()));
+            var section=sections.get(key);
+            if(section==null||section.storage!=storage){if(section!=null)remove(section);section=new Section(key,pos.immutable(),storage);sections.put(key,section);}
+            section.seen=frame;active.add(section);
+        }
+        visible=active;
+        for(var iterator=sections.values().iterator();iterator.hasNext();){var section=iterator.next();if(frame-section.seen>40){remove(section);iterator.remove();}}
+        Vec3 camera=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState.pos;
+        long deadline=System.nanoTime()+3_000_000L;int started=building==null?0:1;
+        while(System.nanoTime()<deadline){
+            if(building==null){
+                if(started++>=4)break;
+                Section next=active.stream().filter(s->s.dirty).min(Comparator.comparingDouble(s->s.origin.distToCenterSqr(camera))).orElse(null);
+                if(next==null)break;
+                if(!next.storage.maybeHas(materials::candidate)){next.dirty=false;continue;}
+                building=new Build(next);
+            }
+            if(!advance(building,deadline))break;
+            var done=building;building=null;
+            try(done){
+                done.section.dirty=false;
+                if(done.quads>0&&!done.overflow){
+                    try(var mesh=done.out.buildOrThrow()){
+                        long size=mesh.vertexBuffer().remaining();
+                        if(bytes+size<=MAX_BYTES){
+                            var buffer=RenderSystem.getDevice().createBuffer(()->"Sanctuary bloom emitters",GpuBuffer.USAGE_VERTEX|GpuBuffer.USAGE_COPY_DST,mesh.vertexBuffer());
+                            int count=mesh.drawState().indexCount();RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS).getBuffer(count);
+                            done.section.entry=new Entry(done.section.origin,buffer,count);bytes+=buffer.size();
+                        }
+                    }
+                }
+            }
+        }
+        return active.stream().map(s->s.entry).filter(Objects::nonNull).toList();
+    }
+    private boolean advance(Build build,long deadline){
+        var mc=Minecraft.getInstance();var models=mc.getModelManager().getBlockStateModelSet();
+        var parts=new ArrayList<BlockStateModelPart>();var random=RandomSource.create();
+        while(build.cursor<4096){
+            int i=build.cursor++,x=i&15,z=i>>4&15,y=i>>8;var state=build.section.storage.getBlockState(x,y,z);
+            if(materials.candidate(state)){
+                var pos=build.section.origin.offset(x,y,z);boolean ore=materials.ore(state);
+                parts.clear();random.setSeed(state.getSeed(pos));if(!state.liquid())models.get(state).collectParts(random,parts);
+                var tintSources=mc.getBlockColors().getTintSources(state);
+                var offset=state.getOffset(pos);
+                for(var part:parts)for(int f=0;f<7;f++){
+                    Direction face=f==6?null:Direction.values()[f];
+                    if(face!=null&&mc.level.getBlockState(pos.relative(face)).isSolidRender())continue;
+                    for(var quad:part.getQuads(face)){
+                        var material=quad.materialInfo();var sprite=material.sprite();
+                        if(!sprite.atlasLocation().equals(TextureAtlas.LOCATION_BLOCKS))continue;
+                        var slot=materials.slot(sprite,ore,material.lightEmission()>0||state.emissiveRendering()||sprite.isAnimated());
+                        if(slot.empty())continue;
+                        if(build.quads>=16384){build.overflow=true;return true;}
+                        int tint=0xFFFFFF,index=material.tintIndex();
+                        if(index>=0&&index<tintSources.size())tint=tintSources.get(index).colorInWorld(state,mc.level,pos)&0xFFFFFF;
+                        // Alpha marks ore vs. native emitter; the mask alpha is not a gameplay light value.
+                        int light=state.emissiveRendering()?15:Math.max(state.getLightEmission(),material.lightEmission());
+                        int alpha=ore?Math.round(light/15f*120):128+Math.round(light/15f*127);
+                        int color=(alpha<<24)|tint;
+                        for(int v=0;v<4;v++){
+                            var p=quad.position(v);float u=UVPair.unpackU(quad.packedUV(v)),tv=UVPair.unpackV(quad.packedUV(v));
+                            float localU=(u-sprite.getU0())/(sprite.getU1()-sprite.getU0()),localV=(tv-sprite.getV0())/(sprite.getV1()-sprite.getV0());
+                            build.out.addVertex(x+p.x()+(float)offset.x,y+p.y()+(float)offset.y,z+p.z()+(float)offset.z)
+                                    .setColor(color).setUv(u,tv).setUv3(slot.u(localU),slot.v(localV));
+                        }
+                        build.quads++;
+                    }
+                }
+                if(state.liquid()&&state.getLightEmission()>0)fluid(build,pos,x,y,z,state.getFluidState().getHeight(mc.level,pos));
+            }
+            if((build.cursor&31)==0&&System.nanoTime()>=deadline)return build.cursor==4096;
+        }
+        return true;
+    }
+    private void fluid(Build build,BlockPos pos,int x,int y,int z,float height){
+        var mc=Minecraft.getInstance();var sprite=((TextureAtlas)mc.getTextureManager().getTexture(TextureAtlas.LOCATION_BLOCKS)).getSprite(net.minecraft.resources.Identifier.withDefaultNamespace("block/lava_still"));
+        var slot=materials.slot(sprite,false,true);if(slot.empty())return;
+        // Native world depth retains the actual fluid silhouette and occludes these candidate faces.
+        float[][][] faces={{{0,height,0},{0,height,1},{1,height,1},{1,height,0}},{{0,0,0},{0,height,0},{1,height,0},{1,0,0}},
+                {{0,0,1},{1,0,1},{1,height,1},{0,height,1}},{{0,0,0},{0,0,1},{0,height,1},{0,height,0}},{{1,0,0},{1,height,0},{1,height,1},{1,0,1}}};
+        for(var face:faces){if(build.quads>=16384){build.overflow=true;return;}
+            for(int i=0;i<4;i++){float u=i>=2?1:0,v=i==1||i==2?1:0;var p=face[i];
+                build.out.addVertex(x+p[0],y+p[1],z+p[2]).setColor(0xFFFFFFFF).setUv(sprite.getU(u),sprite.getV(v)).setUv3(slot.u(u),slot.v(v));}
+            build.quads++;
+        }
+    }
+    void dirty(BlockPos pos){for(int x=(pos.getX()-1)>>4;x<=(pos.getX()+1)>>4;x++)for(int y=(pos.getY()-1)>>4;y<=(pos.getY()+1)>>4;y++)for(int z=(pos.getZ()-1)>>4;z<=(pos.getZ()+1)>>4;z++)dirty(sections.get(SectionPos.asLong(x,y,z)));}
+    void dirtyChunk(int x,int z){for(var section:sections.values())if(Math.abs((section.origin.getX()>>4)-x)<=1&&Math.abs((section.origin.getZ()>>4)-z)<=1)dirty(section);}
+    private void dirty(Section section){if(section!=null){remove(section);section.dirty=true;}}
+    private void remove(Section section){if(building!=null&&building.section==section){building.close();building=null;}if(section.entry!=null){bytes-=section.entry.vertices.size();section.entry.vertices.close();section.entry=null;}}
+    boolean settled(){return building==null&&visible.stream().noneMatch(s->s.dirty);}
+    public void close(){if(building!=null){building.close();building=null;}for(var section:sections.values())remove(section);sections.clear();visible=List.of();materials.close();models=level=null;bytes=0;}
+    private static final class Section{
+        final long key;final BlockPos origin;final LevelChunkSection storage;long seen;boolean dirty=true;Entry entry;
+        Section(long key,BlockPos origin,LevelChunkSection storage){this.key=key;this.origin=origin;this.storage=storage;}
+    }
+    private static final class Build implements AutoCloseable{
+        final Section section;final ByteBufferBuilder buffer=new ByteBufferBuilder(65536);final BufferBuilder out=new BufferBuilder(buffer,PrimitiveTopology.QUADS,FORMAT);
+        int cursor,quads;boolean overflow;
+        Build(Section section){this.section=section;}
+        public void close(){buffer.close();}
+    }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ColoredDynamicLights.java

@@ -0,0 +1,37 @@
+package fr.koka.sanctuary.client.shader;
+
+import fr.koka.sanctuary.client.DynamicLightClient;
+import fr.koka.sanctuary.lighting.DynamicLightField;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.world.phys.Vec3;
+
+/** Same bounded sources as native dynamic lighting, with visual interpolation only. */
+final class ColoredDynamicLights {
+    static final int LIMIT=128;
+    static final class Light {
+        double x,y,z,r,g,b,visibility;int level;boolean seen;
+        Light(DynamicLightField.Source s){x=s.x();y=s.y();z=s.z();level=s.light();r=(s.color()>>16&255)/255.;g=(s.color()>>8&255)/255.;b=(s.color()&255)/255.;}
+    }
+    private final Map<DynamicLightField.Id,Light> lights=new HashMap<>();
+    private long last;
+    List<Light> update(Vec3 camera){
+        long now=System.nanoTime();double dt=last==0?0:Math.min(.1,(now-last)/1e9);last=now;
+        double ease=1-Math.exp(-dt*14),fade=dt/.3;
+        lights.values().forEach(l->l.seen=false);
+        var mc=Minecraft.getInstance();
+        for(var s:DynamicLightClient.snapshot(mc.level).sources()){
+            Light l=lights.computeIfAbsent(s.id(),id->new Light(s));l.seen=true;l.level=s.light();
+            boolean own=!s.id().drop()&&mc.player!=null&&s.id().value()==mc.player.getId()
+                    &&mc.getCameraEntity()==mc.player&&mc.options.getCameraType().isFirstPerson();
+            double x=own?camera.x:s.x(),y=own?camera.y:s.y(),z=own?camera.z:s.z();
+            double step=own?1:ease;l.x+=(x-l.x)*step;l.y+=(y-l.y)*step;l.z+=(z-l.z)*step;
+            l.r+=((s.color()>>16&255)/255.-l.r)*ease;l.g+=((s.color()>>8&255)/255.-l.g)*ease;l.b+=((s.color()&255)/255.-l.b)*ease;
+        }
+        for(var it=lights.values().iterator();it.hasNext();){var l=it.next();l.visibility=Math.clamp(l.visibility+(l.seen?fade:-fade),0,1);if(!l.seen&&l.visibility<=0)it.remove();}
+        return lights.values().stream().filter(l->camera.distanceToSqr(l.x,l.y,l.z)<Math.pow(VanillaLight.coloredLightDistance()+l.level,2))
+                .sorted(Comparator.comparingDouble(l->camera.distanceToSqr(l.x,l.y,l.z))).limit(LIMIT).toList();
+    }
+    Vec3 position(long entity){var l=lights.get(new DynamicLightField.Id(false,entity));return l==null?null:new Vec3(l.x,l.y,l.z);}
+    void clear(){lights.clear();last=0;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ColoredLightMaterials.java

@@ -0,0 +1,73 @@
+package fr.koka.sanctuary.client.shader;
+
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.core.Direction;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.resources.Identifier;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.client.renderer.block.dispatch.BlockStateModelPart;
+
+/** Colours are analysed once per state/resource reload, never from rendered GPU pixels. */
+public final class ColoredLightMaterials {
+    private final Map<BlockState,Integer> colors=new IdentityHashMap<>();
+    private final Map<Identifier,Integer> sprites=new HashMap<>();
+    private boolean warm;
+    public int color(BlockState state){if(warm!=VanillaLight.warmTorches()){warm=VanillaLight.warmTorches();clear();}return colors.computeIfAbsent(state,this::analyse);}
+    public int color(net.minecraft.world.item.ItemStack stack){
+        var state=fr.koka.sanctuary.cosmetics.HeadCosmeticData.state(stack);
+        if(state!=null)return color(state);
+        var item=stack.getItem();
+        if(item==net.minecraft.world.item.Items.LAVA_BUCKET)return 0xFF6020;
+        if(item==net.minecraft.world.item.Items.BLAZE_ROD||item==net.minecraft.world.item.Items.BLAZE_POWDER)return 0xFFAB55;
+        if(item==net.minecraft.world.item.Items.GLOWSTONE_DUST)return color(net.minecraft.world.level.block.Blocks.GLOWSTONE.defaultBlockState());
+        if(item==net.minecraft.world.item.Items.GLOW_BERRIES)return 0xFFBD52;
+        if(item==net.minecraft.world.item.Items.GLOW_INK_SAC||item==net.minecraft.world.item.Items.GLOW_ITEM_FRAME)return 0x66EADD;
+        return 0xFFFFFF;
+    }
+    private int analyse(BlockState state){
+        var id=BuiltInRegistries.BLOCK.getKey(state.getBlock());String name=id.getPath();
+        if(id.getNamespace().equals("minecraft")){
+            if(name.contains("copper"))return 0x62FFA0;
+            if(name.startsWith("soul_"))return 0x55BDFF;
+            if(name.contains("redstone"))return 0xFF0602;
+            if(name.equals("torch")||name.equals("wall_torch"))return VanillaLight.warmTorches()?0xFFAB55:0xFFFFFF;
+            if(name.equals("lava"))return 0xFF6020;
+            if(name.equals("pearlescent_froglight"))return 0xFFC0EC;
+            if(name.equals("verdant_froglight"))return 0xB4FF82;
+            if(name.equals("ochre_froglight"))return 0xFFCD72;
+            if(name.contains("torch")||name.equals("lantern")||name.equals("fire")||name.equals("campfire")||name.equals("lava"))return 0xFFAB55;
+        }
+        var parts=new ArrayList<BlockStateModelPart>();
+        Minecraft.getInstance().getModelManager().getBlockStateModelSet().get(state).collectParts(RandomSource.create(0),parts);
+        var used=new HashSet<Identifier>();long r=0,g=0,b=0;int count=0;
+        for(var part:parts)for(int f=0;f<7;f++)for(var quad:part.getQuads(f==6?null:Direction.values()[f])){
+            var sprite=quad.materialInfo().sprite().contents().name();if(!used.add(sprite))continue;
+            int color=sprites.computeIfAbsent(sprite,this::sample);if(color<0)continue;
+            r+=color>>16&255;g+=color>>8&255;b+=color&255;count++;
+        }
+        if(count==0)return 0xFFFFFF;
+        return normalize((float)r/count,(float)g/count,(float)b/count);
+    }
+    private int sample(Identifier id){
+        try(var image=BloomMaterials.read(id)){
+            double r=0,g=0,b=0,weight=0;
+            // First animation frame; bounded sampling also covers high-resolution packs.
+            int w=image.getWidth(),h=Math.min(w,image.getHeight()),step=Math.max(1,Math.max(w,h)/32);
+            for(int y=0;y<h;y+=step)for(int x=0;x<w;x+=step){
+                int c=image.getPixel(x,y);if((c>>>24)<128)continue;
+                int cr=c>>16&255,cg=c>>8&255,cb=c&255,max=Math.max(cr,Math.max(cg,cb)),min=Math.min(cr,Math.min(cg,cb));
+                double k=Math.max(0,(max-96)/159.0);k*=k*(.2+(max-min)/255.0);
+                r+=cr*k;g+=cg*k;b+=cb*k;weight+=k;
+            }
+            return weight<.001?-1:normalize((float)(r/weight),(float)(g/weight),(float)(b/weight));
+        }catch(java.io.IOException e){return -1;}
+    }
+    private static int normalize(float r,float g,float b){
+        float max=Math.max(1,Math.max(r,Math.max(g,b)));
+        return Math.round(r/max*255)<<16|Math.round(g/max*255)<<8|Math.round(b/max*255);
+    }
+    public void clear(){colors.clear();sprites.clear();}
+    int cachedStates(){return colors.size();}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ColoredLightVolume.java

@@ -0,0 +1,134 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.platform.NativeImage;
+import it.unimi.dsi.fastutil.ints.IntArrayFIFOQueue;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.multiplayer.ClientLevel;
+import net.minecraft.client.renderer.texture.DynamicTexture;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.world.level.LightLayer;
+import net.minecraft.world.level.block.Blocks;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.chunk.LevelChunk;
+import net.minecraft.world.level.chunk.status.ChunkStatus;
+
+/** Client-only RGB propagation. Snapshot, flood and packing share a bounded per-frame work budget. */
+final class ColoredLightVolume implements AutoCloseable {
+    static int sideFor(int distance){return (distance+20)*2;}
+    static int columns(int side){return (int)Math.ceil(Math.sqrt(side));}
+    private static final Direction[] DIRECTIONS=Direction.values();
+    private final ColoredLightMaterials materials=new ColoredLightMaterials();
+    private ClientLevel level;
+    private Object models;
+    private Build build;
+    private DynamicTexture texture,previous;
+    private BlockPos previousOrigin;
+    private int side,previousSide;
+    private long transitionStarted;
+    float blend(){return Math.clamp((System.nanoTime()-transitionStarted)/300_000_000f,0,1);}
+    DynamicTexture previous(){return previous;}
+    BlockPos previousOrigin(){return previousOrigin;}
+    int previousSide(){return previousSide;}
+    int side(){return side;}
+    private BlockPos origin;
+    private long revision,published=-1,lastStart;
+    private int completed;
+    private boolean warm;
+    void update(){
+        var mc=Minecraft.getInstance();var modelSet=mc.getModelManager().getBlockStateModelSet();
+        if(level!=mc.level||models!=modelSet){close();level=mc.level;models=modelSet;}
+        if(warm!=VanillaLight.warmTorches()){warm=VanillaLight.warmTorches();materials.clear();revision++;if(build!=null){build.close();build=null;}}
+        var p=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState.pos;
+        int wantedSide=sideFor(VanillaLight.coloredLightDistance());
+        var wanted=new BlockPos(anchor(p.x,wantedSide),anchor(p.y,wantedSide),anchor(p.z,wantedSide));
+        long now=System.nanoTime();
+        if(previous!=null&&blend()>=1){previous.close();previous=null;previousOrigin=null;}
+        // Complete a snapshot even if the world keeps changing, then catch up; moving
+        // beyond it cancels immediately. Static worlds do no further scanning or flooding.
+        if(build!=null&&(build.side!=wantedSide||!inside(build.origin,BlockPos.containing(p),build.side))){build.close();build=null;}
+        if(build==null&&previous==null&&(texture==null||side!=wantedSide||!wanted.equals(origin)||published!=revision)&&now-lastStart>=100_000_000L){
+            build=new Build(level,wanted,wantedSide,revision,materials);lastStart=now;
+        }
+        if(build!=null&&build.advance(now+2_000_000L)){
+            previous=texture;previousOrigin=origin;previousSide=side;
+            texture=new DynamicTexture(()->"Sanctuary coloured light volume",build.takeImage());
+            side=build.side;transitionStarted=System.nanoTime();
+            origin=build.origin;published=build.revision;build.close();build=null;completed++;
+        }
+    }
+    private static int anchor(double p,int side){return Math.floorDiv((int)Math.floor(p),4)*4-side/2;}
+    private static boolean inside(BlockPos base,BlockPos p,int side){return p.getX()>=base.getX()&&p.getX()<base.getX()+side&&p.getY()>=base.getY()&&p.getY()<base.getY()+side&&p.getZ()>=base.getZ()&&p.getZ()<base.getZ()+side;}
+    void dirty(BlockPos p){if(origin!=null&&inside(origin,p,side)||build!=null&&inside(build.origin,p,build.side))revision++;}
+    void dirtyChunk(int x,int z){if(overlaps(origin,x,z,side)||build!=null&&overlaps(build.origin,x,z,build.side))revision++;}
+    void dirtySection(int x,int y,int z){if(overlapsSection(origin,x,y,z,side)||build!=null&&overlapsSection(build.origin,x,y,z,build.side))revision++;}
+    private static boolean overlapsSection(BlockPos o,int x,int y,int z,int side){return overlaps(o,x,z,side)&&y>=(o.getY()>>4)&&y<=((o.getY()+side-1)>>4);}
+    private static boolean overlaps(BlockPos o,int x,int z,int side){return o!=null&&x>=(o.getX()>>4)&&x<=((o.getX()+side-1)>>4)&&z>=(o.getZ()>>4)&&z<=((o.getZ()+side-1)>>4);}
+    DynamicTexture texture(){return texture;}
+    BlockPos origin(){return origin;}
+    boolean settled(){return texture!=null&&build==null&&revision==published&&blend()>=1;}
+    int completed(){return completed;}
+    int cachedStates(){return materials.cachedStates();}
+    int sample(BlockPos p){if(texture==null||!inside(origin,p,side))return 0;int x=p.getX()-origin.getX(),y=p.getY()-origin.getY(),z=p.getZ()-origin.getZ(),cols=columns(side);return texture.getPixels().getPixel(x+(y%cols)*side,z+(y/cols)*side);}
+    public void close(){if(build!=null){build.close();build=null;}if(texture!=null){texture.close();texture=null;}if(previous!=null){previous.close();previous=null;}materials.clear();level=null;models=null;origin=null;previousOrigin=null;side=previousSide=0;published=-1;revision=0;lastStart=0;}
+
+    private static final class Build implements AutoCloseable {
+        final int side,count,cols,chunkSide;
+        final ClientLevel level;final BlockPos origin;final long revision;final ColoredLightMaterials materials;
+        final BlockState[] states;
+        final byte[] red,green,blue,sky;
+        final boolean[] queued;final IntArrayFIFOQueue queue=new IntArrayFIFOQueue();
+        final LevelChunk[] chunks;final int cx,cz;
+        final BlockPos.MutableBlockPos pos=new BlockPos.MutableBlockPos();
+        NativeImage image;int scan,packed;
+        Build(ClientLevel level,BlockPos origin,int side,long revision,ColoredLightMaterials materials){
+            this.side=side;count=side*side*side;cols=columns(side);chunkSide=(side+15)/16+1;
+            states=new BlockState[count];red=new byte[count];green=new byte[count];blue=new byte[count];sky=new byte[count];queued=new boolean[count];chunks=new LevelChunk[chunkSide*chunkSide];
+            image=new NativeImage(cols*side,((side+cols-1)/cols)*side,false);
+            this.level=level;this.origin=origin;this.revision=revision;this.materials=materials;
+            cx=origin.getX()>>4;cz=origin.getZ()>>4;
+            for(int z=0;z<chunkSide;z++)for(int x=0;x<chunkSide;x++)chunks[x+z*chunkSide]=level.getChunkSource().getChunk(cx+x,cz+z,ChunkStatus.FULL,false);
+        }
+        boolean advance(long deadline){
+            while(scan<count){scan(scan++);if((scan&127)==0&&System.nanoTime()>=deadline)return false;}
+            int work=0;
+            while(!queue.isEmpty()){
+                int i=queue.dequeueInt();queued[i]=false;spread(i);
+                if((++work&127)==0&&System.nanoTime()>=deadline)return false;
+            }
+            while(packed<count){
+                int i=packed++,x=i%side,z=i/side%side,y=i/(side*side);
+                image.setPixel(x+(y%cols)*side,z+(y/cols)*side,(sky[i]&255)<<24|(red[i]&255)<<16|(green[i]&255)<<8|(blue[i]&255));
+                if((packed&511)==0&&System.nanoTime()>=deadline)return false;
+            }
+            return true;
+        }
+        void scan(int i){
+            int x=origin.getX()+(i%side),z=origin.getZ()+(i/side%side),y=origin.getY()+(i/(side*side));pos.set(x,y,z);
+            var chunk=chunks[((x>>4)-cx)+((z>>4)-cz)*chunkSide];
+            var state=chunk==null||level.isOutsideBuildHeight(y)?Blocks.BEDROCK.defaultBlockState():chunk.getBlockState(pos);states[i]=state;
+            if(chunk!=null&&!level.isOutsideBuildHeight(y))sky[i]=(byte)(level.getBrightness(LightLayer.SKY,pos)*17);
+            int emission=state.getLightEmission();if(emission<=0)return;
+            int c=materials.color(state);red[i]=(byte)encode(emission,c>>16&255);green[i]=(byte)encode(emission,c>>8&255);blue[i]=(byte)encode(emission,c&255);enqueue(i);
+        }
+        void spread(int i){
+            int r=red[i]&255,g=green[i]&255,b=blue[i]&255;if(Math.max(r,Math.max(g,b))<=136)return;
+            int x=i%side,z=i/side%side,y=i/(side*side);
+            for(var d:DIRECTIONS){
+                int nx=x+d.getStepX(),ny=y+d.getStepY(),nz=z+d.getStepZ();if(nx<0||nx>=side||ny<0||ny>=side||nz<0||nz>=side)continue;
+                int n=nx+nz*side+ny*side*side;
+                if(r-8<=(red[n]&255)&&g-8<=(green[n]&255)&&b-8<=(blue[n]&255))continue;
+                int loss=net.minecraft.world.level.lighting.LightEngine.getLightDampeningInto(states[i],states[n],d,Math.max(1,states[n].getLightDampening()))*8;
+                int nr=Math.max(0,r-loss),ng=Math.max(0,g-loss),nb=Math.max(0,b-loss);if(Math.max(nr,Math.max(ng,nb))<=128)continue;boolean changed=false;
+                if(nr>(red[n]&255)){red[n]=(byte)nr;changed=true;}if(ng>(green[n]&255)){green[n]=(byte)ng;changed=true;}if(nb>(blue[n]&255)){blue[n]=(byte)nb;changed=true;}
+                if(changed)enqueue(n);
+            }
+        }
+        void enqueue(int i){if(!queued[i]){queued[i]=true;queue.enqueue(i);}}
+        NativeImage takeImage(){var result=image;image=null;return result;}
+        public void close(){if(image!=null){image.close();image=null;}}
+    }
+    // An offset preserves dim colour channels below native level zero. The shader
+    // applies the native cutoff to overall energy, never to each channel separately.
+    static int encode(int emission,int channel){return channel==0?0:Math.clamp((int)Math.round((emission+16+Math.log(channel/255.0)/Math.log(1.25))*8),0,248);}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ColoredLights.java

@@ -0,0 +1,102 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.Optional;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.core.BlockPos;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+
+/** Visual local colour only: native block/sky light and gameplay remain unchanged. */
+public final class ColoredLights {
+    private static final RenderPipeline APPLY=RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(Identifier.parse("sanctuary:pipeline/colored_lights"))
+            .withVertexShader("core/screenquad").withFragmentShader(Identifier.parse("sanctuary:core/colored_lights"))
+            .withBindGroupLayout(BindGroupLayout.builder().withUniform("ColoredLightScene",UniformType.UNIFORM_BUFFER)
+                    .withUniform("WorldDepth",UniformType.COMBINED_IMAGE_SAMPLER)
+                    .withUniform("SceneColor",UniformType.COMBINED_IMAGE_SAMPLER)
+                    .withUniform("LightVolume",UniformType.COMBINED_IMAGE_SAMPLER)
+                    .withUniform("PreviousVolume",UniformType.COMBINED_IMAGE_SAMPLER).build())
+            .withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.of(new BlendFunction(BlendFactor.ONE,BlendFactor.ZERO,BlendFactor.ZERO,BlendFactor.ONE)),GpuFormat.RGBA8_UNORM,ColorTargetState.WRITE_COLOR))
+            .withDepthStencilState(Optional.empty()).build());
+    private static final ColoredLightVolume VOLUME=new ColoredLightVolume();
+    private static final Matrix4f projection=new Matrix4f();
+    private static TextureTarget source;
+    private static net.minecraft.client.renderer.texture.DynamicTexture black;
+    private static final ColoredDynamicLights DYNAMIC=new ColoredDynamicLights();
+    private static long activated,lastRender;
+    private static float displayedDistance;
+    private static int dynamicCount;
+    private static MappableRingBuffer uniforms;
+    private static boolean applied;
+    private static int frames;
+    private ColoredLights(){}
+    public static void captureProjection(Matrix4f matrix){projection.set(matrix);}
+    public static void dirtyBlock(BlockPos pos){VOLUME.dirty(pos);}
+    public static void dirtyChunk(int x,int z){VOLUME.dirtyChunk(x,z);}
+    public static void dirtySection(int x,int y,int z){if(!fr.koka.sanctuary.client.DynamicLightClient.invalidatingSections())VOLUME.dirtySection(x,y,z);}
+    public static void render(){
+        applied=false;var mc=Minecraft.getInstance();
+        if(!VanillaLight.active()||!VanillaLight.coloredLights()||VanillaLight.coloredLightIntensity()==0||mc.level==null){release();return;}
+        if(PanoramaCapture.rendering())return;
+        var camera=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+        if(camera.fogType!=FogType.NONE)return;
+        long now=System.nanoTime();if(activated==0){activated=now;displayedDistance=VanillaLight.coloredLightDistance();}
+        double elapsed=lastRender==0?0:Math.min(.1,(now-lastRender)/1e9);lastRender=now;
+        displayedDistance+=(VanillaLight.coloredLightDistance()-displayedDistance)*(float)(1-Math.exp(-elapsed*10));
+        VOLUME.update();
+        if(black==null){var image=new com.mojang.blaze3d.platform.NativeImage(1,1,false);image.setPixel(0,0,0);black=new net.minecraft.client.renderer.texture.DynamicTexture(()->"Empty coloured light",image);}
+        var lights=DYNAMIC.update(camera.pos);dynamicCount=lights.size();
+        var current=VOLUME.texture()==null?black:VOLUME.texture();
+        var previous=VOLUME.previous()==null?black:VOLUME.previous();
+        var main=mc.gameRenderer.mainRenderTarget();
+        if(source==null||source.width!=main.width||source.height!=main.height){if(source!=null)source.destroyBuffers();source=new TextureTarget("Sanctuary coloured light source",main.width,main.height,GpuFormat.RGBA8_UNORM,null);}
+        if(uniforms==null)uniforms=new MappableRingBuffer(()->"Sanctuary coloured light scene",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,176+ColoredDynamicLights.LIMIT*32);
+        var base=VOLUME.origin()==null?BlockPos.containing(camera.pos):VOLUME.origin();var fog=camera.fogData;
+        var old=VOLUME.previousOrigin()==null?base:VOLUME.previousOrigin();
+        int side=VOLUME.texture()==null?1:VOLUME.side(),oldSide=VOLUME.previous()==null?1:VOLUME.previousSide();
+        uniforms.rotate();try(var mapped=uniforms.currentBuffer().map(false,true)){
+            var data=Std140Builder.intoBuffer(mapped.data()).putMat4f(new Matrix4f(projection).mul(camera.viewRotationMatrix).invert())
+                    .putVec4((float)(camera.pos.x-base.getX()),(float)(camera.pos.y-base.getY()),(float)(camera.pos.z-base.getZ()),VanillaLight.coloredLightIntensity()/100f)
+                    .putVec4(RenderSystem.getDevice().getDeviceInfo().isZZeroToOne()?1:0,Math.clamp((15-mc.level.getSkyDarken())/15f,0,1),fog.color.w,0)
+                    .putVec4(fog.renderDistanceStart,fog.renderDistanceEnd,fog.environmentalStart,fog.environmentalEnd)
+                    .putVec4(displayedDistance,VOLUME.texture()==null?0:VOLUME.blend(),Math.clamp((now-activated)/300_000_000f,0,1),lights.size())
+                    .putVec4(side,ColoredLightVolume.columns(side),current.getPixels().getWidth(),current.getPixels().getHeight())
+                    .putVec4((float)(camera.pos.x-old.getX()),(float)(camera.pos.y-old.getY()),(float)(camera.pos.z-old.getZ()),VOLUME.previous()==null?0:1)
+                    .putVec4(oldSide,ColoredLightVolume.columns(oldSide),previous.getPixels().getWidth(),previous.getPixels().getHeight());
+            for(int i=0;i<ColoredDynamicLights.LIMIT;i++){if(i<lights.size()){var l=lights.get(i);data.putVec4((float)(l.x-camera.pos.x),(float)(l.y-camera.pos.y),(float)(l.z-camera.pos.z),l.level);}else data.putVec4(0,0,0,0);}
+            for(int i=0;i<ColoredDynamicLights.LIMIT;i++){if(i<lights.size()){var l=lights.get(i);data.putVec4((float)l.r,(float)l.g,(float)l.b,(float)l.visibility);}else data.putVec4(0,0,0,0);}
+        }
+        var encoder=RenderSystem.getDevice().createCommandEncoder();
+        encoder.copyTextureToTexture(main.getColorTexture(),source.getColorTexture(),0,0,0,0,0,main.width,main.height);
+        var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        try(var pass=encoder.createRenderPass(()->"Sanctuary coloured light",main.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(APPLY));pass.setUniform("ColoredLightScene",uniforms.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SceneColor",source.getColorTextureView(),nearest);pass.setUniform("LightVolume",current.getTextureView(),nearest);pass.setUniform("PreviousVolume",previous.getTextureView(),nearest);pass.draw(3,1,0,0);
+        }
+        applied=true;frames++;
+    }
+    public static void release(){VOLUME.close();DYNAMIC.clear();activated=lastRender=0;dynamicCount=0;if(black!=null){black.close();black=null;}if(source!=null){source.destroyBuffers();source=null;}if(uniforms!=null){uniforms.close();uniforms=null;}applied=false;}
+    static boolean applied(){return applied;}
+    static boolean allocated(){return source!=null||VOLUME.texture()!=null;}
+    static boolean settled(){return VOLUME.settled();}
+    static int renderedFrames(){return frames;}
+    static int builds(){return VOLUME.completed();}
+    static int sample(BlockPos pos){return VOLUME.sample(pos);}
+    static net.minecraft.world.phys.Vec3 dynamicPosition(long entity){return DYNAMIC.position(entity);}
+    static int dynamicCount(){return dynamicCount;}
+    static float blend(){return VOLUME.blend();}
+    static int volumeSide(){return VOLUME.side();}
+    static int materials(){return VOLUME.cachedStates();}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/EdgeHighlights.java

@@ -0,0 +1,99 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.Optional;
+import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientLifecycleEvents;
+import net.fabricmc.fabric.api.client.networking.v1.ClientPlayConnectionEvents;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+
+/** Optional, texture-preserving highlights on visible voxel edges. No gameplay light changes. */
+public final class EdgeHighlights {
+    // Destination * (1 + highlight): retain the block's existing colour and texture, including shadows.
+    private static final RenderPipeline APPLY = RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(Identifier.parse("sanctuary:pipeline/edge_highlights"))
+            .withVertexShader("core/screenquad")
+            .withFragmentShader(Identifier.parse("sanctuary:core/edge_highlights"))
+            .withBindGroupLayout(BindGroupLayout.builder()
+                    .withUniform("EdgeHighlights", UniformType.UNIFORM_BUFFER)
+                    .withUniform("WorldDepth", UniformType.COMBINED_IMAGE_SAMPLER).build())
+            .withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.of(new BlendFunction(
+                    BlendFactor.DST_COLOR, BlendFactor.ONE, BlendFactor.ZERO, BlendFactor.ONE)),
+                    GpuFormat.RGBA8_UNORM, ColorTargetState.WRITE_COLOR))
+            .withDepthStencilState(Optional.empty()).build());
+    private static final Matrix4f projection = new Matrix4f();
+    private static MappableRingBuffer uniforms;
+    private static boolean applied;
+    private static int renderedFrames;
+
+    private EdgeHighlights() { }
+
+    public static void register() {
+        ClientPlayConnectionEvents.DISCONNECT.register((handler, client) -> release());
+        ClientLifecycleEvents.CLIENT_STOPPING.register(client -> release());
+    }
+
+    public static void captureProjection(Matrix4f matrix) { projection.set(matrix); }
+
+    /** Runs after cast shadows and before the hand and HUD; works without the shadow depth map. */
+    public static void render() {
+        applied = false;
+        var client = Minecraft.getInstance();
+        if (!VanillaLight.active() || !VanillaLight.edgeHighlights() || VanillaLight.edgeIntensity() == 0
+                || client.level == null) {
+            release();
+            return;
+        }
+        if (PanoramaCapture.rendering()) return;
+        var camera = client.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+        if (camera.fogType != FogType.NONE) return;
+        if (uniforms == null) uniforms = new MappableRingBuffer(() -> "Sanctuary edge highlights",
+                GpuBuffer.USAGE_UNIFORM | GpuBuffer.USAGE_MAP_WRITE, 176);
+        var viewProjection = new Matrix4f(projection).mul(camera.viewRotationMatrix);
+        var inverse = new Matrix4f(viewProjection).invert();
+        var fog = camera.fogData;
+        uniforms.rotate();
+        try (var mapped = uniforms.currentBuffer().map(false, true)) {
+            Std140Builder.intoBuffer(mapped.data()).putMat4f(inverse).putMat4f(viewProjection)
+                    .putVec4((float)(camera.pos.x - Math.floor(camera.pos.x)),
+                            (float)(camera.pos.y - Math.floor(camera.pos.y)),
+                            (float)(camera.pos.z - Math.floor(camera.pos.z)), VanillaLight.shadowPixels())
+                    .putVec4(VanillaLight.edgeIntensity() * .004f,
+                            RenderSystem.getDevice().getDeviceInfo().isZZeroToOne() ? 1 : 0,
+                            fog.renderDistanceStart, fog.renderDistanceEnd)
+                    .putVec4(fog.environmentalStart, fog.environmentalEnd, fog.color.w, VanillaLight.edgeDistance());
+        }
+        var main = client.gameRenderer.mainRenderTarget();
+        var encoder = RenderSystem.getDevice().createCommandEncoder();
+        try (var pass = encoder.createRenderPass(() -> "Sanctuary edge highlights",
+                main.getColorTextureView(), Optional.empty())) {
+            pass.setPipeline(RenderSystem.getCompiledPipeline(APPLY));
+            pass.setUniform("EdgeHighlights", uniforms.currentBuffer());
+            pass.setUniform("WorldDepth", main.getDepthTextureView(),
+                    RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST));
+            pass.draw(3, 1, 0, 0);
+        }
+        renderedFrames++;
+        applied = true;
+    }
+
+    public static void release() {
+        if (uniforms != null) { uniforms.close(); uniforms = null; }
+        applied = false;
+    }
+
+    static boolean applied() { return applied; }
+    static boolean allocated() { return uniforms != null; }
+    static int renderedFrames() { return renderedFrames; }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/PbrMaterials.java

@@ -0,0 +1,65 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.platform.NativeImage;
+import java.util.*;
+import net.minecraft.client.renderer.texture.DynamicTexture;
+import net.minecraft.client.renderer.texture.TextureAtlasSprite;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.world.level.block.state.BlockState;
+
+/** One source-texture analysis per cached material. No frame readback and no generated files on disk. */
+final class PbrMaterials implements AutoCloseable {
+    static final int INNER=16,TILE=20,GRID=64,SIZE=TILE*GRID,MAX_SPRITES=GRID*GRID;
+    record Profile(float roughness,float metal){}
+    record Slot(int x,int y,boolean empty){
+        float u(float f){return (x+2+Math.clamp(f,0,1)*INNER)/SIZE;}
+        float v(float f){return (y+2+Math.clamp(f,0,1)*INNER)/SIZE;}
+    }
+    private final Map<String,Slot> slots=new HashMap<>();
+    private final Map<BlockState,Profile> profiles=new IdentityHashMap<>();
+    private DynamicTexture atlas;private boolean dirty;private int analyses;
+    boolean candidate(BlockState state){return !state.isAir()&&!state.liquid();}
+    Profile profile(BlockState state){return profiles.computeIfAbsent(state,s->profile(BuiltInRegistries.BLOCK.getKey(s.getBlock()).getPath()));}
+    static Profile profile(String name){
+        if(name.equals("iron_block")||name.equals("gold_block")||name.equals("netherite_block")||name.contains("copper")&&!name.contains("ore")&&!name.contains("raw"))
+            return new Profile(name.contains("oxidized")?.65f:.32f,name.contains("oxidized")?.35f:.85f);
+        if(name.contains("polished")||name.contains("glazed")||name.equals("diamond_block")||name.equals("emerald_block")||name.equals("ruby_block")||name.equals("sapphire_block"))return new Profile(.42f,0);
+        if(name.contains("wool")||name.contains("leaves"))return new Profile(.98f,0);
+        if(name.contains("planks")||name.contains("log")||name.contains("wood"))return new Profile(.88f,0);
+        return new Profile(.82f,0);
+    }
+    Slot slot(TextureAtlasSprite sprite,BlockState state){
+        var profile=profile(state);String key=sprite.contents().name()+":"+profile;
+        var existing=slots.get(key);if(existing!=null)return existing;
+        if(slots.size()>=MAX_SPRITES)return new Slot(0,0,true);
+        int i=slots.size(),x=i%GRID*TILE,y=i/GRID*TILE;
+        if(atlas==null){atlas=new DynamicTexture("Sanctuary procedural PBR",SIZE,SIZE,false);atlas.getPixels().fillRect(0,0,SIZE,SIZE,0x008080FF);}
+        boolean empty=false;
+        try(var image=BloomMaterials.read(sprite.contents().name())){
+            int fw=Math.min(image.getWidth(),sprite.contents().width()),fh=Math.min(image.getHeight(),sprite.contents().height());
+            int[] colors=new int[INNER*INNER];
+            for(int py=0;py<INNER;py++)for(int px=0;px<INNER;px++)colors[py*INNER+px]=image.getPixel(px*fw/INNER,py*fh/INNER);
+            int[] pixels=generate(colors,INNER,INNER,profile);analyses++;
+            for(int py=0;py<TILE;py++)for(int px=0;px<TILE;px++)atlas.getPixels().setPixel(x+px,y+py,pixels[Math.clamp(py-2,0,INNER-1)*INNER+Math.clamp(px-2,0,INNER-1)]);
+        }catch(java.io.IOException e){empty=true;fr.koka.sanctuary.SanctuaryMod.LOGGER.warn("Cannot analyse PBR texture {}",sprite.contents().name(),e);}
+        var result=new Slot(x,y,empty);slots.put(key,result);dirty=true;return result;
+    }
+    static int[] generate(int[] colors,int w,int h,Profile profile){
+        int[] result=new int[colors.length];
+        for(int y=0;y<h;y++)for(int x=0;x<w;x++){
+            int center=colors[y*w+x];float base=luma(center);
+            float left=height(colors[y*w+Math.floorMod(x-1,w)],base),right=height(colors[y*w+(x+1)%w],base);
+            float up=height(colors[Math.floorMod(y-1,h)*w+x],base),down=height(colors[(y+1)%h*w+x],base);
+            float nx=Math.clamp((left-right)*2,-.45f,.45f),ny=Math.clamp((up-down)*2,-.45f,.45f);
+            if((center>>>24)<128){nx=ny=0;}
+            int red=Math.round((nx*.5f+.5f)*255),green=Math.round((ny*.5f+.5f)*255);
+            result[y*w+x]=(Math.round(profile.metal*255)<<24)|(red<<16)|(green<<8)|Math.round(profile.roughness*255);
+        }
+        return result;
+    }
+    private static float height(int color,float fallback){return (color>>>24)<128?fallback:luma(color);}
+    private static float luma(int c){return ((c>>16&255)*.2126f+(c>>8&255)*.7152f+(c&255)*.0722f)/255;}
+    DynamicTexture atlas(){if(dirty){atlas.upload();dirty=false;}return atlas;}
+    int count(){return slots.size();}int analyses(){return analyses;}
+    public void close(){if(atlas!=null){atlas.close();atlas=null;}slots.clear();profiles.clear();dirty=false;analyses=0;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/PbrTerrain.java

@@ -0,0 +1,135 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.blaze3d.vertex.BufferBuilder;
+import com.mojang.blaze3d.vertex.ByteBufferBuilder;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.PrimitiveTopology;
+import com.mojang.renderpearl.api.vertex.VertexFormat;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.model.geom.builders.UVPair;
+import net.minecraft.client.renderer.block.dispatch.BlockStateModelPart;
+import net.minecraft.client.renderer.texture.TextureAtlas;
+import net.minecraft.core.BlockPos;
+import net.minecraft.core.Direction;
+import net.minecraft.core.SectionPos;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.level.chunk.LevelChunkSection;
+import net.minecraft.world.level.chunk.status.ChunkStatus;
+import net.minecraft.world.phys.Vec3;
+
+/** Nearby native sections, bounded incremental meshing; models and resource UV rotations remain native. */
+final class PbrTerrain implements AutoCloseable {
+    static final VertexFormat FORMAT=VertexFormat.builder(0).addAttribute("Position",GpuFormat.RGB32_FLOAT)
+            .addAttribute("Color",GpuFormat.RGBA8_UNORM).addAttribute("UV0",GpuFormat.RG32_FLOAT)
+            .addAttribute("UV3",GpuFormat.RG32_FLOAT).build();
+    private static final long MAX_BYTES=24L*1024*1024;
+    private final Map<Long,Section> sections=new HashMap<>();
+    final PbrMaterials materials=new PbrMaterials();
+    private Build building;
+    private long bytes;
+    private Object models,level;
+    private List<Section> visible=List.of();
+    record Entry(BlockPos origin,GpuBuffer vertices,int indices){}
+    List<Entry> update(){
+        var mc=Minecraft.getInstance();var current=mc.getModelManager().getBlockStateModelSet();
+        if(models!=current||level!=mc.level){close();models=current;level=mc.level;}
+        Vec3 camera=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState.pos;
+        long frame=mc.level.getGameTime();var active=new ArrayList<Section>();
+        for(var render:mc.levelRenderer.visibleSections()){
+            long key=render.getSectionNode();var pos=render.getRenderOrigin();
+            if(pos.offset(8,8,8).distToCenterSqr(camera)>48*48)continue;
+            var chunk=mc.level.getChunkSource().getChunk(pos.getX()>>4,pos.getZ()>>4,ChunkStatus.FULL,false);
+            if(chunk==null)continue;
+            var storage=chunk.getSection(mc.level.getSectionIndex(pos.getY()));
+            var section=sections.get(key);
+            if(section==null||section.storage!=storage){if(section!=null)remove(section);section=new Section(key,pos.immutable(),storage);sections.put(key,section);}
+            section.seen=frame;active.add(section);
+        }
+        visible=active;
+        for(var iterator=sections.values().iterator();iterator.hasNext();){var section=iterator.next();if(frame-section.seen>40){remove(section);iterator.remove();}}
+        long deadline=System.nanoTime()+3_000_000L;int started=building==null?0:1;
+        while(System.nanoTime()<deadline){
+            if(building==null){
+                if(started++>=4)break;
+                Section next=active.stream().filter(s->s.dirty).min(Comparator.comparingDouble(s->s.origin.distToCenterSqr(camera))).orElse(null);
+                if(next==null)break;
+                if(!next.storage.maybeHas(materials::candidate)){next.dirty=false;continue;}
+                building=new Build(next);
+            }
+            if(!advance(building,deadline))break;
+            var done=building;building=null;
+            try(done){
+                done.section.dirty=false;
+                if(done.quads>0&&!done.overflow){
+                    try(var mesh=done.out.buildOrThrow()){
+                        long size=mesh.vertexBuffer().remaining();
+                        if(bytes+size<=MAX_BYTES){
+                            var buffer=RenderSystem.getDevice().createBuffer(()->"Sanctuary PBR surfaces",GpuBuffer.USAGE_VERTEX|GpuBuffer.USAGE_COPY_DST,mesh.vertexBuffer());
+                            int count=mesh.drawState().indexCount();RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS).getBuffer(count);
+                            done.section.entry=new Entry(done.section.origin,buffer,count);bytes+=buffer.size();
+                        }
+                    }
+                }
+            }
+        }
+        return active.stream().map(s->s.entry).filter(Objects::nonNull).toList();
+    }
+    private boolean advance(Build build,long deadline){
+        var mc=Minecraft.getInstance();var models=mc.getModelManager().getBlockStateModelSet();
+        var parts=new ArrayList<BlockStateModelPart>();var random=RandomSource.create();
+        while(build.cursor<4096){
+            int i=build.cursor++,x=i&15,z=i>>4&15,y=i>>8;var state=build.section.storage.getBlockState(x,y,z);
+            if(materials.candidate(state)){
+                var pos=build.section.origin.offset(x,y,z);
+                parts.clear();random.setSeed(state.getSeed(pos));if(!state.liquid())models.get(state).collectParts(random,parts);
+                var tintSources=mc.getBlockColors().getTintSources(state);
+                var offset=state.getOffset(pos);
+                for(var part:parts)for(int f=0;f<7;f++){
+                    Direction face=f==6?null:Direction.values()[f];
+                    if(face!=null&&mc.level.getBlockState(pos.relative(face)).isSolidRender())continue;
+                    for(var quad:part.getQuads(face)){
+                        var material=quad.materialInfo();var sprite=material.sprite();
+                        if(!sprite.atlasLocation().equals(TextureAtlas.LOCATION_BLOCKS))continue;
+                        var slot=materials.slot(sprite,state);
+                        if(slot.empty())continue;
+                        if(build.quads>=16384){build.overflow=true;return true;}
+                        int tint=0xFFFFFF,index=material.tintIndex();
+                        if(index>=0&&index<tintSources.size())tint=tintSources.get(index).colorInWorld(state,mc.level,pos)&0xFFFFFF;
+                        int sky=mc.level.getBrightness(net.minecraft.world.level.LightLayer.SKY,face==null?pos:pos.relative(face));
+                        int color=(Math.round(sky/15f*255)<<24)|tint;
+                        for(int v=0;v<4;v++){
+                            var p=quad.position(v);float u=UVPair.unpackU(quad.packedUV(v)),tv=UVPair.unpackV(quad.packedUV(v));
+                            float localU=(u-sprite.getU0())/(sprite.getU1()-sprite.getU0()),localV=(tv-sprite.getV0())/(sprite.getV1()-sprite.getV0());
+                            build.out.addVertex(x+p.x()+(float)offset.x,y+p.y()+(float)offset.y,z+p.z()+(float)offset.z)
+                                    .setColor(color).setUv(u,tv).setUv3(slot.u(localU),slot.v(localV));
+                        }
+                        build.quads++;
+                    }
+                }
+
+            }
+            if(System.nanoTime()>=deadline)return build.cursor==4096;
+        }
+        return true;
+    }
+    void dirtySection(int x,int y,int z){dirty(sections.get(SectionPos.asLong(x,y,z)));}
+    void dirty(BlockPos pos){for(int x=(pos.getX()-1)>>4;x<=(pos.getX()+1)>>4;x++)for(int y=(pos.getY()-1)>>4;y<=(pos.getY()+1)>>4;y++)for(int z=(pos.getZ()-1)>>4;z<=(pos.getZ()+1)>>4;z++)dirty(sections.get(SectionPos.asLong(x,y,z)));}
+    void dirtyChunk(int x,int z){for(var section:sections.values())if(Math.abs((section.origin.getX()>>4)-x)<=1&&Math.abs((section.origin.getZ()>>4)-z)<=1)dirty(section);}
+    private void dirty(Section section){if(section!=null){remove(section);section.dirty=true;}}
+    private void remove(Section section){if(building!=null&&building.section==section){building.close();building=null;}if(section.entry!=null){bytes-=section.entry.vertices.size();section.entry.vertices.close();section.entry=null;}}
+    boolean settled(){return building==null&&visible.stream().noneMatch(s->s.dirty);}
+    public void close(){if(building!=null){building.close();building=null;}for(var section:sections.values())remove(section);sections.clear();visible=List.of();materials.close();models=level=null;bytes=0;}
+    private static final class Section{
+        final long key;final BlockPos origin;final LevelChunkSection storage;long seen;boolean dirty=true;Entry entry;
+        Section(long key,BlockPos origin,LevelChunkSection storage){this.key=key;this.origin=origin;this.storage=storage;}
+    }
+    private static final class Build implements AutoCloseable{
+        final Section section;final ByteBufferBuilder buffer=new ByteBufferBuilder(65536);final BufferBuilder out=new BufferBuilder(buffer,PrimitiveTopology.QUADS,FORMAT);
+        int cursor,quads;boolean overflow;
+        Build(Section section){this.section=section;}
+        public void close(){buffer.close();}
+    }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/PixelShadows.java

@@ -0,0 +1,185 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.blaze3d.vertex.DefaultVertexFormat;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.buffers.GpuBufferSlice;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.*;
+import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientLifecycleEvents;
+import net.fabricmc.fabric.api.client.networking.v1.ClientPlayConnectionEvents;
+import net.minecraft.client.Minecraft;
+import net.minecraft.resources.Identifier;
+import net.minecraft.core.BlockPos;
+import net.minecraft.client.renderer.BindGroupLayouts;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.client.renderer.state.level.CameraRenderState;
+import net.minecraft.world.level.dimension.DimensionType;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+import org.joml.Vector3f;
+import org.joml.Vector4f;
+
+/** Native sun/moon depth map and world-grid receivers. Never reads GPU pixels or changes gameplay light. */
+public final class PixelShadows {
+    private static final RenderPipeline DEPTH = RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(Identifier.parse("sanctuary:pipeline/pixel_shadow_depth"))
+            .withVertexShader(Identifier.parse("sanctuary:core/pixel_shadow_depth"))
+            .withFragmentShader(Identifier.parse("sanctuary:core/pixel_shadow_depth"))
+            .withBindGroupLayout(BindGroupLayouts.DYNAMIC_TRANSFORMS)
+            .withVertexBinding(0, DefaultVertexFormat.POSITION_COLOR)
+            .withPrimitiveTopology(PrimitiveTopology.QUADS).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.empty(), GpuFormat.R8_UNORM, ColorTargetState.WRITE_COLOR))
+            .withDepthStencilState(new DepthStencilState(CompareOp.LESS_THAN, true)).build());
+    private static final RenderPipeline APPLY = RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(Identifier.parse("sanctuary:pipeline/pixel_shadows"))
+            .withVertexShader("core/screenquad")
+            .withFragmentShader(Identifier.parse("sanctuary:core/pixel_shadows"))
+            .withBindGroupLayout(BindGroupLayout.builder()
+                    .withUniform("PixelShadows", UniformType.UNIFORM_BUFFER)
+                    .withUniform("WorldDepth", UniformType.COMBINED_IMAGE_SAMPLER)
+                    .withUniform("SunDepth", UniformType.COMBINED_IMAGE_SAMPLER)
+                    .withUniform("SunMaterial", UniformType.COMBINED_IMAGE_SAMPLER).build())
+            .withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.of(BlendFunction.TRANSLUCENT), GpuFormat.RGBA8_UNORM, ColorTargetState.WRITE_COLOR))
+            .withDepthStencilState(Optional.empty()).build());
+    private static final ShadowTerrain TERRAIN = new ShadowTerrain();
+    private static final Matrix4f projection = new Matrix4f();
+    private static final ShadowProjection lightGrid = new ShadowProjection();
+    private static TextureTarget shadowMap;
+    private static MappableRingBuffer uniforms;
+    private static int renderedFrames;
+    private static boolean applied, depthReady;
+
+    private PixelShadows() { }
+    public static void register() {
+        ClientPlayConnectionEvents.DISCONNECT.register((handler, client) -> release());
+        ClientLifecycleEvents.CLIENT_STOPPING.register(client -> release());
+    }
+    public static void captureProjection(Matrix4f matrix) { projection.set(matrix); }
+    public static void dirtyBlock(BlockPos pos) {
+        for (int x = (pos.getX()-1)>>4; x <= (pos.getX()+1)>>4; x++)
+            for (int y = (pos.getY()-1)>>4; y <= (pos.getY()+1)>>4; y++)
+                for (int z = (pos.getZ()-1)>>4; z <= (pos.getZ()+1)>>4; z++) TERRAIN.dirtySection(x,y,z);
+    }
+    public static void dirtyChunk(int x, int z) { TERRAIN.dirtyChunk(x, z); }
+
+    /** Called after the world's depth is resolved and before the first-person hand and GUI. */
+    public static void render() {
+        applied = false;
+        depthReady = false;
+        var client = Minecraft.getInstance();
+        if (!VanillaLight.active() || (!VanillaLight.pixelShadows() && !(VanillaLight.sunshafts() && VanillaLight.sunshaftIntensity()>0)) || client.level == null) {
+            release();
+            return;
+        }
+        if (PanoramaCapture.rendering()) return;
+        var state = client.gameRenderer.gameRenderState().levelRenderState;
+        var sky = state.skyRenderState;
+        CameraRenderState camera = state.cameraRenderState;
+        var sun = sunDirection(sky.sunAngle);
+        boolean lunar = sun.y <= .08f;
+        if (lunar && !VanillaLight.pixelShadows()) { release(); return; }
+        if (lunar) sun = sunDirection(sky.moonAngle);
+        if (sky.skybox != DimensionType.Skybox.OVERWORLD || camera.fogType != FogType.NONE || sun.y <= .08f) return;
+        float moon = sky.moonPhase == null ? 1 : (float)(.5 + .5 * Math.cos(sky.moonPhase.index() * Math.PI / 4));
+        float strength = (lunar ? .10f * moon : .38f)
+                * Math.clamp((sun.y - .08f) / .16f, 0, 1) * sky.rainBrightness;
+        // Rain hides the native solar sprite completely. The atmospheric volume still
+        // needs occluders for its weak scattered daylight; surface shadows stay off.
+        boolean solarVolume=!lunar&&VanillaLight.sunshafts()&&VanillaLight.sunshaftIntensity()>0;
+        if (strength <= .001f && !solarVolume) return;
+        int distance = VanillaLight.shadowDistance(), pixels = VanillaLight.shadowPixels();
+        TERRAIN.update(client.level, camera.pos, distance, sun);
+        int size = mapSize(distance, pixels);
+        if (shadowMap == null || shadowMap.width != size) {
+            if (shadowMap != null) shadowMap.destroyBuffers();
+            shadowMap = new TextureTarget("Sanctuary celestial shadows", size, size, GpuFormat.R8_UNORM, GpuFormat.D32_FLOAT);
+        }
+        if (uniforms == null) uniforms = new MappableRingBuffer(() -> "Sanctuary pixel shadows",
+                GpuBuffer.USAGE_UNIFORM | GpuBuffer.USAGE_MAP_WRITE, 192);
+        double ox = anchor(camera.pos.x), oy = anchor(camera.pos.y), oz = anchor(camera.pos.z);
+        boolean zeroToOne = RenderSystem.getDevice().getDeviceInfo().isZZeroToOne();
+        var light = lightGrid.matrix(sun, distance, size, ox, oy, oz, zeroToOne);
+        var inverse = new Matrix4f(projection).mul(camera.viewRotationMatrix).invert();
+        uniforms.rotate();
+        var fog = camera.fogData;
+        try (var mapped = uniforms.currentBuffer().map(false, true)) {
+            Std140Builder.intoBuffer(mapped.data()).putMat4f(inverse).putMat4f(light)
+                    .putVec4((float)(camera.pos.x - ox), (float)(camera.pos.y - oy), (float)(camera.pos.z - oz), pixels)
+                    .putVec4(sun.x, sun.y, sun.z, strength)
+                    .putVec4(distance, zeroToOne ? 1 : 0, fog.renderDistanceStart, fog.renderDistanceEnd)
+                    .putVec4(fog.environmentalStart, fog.environmentalEnd, fog.color.w, 0);
+        }
+        var entries = TERRAIN.entries();
+        var transforms = new ArrayList<GpuBufferSlice>(entries.size());
+        int maxIndices = 0;
+        for (var entry : entries) {
+            transforms.add(RenderSystem.getDynamicUniforms().writeTransform(new Matrix4f(light)
+                    .translate((float)(entry.x() - ox), (float)(entry.y() - oy), (float)(entry.z() - oz)),
+                    new Vector4f(1, 1, 1, 1),
+                    // Bounded world coordinates keep foliage noise precise far from spawn.
+                    new Vector3f(Math.floorMod(entry.x(), 4096), Math.floorMod(entry.y(), 4096),
+                            Math.floorMod(entry.z(), 4096)), new Matrix4f()));
+            maxIndices = Math.max(maxIndices, entry.indexCount());
+        }
+        var indices = RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS);
+        indices.requestIndexCount(maxIndices);
+        var encoder = RenderSystem.getDevice().createCommandEncoder();
+        try (var pass = encoder.createRenderPass(com.mojang.renderpearl.api.commands.RenderPassDescriptor.builder(() -> "Sanctuary celestial depth")
+                .withColorAttachment(shadowMap.getColorTextureView(), Optional.of(new Vector4f(0, 0, 0, 0)))
+                .withDepthAttachment(shadowMap.getDepthTextureView(), OptionalDouble.of(1)).build())) {
+            pass.setPipeline(RenderSystem.getCompiledPipeline(DEPTH));
+            if (maxIndices > 0) pass.setIndexBuffer(indices.getBuffer(), indices.type());
+            for (int i = 0; i < entries.size(); i++) {
+                var entry = entries.get(i);
+                pass.setUniform("DynamicTransforms", transforms.get(i));
+                pass.setVertexBuffer(0, entry.vertices().slice());
+                pass.drawIndexed(entry.indexCount(), 1, 0, 0, 0);
+            }
+        }
+        depthReady = !lunar;
+        if (!VanillaLight.pixelShadows() || strength <= .001f) { renderedFrames++; return; }
+        var main = client.gameRenderer.mainRenderTarget();
+        var nearest = RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        try (var pass = encoder.createRenderPass(() -> "Sanctuary pixel shadows", main.getColorTextureView(), Optional.empty())) {
+            pass.setPipeline(RenderSystem.getCompiledPipeline(APPLY));
+            pass.setUniform("PixelShadows", uniforms.currentBuffer());
+            pass.setUniform("WorldDepth", main.getDepthTextureView(), nearest);
+            pass.setUniform("SunDepth", shadowMap.getDepthTextureView(), nearest);
+            pass.setUniform("SunMaterial", shadowMap.getColorTextureView(), nearest);
+            pass.draw(3, 1, 0, 0);
+        }
+        renderedFrames++;
+        applied = true;
+    }
+
+    static double anchor(double coordinate) { return Math.floor(coordinate / 16.0 + .5) * 16.0; }
+    static com.mojang.renderpearl.api.buffers.GpuBuffer materialUniforms(){return uniforms.currentBuffer();}
+    static com.mojang.renderpearl.api.textures.GpuTextureView materialDepth(){return shadowMap.getDepthTextureView();}
+    static Vector3f sunDirection(float angle) { return new Vector3f(-(float)Math.sin(angle), (float)Math.cos(angle), 0); }
+    static int mapSize(int distance, int pixels) {
+        int size = 512;
+        while (size < 2 * (distance + 16) * pixels && size < 4096) size *= 2;
+        return size;
+    }
+    public static void release() {
+        TERRAIN.close();
+        lightGrid.reset();
+        if (shadowMap != null) { shadowMap.destroyBuffers(); shadowMap = null; }
+        if (uniforms != null) { uniforms.close(); uniforms = null; }
+        applied = false;
+        depthReady = false;
+    }
+    static boolean depthReady() { return depthReady; }
+    static int renderedFrames() { return renderedFrames; }
+    static boolean applied() { return applied; }
+    static boolean ready() { return TERRAIN.settled(); }
+    static TextureTarget shadowMap() { return shadowMap; }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ProceduralPbr.java

@@ -0,0 +1,93 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.buffers.GpuBufferSlice;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.*;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.BindGroupLayouts;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.client.renderer.texture.TextureAtlas;
+import net.minecraft.core.BlockPos;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.dimension.DimensionType;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+import org.joml.Vector3f;
+import org.joml.Vector4f;
+
+/** Optional local material pass: cached texture normals, GGX highlights and diffuse relief. */
+public final class ProceduralPbr {
+    private static final BindGroupLayout SCENE=BindGroupLayout.builder().withUniform("PbrScene",UniformType.UNIFORM_BUFFER)
+            .withUniform("PixelShadows",UniformType.UNIFORM_BUFFER).withUniform("SunDepth",UniformType.COMBINED_IMAGE_SAMPLER)
+            .withUniform("WorldDepth",UniformType.COMBINED_IMAGE_SAMPLER).withUniform("SceneColor",UniformType.COMBINED_IMAGE_SAMPLER)
+            .withUniform("BlockAtlas",UniformType.COMBINED_IMAGE_SAMPLER).withUniform("MaterialAtlas",UniformType.COMBINED_IMAGE_SAMPLER).build();
+    private static final RenderPipeline PIPELINE=RenderPipelines.register(RenderPipeline.builder()
+            .withLocation(Identifier.parse("sanctuary:pipeline/pbr")).withVertexShader(Identifier.parse("sanctuary:core/pbr"))
+            .withFragmentShader(Identifier.parse("sanctuary:core/pbr")).withBindGroupLayout(BindGroupLayouts.DYNAMIC_TRANSFORMS).withBindGroupLayout(SCENE)
+            .withVertexBinding(0,PbrTerrain.FORMAT).withPrimitiveTopology(PrimitiveTopology.QUADS).withCull(false)
+            .withColorTargetState(new ColorTargetState(Optional.empty(),GpuFormat.RGBA8_UNORM,ColorTargetState.WRITE_COLOR))
+            .withDepthStencilState(Optional.empty()).build());
+    private static final PbrTerrain TERRAIN=new PbrTerrain();
+    private static final Matrix4f projection=new Matrix4f();
+    private static TextureTarget source;
+    private static MappableRingBuffer scene;
+    private static boolean applied;private static int frames;
+    private ProceduralPbr(){}
+    public static void captureProjection(Matrix4f matrix){projection.set(matrix);}
+    public static void dirtyBlock(BlockPos pos){TERRAIN.dirty(pos);}
+    public static void dirtyChunk(int x,int z){TERRAIN.dirtyChunk(x,z);}
+    public static void dirtySection(int x,int y,int z){TERRAIN.dirtySection(x,y,z);}
+    public static void render(){
+        applied=false;var mc=Minecraft.getInstance();
+        if(!VanillaLight.active()||!VanillaLight.pbr()||VanillaLight.pbrIntensity()==0||mc.level==null){release();return;}
+        var state=mc.gameRenderer.gameRenderState().levelRenderState;var camera=state.cameraRenderState;var sky=state.skyRenderState;
+        if(PanoramaCapture.rendering()||camera.fogType!=FogType.NONE||sky.skybox!=DimensionType.Skybox.OVERWORLD)return;
+        var main=mc.gameRenderer.mainRenderTarget();
+        if(source==null||source.width!=main.width||source.height!=main.height){if(source!=null)source.destroyBuffers();source=new TextureTarget("Sanctuary PBR source",main.width,main.height,GpuFormat.RGBA8_UNORM,null);}
+        // The extra padding also supplies a valid inactive PixelShadows binding (192 bytes).
+        if(scene==null)scene=new MappableRingBuffer(()->"Sanctuary PBR scene",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,192);
+        var entries=TERRAIN.update();var atlas=TERRAIN.materials.atlas();
+        var vp=new Matrix4f(projection).mul(camera.viewRotationMatrix);var fog=camera.fogData;
+        var sun=PixelShadows.sunDirection(sky.sunAngle);boolean lunar=sun.y<=.08f;
+        if(lunar)sun=PixelShadows.sunDirection(sky.moonAngle);
+        float moon=sky.moonPhase==null?1:(float)(.5+.5*Math.cos(sky.moonPhase.index()*Math.PI/4));
+        float strength=(lunar?.12f*moon:1)*sky.rainBrightness*Math.clamp((sun.y-.04f)/.16f,0,1);
+        boolean shadow=PixelShadows.applied();
+        scene.rotate();try(var mapped=scene.currentBuffer().map(false,true)){
+            Std140Builder.intoBuffer(mapped.data()).putMat4f(new Matrix4f(vp).invert())
+                    .putVec4(sun.x,sun.y,sun.z,strength)
+                    .putVec4(VanillaLight.pbrIntensity()/100f,RenderSystem.getDevice().getDeviceInfo().isZZeroToOne()?1:0,shadow?1:0,32)
+                    .putVec4(fog.renderDistanceStart,fog.renderDistanceEnd,fog.environmentalStart,fog.environmentalEnd).putVec4(fog.color.w,0,0,0)
+                    .putVec4(0,0,0,0).putVec4(0,0,0,0).putVec4(0,0,0,0).putVec4(0,0,0,0);
+        }
+        var transforms=new ArrayList<GpuBufferSlice>(entries.size());int max=0;
+        for(var entry:entries){var p=entry.origin();var offset=new Vector3f((float)(p.getX()-camera.pos.x),(float)(p.getY()-camera.pos.y),(float)(p.getZ()-camera.pos.z));
+            transforms.add(RenderSystem.getDynamicUniforms().writeTransform(new Matrix4f(vp).translate(offset),new Vector4f(1,1,1,1),offset,new Matrix4f()));max=Math.max(max,entry.indices());}
+        var indices=RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS);indices.requestIndexCount(max);
+        var encoder=RenderSystem.getDevice().createCommandEncoder();
+        encoder.copyTextureToTexture(main.getColorTexture(),source.getColorTexture(),0,0,0,0,0,main.width,main.height);
+        var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        if(atlas!=null&&!entries.isEmpty())try(var pass=encoder.createRenderPass(()->"Sanctuary PBR materials",main.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(PIPELINE));pass.setUniform("PbrScene",scene.currentBuffer());
+            pass.setUniform("PixelShadows",shadow?PixelShadows.materialUniforms():scene.currentBuffer());
+            pass.setUniform("SunDepth",shadow?PixelShadows.materialDepth():main.getDepthTextureView(),nearest);
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SceneColor",source.getColorTextureView(),nearest);
+            pass.setUniform("BlockAtlas",mc.getTextureManager().getTexture(TextureAtlas.LOCATION_BLOCKS).getTextureView(),nearest);
+            pass.setUniform("MaterialAtlas",atlas.getTextureView(),nearest);pass.setIndexBuffer(indices.getBuffer(),indices.type());
+            for(int i=0;i<entries.size();i++){var entry=entries.get(i);pass.setUniform("DynamicTransforms",transforms.get(i));pass.setVertexBuffer(0,entry.vertices().slice());pass.drawIndexed(entry.indices(),1,0,0,0);}
+        }
+        applied=true;frames++;
+    }
+    public static void release(){TERRAIN.close();if(source!=null){source.destroyBuffers();source=null;}if(scene!=null){scene.close();scene=null;}applied=false;}
+    static boolean applied(){return applied;}static boolean ready(){return TERRAIN.settled();}
+    static boolean allocated(){return source!=null;}static int renderedFrames(){return frames;}
+    static int materialCount(){return TERRAIN.materials.count();}static int analyses(){return TERRAIN.materials.analyses();}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ScreenSpaceGI.java

@@ -0,0 +1,100 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.Optional;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.resources.Identifier;
+import net.minecraft.world.level.material.FogType;
+import org.joml.Matrix4f;
+
+/** Bounded, single-bounce diffuse lighting from this frame's visible surfaces. No GPU readback or history. */
+public final class ScreenSpaceGI {
+    private static final BindGroupLayout LAYOUT=BindGroupLayout.builder()
+            .withUniform("GIParams",UniformType.UNIFORM_BUFFER)
+            .withUniform("WorldDepth",UniformType.COMBINED_IMAGE_SAMPLER)
+            .withUniform("SceneColor",UniformType.COMBINED_IMAGE_SAMPLER)
+            .withUniform("IndirectLight",UniformType.COMBINED_IMAGE_SAMPLER).build();
+    private static RenderPipeline pipeline(String name,boolean composite){
+        return RenderPipelines.register(RenderPipeline.builder().withLocation(Identifier.parse("sanctuary:pipeline/"+name))
+                .withVertexShader("core/screenquad").withFragmentShader(Identifier.parse("sanctuary:core/"+name))
+                .withBindGroupLayout(LAYOUT).withBindGroupLayout(BindGroupLayout.builder().withUniform("GIBlur",UniformType.UNIFORM_BUFFER).build()).withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+                .withColorTargetState(new ColorTargetState(composite?Optional.of(new BlendFunction(BlendFactor.ONE,BlendFactor.ZERO,BlendFactor.ZERO,BlendFactor.ONE)):Optional.empty(),
+                        composite?GpuFormat.RGBA8_UNORM:GpuFormat.RGBA16_FLOAT,composite?ColorTargetState.WRITE_COLOR:ColorTargetState.WRITE_ALL))
+                .withDepthStencilState(Optional.empty()).build());
+    }
+    private static final RenderPipeline GATHER=pipeline("ssgi_gather",false),APPLY=pipeline("ssgi_apply",true),FILTER=pipeline("ssgi_filter",false);
+    private static final Matrix4f projection=new Matrix4f();
+    private static TextureTarget source,indirect,filtered;
+    private static MappableRingBuffer uniforms,horizontal,vertical;
+    private static boolean applied;
+    private static int frames;
+    private ScreenSpaceGI(){}
+    public static void captureProjection(Matrix4f matrix){projection.set(matrix);}
+    public static void render(){
+        applied=false;var mc=Minecraft.getInstance();
+        if(!VanillaLight.active()||!VanillaLight.ssgi()||VanillaLight.ssgiIntensity()==0||mc.level==null){release();return;}
+        if(PanoramaCapture.rendering())return;
+        var camera=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+        if(camera.fogType!=FogType.NONE)return;
+        var main=mc.gameRenderer.mainRenderTarget();
+        if(source==null||source.width!=main.width||source.height!=main.height){
+            release();source=new TextureTarget("Sanctuary SSGI source",main.width,main.height,GpuFormat.RGBA8_UNORM,null);
+            indirect=new TextureTarget("Sanctuary SSGI indirect",Math.max(1,(main.width+1)/2),Math.max(1,(main.height+1)/2),GpuFormat.RGBA16_FLOAT,null);
+            filtered=new TextureTarget("Sanctuary SSGI filtered",indirect.width,indirect.height,GpuFormat.RGBA16_FLOAT,null);
+        }
+        if(uniforms==null){
+            uniforms=new MappableRingBuffer(()->"Sanctuary SSGI",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,176);
+            horizontal=new MappableRingBuffer(()->"Sanctuary SSGI filter X",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,16);
+            vertical=new MappableRingBuffer(()->"Sanctuary SSGI filter Y",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,16);
+        }
+        horizontal.rotate();try(var m=horizontal.currentBuffer().map(false,true)){Std140Builder.intoBuffer(m.data()).putVec4(1,0,0,0);}
+        vertical.rotate();try(var m=vertical.currentBuffer().map(false,true)){Std140Builder.intoBuffer(m.data()).putVec4(0,1,0,0);}
+
+        var vp=new Matrix4f(projection).mul(camera.viewRotationMatrix);var fog=camera.fogData;
+        uniforms.rotate();try(var mapped=uniforms.currentBuffer().map(false,true)){
+            Std140Builder.intoBuffer(mapped.data()).putMat4f(new Matrix4f(vp).invert()).putMat4f(vp)
+                    .putVec4(VanillaLight.ssgiIntensity()/100f,RenderSystem.getDevice().getDeviceInfo().isZZeroToOne()?1:0,2.5f,32)
+                    .putVec4(fog.renderDistanceStart,fog.renderDistanceEnd,fog.environmentalStart,fog.environmentalEnd)
+                    .putVec4(fog.color.w,0,0,0);
+        }
+        // Snapshot once, before adding indirect light: no feedback, no texture sampled while attached for writing.
+        var encoder=RenderSystem.getDevice().createCommandEncoder();
+        encoder.copyTextureToTexture(main.getColorTexture(),source.getColorTexture(),0,0,0,0,0,main.width,main.height);
+        var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        try(var pass=encoder.createRenderPass(()->"Sanctuary SSGI gather",indirect.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(GATHER));pass.setUniform("GIBlur",horizontal.currentBuffer());pass.setUniform("GIParams",uniforms.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SceneColor",source.getColorTextureView(),nearest);
+            // Unused by gather; bind a separate texture, never its own output.
+            pass.setUniform("IndirectLight",source.getColorTextureView(),nearest);pass.draw(3,1,0,0);
+        }
+        filter(encoder,indirect,filtered,horizontal);
+        filter(encoder,filtered,indirect,vertical);
+        try(var pass=encoder.createRenderPass(()->"Sanctuary SSGI composite",main.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(APPLY));pass.setUniform("GIBlur",horizontal.currentBuffer());pass.setUniform("GIParams",uniforms.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SceneColor",source.getColorTextureView(),nearest);
+            pass.setUniform("IndirectLight",indirect.getColorTextureView(),nearest);pass.draw(3,1,0,0);
+        }
+        applied=true;frames++;
+    }
+    private static void filter(com.mojang.renderpearl.api.commands.CommandEncoder encoder,TextureTarget input,TextureTarget output,MappableRingBuffer direction){
+        var main=Minecraft.getInstance().gameRenderer.mainRenderTarget();var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        try(var pass=encoder.createRenderPass(()->"Sanctuary SSGI bilateral filter",output.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(FILTER));pass.setUniform("GIParams",uniforms.currentBuffer());pass.setUniform("GIBlur",direction.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SceneColor",source.getColorTextureView(),nearest);
+            pass.setUniform("IndirectLight",input.getColorTextureView(),RenderSystem.getSamplerCache().getClampToEdge(FilterMode.LINEAR));pass.draw(3,1,0,0);
+        }
+    }
+    public static void release(){if(source!=null){source.destroyBuffers();indirect.destroyBuffers();filtered.destroyBuffers();source=indirect=filtered=null;}if(uniforms!=null){uniforms.close();horizontal.close();vertical.close();uniforms=horizontal=vertical=null;}applied=false;}
+    static boolean applied(){return applied;}
+    static boolean allocated(){return source!=null;}
+    static int renderedFrames(){return frames;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ShaderOptionsScreen.java

@@ -1,5 +1,7 @@
 package fr.koka.sanctuary.client.shader;
 
+import com.mojang.serialization.Codec;
+import java.util.List;
 import net.minecraft.client.Minecraft;
 import net.minecraft.client.OptionInstance;
 import net.minecraft.client.gui.screens.Screen;
@@ -15,5 +17,55 @@ public final class ShaderOptionsScreen extends OptionsSubScreen {
         list.addBig(new OptionInstance<Integer>("sanctuary.shaders.saturation",OptionInstance.cachedConstantTooltip(
                 Component.translatable("sanctuary.shaders.saturation_help")),(caption,value)->Component.translatable("sanctuary.shaders.saturation_value",value),
                 new OptionInstance.IntRange(0,200),VanillaLight.saturation(),VanillaLight::setSaturation));
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders.precision",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.precision_help")),(caption,value)->Component.translatable("sanctuary.shaders.precision_value",value),
+                new OptionInstance.Enum<>(List.of(8,16,32,64,128),Codec.INT),VanillaLight.shadowPixels(),VanillaLight::setShadowPixels));
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.pbr",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.pbr_help")),VanillaLight.pbr(),VanillaLight::setPbr));
+        slider("pbr_intensity",VanillaLight.pbrIntensity(),VanillaLight::setPbrIntensity);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.colored_lights",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.colored_lights_help")),VanillaLight.coloredLights(),VanillaLight::setColoredLights));
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.warm_torches",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.warm_torches_help")),VanillaLight.warmTorches(),VanillaLight::setWarmTorches));
+        slider("colored_light_intensity",VanillaLight.coloredLightIntensity(),VanillaLight::setColoredLightIntensity);
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders.colored_light_distance",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.colored_light_distance_help")),(caption,value)->Component.translatable("sanctuary.shaders.colored_light_distance_value",value),
+                new OptionInstance.Enum<>(List.of(8,16,32,64),Codec.INT),VanillaLight.coloredLightDistance(),VanillaLight::setColoredLightDistance));
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.ssgi",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.ssgi_help")),VanillaLight.ssgi(),VanillaLight::setSsgi));
+        slider("ssgi_intensity",VanillaLight.ssgiIntensity(),VanillaLight::setSsgiIntensity);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.bloom",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.bloom_help")),VanillaLight.bloom(),VanillaLight::setBloom));
+        slider("bloom_intensity",VanillaLight.bloomIntensity(),VanillaLight::setBloomIntensity);
+        slider("bloom_radius",VanillaLight.bloomRadius(),VanillaLight::setBloomRadius);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.sunshafts",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.sunshafts_help")),VanillaLight.sunshafts(),VanillaLight::setSunshafts));
+        slider("sunshaft_intensity",VanillaLight.sunshaftIntensity(),VanillaLight::setSunshaftIntensity);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.lens_flare",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.lens_flare_help")),VanillaLight.lensFlare(),VanillaLight::setLensFlare));
+        slider("lens_flare_intensity",VanillaLight.lensFlareIntensity(),VanillaLight::setLensFlareIntensity);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.ore_emission",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.ore_emission_help")),VanillaLight.oreEmission(),VanillaLight::setOreEmission));
+        slider("ore_intensity",VanillaLight.oreIntensity(),VanillaLight::setOreIntensity);
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.edge_highlights",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.edge_highlights_help")),
+                VanillaLight.edgeHighlights(),VanillaLight::setEdgeHighlights));
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders.edge_intensity",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.edge_intensity_help")),(caption,value)->Component.translatable("sanctuary.shaders.edge_intensity_value",value),
+                new OptionInstance.IntRange(0,100),VanillaLight.edgeIntensity(),VanillaLight::setEdgeIntensity));
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders.edge_distance",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.edge_distance_help")),(caption,value)->Component.translatable("sanctuary.shaders.edge_distance_value",value),
+                new OptionInstance.Enum<>(List.of(16,32,64,128,256),Codec.INT),VanillaLight.edgeDistance(),VanillaLight::setEdgeDistance));
+        list.addBig(OptionInstance.createBoolean("sanctuary.shaders.pixel_shadows",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.pixel_shadows_help")),
+                VanillaLight.pixelShadows(),VanillaLight::setPixelShadows));
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders.shadow_distance",OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders.shadow_distance_help")),(caption,value)->Component.translatable("sanctuary.shaders.shadow_distance_value",value),
+                new OptionInstance.Enum<>(List.of(16,32,64,128,256),Codec.INT),VanillaLight.shadowDistance(),VanillaLight::setShadowDistance));
+    }
+    private void slider(String key,int value,java.util.function.Consumer<Integer> setter){
+        list.addBig(new OptionInstance<Integer>("sanctuary.shaders."+key,OptionInstance.cachedConstantTooltip(
+                Component.translatable("sanctuary.shaders."+key+"_help")),(caption,v)->Component.translatable("sanctuary.shaders."+key+"_value",v),
+                new OptionInstance.IntRange(0,100),value,setter::accept));
     }
 }

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ShadowProjection.java

@@ -0,0 +1,37 @@
+package fr.koka.sanctuary.client.shader;
+
+import org.joml.Matrix4f;
+import org.joml.Vector3f;
+
+/** Keeps the raster grid continuous as the sun moves; only camera recentering snaps to texels. */
+final class ShadowProjection {
+    private boolean initialized;
+    private int distance, size;
+    private double x, y, z, phaseX, phaseY;
+
+    Matrix4f matrix(Vector3f sun, int distance, int size, double x, double y, double z, boolean zeroToOne) {
+        float extent = distance + 16, reach = 4 * (distance + 16);
+        var view = new Matrix4f().lookAt(sun.x * reach, sun.y * reach, sun.z * reach,
+                0, 0, 0, 0, 0, 1);
+        double texel = 2.0 * extent / size;
+        if (!initialized || this.distance != distance || this.size != size) {
+            phaseX = phaseY = 0;
+        } else if (this.x != x || this.y != y || this.z != z) {
+            double dx = x - this.x, dy = y - this.y, dz = z - this.z;
+            phaseX = Math.IEEEremainder(phaseX + view.m00() * dx + view.m10() * dy + view.m20() * dz, texel);
+            phaseY = Math.IEEEremainder(phaseY + view.m01() * dx + view.m11() * dy + view.m21() * dz, texel);
+        }
+        // Re-rounding the projected WORLD origin every frame made a slowly rotating light jump
+        // a raster texel periodically, particularly far from spawn. Retain this phase in between
+        // camera anchor changes: the light can rotate continuously without moving the raster origin.
+        initialized = true;
+        this.distance = distance; this.size = size;
+        this.x = x; this.y = y; this.z = z;
+        var result = new Matrix4f().setOrtho(-extent, extent, -extent, extent, .1f, reach * 2, zeroToOne).mul(view);
+        result.m30(result.m30() + (float)(phaseX / extent));
+        result.m31(result.m31() + (float)(phaseY / extent));
+        return result;
+    }
+
+    void reset() { initialized = false; }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/ShadowTerrain.java

@@ -0,0 +1,528 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.blaze3d.vertex.BufferBuilder;
+import com.mojang.blaze3d.vertex.ByteBufferBuilder;
+import com.mojang.blaze3d.vertex.DefaultVertexFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.PrimitiveTopology;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.IdentityHashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import net.minecraft.core.Direction;
+import net.minecraft.tags.BlockTags;
+import net.minecraft.core.SectionPos;
+import net.minecraft.world.level.ChunkPos;
+import net.minecraft.client.multiplayer.ClientLevel;
+import net.minecraft.world.level.block.Block;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.chunk.LevelChunk;
+import net.minecraft.world.level.chunk.LevelChunkSection;
+import net.minecraft.world.level.chunk.status.ChunkStatus;
+import net.minecraft.world.phys.AABB;
+import net.minecraft.world.phys.Vec3;
+import org.joml.Vector3fc;
+
+/**
+ * Render-thread-only, read-only terrain casters. Call update BEFORE opening any render pass.
+ * Positions use POSITION_COLOR (three floats plus a foliage flag), relative to the entry's block
+ * origin; add that origin in the draw transform. Indices belong to RenderSystem's shared
+ * QUADS sequential buffer, which update grows before drawing. This cache never owns it.
+ *
+ * <p>Call dirtySection for edits (including affected neighbors), or dirtyChunk for a chunk
+ * packet that mutates an existing chunk. Identity changes/unloads are detected automatically.
+ * Call close on disable/disconnect/resource teardown; it is idempotent and the cache is reusable.
+ * A different ClientLevel, or update(null, ...), also releases all owned resources.
+ */
+public final class ShadowTerrain implements AutoCloseable {
+    /** Bounds metadata/work as well as geometry; shader options reach 256 blocks. */
+    public static final int MAX_DISTANCE = 256;
+    private static final int MAX_SECTIONS_PER_UPDATE = 4;
+    private static final long BUILD_NANOS = 3_000_000L;
+    private static final long MAX_GPU_BYTES = 96L * 1024 * 1024;
+    private static final int MAX_SECTION_QUADS = 65_536;
+    private static final int MAX_SHAPES = 1024;
+    private static final int MAX_BOXES = 256;
+    private static final Direction[] DIRECTIONS = Direction.values();
+
+    /** Borrowed buffer: owned exclusively by this cache, valid until its next update/close. */
+    public record Entry(int x, int y, int z, GpuBuffer vertices, int indexCount) { }
+
+    private final Map<Long, LevelChunk> chunks = new HashMap<>();
+    private final Map<Long, Section> sections = new HashMap<>();
+    private final Map<BlockState, Shape> shapes = new IdentityHashMap<>();
+    private ClientLevel level;
+    private Bounds bounds;
+    private Build building;
+    private long gpuBytes;
+    private List<Entry> entries = List.of();
+    private boolean entriesChanged;
+    private long reconciledTick = Long.MIN_VALUE;
+    private boolean metadataDirty = true;
+    private int cameraSectionX, cameraSectionY, cameraSectionZ;
+
+    /**
+     * Refreshes loaded section metadata, then meshes at most four sections within a soft 3 ms
+     * budget. A large section resumes next call; a single shape lookup or GPU upload cannot be
+     * preempted. distance is in blocks, 0..MAX_DISTANCE. The receiver volume plus an eight-block guard
+     * is extruded by twice that distance toward the sun, rounded to sections and clipped
+     * to the level's build height. This includes loaded casters outside the camera frustum.
+     *
+     * <p>The 96 MiB vertex budget favors nearer sections. Evicted/deferred meshes are retried
+     * when room becomes available or the camera enters another section. Pathological geometry
+     * exceeding 256 boxes per state or 65,536 quads per section is omitted, never approximated
+     * by a full cube or uploaded partially. It can be retried after invalidation.
+     */
+    public List<Entry> update(ClientLevel level, Vec3 camera, int distance, Vector3fc sun) {
+        RenderSystem.assertOnRenderThread();
+        if (level == null) {
+            close();
+            return entries;
+        }
+        Objects.requireNonNull(camera, "camera");
+        if (distance < 0 || distance > MAX_DISTANCE || !Double.isFinite(camera.x)
+                || !Double.isFinite(camera.y) || !Double.isFinite(camera.z)) {
+            throw new IllegalArgumentException("Finite camera and shadow distance 0.." + MAX_DISTANCE + " required");
+        }
+        if (this.level != level) {
+            close();
+            this.level = level;
+        }
+        int radius = distance + 8;
+        double dx = sun.x() * distance * 2, dy = sun.y() * distance * 2, dz = sun.z() * distance * 2;
+        Bounds next = new Bounds(section(camera.x - radius + Math.min(0, dx)), section(camera.x + radius + Math.max(0, dx)),
+                Math.max(level.getMinSectionY(), section(camera.y - radius + Math.min(0, dy))),
+                Math.min(level.getMaxSectionY() - 1, section(camera.y + radius + Math.max(0, dy))),
+                section(camera.z - radius + Math.min(0, dz)), section(camera.z + radius + Math.max(0, dz)));
+        int cx = section(camera.x), cy = section(camera.y), cz = section(camera.z);
+        boolean moved = !next.equals(bounds) || cx != cameraSectionX || cy != cameraSectionY || cz != cameraSectionZ;
+        if (bounds != null && !next.equals(bounds)) {
+            // Changing the caster boundary changes which neighboring faces may be culled.
+            for (Section section : sections.values()) {
+                if (bounds.onBoundary(section) || next.onBoundary(section)) dirty(section);
+            }
+        }
+        bounds = next;
+        cameraSectionX = cx;
+        cameraSectionY = cy;
+        cameraSectionZ = cz;
+        // Large ranges must not rescan loaded chunk metadata at the display's frame rate.
+        if (moved || metadataDirty || reconciledTick != level.getGameTime()) {
+            reconcile();
+            reconciledTick = level.getGameTime();
+            metadataDirty = false;
+        }
+        if (moved) {
+            retryDeferred();
+        }
+
+        long deadline = System.nanoTime() + BUILD_NANOS;
+        int started = building == null ? 0 : 1;
+        try {
+            while (System.nanoTime() < deadline) {
+                if (building == null) {
+                    if (started == MAX_SECTIONS_PER_UPDATE) break;
+                    Section nearest = nearestDirty(camera);
+                    if (nearest == null) break;
+                    building = new Build(nearest);
+                    started++;
+                }
+                if (!advance(building, deadline)) break;
+                Build finished = building;
+                building = null;
+                try (finished) {
+                    upload(finished, camera);
+                }
+            }
+        } catch (RuntimeException | Error failure) {
+            cancelBuild();
+            throw failure;
+        }
+        return entries();
+    }
+
+    /** Immutable snapshot; consume after update and before another update or close. */
+    public List<Entry> entries() {
+        RenderSystem.assertOnRenderThread();
+        if (entriesChanged) {
+            var result = new ArrayList<Entry>();
+            for (Section section : sections.values()) {
+                if (section.entry != null) result.add(section.entry);
+            }
+            entries = List.copyOf(result);
+            entriesChanged = false;
+        }
+        return entries;
+    }
+
+    /** Outstanding rebuilds, including the in-progress section; excludes memory-deferred work. */
+    public int pendingSections() {
+        RenderSystem.assertOnRenderThread();
+        int pending = 0;
+        for (Section section : sections.values()) {
+            if (section.dirty && !section.deferred) pending++;
+        }
+        return pending;
+    }
+
+    /** No runnable mesh work after the last update; may still omit memory/complexity-limited sections. */
+    public boolean settled() {
+        return pendingSections() == 0;
+    }
+
+    /** Coordinates are section coordinates, not block origins. Caller also invalidates neighbors. */
+    public void dirtySection(int sx, int sy, int sz) {
+        RenderSystem.assertOnRenderThread();
+        Section section = sections.get(SectionPos.asLong(sx, sy, sz));
+        if (section != null) dirty(section);
+        else metadataDirty = true;
+    }
+
+    /** Coordinates are chunk coordinates. Caller also invalidates adjacent chunks as needed. */
+    public void dirtyChunk(int cx, int cz) {
+        RenderSystem.assertOnRenderThread();
+        metadataDirty = true;
+        for (Section section : sections.values()) {
+            if (section.x == cx && section.z == cz) dirty(section);
+        }
+    }
+
+    private void dirty(Section section) {
+        section.dirty = true;
+        section.deferred = false;
+        if (building != null && building.section == section) cancelBuild();
+    }
+
+    /** Poll only chunk identities and section emptiness; never scan unchanged block storage. */
+    private void reconcile() {
+        var loaded = new HashMap<Long, LevelChunk>();
+        if (bounds.minY <= bounds.maxY) {
+            for (int x = bounds.minX; x <= bounds.maxX; x++) {
+                for (int z = bounds.minZ; z <= bounds.maxZ; z++) {
+                    LevelChunk chunk = level.getChunkSource().getChunk(x, z, ChunkStatus.FULL, false);
+                    long key = ChunkPos.pack(x, z);
+                    if (chunk != null) loaded.put(key, chunk);
+                    if (chunks.get(key) != chunk) dirtyChunkAndNeighbors(x, z);
+                }
+            }
+        }
+        for (long key : chunks.keySet()) {
+            if (!loaded.containsKey(key)) dirtyChunkAndNeighbors(ChunkPos.getX(key), ChunkPos.getZ(key));
+        }
+        chunks.clear();
+        chunks.putAll(loaded);
+
+        boolean freed = false;
+        for (Iterator<Section> iterator = sections.values().iterator(); iterator.hasNext();) {
+            Section section = iterator.next();
+            LevelChunk chunk = chunks.get(ChunkPos.pack(section.x, section.z));
+            if (!bounds.contains(section.x, section.y, section.z) || chunk != section.chunk
+                    || chunk.getSection(level.getSectionIndexFromSectionY(section.y)) != section.storage
+                    || section.storage.hasOnlyAir()) {
+                if (building != null && building.section == section) cancelBuild();
+                freed |= section.entry != null;
+                release(section);
+                iterator.remove();
+            }
+        }
+        for (LevelChunk chunk : chunks.values()) {
+            int x = chunk.getPos().x(), z = chunk.getPos().z();
+            for (int y = bounds.minY; y <= bounds.maxY; y++) {
+                LevelChunkSection storage = chunk.getSection(level.getSectionIndexFromSectionY(y));
+                long key = SectionPos.asLong(x, y, z);
+                if (!storage.hasOnlyAir() && !sections.containsKey(key)) {
+                    sections.put(key, new Section(x, y, z, chunk, storage));
+                }
+            }
+        }
+        if (freed) retryDeferred();
+    }
+
+    private void dirtyChunkAndNeighbors(int x, int z) {
+        dirtyChunk(x, z);
+        dirtyChunk(x - 1, z);
+        dirtyChunk(x + 1, z);
+        dirtyChunk(x, z - 1);
+        dirtyChunk(x, z + 1);
+    }
+
+    private void retryDeferred() {
+        for (Section section : sections.values()) {
+            if (section.deferred) {
+                section.deferred = false;
+                section.dirty = true;
+            }
+        }
+    }
+
+    private Section nearestDirty(Vec3 camera) {
+        Section nearest = null;
+        double best = Double.POSITIVE_INFINITY;
+        for (Section section : sections.values()) {
+            if (section.dirty && !section.deferred) {
+                double distance = section.distanceSquared(camera);
+                if (distance < best) {
+                    best = distance;
+                    nearest = section;
+                }
+            }
+        }
+        return nearest;
+    }
+
+    private boolean advance(Build build, long deadline) {
+        while (build.cursor < 4096) {
+            int index = build.cursor++;
+            int x = index & 15, z = (index >> 4) & 15, y = index >> 8;
+            var state = build.section.storage.getBlockState(x, y, z);
+            boolean foliage = state.is(BlockTags.LEAVES);
+            Shape shape = foliage ? LEAVES : shape(state);
+            if (shape != null) {
+                if (shape.boxes == null) {
+                    build.oversized = true;
+                    return true;
+                }
+                int hidden = 0;
+                for (Direction direction : DIRECTIONS) {
+                    if (foliage) break; // Retain internal leaf faces: each layer contributes transmission.
+                    BlockState neighbor = neighbor(build.section, x + direction.getStepX(),
+                            y + direction.getStepY(), z + direction.getStepZ());
+                    Shape other = neighbor == null ? null : shape(neighbor);
+                    if (other != null && (other.fullFaces & (1 << direction.getOpposite().ordinal())) != 0) {
+                        hidden |= 1 << direction.ordinal();
+                    }
+                }
+                for (AABB box : shape.boxes) {
+                    for (Direction direction : DIRECTIONS) {
+                        if ((hidden & (1 << direction.ordinal())) != 0 && atBoundary(box, direction)) continue;
+                        if (build.quads == MAX_SECTION_QUADS) {
+                            build.oversized = true;
+                            return true;
+                        }
+                        face(build.vertices, box, x, y, z, direction, foliage ? 0xFFFFFFFF : 0xFF000000);
+                        build.quads++;
+                    }
+                }
+            }
+            if ((build.cursor & 31) == 0 && System.nanoTime() >= deadline) return build.cursor == 4096;
+        }
+        return true;
+    }
+
+    private BlockState neighbor(Section section, int x, int y, int z) {
+        if ((x | y | z) >= 0 && x < 16 && y < 16 && z < 16) {
+            return section.storage.getBlockState(x, y, z);
+        }
+        int sx = section.x + (x >> 4), sy = section.y + (y >> 4), sz = section.z + (z >> 4);
+        // Keep the exterior faces of the caster volume; no dependency on chunks outside it.
+        if (!bounds.contains(sx, sy, sz)) return null;
+        LevelChunk chunk = chunks.get(ChunkPos.pack(sx, sz));
+        if (chunk == null) return null;
+        return chunk.getSection(level.getSectionIndexFromSectionY(sy)).getBlockState(x & 15, y & 15, z & 15);
+    }
+
+    private Shape shape(BlockState state) {
+        // Retain the solid part of waterlogged slabs/stairs, but never mesh the fluid itself.
+        if (state.isAir() || state.is(BlockTags.LEAVES) || !state.canOcclude() || state.liquid()) return null;
+        Shape cached = shapes.get(state);
+        if (cached != null) return cached;
+        // In 26.3 occlusion shapes are cached on BlockState and take no level/position argument.
+        var voxel = state.getOcclusionShape();
+        var boxes = new ArrayList<AABB>();
+        voxel.forAllBoxes((x0, y0, z0, x1, y1, z1) -> {
+            if (boxes.size() <= MAX_BOXES) boxes.add(new AABB(x0, y0, z0, x1, y1, z1));
+        });
+        int fullFaces = 0;
+        for (Direction direction : DIRECTIONS) {
+            if (Block.isFaceFull(voxel, direction)) fullFaces |= 1 << direction.ordinal();
+        }
+        // An omitted shape must not hide the faces of the surrounding geometry.
+        Shape result = boxes.size() > MAX_BOXES ? new Shape(null, 0) : new Shape(boxes.toArray(AABB[]::new), fullFaces);
+        if (shapes.size() == MAX_SHAPES) shapes.clear();
+        shapes.put(state, result);
+        return result;
+    }
+
+    private void upload(Build build, Vec3 camera) {
+        Section section = build.section;
+        if (build.oversized || build.quads == 0) {
+            release(section);
+            section.dirty = false;
+            retryDeferred();
+            return;
+        }
+        try (var mesh = build.vertices.buildOrThrow()) {
+            long bytes = mesh.vertexBuffer().remaining();
+            long previous = section.entry == null ? 0 : section.entry.vertices.size();
+            // Release the old buffer before replacement, so even transient owned GPU memory is bounded.
+            release(section);
+            while (gpuBytes + bytes > MAX_GPU_BYTES) {
+                Section farthest = null;
+                double far = section.distanceSquared(camera);
+                for (Section candidate : sections.values()) {
+                    double distance = candidate.distanceSquared(camera);
+                    if (candidate.entry != null && distance > far) {
+                        farthest = candidate;
+                        far = distance;
+                    }
+                }
+                if (farthest == null) {
+                    section.deferred = true;
+                    return;
+                }
+                release(farthest);
+                farthest.dirty = true;
+                farthest.deferred = true;
+            }
+            int indexCount = mesh.drawState().indexCount();
+            RenderSystem.getSequentialBuffer(PrimitiveTopology.QUADS).getBuffer(indexCount);
+            GpuBuffer buffer = RenderSystem.getDevice().createBuffer(() -> "Sanctuary shadow terrain "
+                            + section.x + "," + section.y + "," + section.z,
+                    GpuBuffer.USAGE_VERTEX | GpuBuffer.USAGE_COPY_DST, mesh.vertexBuffer());
+            section.entry = new Entry(section.x << 4, section.y << 4, section.z << 4, buffer, indexCount);
+            gpuBytes += buffer.size();
+            section.dirty = false;
+            entriesChanged = true;
+            if (bytes < previous) retryDeferred();
+        }
+    }
+
+    private void release(Section section) {
+        if (section.entry != null) {
+            GpuBuffer buffer = section.entry.vertices;
+            gpuBytes -= buffer.size();
+            buffer.close();
+            section.entry = null;
+            entriesChanged = true;
+        }
+    }
+
+    private void cancelBuild() {
+        if (building != null) {
+            building.close();
+            building = null;
+        }
+    }
+
+    @Override
+    public void close() {
+        RenderSystem.assertOnRenderThread();
+        cancelBuild();
+        for (Section section : sections.values()) release(section);
+        sections.clear();
+        chunks.clear();
+        reconciledTick = Long.MIN_VALUE;
+        metadataDirty = true;
+        shapes.clear();
+        entries = List.of();
+        entriesChanged = false;
+        gpuBytes = 0;
+        bounds = null;
+        level = null;
+    }
+
+    private static int section(double coordinate) {
+        return (int) Math.floor(coordinate / 16.0);
+    }
+
+    private static boolean atBoundary(AABB box, Direction direction) {
+        return switch (direction) {
+            case DOWN -> box.minY == 0;
+            case UP -> box.maxY == 1;
+            case NORTH -> box.minZ == 0;
+            case SOUTH -> box.maxZ == 1;
+            case WEST -> box.minX == 0;
+            case EAST -> box.maxX == 1;
+        };
+    }
+
+    /** Counterclockwise exterior faces, matching the native sequential QUADS index order. */
+    private static void face(BufferBuilder out, AABB box, int x, int y, int z, Direction direction, int color) {
+        float x0 = x + (float) box.minX, x1 = x + (float) box.maxX;
+        float y0 = y + (float) box.minY, y1 = y + (float) box.maxY;
+        float z0 = z + (float) box.minZ, z1 = z + (float) box.maxZ;
+        switch (direction) {
+            case DOWN -> {
+                out.addVertex(x0, y0, z0).setColor(color); out.addVertex(x1, y0, z0).setColor(color);
+                out.addVertex(x1, y0, z1).setColor(color); out.addVertex(x0, y0, z1).setColor(color);
+            }
+            case UP -> {
+                out.addVertex(x0, y1, z0).setColor(color); out.addVertex(x0, y1, z1).setColor(color);
+                out.addVertex(x1, y1, z1).setColor(color); out.addVertex(x1, y1, z0).setColor(color);
+            }
+            case NORTH -> {
+                out.addVertex(x0, y0, z0).setColor(color); out.addVertex(x0, y1, z0).setColor(color);
+                out.addVertex(x1, y1, z0).setColor(color); out.addVertex(x1, y0, z0).setColor(color);
+            }
+            case SOUTH -> {
+                out.addVertex(x0, y0, z1).setColor(color); out.addVertex(x1, y0, z1).setColor(color);
+                out.addVertex(x1, y1, z1).setColor(color); out.addVertex(x0, y1, z1).setColor(color);
+            }
+            case WEST -> {
+                out.addVertex(x0, y0, z0).setColor(color); out.addVertex(x0, y0, z1).setColor(color);
+                out.addVertex(x0, y1, z1).setColor(color); out.addVertex(x0, y1, z0).setColor(color);
+            }
+            case EAST -> {
+                out.addVertex(x1, y0, z0).setColor(color); out.addVertex(x1, y1, z0).setColor(color);
+                out.addVertex(x1, y1, z1).setColor(color); out.addVertex(x1, y0, z1).setColor(color);
+            }
+        }
+    }
+
+    private record Bounds(int minX, int maxX, int minY, int maxY, int minZ, int maxZ) {
+        boolean contains(int x, int y, int z) {
+            return x >= minX && x <= maxX && y >= minY && y <= maxY && z >= minZ && z <= maxZ;
+        }
+
+        boolean onBoundary(Section section) {
+            return section.x == minX || section.x == maxX || section.y == minY || section.y == maxY
+                    || section.z == minZ || section.z == maxZ;
+        }
+    }
+
+    private record Shape(AABB[] boxes, int fullFaces) { }
+    private static final Shape LEAVES = new Shape(new AABB[]{new AABB(0, 0, 0, 1, 1, 1)}, 0);
+
+    private static final class Section {
+        final int x, y, z;
+        final LevelChunk chunk;
+        final LevelChunkSection storage;
+        Entry entry;
+        boolean dirty = true;
+        boolean deferred;
+
+        Section(int x, int y, int z, LevelChunk chunk, LevelChunkSection storage) {
+            this.x = x;
+            this.y = y;
+            this.z = z;
+            this.chunk = chunk;
+            this.storage = storage;
+        }
+
+        double distanceSquared(Vec3 camera) {
+            double dx = x * 16.0 + 8 - camera.x, dy = y * 16.0 + 8 - camera.y, dz = z * 16.0 + 8 - camera.z;
+            return dx * dx + dy * dy + dz * dz;
+        }
+    }
+
+    private static final class Build implements AutoCloseable {
+        final Section section;
+        final ByteBufferBuilder bytes = new ByteBufferBuilder(64 * 1024);
+        final BufferBuilder vertices = new BufferBuilder(bytes, PrimitiveTopology.QUADS, DefaultVertexFormat.POSITION_COLOR);
+        int cursor, quads;
+        boolean oversized;
+
+        Build(Section section) {
+            this.section = section;
+        }
+
+        @Override
+        public void close() {
+            bytes.close();
+        }
+    }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/Sunshafts.java

@@ -0,0 +1,86 @@
+package fr.koka.sanctuary.client.shader;
+
+import com.mojang.blaze3d.buffers.Std140Builder;
+import com.mojang.blaze3d.pipeline.TextureTarget;
+import com.mojang.blaze3d.systems.RenderSystem;
+import com.mojang.renderpearl.api.GpuFormat;
+import com.mojang.renderpearl.api.buffers.GpuBuffer;
+import com.mojang.renderpearl.api.pipeline.*;
+import com.mojang.renderpearl.api.textures.FilterMode;
+import fr.koka.sanctuary.client.panorama.PanoramaCapture;
+import java.util.Optional;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.MappableRingBuffer;
+import net.minecraft.client.renderer.RenderPipelines;
+import net.minecraft.resources.Identifier;
+
+/** Solar scattering in the existing shadow volume. No scene copy, readback, temporal history or terrain duplication. */
+public final class Sunshafts {
+    private static final BindGroupLayout SCENE=BindGroupLayout.builder()
+            .withUniform("PixelShadows",UniformType.UNIFORM_BUFFER)
+            .withUniform("ShaftParams",UniformType.UNIFORM_BUFFER)
+            .withUniform("WorldDepth",UniformType.COMBINED_IMAGE_SAMPLER).build();
+    private static RenderPipeline pipeline(String name,boolean composite){
+        var inputs=BindGroupLayout.builder();
+        if(composite)inputs.withUniform("ShaftLight",UniformType.COMBINED_IMAGE_SAMPLER);
+        else inputs.withUniform("SunDepth",UniformType.COMBINED_IMAGE_SAMPLER);
+        return RenderPipelines.register(RenderPipeline.builder().withLocation(Identifier.parse("sanctuary:pipeline/"+name))
+                .withVertexShader("core/screenquad").withFragmentShader(Identifier.parse("sanctuary:core/"+name))
+                .withBindGroupLayout(SCENE).withBindGroupLayout(inputs.build())
+                .withPrimitiveTopology(PrimitiveTopology.TRIANGLES).withCull(false)
+                .withColorTargetState(new ColorTargetState(composite?Optional.of(new BlendFunction(BlendFactor.ONE,BlendFactor.ONE_MINUS_SRC_COLOR,BlendFactor.ZERO,BlendFactor.ONE)):Optional.empty(),
+                        composite?GpuFormat.RGBA8_UNORM:GpuFormat.RGBA16_FLOAT,composite?ColorTargetState.WRITE_COLOR:ColorTargetState.WRITE_ALL))
+                .withDepthStencilState(Optional.empty()).build());
+    }
+    private static final RenderPipeline GATHER=pipeline("sunshaft_gather",false),APPLY=pipeline("sunshaft_apply",true);
+    private static TextureTarget light;
+    private static MappableRingBuffer settings;
+    private static boolean applied;
+    private static int frames;
+    private Sunshafts(){}
+    public static void render(){
+        applied=false;var mc=Minecraft.getInstance();
+        if(!VanillaLight.active()||!VanillaLight.sunshafts()||VanillaLight.sunshaftIntensity()==0||mc.level==null){release();return;}
+        if(PanoramaCapture.rendering())return;
+        if(!PixelShadows.depthReady()){release();return;}
+        var main=mc.gameRenderer.mainRenderTarget();int width=Math.max(1,(main.width+3)/4),height=Math.max(1,(main.height+3)/4);
+        if(light==null||light.width!=width||light.height!=height){release();light=new TextureTarget("Sanctuary sunshafts",width,height,GpuFormat.RGBA16_FLOAT,null);}
+        if(settings==null)settings=new MappableRingBuffer(()->"Sanctuary sunshafts",GpuBuffer.USAGE_UNIFORM|GpuBuffer.USAGE_MAP_WRITE,48);
+        var camera=mc.gameRenderer.gameRenderState().levelRenderState.cameraRenderState;
+        var fog=camera.fogData;
+        float mist=fogDensity(fog.environmentalEnd);
+        float rain=mc.level.getRainLevel(camera.cameraEntityPartialTicks);
+        float thunder=mc.level.getThunderLevel(camera.cameraEntityPartialTicks);
+        var sun=PixelShadows.sunDirection(mc.gameRenderer.gameRenderState().levelRenderState.skyRenderState.sunAngle);
+        float daylight=Math.clamp((sun.y-.08f)/.16f,0,1)*(1-.75f*rain)*(1-.65f*thunder);
+        float density=1+2.5f*mist+.8f*rain;
+        float spread=Math.max(mist,.35f*rain);
+        float extinction=1+.7f*mist+.25f*rain;
+        settings.rotate();try(var mapped=settings.currentBuffer().map(false,true)){
+            Std140Builder.intoBuffer(mapped.data()).putVec4(.85f+.15f*fog.color.x,.78f+.15f*fog.color.y,.66f+.15f*fog.color.z,0)
+                    .putVec4(VanillaLight.sunshaftIntensity()/100f,Math.min(64,VanillaLight.shadowDistance()*.5f),0,0)
+                    .putVec4(density,spread,extinction,daylight);
+        }
+        var encoder=RenderSystem.getDevice().createCommandEncoder();var nearest=RenderSystem.getSamplerCache().getClampToEdge(FilterMode.NEAREST);
+        try(var pass=encoder.createRenderPass(()->"Sanctuary solar volume",light.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(GATHER));pass.setUniform("PixelShadows",PixelShadows.materialUniforms());pass.setUniform("ShaftParams",settings.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("SunDepth",PixelShadows.materialDepth(),nearest);pass.draw(3,1,0,0);
+        }
+        try(var pass=encoder.createRenderPass(()->"Sanctuary solar volume composite",main.getColorTextureView(),Optional.empty())){
+            pass.setPipeline(RenderSystem.getCompiledPipeline(APPLY));pass.setUniform("PixelShadows",PixelShadows.materialUniforms());pass.setUniform("ShaftParams",settings.currentBuffer());
+            pass.setUniform("WorldDepth",main.getDepthTextureView(),nearest);pass.setUniform("ShaftLight",light.getColorTextureView(),nearest);pass.draw(3,1,0,0);
+        }
+        applied=true;frames++;
+    }
+    /** Environmental fog has its own end distance; changing render distance is not weather. */
+    static float fogDensity(float environmentalEnd){
+        if(!Float.isFinite(environmentalEnd))return 0;
+        float t=Math.clamp((192-environmentalEnd)/112,0,1);
+        return t*t*(3-2*t);
+    }
+    public static void release(){if(light!=null){light.destroyBuffers();light=null;}if(settings!=null){settings.close();settings=null;}applied=false;}
+    static boolean applied(){return applied;}
+    static boolean allocated(){return light!=null;}
+    static int renderedFrames(){return frames;}
+    static TextureTarget target(){return light;}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/client/shader/VanillaLight.java

@@ -14,25 +14,124 @@ public final class VanillaLight {
             ||FabricLoader.getInstance().isModLoaded("oculus")||FabricLoader.getInstance().isModLoaded("canvas");
     private static Preferences preferences;
     private VanillaLight() { }
-    private static final class Preferences { boolean enabled=true;int saturation=142; }
+    private static final class Preferences {
+        boolean enabled=true;
+        int saturation=142;
+        boolean pixelShadows=true;
+        boolean bloom=true;
+        boolean sunshafts=true;
+        int sunshaftIntensity=35;
+        boolean lensFlare=true;
+        int lensFlareIntensity=30;
+        boolean pbr=true;
+        int pbrIntensity=50;
+        boolean ssgi=true;
+        boolean coloredLights=true;
+        boolean warmTorches=false;
+        int coloredLightIntensity=30;
+        int coloredLightDistance=16;
+        int ssgiIntensity=35;
+        int bloomIntensity=20;
+        int bloomRadius=50;
+        boolean oreEmission=true;
+        int oreIntensity=50;
+        boolean edgeHighlights=true;
+        int edgeIntensity=30;
+        int edgeDistance=32;
+        int shadowPixels=16;
+        int shadowDistance=128;
+    }
     private static Path path(){return FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");}
     public static boolean enabled(){
         if(preferences==null){
             try{if(Files.isRegularFile(path()))preferences=new GsonBuilder().create().fromJson(Files.readString(path()),Preferences.class);}
             catch(Exception e){SanctuaryMod.LOGGER.warn("Cannot read Sanctuary shader preference",e);}
             if(preferences==null)preferences=new Preferences();
+            preferences.sunshaftIntensity=Math.clamp(preferences.sunshaftIntensity,0,100);
+            preferences.lensFlareIntensity=Math.clamp(preferences.lensFlareIntensity,0,100);
+            preferences.pbrIntensity=Math.clamp(preferences.pbrIntensity,0,100);
+            preferences.coloredLightIntensity=Math.clamp(preferences.coloredLightIntensity,0,100);
+            preferences.coloredLightDistance=normalizeColoredLightDistance(preferences.coloredLightDistance);
+            preferences.ssgiIntensity=Math.clamp(preferences.ssgiIntensity,0,100);
+            preferences.bloomIntensity=Math.clamp(preferences.bloomIntensity,0,100);
+            preferences.bloomRadius=Math.clamp(preferences.bloomRadius,0,100);
+            preferences.oreIntensity=Math.clamp(preferences.oreIntensity,0,100);
+            preferences.edgeIntensity=Math.clamp(preferences.edgeIntensity,0,100);
+            preferences.edgeDistance=normalizeShadowDistance(preferences.edgeDistance);
             preferences.saturation=Math.clamp(preferences.saturation,0,200);
+            preferences.shadowPixels=normalizePrecision(preferences.shadowPixels);
+            preferences.shadowDistance=normalizeShadowDistance(preferences.shadowDistance);
         }
         return preferences.enabled;
     }
     public static boolean externalEngine(){return EXTERNAL_ENGINE;}
     public static boolean active(){return ProgressionClient.active()&&!EXTERNAL_ENGINE&&enabled();}
     public static int saturation(){enabled();return preferences.saturation;}
+    public static boolean edgeHighlights(){enabled();return preferences.edgeHighlights;}
+    public static int edgeDistance(){enabled();return preferences.edgeDistance;}
+    public static void setEdgeDistance(int value){enabled();preferences.edgeDistance=normalizeShadowDistance(value);save();}
+    public static int edgeIntensity(){enabled();return preferences.edgeIntensity;}
+    public static void setEdgeHighlights(boolean value){enabled();preferences.edgeHighlights=value;save();}
+    public static void setEdgeIntensity(int value){enabled();preferences.edgeIntensity=Math.clamp(value,0,100);save();}
+    public static boolean sunshafts(){enabled();return preferences.sunshafts;}
+    public static int sunshaftIntensity(){enabled();return preferences.sunshaftIntensity;}
+    public static void setSunshafts(boolean value){enabled();preferences.sunshafts=value;save();}
+    public static void setSunshaftIntensity(int value){enabled();preferences.sunshaftIntensity=Math.clamp(value,0,100);save();}
+    public static boolean lensFlare(){enabled();return preferences.lensFlare;}
+    public static int lensFlareIntensity(){enabled();return preferences.lensFlareIntensity;}
+    public static void setLensFlare(boolean value){enabled();preferences.lensFlare=value;save();}
+    public static void setLensFlareIntensity(int value){enabled();preferences.lensFlareIntensity=Math.clamp(value,0,100);save();}
+    public static boolean pbr(){enabled();return preferences.pbr;}
+    public static int pbrIntensity(){enabled();return preferences.pbrIntensity;}
+    public static void setPbr(boolean value){enabled();preferences.pbr=value;save();}
+    public static void setPbrIntensity(int value){enabled();preferences.pbrIntensity=Math.clamp(value,0,100);save();}
+    public static boolean warmTorches(){enabled();return preferences.warmTorches;}
+    public static void setWarmTorches(boolean value){enabled();preferences.warmTorches=value;save();}
+    public static boolean coloredLights(){enabled();return preferences.coloredLights;}
+    public static int coloredLightIntensity(){enabled();return preferences.coloredLightIntensity;}
+    public static void setColoredLights(boolean value){enabled();preferences.coloredLights=value;save();}
+    public static void setColoredLightIntensity(int value){enabled();preferences.coloredLightIntensity=Math.clamp(value,0,100);save();}
+    public static int coloredLightDistance(){enabled();return preferences.coloredLightDistance;}
+    public static void setColoredLightDistance(int value){enabled();preferences.coloredLightDistance=normalizeColoredLightDistance(value);save();}
+    static int normalizeColoredLightDistance(int value){return value<12?8:value<24?16:value<48?32:64;}
+    public static boolean ssgi(){enabled();return preferences.ssgi;}
+    public static int ssgiIntensity(){enabled();return preferences.ssgiIntensity;}
+    public static void setSsgi(boolean value){enabled();preferences.ssgi=value;save();}
+    public static void setSsgiIntensity(int value){enabled();preferences.ssgiIntensity=Math.clamp(value,0,100);save();}
+    public static boolean bloom(){enabled();return preferences.bloom;}
+    public static int bloomIntensity(){enabled();return preferences.bloomIntensity;}
+    public static int bloomRadius(){enabled();return preferences.bloomRadius;}
+    public static boolean oreEmission(){enabled();return preferences.oreEmission;}
+    public static int oreIntensity(){enabled();return preferences.oreIntensity;}
+    public static void setBloom(boolean value){enabled();preferences.bloom=value;save();}
+    public static void setBloomIntensity(int value){enabled();preferences.bloomIntensity=Math.clamp(value,0,100);save();}
+    public static void setBloomRadius(int value){enabled();preferences.bloomRadius=Math.clamp(value,0,100);save();}
+    public static void setOreEmission(boolean value){enabled();preferences.oreEmission=value;save();}
+    public static void setOreIntensity(int value){enabled();preferences.oreIntensity=Math.clamp(value,0,100);save();}
+    public static boolean pixelShadows(){enabled();return preferences.pixelShadows;}
+    public static int shadowPixels(){enabled();return preferences.shadowPixels;}
+    public static int shadowDistance(){enabled();return preferences.shadowDistance;}
     public static void setSaturation(int value){enabled();preferences.saturation=Math.clamp(value,0,200);save();}
+    public static void setPixelShadows(boolean value){enabled();preferences.pixelShadows=value;save();}
+    public static void setShadowPixels(int value){enabled();preferences.shadowPixels=normalizePrecision(value);save();}
+    public static void setShadowDistance(int value){enabled();preferences.shadowDistance=normalizeShadowDistance(value);save();}
     public static void setEnabled(boolean value){
         enabled();preferences.enabled=value;
         save();
     }
+    /** Nearest supported value, clamped at either end; midpoint ties round up. */
+    private static int normalizePrecision(int value){
+        if(value<12)return 8;
+        if(value<24)return 16;
+        if(value<48)return 32;
+        return value<96?64:128;
+    }
+    private static int normalizeShadowDistance(int value){
+        if(value<24)return 16;
+        if(value<48)return 32;
+        if(value<96)return 64;
+        return value<192?128:256;
+    }
     private static void save(){
         try{
             Files.createDirectories(path().getParent());var temporary=path().resolveSibling(path().getFileName()+".tmp");

mods/sanctuary/src/main/java/fr/koka/sanctuary/companion/CompanionQueries.java

@@ -34,13 +34,17 @@ public final class CompanionQueries {
             &&familiar.egg().getItem() instanceof net.minecraft.world.item.SpawnEggItem?net.minecraft.world.item.SpawnEggItem.getType(familiar.egg()):entity.getType();
         var id=BuiltInRegistries.ENTITY_TYPE.getKey(type).getPath();
         if(CompanionType.find(id)==null)return;
-        var seen=new TreeSet<>(Arrays.asList(record.notes().getOrDefault("seen_mobs","").split(",")));seen.remove("");
-        if(seen.add(id))record=record.note("seen_mobs",String.join(",",seen));
+        record=discoverSpecies(record,List.of(id));
         if(entity instanceof net.minecraft.world.entity.animal.fish.TropicalFish fish){
             var variants=fishVariants(record);variants.set(fishVariant(fish));record=record.note("seen_fish_v1",Base64.getEncoder().encodeToString(variants.toByteArray()));
         }
         if(!record.equals(CompanionService.record(p)))CompanionService.save(p,record);
     }
+    /** The same encounter record is used by natural observation and administrative discoveries. */
+    public static CompanionRecord discoverSpecies(CompanionRecord record,Collection<String> ids){
+        var seen=new TreeSet<>(Arrays.asList(record.notes().getOrDefault("seen_mobs","").split(",")));seen.remove("");
+        return seen.addAll(ids)?record.note("seen_mobs",String.join(",",seen)):record;
+    }
     private static int fishVariant(net.minecraft.world.entity.animal.fish.TropicalFish fish){
         int packed=fish.getPattern().getPackedId();return ((packed>>>8)*2+(packed&1))*256+fish.getBaseColor().getId()*16+fish.getPatternColor().getId();
     }

mods/sanctuary/src/main/java/fr/koka/sanctuary/gems/GemOreFeature.java

@@ -0,0 +1,19 @@
+package fr.koka.sanctuary.gems;
+
+import com.mojang.serialization.MapCodec;
+import fr.koka.sanctuary.worldgen.SanctuaryChunkGenerator;
+import net.minecraft.core.BlockPos;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.level.WorldGenLevel;
+import net.minecraft.world.level.chunk.ChunkGenerator;
+import net.minecraft.world.level.levelgen.feature.*;
+
+/** Native seeded ore veins, scoped to Sanctuary even when its biomes are shared with vanilla. */
+public record GemOreFeature(OreFeature ore) implements Feature {
+    public static final MapCodec<GemOreFeature> CODEC=OreFeature.CODEC.xmap(GemOreFeature::new,GemOreFeature::ore);
+    @Override public MapCodec<GemOreFeature> codec(){return CODEC;}
+    @Override public boolean place(WorldGenLevel level,ChunkGenerator generator,RandomSource random,BlockPos origin){
+        if(!(level.getLevel().getChunkSource().getGenerator() instanceof SanctuaryChunkGenerator))return false;
+        return ore.place(level,generator,random,origin);
+    }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/gems/Gems.java

@@ -0,0 +1,50 @@
+package fr.koka.sanctuary.gems;
+
+import fr.koka.sanctuary.SanctuaryMod;
+import java.util.List;
+import net.fabricmc.fabric.api.biome.v1.BiomeModifications;
+import net.fabricmc.fabric.api.creativetab.v1.CreativeModeTabEvents;
+import net.minecraft.core.Registry;
+import net.minecraft.core.registries.*;
+import net.minecraft.resources.ResourceKey;
+import net.minecraft.tags.TagKey;
+import net.minecraft.util.valueproviders.UniformInt;
+import net.minecraft.world.item.*;
+import net.minecraft.world.level.block.*;
+import net.minecraft.world.level.block.state.BlockBehaviour;
+import net.minecraft.world.level.levelgen.GenerationStep;
+
+/** Ordinary gem items and blocks; their distribution lives in data, not this registry. */
+public final class Gems {
+    public record Family(String id,Item gem,Block block,Block ore,Block deepslateOre){}
+    public static final Family RUBY=family("ruby",DyeColor.RED);
+    public static final Family SAPPHIRE=family("sapphire",DyeColor.BLUE);
+    public static final List<Family> FAMILIES=List.of(RUBY,SAPPHIRE);
+    public static void register(){
+        Registry.register(BuiltInRegistries.FEATURE_TYPE,SanctuaryMod.id("gem_ore"),GemOreFeature.CODEC);
+        for(var f:FAMILIES){
+            var biomes=TagKey.create(Registries.BIOME,SanctuaryMod.id("has_ore/"+f.id));
+            BiomeModifications.addFeature(c->c.hasTag(biomes),GenerationStep.Decoration.UNDERGROUND_ORES,
+                ResourceKey.create(Registries.PLACED_FEATURE,SanctuaryMod.id("ore_"+f.id)));
+        }
+        CreativeModeTabEvents.modifyOutputEvent(CreativeModeTabs.INGREDIENTS).register(out->out.insertAfter(Items.EMERALD,RUBY.gem,SAPPHIRE.gem));
+        CreativeModeTabEvents.modifyOutputEvent(CreativeModeTabs.BUILDING_BLOCKS).register(out->out.insertAfter(Blocks.EMERALD_BLOCK,RUBY.block,SAPPHIRE.block));
+        CreativeModeTabEvents.modifyOutputEvent(CreativeModeTabs.NATURAL_BLOCKS).register(out->{
+            out.insertAfter(Blocks.EMERALD_ORE,RUBY.ore,SAPPHIRE.ore);
+            out.insertAfter(Blocks.DEEPSLATE_EMERALD_ORE,RUBY.deepslateOre,SAPPHIRE.deepslateOre);
+        });
+    }
+    private static Family family(String id,DyeColor color){
+        var key=SanctuaryMod.id(id);var item=Registry.register(BuiltInRegistries.ITEM,key,new Item(new Item.Properties().setId(ResourceKey.create(Registries.ITEM,key))));
+        var block=block(id+"_block",new Block(properties(id+"_block",Blocks.EMERALD_BLOCK).mapColor(color.getMapColor())));
+        var ore=block(id+"_ore",new DropExperienceBlock(UniformInt.of(3,7),properties(id+"_ore",Blocks.EMERALD_ORE)));
+        var deep=block("deepslate_"+id+"_ore",new DropExperienceBlock(UniformInt.of(3,7),properties("deepslate_"+id+"_ore",Blocks.DEEPSLATE_EMERALD_ORE)));
+        return new Family(id,item,block,ore,deep);
+    }
+    private static BlockBehaviour.Properties properties(String id,Block source){return BlockBehaviour.Properties.ofFullCopy(source).setId(ResourceKey.create(Registries.BLOCK,SanctuaryMod.id(id)));}
+    private static Block block(String id,Block block){
+        var key=SanctuaryMod.id(id);Registry.register(BuiltInRegistries.BLOCK,key,block);
+        Registry.register(BuiltInRegistries.ITEM,key,new BlockItem(block,new Item.Properties().setId(ResourceKey.create(Registries.ITEM,key)).useBlockDescriptionPrefix()));return block;
+    }
+    private Gems(){}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/knowledge/BlockKnowledgeService.java

@@ -47,6 +47,7 @@ public final class BlockKnowledgeService {
     private BlockKnowledgeService() {}
 
     public static void register() {
+        DiscoveryCommands.register();
         ServerPlayConnectionEvents.JOIN.register((handler, sender, server) -> observeInventory(handler.player));
         // Fabric also reaches DISCONNECT through Netty's channelInactive callback.
         ServerPlayConnectionEvents.DISCONNECT.register((handler, server) -> server.execute(() -> {
@@ -97,6 +98,12 @@ public final class BlockKnowledgeService {
 
     public static void recordSeen(ServerPlayer player, Block block) {
         if (block.defaultBlockState().isAir() || player.isSpectator()) return;
+        discover(player,block);
+    }
+
+    /** Explicit discoveries use the same record and events, including for a spectator command target. */
+    public static void discover(ServerPlayer player,Block block) {
+        if(block.defaultBlockState().isAir())return;
         Session session = session(player);
         if (session.failed || !session.memory.recordSeen(id(block))) return;
         session.dirty = true;

mods/sanctuary/src/main/java/fr/koka/sanctuary/knowledge/DiscoveryCommands.java

@@ -0,0 +1,75 @@
+package fr.koka.sanctuary.knowledge;
+
+import com.mojang.brigadier.builder.ArgumentBuilder;
+import com.mojang.brigadier.context.CommandContext;
+import com.mojang.brigadier.exceptions.CommandSyntaxException;
+import fr.koka.sanctuary.companion.*;
+import fr.koka.sanctuary.operator.OperatorService;
+import fr.koka.sanctuary.progression.ProgressEffects;
+import fr.koka.sanctuary.recipes.*;
+import java.util.*;
+import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
+import net.minecraft.commands.*;
+import net.minecraft.commands.arguments.*;
+import net.minecraft.core.registries.*;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.entity.EntityType;
+import net.minecraft.world.item.*;
+import net.minecraft.world.level.block.Block;
+
+/** One command routes through the existing discovery services and their dependent recipe/catalogue rules. */
+public final class DiscoveryCommands {
+    private record Selection(List<Block> blocks,List<Item> items,List<EntityType<?>> mobs){}
+    @FunctionalInterface private interface SelectionArgument {Selection get(CommandContext<CommandSourceStack> context)throws CommandSyntaxException;}
+    public static void register(){
+        CommandRegistrationCallback.EVENT.register((dispatcher,registries,environment)->{
+            var root=Commands.literal("discovery").requires(OperatorService::canCommand);
+            root.then(targets(Commands.literal("all"),c->all(true,true,true)));
+            root.then(Commands.literal("blocks").then(targets(Commands.literal("all"),c->all(true,false,false))));
+            root.then(Commands.literal("items").then(targets(Commands.literal("all"),c->all(false,true,false))));
+            root.then(Commands.literal("mobs").then(targets(Commands.literal("all"),c->all(false,false,true))));
+            root.then(Commands.literal("block").then(targets(Commands.argument("block",ResourceArgument.resource(registries,Registries.BLOCK)),c->new Selection(List.of(ResourceArgument.getResource(c,"block",Registries.BLOCK).value()),List.of(),List.of()))));
+            root.then(Commands.literal("item").then(targets(Commands.argument("item",ResourceArgument.resource(registries,Registries.ITEM)),c->new Selection(List.of(),List.of(ResourceArgument.getResource(c,"item",Registries.ITEM).value()),List.of()))));
+            root.then(Commands.literal("mob").then(targets(Commands.argument("mob",ResourceArgument.resource(registries,Registries.ENTITY_TYPE)),c->new Selection(List.of(),List.of(),List.of(ResourceArgument.getResource(c,"mob",Registries.ENTITY_TYPE).value())))));
+            dispatcher.register(Commands.literal("sanctuary").then(root));
+        });
+    }
+    private static <T extends ArgumentBuilder<CommandSourceStack,T>> T targets(T node,SelectionArgument selection){
+        return node.executes(c->discover(c,selection.get(c),List.of(c.getSource().getPlayerOrException())))
+            .then(Commands.argument("players",EntityArgument.players()).executes(c->discover(c,selection.get(c),EntityArgument.getPlayers(c,"players"))));
+    }
+    private static Selection all(boolean blocks,boolean items,boolean mobs){
+        return new Selection(blocks?BuiltInRegistries.BLOCK.stream().filter(b->!b.defaultBlockState().isAir()).toList():List.of(),
+            items?BuiltInRegistries.ITEM.stream().filter(i->i!=Items.AIR).toList():List.of(),
+            mobs?BuiltInRegistries.ENTITY_TYPE.stream().filter(t->SpawnEggItem.byId(t).isPresent()).toList():List.of());
+    }
+    private static int discover(CommandContext<CommandSourceStack> context,Selection selection,Collection<ServerPlayer> players){
+        var source=context.getSource();
+        if(selection.blocks.stream().anyMatch(b->b.defaultBlockState().isAir())||selection.items.contains(Items.AIR)||selection.mobs.stream().anyMatch(t->SpawnEggItem.byId(t).isEmpty())){
+            source.sendFailure(Component.translatable("sanctuary.discovery.invalid"));return 0;
+        }
+        var species=selection.mobs.stream().map(BuiltInRegistries.ENTITY_TYPE::getKey).map(id->id.getNamespace().equals("minecraft")?id.getPath():id.toString()).toList();
+        int changed=0;
+        for(var player:players){
+            var record=CompanionService.record(player);
+            if(ProgressEffects.get(player)==null||record==null||!BlockKnowledgeService.healthy(player)||!RecipeService.healthy(player)){
+                source.sendFailure(Component.translatable("sanctuary.discovery.unavailable",player.getDisplayName()));continue;
+            }
+            // Validate bounded records before any write; no new save schema or unlock flag.
+            CompanionRecord next;
+            var discoveredItems=new HashSet<String>(RecipeService.knowledge(player).items);
+            for(var item:selection.items)discoveredItems.add(BuiltInRegistries.ITEM.getKey(item).toString());
+            for(var block:selection.blocks)if(block.asItem()!=Items.AIR)discoveredItems.add(BuiltInRegistries.ITEM.getKey(block.asItem()).toString());
+            try{next=CompanionQueries.discoverSpecies(record,species);if(discoveredItems.size()>RecipeKnowledge.MAX_IDS)throw new IllegalArgumentException("Discovery capacity");}
+            catch(IllegalArgumentException invalid){source.sendFailure(Component.translatable("sanctuary.discovery.unavailable",player.getDisplayName()));continue;}
+            CompanionService.save(player,next);
+            for(var block:selection.blocks)BlockKnowledgeService.discover(player,block);
+            for(var item:selection.items){if(item instanceof BlockItem b)BlockKnowledgeService.discover(player,b.getBlock());RecipeService.discover(player,item);}
+            RecipeService.refresh(player);
+            source.sendSuccess(()->Component.translatable("sanctuary.discovery.granted",player.getDisplayName(),selection.blocks.size(),selection.items.size(),selection.mobs.size()),true);changed++;
+        }
+        return changed;
+    }
+    private DiscoveryCommands(){}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/lighting/DynamicLightField.java

@@ -7,7 +7,8 @@ import java.util.function.LongConsumer;
 /** Immutable render snapshots; entity collection and the dirty queue belong to the client tick. */
 public final class DynamicLightField {
     public record Id(boolean drop, long value) {}
-    public record Source(Id id, double x, double y, double z, int light) {
+    public record Source(Id id, double x, double y, double z, int light, int color) {
+        public Source(Id id,double x,double y,double z,int light){this(id,x,y,z,light,0xFFFFFF);}
         public Source {
             if (!Double.isFinite(x+y+z) || light<1 || light>15) throw new IllegalArgumentException("light source");
         }
@@ -20,9 +21,12 @@ public final class DynamicLightField {
         private final int cellSize;
         public Collector(int cellSize) {this.cellSize=Math.max(1,cellSize);}
         public void add(long entity,boolean drop,double x,double y,double z,int light) {
+            add(entity,drop,x,y,z,light,0xFFFFFF);
+        }
+        public void add(long entity,boolean drop,double x,double y,double z,int light,int color) {
             if(light<=0)return;
             Id id=new Id(drop,drop ? sectionKey(floor(x/cellSize),floor(y/cellSize),floor(z/cellSize)) : entity);
-            Source candidate=new Source(id,snap(x),snap(y),snap(z),Math.min(15,light));
+            Source candidate=new Source(id,snap(x),snap(y),snap(z),Math.min(15,light),color);
             sources.merge(id,candidate,(a,b)->compareRepresentative(a,b)<=0?a:b);
         }
         public List<Source> finish(int limit,double x,double y,double z,long priorityEntity) {
@@ -53,6 +57,7 @@ public final class DynamicLightField {
             lists.long2ObjectEntrySet().forEach(e->bins.put(e.getLongKey(),e.getValue().toArray(Source[]::new)));
         }
         public int size() {return sources.size();}
+        public Collection<Source> sources(){return sources.values();}
         public int sectionCount() {return bins.size();}
         public int sampleCount(double x,double y,double z) {
             Source[] near=bins.get(sectionKey(floor(x)>>4,floor(y)>>4,floor(z)>>4));return near==null?0:near.length;

mods/sanctuary/src/main/java/fr/koka/sanctuary/mixin/client/PixelShadowDirtyMixin.java

@@ -0,0 +1,26 @@
+package fr.koka.sanctuary.mixin.client;
+
+import fr.koka.sanctuary.client.shader.PixelShadows;
+import fr.koka.sanctuary.client.shader.ColoredLights;
+import fr.koka.sanctuary.client.shader.ProceduralPbr;
+import fr.koka.sanctuary.client.shader.Bloom;
+import fr.koka.sanctuary.client.shader.ScreenSpaceGI;
+import net.minecraft.client.renderer.extract.LevelExtractor;
+import net.minecraft.core.BlockPos;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+/** Geometry changes only: lighting-only section invalidations do not rebuild shadow casters. */
+@Mixin(LevelExtractor.class)
+abstract class PixelShadowDirtyMixin {
+    @Inject(method="blockChanged", at=@At("HEAD"))
+    private void sanctuary$dirty(BlockPos pos, int flags, CallbackInfo ci) {
+        PixelShadows.dirtyBlock(pos); ProceduralPbr.dirtyBlock(pos); Bloom.dirtyBlock(pos); ColoredLights.dirtyBlock(pos);
+    }
+    @Inject(method="allChanged", at=@At("HEAD"))
+    private void sanctuary$reload(CallbackInfo ci) { PixelShadows.release(); ProceduralPbr.release(); Bloom.release(); ColoredLights.release(); ScreenSpaceGI.release(); }
+    @Inject(method="setSectionDirty", at=@At("HEAD"))
+    private void sanctuary$pbrLight(int x,int y,int z,CallbackInfo ci){ProceduralPbr.dirtySection(x,y,z); ColoredLights.dirtySection(x,y,z);}
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/mixin/client/PixelShadowLevelMixin.java

@@ -0,0 +1,28 @@
+package fr.koka.sanctuary.mixin.client;
+
+import fr.koka.sanctuary.client.shader.PixelShadows;
+import fr.koka.sanctuary.client.shader.ColoredLights;
+import fr.koka.sanctuary.client.shader.ProceduralPbr;
+import fr.koka.sanctuary.client.shader.Bloom;
+import net.minecraft.client.multiplayer.ClientLevel;
+import net.minecraft.core.BlockPos;
+import net.minecraft.world.level.block.state.BlockState;
+import net.minecraft.world.level.ChunkPos;
+import net.minecraft.world.level.chunk.LevelChunk;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+@Mixin(ClientLevel.class)
+abstract class PixelShadowLevelMixin {
+    @Inject(method="setBlocksDirty", at=@At("HEAD"))
+    private void sanctuary$block(BlockPos pos, BlockState before, BlockState after, CallbackInfo ci) {
+        if (before != after) {PixelShadows.dirtyBlock(pos); ProceduralPbr.dirtyBlock(pos);Bloom.dirtyBlock(pos); ColoredLights.dirtyBlock(pos);}
+    }
+
+    @Inject(method="onChunkLoaded", at=@At("TAIL"))
+    private void sanctuary$loaded(ChunkPos pos, CallbackInfo ci) { PixelShadows.dirtyChunk(pos.x(), pos.z()); ProceduralPbr.dirtyChunk(pos.x(), pos.z()); Bloom.dirtyChunk(pos.x(), pos.z()); ColoredLights.dirtyChunk(pos.x(),pos.z()); }
+    @Inject(method="unload", at=@At("HEAD"))
+    private void sanctuary$unload(LevelChunk chunk, CallbackInfo ci) { PixelShadows.dirtyChunk(chunk.getPos().x(), chunk.getPos().z()); ProceduralPbr.dirtyChunk(chunk.getPos().x(), chunk.getPos().z()); Bloom.dirtyChunk(chunk.getPos().x(), chunk.getPos().z()); ColoredLights.dirtyChunk(chunk.getPos().x(),chunk.getPos().z()); }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/mixin/client/PixelShadowRendererMixin.java

@@ -0,0 +1,37 @@
+package fr.koka.sanctuary.mixin.client;
+
+import com.llamalad7.mixinextras.injector.wrapoperation.Operation;
+import com.llamalad7.mixinextras.injector.wrapoperation.WrapOperation;
+import com.mojang.renderpearl.api.buffers.GpuBufferSlice;
+import fr.koka.sanctuary.client.shader.PixelShadows;
+import fr.koka.sanctuary.client.shader.ColoredLights;
+import fr.koka.sanctuary.client.shader.ProceduralPbr;
+import fr.koka.sanctuary.client.shader.EdgeHighlights;
+import fr.koka.sanctuary.client.shader.Bloom;
+import fr.koka.sanctuary.client.shader.Sunshafts;
+import fr.koka.sanctuary.client.shader.ScreenSpaceGI;
+import net.minecraft.client.renderer.GameRenderer;
+import net.minecraft.client.renderer.ProjectionMatrixBuffer;
+import org.joml.Matrix4f;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+@Mixin(GameRenderer.class)
+abstract class PixelShadowRendererMixin {
+    @WrapOperation(method="renderLevel", at=@At(value="INVOKE", target="Lnet/minecraft/client/renderer/ProjectionMatrixBuffer;getBuffer(Lorg/joml/Matrix4f;)Lcom/mojang/renderpearl/api/buffers/GpuBufferSlice;"))
+    private GpuBufferSlice sanctuary$projection(ProjectionMatrixBuffer buffer, Matrix4f matrix, Operation<GpuBufferSlice> original) {
+        PixelShadows.captureProjection(matrix);
+        ProceduralPbr.captureProjection(matrix);
+        EdgeHighlights.captureProjection(matrix);
+        Bloom.captureProjection(matrix);
+        ColoredLights.captureProjection(matrix);
+        ScreenSpaceGI.captureProjection(matrix);
+        return original.call(buffer, matrix);
+    }
+    @Inject(method="renderLevel", at=@At(value="INVOKE", target="Lnet/minecraft/client/renderer/GameRenderer;render3dHud(Lnet/minecraft/client/renderer/state/level/CameraRenderState;Lnet/minecraft/client/renderer/state/level/PlayerRenderState;Lnet/minecraft/client/renderer/state/OptionsRenderState;Z)V"))
+    private void sanctuary$shadows(CallbackInfo ci) { PixelShadows.render(); ProceduralPbr.render(); ColoredLights.render(); ScreenSpaceGI.render(); EdgeHighlights.render(); Bloom.render(); Sunshafts.render(); }
+    @Inject(method={"close", "setLevel"}, at=@At("HEAD"))
+    private void sanctuary$close(CallbackInfo ci) { PixelShadows.release(); ProceduralPbr.release(); EdgeHighlights.release(); Bloom.release(); ColoredLights.release(); ScreenSpaceGI.release(); Sunshafts.release(); }
+}

mods/sanctuary/src/main/java/fr/koka/sanctuary/plans/ClayWorkshopMenu.java

@@ -71,14 +71,18 @@ public final class ClayWorkshopMenu extends AbstractContainerMenu {
         var contents=item.get(DataComponents.CONTAINER);
         return contents==null||!contents.nonEmptyItems().iterator().hasNext();
     }
+    /** Plain clay retains the model's sampled colors; other blocks transfer their texture palette. */
+    public static VoxelSculpture appearance(VoxelSculpture source,Item material,SculpturePalette palette){
+        return material==Items.CLAY?source:palette.apply(source);
+    }
     public void select(ServerPlayer p,VoxelSculpture sculpture,Item material,SculpturePalette palette){
         if(level==null||!stillValid(p)||level.getGameTime()-lastSelection<4)return;
         var hit=new BlockHitResult(Vec3.atCenterOf(view.pos),Direction.UP,view.pos,false);
         if(UseBlockCallback.EVENT.invoker().interact(p,level,InteractionHand.MAIN_HAND,hit)!=InteractionResult.PASS||!stillValid(p))return;
         lastSelection=level.getGameTime();
         if(sculpture!=null&&(!StatueDiscoveries.allowedModel(sculpture.modelId(),view.statues())||!material(input.getItem(0))||!input.getItem(0).is(material)||palette==null))return;
-        if(!Objects.equals(selected,sculpture)||!Objects.equals(selectedPalette,palette))
-            selectedResult=sculpture==null||palette==null?null:palette.apply(sculpture);
+        if(!Objects.equals(selected,sculpture)||selectedMaterial!=material||!Objects.equals(selectedPalette,palette))
+            selectedResult=sculpture==null||palette==null?null:appearance(sculpture,material,palette);
         selected=sculpture;selectedMaterial=material;selectedPalette=palette;refresh();broadcastChanges();
     }
     private void refresh(){

mods/sanctuary/src/main/java/fr/koka/sanctuary/recipes/RecipeService.java

@@ -35,6 +35,7 @@ public final class RecipeService {
     }
     private static Session session(ServerPlayer p){return SESSIONS.computeIfAbsent(p,Session::new);}
     public static RecipeKnowledge knowledge(ServerPlayer p){return session(p).data;}
+    public static boolean healthy(ServerPlayer p){return !session(p).invalid;}
     public static void discover(ServerPlayer p,Item item){
         if(ProgressEffects.get(p)==null||item==Items.AIR)return;var s=session(p);if(s.invalid)return;
         s.dirty|=RecipeKnowledge.add(s.data.items,BuiltInRegistries.ITEM.getKey(item).toString());

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/deepslate_ruby_ore.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/deepslate_ruby_ore"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/deepslate_sapphire_ore.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/deepslate_sapphire_ore"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/ruby_block.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/ruby_block"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/ruby_ore.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/ruby_ore"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/sapphire_block.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/sapphire_block"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/blockstates/sapphire_ore.json

@@ -0,0 +1,7 @@
+{
+  "variants": {
+    "": {
+      "model": "sanctuary:block/sapphire_ore"
+    }
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/deepslate_ruby_ore.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/deepslate_ruby_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/deepslate_sapphire_ore.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/deepslate_sapphire_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/ruby.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:item/ruby"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/ruby_block.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/ruby_block"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/ruby_ore.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/ruby_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/sapphire.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:item/sapphire"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/sapphire_block.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/sapphire_block"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/items/sapphire_ore.json

@@ -0,0 +1,6 @@
+{
+  "model": {
+    "type": "minecraft:model",
+    "model": "sanctuary:block/sapphire_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/lang/en_us.json

@@ -1,4 +1,5 @@
 {
+  "sanctuary.statuary.clay_ready": "Clay: original model colors.",
   "sanctuary.weather.selected": "Real Time weather: %s for %s (%s). The daily forecast resumes at midnight.",
   "sanctuary.weather.overcast": "Overcast",
   "sanctuary.weather.fog": "Fog",
@@ -1284,7 +1285,7 @@
   "sanctuary.shaders.saturation": "Saturation",
   "sanctuary.shaders.saturation_value": "Saturation: %s%%",
   "sanctuary.shaders.saturation_help": "0%: grayscale. 100%: neutral. 142%: default setting. 200%: more vivid colours. Requires Vanilla Light; interface colours stay unchanged.",
-  "sanctuary.shaders.help": "Subtle colour grading and progressive fog from your viewpoint to the visible limit. No extra shadows or reflections.",
+  "sanctuary.shaders.help": "Subtle colour grading and progressive fog from your viewpoint to the visible limit. Optional pixel sun shadows, with no extra reflections.",
   "sanctuary.shaders.external": "Sanctuary Vanilla Light is suspended while another shader engine is installed. Your preference is kept.",
   "sanctuary.cosmetic.bed_other": "Decorative bed: you cannot sleep in a worn bed.",
   "block.sanctuary.slime_springboard": "Temporary slime",
@@ -1972,7 +1973,7 @@
   "sanctuary.discovery.item_filter": "Show carried items or every item already discovered.",
   "sanctuary.discovery.catalogue_required": "The Catalogue ability lets you browse discovered items you no longer carry.",
   "sanctuary.discovery.loading": "Loading statistics…",
-  "sanctuary.discovery.unavailable": "Statistics unavailable. Refresh to try again.",
+  "sanctuary.discovery.unavailable": "Unable to update discoveries for %s; no changes made.",
   "sanctuary.discovery.mobs_hint": "Mobs you have killed or that have killed you. Sightings alone are not recorded yet.",
   "sanctuary.discovery.count": "%s entries",
   "sanctuary.discovery.empty": "No entries match this filter.",
@@ -2245,5 +2246,77 @@
   "sanctuary.statuary.animals": "Animals",
   "sanctuary.statuary.imports": "Imports",
   "sanctuary.statuary.no_animals": "Encounter creatures to unlock their sculptures.",
-  "sanctuary.statuary.animal_error": "This creature’s model could not be sculpted."
+  "sanctuary.statuary.animal_error": "This creature’s model could not be sculpted.",
+  "item.sanctuary.ruby": "Ruby",
+  "block.sanctuary.ruby_block": "Block of Ruby",
+  "block.sanctuary.ruby_ore": "Ruby Ore",
+  "block.sanctuary.deepslate_ruby_ore": "Deepslate Ruby Ore",
+  "item.sanctuary.sapphire": "Sapphire",
+  "block.sanctuary.sapphire_block": "Block of Sapphire",
+  "block.sanctuary.sapphire_ore": "Sapphire Ore",
+  "block.sanctuary.deepslate_sapphire_ore": "Deepslate Sapphire Ore",
+  "sanctuary.discovery.granted": "Discoveries added for %s: %s blocks, %s items, %s species. Linked recipes updated; reopen catalogues.",
+  "sanctuary.discovery.invalid": "Choose a discoverable block, item or species.",
+  "sanctuary.shaders.edge_highlights": "Edge highlights",
+  "sanctuary.shaders.edge_highlights_help": "Connected highlights along terrain contours. Flat surfaces connect, even across different blocks. Preserves textures. ON by default; requires Vanilla Light.",
+  "sanctuary.shaders.edge_intensity": "Edge intensity",
+  "sanctuary.shaders.edge_intensity_help": "Highlight strength along edges. Independent of cast shadows.",
+  "sanctuary.shaders.edge_intensity_value": "Edge intensity: %s %%",
+  "sanctuary.shaders.pixel_shadows": "Pixel shadows",
+  "sanctuary.shaders.pixel_shadows_help": "Sun shadows and subtle moon shadows on a pixel grid. Dappled foliage and stable contours. Enabled by default at 128 blocks; requires Vanilla Light.",
+  "sanctuary.shaders.shadow_pixels": "Shadow precision",
+  "sanctuary.shaders.shadow_pixels_value": "%s pixels/block",
+  "sanctuary.shaders.shadow_pixels_help": "Grid precision: 8, 16, 32, 64 or 128 pixels per block. Higher values make shadow pixels finer. Requires Vanilla Light and pixel shadows.",
+  "sanctuary.shaders.shadow_distance": "Shadow distance",
+  "sanctuary.shaders.shadow_distance_value": "%s blocks",
+  "sanctuary.shaders.shadow_distance_help": "Shadow range: 16, 32, 64, 128 or 256 blocks, within loaded terrain. Higher distances cost more performance. Requires Vanilla Light and pixel shadows.",
+  "sanctuary.shaders.edge_distance": "Highlight distance",
+  "sanctuary.shaders.edge_distance_value": "%s blocks",
+  "sanctuary.shaders.edge_distance_help": "Independent range: 16, 32, 64, 128 or 256 blocks. Limited to visible terrain and render distance. Distant contours become naturally finer.",
+  "sanctuary.shaders.precision": "Precision",
+  "sanctuary.shaders.precision_help": "Shared grid for shadows and edge highlights: 8, 16, 32, 64 or 128 pixels per block. The shadow map retains its resolution cap.",
+  "sanctuary.shaders.precision_value": "%s pixels/block",
+  "sanctuary.shaders.bloom": "Bloom",
+  "sanctuary.shaders.bloom_help": "Glow around the sun and luminous surfaces. ON by default. Turning it off removes halos while keeping emissive ores. Requires Vanilla Light.",
+  "sanctuary.shaders.bloom_intensity": "Bloom strength",
+  "sanctuary.shaders.bloom_intensity_help": "Halo strength, 20% by default. Zero removes halos and their blur passes while keeping emissive ores.",
+  "sanctuary.shaders.bloom_intensity_value": "Bloom: %s%%",
+  "sanctuary.shaders.bloom_radius": "Bloom spread",
+  "sanctuary.shaders.bloom_radius_help": "Halo size around luminous pixels. Texture details stay sharp.",
+  "sanctuary.shaders.bloom_radius_value": "Spread: %s%%",
+  "sanctuary.shaders.ore_emission": "Emissive ores",
+  "sanctuary.shaders.ore_emission_help": "Makes ore inclusions glow while preserving their host rock, even with bloom off or at zero. ON by default. Visual effect only.",
+  "sanctuary.shaders.ore_intensity": "Ore emission",
+  "sanctuary.shaders.ore_intensity_help": "Inclusion brightness. Does not change world light levels or mob spawning.",
+  "sanctuary.shaders.ore_intensity_value": "Ores: %s%%",
+  "sanctuary.shaders.ssgi": "SSGI · color bounce",
+  "sanctuary.shaders.ssgi_help": "Experimental: enhanced color bounce between nearby visible surfaces. Radius 2.5 blocks. Off-screen surfaces do not contribute. ON by default.",
+  "sanctuary.shaders.ssgi_intensity": "SSGI strength",
+  "sanctuary.shaders.ssgi_intensity_help": "Strength of diffuse color bounce. Zero stops rendering and frees its resources. Does not change world light.",
+  "sanctuary.shaders.ssgi_intensity_value": "SSGI: %s%%",
+  "sanctuary.shaders.pbr": "PBR · material relief",
+  "sanctuary.shaders.pbr_help": "Experimental: procedural block normals and roughness, sun and moon highlights. Range 32 blocks. ON by default.",
+  "sanctuary.shaders.pbr_intensity": "PBR strength",
+  "sanctuary.shaders.pbr_intensity_help": "Material relief and highlights. Zero stops rendering and frees the cache. Original textures remain unchanged.",
+  "sanctuary.shaders.pbr_intensity_value": "PBR: %s%%",
+  "sanctuary.shaders.lens_flare": "Lens flare · soft rectangles",
+  "sanctuary.shaders.lens_flare_help": "Soft rectangular sun and moon reflections. Obstacles hide the sources. Independent of the bloom halo.",
+  "sanctuary.shaders.lens_flare_intensity": "Lens flare intensity",
+  "sanctuary.shaders.lens_flare_intensity_help": "Celestial reflection strength. Zero disables the effect.",
+  "sanctuary.shaders.lens_flare_intensity_value": "Lens flare: %s %%",
+  "sanctuary.shaders.sunshafts": "Sunshafts",
+  "sanctuary.shaders.sunshafts_help": "Light beams through openings in the scenery. Independent of bloom; range follows shadows (up to 64 blocks).",
+  "sanctuary.shaders.sunshaft_intensity": "Sunshaft intensity",
+  "sanctuary.shaders.sunshaft_intensity_help": "Strength of light scattered in the air. Beams automatically thicken with fog and precipitation. Zero disables the effect.",
+  "sanctuary.shaders.sunshaft_intensity_value": "Sunshafts: %s %%",
+  "sanctuary.shaders.colored_lights": "Colored lights",
+  "sanctuary.shaders.colored_lights_help": "Light-emitting blocks and carried items tint their surroundings, even off screen. Smooth appearance without changing gameplay light levels.",
+  "sanctuary.shaders.colored_light_intensity": "Colored light intensity",
+  "sanctuary.shaders.colored_light_intensity_value": "Colored lights: %s %%",
+  "sanctuary.shaders.colored_light_intensity_help": "Enabled at 30% by default. Zero disables computation. Changes fade in smoothly.",
+  "sanctuary.shaders.colored_light_distance": "Colored light distance",
+  "sanctuary.shaders.colored_light_distance_value": "Colored lights: %s blocks",
+  "sanctuary.shaders.colored_light_distance_help": "View distance: 8 to 64 blocks. Longer distances use more memory and computation. Smooth range fade; each source keeps its native reach.",
+  "sanctuary.shaders.warm_torches": "Warm torches",
+  "sanctuary.shaders.warm_torches_help": "Off: ordinary torches keep the native color temperature. On: orange tint. Other sources retain their own colors."
 }

mods/sanctuary/src/main/resources/assets/sanctuary/lang/fr_fr.json

@@ -1,4 +1,5 @@
 {
+  "sanctuary.statuary.clay_ready": "Argile : couleurs originales du modèle.",
   "sanctuary.weather.selected": "Météo Real Time : %s pour la journée du %s (%s). Le tirage quotidien reprend à minuit.",
   "sanctuary.weather.overcast": "Ciel gris",
   "sanctuary.weather.fog": "Brouillard",
@@ -1284,7 +1285,7 @@
   "sanctuary.shaders.saturation": "Saturation",
   "sanctuary.shaders.saturation_value": "Saturation : %s %%",
   "sanctuary.shaders.saturation_help": "0 % : noir et blanc. 100 % : neutre. 142 % : réglage par défaut. 200 % : couleurs plus vives. Avec Vanilla Light activé ; l’interface garde ses couleurs.",
-  "sanctuary.shaders.help": "Couleurs légèrement retravaillées et brume progressive depuis ton point de vue jusqu’à la limite visible. Sans ombres ni reflets supplémentaires.",
+  "sanctuary.shaders.help": "Couleurs légèrement retravaillées et brume progressive depuis ton point de vue jusqu’à la limite visible. Ombres pixelisées du soleil en option, sans reflets supplémentaires.",
   "sanctuary.shaders.external": "Sanctuary Vanilla Light est suspendu lorsqu’un autre moteur de shaders est installé. Votre préférence est conservée.",
   "sanctuary.cosmetic.bed_other": "Lit décoratif : impossible de dormir dans un lit porté.",
   "block.sanctuary.slime_springboard": "Slime éphémère",
@@ -1972,7 +1973,7 @@
   "sanctuary.discovery.item_filter": "Afficher les objets portés ou tous les objets déjà découverts.",
   "sanctuary.discovery.catalogue_required": "L’aptitude Catalogue permet de consulter les objets découverts que tu ne portes plus.",
   "sanctuary.discovery.loading": "Chargement des statistiques…",
-  "sanctuary.discovery.unavailable": "Statistiques indisponibles. Actualise pour réessayer.",
+  "sanctuary.discovery.unavailable": "Impossible de mettre à jour les découvertes de %s ; aucune modification effectuée.",
   "sanctuary.discovery.mobs_hint": "Créatures déjà tuées ou responsables de ta mort. Les simples observations ne sont pas encore enregistrées.",
   "sanctuary.discovery.count": "%s entrées",
   "sanctuary.discovery.empty": "Aucune entrée pour ce filtre.",
@@ -2245,5 +2246,77 @@
   "sanctuary.statuary.animals": "Animaux",
   "sanctuary.statuary.imports": "Imports",
   "sanctuary.statuary.no_animals": "Rencontrez des créatures pour débloquer leurs sculptures.",
-  "sanctuary.statuary.animal_error": "Impossible de sculpter le modèle de cette créature."
+  "sanctuary.statuary.animal_error": "Impossible de sculpter le modèle de cette créature.",
+  "item.sanctuary.ruby": "Rubis",
+  "block.sanctuary.ruby_block": "Bloc de rubis",
+  "block.sanctuary.ruby_ore": "Minerai de rubis",
+  "block.sanctuary.deepslate_ruby_ore": "Minerai de rubis des abîmes",
+  "item.sanctuary.sapphire": "Saphir",
+  "block.sanctuary.sapphire_block": "Bloc de saphir",
+  "block.sanctuary.sapphire_ore": "Minerai de saphir",
+  "block.sanctuary.deepslate_sapphire_ore": "Minerai de saphir des abîmes",
+  "sanctuary.discovery.granted": "Découvertes ajoutées pour %s : %s blocs, %s objets, %s espèces. Recettes liées actualisées ; rouvre les catalogues.",
+  "sanctuary.discovery.invalid": "Choisis un bloc, un objet ou une espèce découvrable.",
+  "sanctuary.shaders.edge_highlights": "Reflets sur les arêtes",
+  "sanctuary.shaders.edge_highlights_help": "Reflets connectés sur les contours du relief. Les surfaces plates se raccordent, même entre blocs différents. Préserve les textures. Activé par défaut ; nécessite Vanilla Light.",
+  "sanctuary.shaders.edge_intensity": "Intensité des arêtes",
+  "sanctuary.shaders.edge_intensity_help": "Force du reflet sur les arêtes. Le réglage est indépendant des ombres portées.",
+  "sanctuary.shaders.edge_intensity_value": "Intensité des arêtes : %s %%",
+  "sanctuary.shaders.pixel_shadows": "Ombres pixelisées",
+  "sanctuary.shaders.pixel_shadows_help": "Ombres du soleil et ombres légères de la lune, sur une grille de pixels. Feuillage irrégulier et contours stables. Activées par défaut, portée 128 blocs ; nécessite Vanilla Light.",
+  "sanctuary.shaders.shadow_pixels": "Précision des ombres",
+  "sanctuary.shaders.shadow_pixels_value": "%s pixels/bloc",
+  "sanctuary.shaders.shadow_pixels_help": "Précision de la grille : 8, 16, 32, 64 ou 128 pixels par bloc. Plus la valeur est élevée, plus les pixels des ombres sont fins. Nécessite Vanilla Light et les ombres pixelisées.",
+  "sanctuary.shaders.shadow_distance": "Distance des ombres",
+  "sanctuary.shaders.shadow_distance_value": "%s blocs",
+  "sanctuary.shaders.shadow_distance_help": "Portée des ombres : 16, 32, 64, 128 ou 256 blocs, dans le terrain chargé. Une distance élevée coûte davantage en performances. Nécessite Vanilla Light et les ombres pixelisées.",
+  "sanctuary.shaders.edge_distance": "Portée des arêtes",
+  "sanctuary.shaders.edge_distance_value": "%s blocs",
+  "sanctuary.shaders.edge_distance_help": "Portée indépendante : 16, 32, 64, 128 ou 256 blocs. Limitée au terrain visible et à la distance de rendu. Les contours lointains s’affinent naturellement.",
+  "sanctuary.shaders.precision": "Précision",
+  "sanctuary.shaders.precision_help": "Grille commune aux ombres et aux reflets sur les arêtes : 8, 16, 32, 64 ou 128 pixels par bloc. La carte d’ombres conserve sa résolution maximale.",
+  "sanctuary.shaders.precision_value": "%s pixels/bloc",
+  "sanctuary.shaders.bloom": "Bloom",
+  "sanctuary.shaders.bloom_help": "Halo du soleil et des surfaces lumineuses. Activé par défaut. L’arrêt coupe le halo et conserve les minerais émissifs. Nécessite Vanilla Light.",
+  "sanctuary.shaders.bloom_intensity": "Intensité du bloom",
+  "sanctuary.shaders.bloom_intensity_help": "Force du halo, 20 % par défaut. Zéro supprime le halo et ses passes de diffusion, tout en conservant les minerais émissifs.",
+  "sanctuary.shaders.bloom_intensity_value": "Bloom : %s %%",
+  "sanctuary.shaders.bloom_radius": "Diffusion du bloom",
+  "sanctuary.shaders.bloom_radius_help": "Taille du halo autour des pixels lumineux. Les détails des textures restent nets.",
+  "sanctuary.shaders.bloom_radius_value": "Diffusion : %s %%",
+  "sanctuary.shaders.ore_emission": "Minerais émissifs",
+  "sanctuary.shaders.ore_emission_help": "Fait briller les inclusions des minerais sans éclairer leur roche, même avec le bloom coupé ou à zéro. Activé par défaut. Effet visuel uniquement.",
+  "sanctuary.shaders.ore_intensity": "Émission des minerais",
+  "sanctuary.shaders.ore_intensity_help": "Luminosité des inclusions. Aucun changement de la lumière du monde ou des apparitions de mobs.",
+  "sanctuary.shaders.ore_intensity_value": "Minerais : %s %%",
+  "sanctuary.shaders.ssgi": "SSGI · couleurs diffusées",
+  "sanctuary.shaders.ssgi_help": "Expérimental : diffusion renforcée des couleurs entre surfaces visibles proches. Rayon 2,5 blocs. Les surfaces hors écran ne contribuent pas. Activé par défaut.",
+  "sanctuary.shaders.ssgi_intensity": "Intensité du SSGI",
+  "sanctuary.shaders.ssgi_intensity_help": "Force de la teinte diffusée. Zéro coupe le calcul et libère ses ressources. Aucun changement de lumière du monde.",
+  "sanctuary.shaders.ssgi_intensity_value": "SSGI : %s %%",
+  "sanctuary.shaders.pbr": "PBR · relief des matériaux",
+  "sanctuary.shaders.pbr_help": "Expérimental : normales procédurales et rugosité des blocs, reflets du soleil et de la lune. Portée 32 blocs. Activé par défaut.",
+  "sanctuary.shaders.pbr_intensity": "Intensité du PBR",
+  "sanctuary.shaders.pbr_intensity_help": "Relief et reflets des matériaux. Zéro coupe le calcul et libère le cache. Ne modifie pas les textures originales.",
+  "sanctuary.shaders.pbr_intensity_value": "PBR : %s %%",
+  "sanctuary.shaders.lens_flare": "Lens flare · rectangles doux",
+  "sanctuary.shaders.lens_flare_help": "Reflets rectangulaires du soleil et de la lune, aux bords dégradés. Les obstacles masquent les sources. Indépendant du halo de bloom.",
+  "sanctuary.shaders.lens_flare_intensity": "Intensité du lens flare",
+  "sanctuary.shaders.lens_flare_intensity_help": "Force des reflets célestes. Zéro désactive le calcul.",
+  "sanctuary.shaders.lens_flare_intensity_value": "Lens flare : %s %%",
+  "sanctuary.shaders.sunshafts": "Rayons solaires",
+  "sanctuary.shaders.sunshafts_help": "Faisceaux de lumière dans les ouvertures du décor. Indépendants du bloom, portée liée aux ombres (64 blocs maximum).",
+  "sanctuary.shaders.sunshaft_intensity": "Intensité des rayons",
+  "sanctuary.shaders.sunshaft_intensity_help": "Force de la lumière dans l’air. Les rayons s’épaississent automatiquement avec le brouillard et les précipitations. Zéro désactive le calcul.",
+  "sanctuary.shaders.sunshaft_intensity_value": "Rayons : %s %%",
+  "sanctuary.shaders.colored_lights": "Lumières colorées",
+  "sanctuary.shaders.colored_lights_help": "Les blocs lumineux et les objets portés teintent leurs environs, même hors écran. Apparition progressive, sans changer les règles de lumière du jeu.",
+  "sanctuary.shaders.colored_light_intensity": "Intensité des lumières colorées",
+  "sanctuary.shaders.colored_light_intensity_value": "Lumières colorées : %s %%",
+  "sanctuary.shaders.colored_light_intensity_help": "Activé par défaut à 30 %. Zéro désactive le calcul. Les changements apparaissent progressivement.",
+  "sanctuary.shaders.colored_light_distance": "Distance des lumières colorées",
+  "sanctuary.shaders.colored_light_distance_value": "Lumières colorées : %s blocs",
+  "sanctuary.shaders.colored_light_distance_help": "Distance d'affichage : 8 à 64 blocs. Les grandes distances utilisent plus de mémoire et de calcul. Fondu aux limites ; la portée de chaque source reste native.",
+  "sanctuary.shaders.warm_torches": "Torches chaudes",
+  "sanctuary.shaders.warm_torches_help": "Désactivé : les torches ordinaires conservent la température de couleur native. Activé : teinte orangée. Les autres sources gardent leurs propres couleurs."
 }

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/deepslate_ruby_ore.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/deepslate_ruby_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/deepslate_sapphire_ore.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/deepslate_sapphire_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/ruby_block.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/ruby_block"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/ruby_ore.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/ruby_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/sapphire_block.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/sapphire_block"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/block/sapphire_ore.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:block/cube_all",
+  "textures": {
+    "all": "sanctuary:block/sapphire_ore"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/item/ruby.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:item/generated",
+  "textures": {
+    "layer0": "sanctuary:item/ruby"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/models/item/sapphire.json

@@ -0,0 +1,6 @@
+{
+  "parent": "minecraft:item/generated",
+  "textures": {
+    "layer0": "sanctuary:item/sapphire"
+  }
+}

mods/sanctuary/src/main/resources/assets/sanctuary/shaders/core/bloom_apply.fsh

@@ -0,0 +1,7 @@
+#version 330
+#extension GL_ARB_separate_shader_objects : require
+#include <sanctuary:bloom_scene.glsl>
+uniform sampler2D InputTexture;
+layout(location=0) in vec2 texCoord;
+layout(location=0) out vec4 fragColor;
+void main(){vec3 halo=texture(InputTexture,texCoord).rgb;fragColor=vec4(clamp(halo*BloomParams.z,0.0,1.0),0.0);}