Files
sanctuary-beta/docs/shader-beta127.md
T
2026-09-17 17:53:16 +02:00

5.0 KiB

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 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 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.