89 lines
5.0 KiB
Markdown
89 lines
5.0 KiB
Markdown
# 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`.
|