beta.160: opt-in shaders and lightweight local duo test lab

README.md

@@ -1,5 +1,12 @@
 # Sanctuary
 
+## beta.160 — laboratoire de test en duo
+
+Shader désactivé sur une configuration neuve, serveur local léger, personnages
+de test optionnels et séances de captures horodatées.
+[Mode d’emploi et vérifications](docs/duo-lab-beta160.md) ·
+[Récap Discord 130–160](docs/discord-beta130-160.md).
+
 ## beta.159 — recherche communautaire et galerie adaptable (pack local)
 
 Recherche par joueur, titre ou texte, historique Serveur en lecture seule,

docs/discord-beta130-160.md

@@ -0,0 +1,60 @@
+# Récap Discord — beta.130 à beta.160
+
+Brouillon à relire avant publication. Les captures sont des scènes de test,
+pas des photos d'un serveur public. Aucune annonce envoyée automatiquement.
+
+## Message 1 — l'image et la lumière
+
+**Sanctuary — retour sur les beta.130 à 160**
+
+On a d'abord beaucoup travaillé l'ambiance : bloom, minerais lumineux, rebonds
+de couleur, relief des matériaux, reflets, rayons du soleil et lumières portées.
+L'eau a reçu ses propres réglages, puis plusieurs passes de correction ont
+amélioré les transitions, les distances et les matières.
+
+La version du shader conservée est celle du socle beta.151. Elle reste gourmande,
+mais on garde ce travail ! En beta.160, le shader devient **désactivé par défaut
+sur une nouvelle configuration**, et peut être réactivé dans les options.
+
+Images : `01-minerais-bloom-beta130.png`, `02-eau-beta144.png`.
+
+## Message 2 — la vie du serveur
+
+Le chantier suivant rapproche Minecraft et le site Sanctuary : **Gazette,
+tableau d'affichage et intendance** partagent un contrat de publications.
+Le mod fonctionne avec des fichiers par défaut ; une base MariaDB permet de
+partager les données avec le site.
+
+Le menu pause a été réorganisé autour des systèmes Sanctuary, de la carte et
+des publications. La Gazette accepte les articles avec une capture obligatoire,
+les réponses, les épingles et la recherche par joueur ou contenu.
+
+Le tableau distingue les types d'annonces par couleur. Les demandes peuvent
+indiquer un lieu, des matériaux, une récompense et des participants. Ce sont
+des descriptions pour organiser les échanges entre joueurs : aucun coffre de
+dépôt ni paiement automatique. Une demande suivie apparaît avec un **! sur la
+carte**, et son résumé se lit au survol.
+
+Images : `03-menu-et-quete-beta159.png`, `04-materiaux-beta158.png`.
+
+## Message 3 — tester ensemble
+
+Avec la beta.160, on prépare nos séances de test en binôme sur Mac : un petit
+serveur local, un seul Minecraft à l'écran et des personnages de laboratoire.
+Le but : vérifier les échanges côté technique pendant que les vrais essais en
+jeu nous montrent ce qu'il faut simplifier dans l'interface.
+
+Des scènes courtes et des captures horodatées permettront de reprendre les
+moments où l'on hésite, cherche un bouton ou perd le fil. Le prochain chantier
+est l'ergonomie, dans le jeu comme sur le site.
+
+## Sources et pièces jointes
+
+Les images originales et leurs empreintes sont rassemblées dans
+`build/discord-beta130-160/` (ignoré par Git), avec `images.json` pour la provenance.
+Les captures anciennes illustrent leur version d'origine, sans revendiquer une
+nouvelle validation graphique. Les sondages restent une idée, pas une fonction livrée.
+
+Références : `shader-beta130.md` à `nether-pbr-beta151.md`,
+`community-beta154.md`, `pause-redesign-beta155.md`, `gazette-photos-beta157.md`,
+`community-cards-beta158.md`, `community-search-beta159.md`, `duo-lab-beta160.md`.

docs/duo-lab-beta160.md

@@ -0,0 +1,155 @@
+# DUO-160 — laboratoire Mac et tests en binôme
+
+Branche `codex/duo-lab-beta160`, base `beta.159`. Minecraft 26.3, Java 25,
+Fabric 0.19.5 ; mêmes dépendances. Validation graphique Vulkan uniquement.
+
+## Contrat
+
+Le shader natif est OFF quand sa préférence est absente. Un choix sauvegardé
+ON ou OFF reste respecté, ainsi que ses intensités. Aucun shader supprimé :
+les ressources beta.151 restent identiques. Le client du laboratoire reçoit
+explicitement `enabled:false`, indépendamment de l'installation personnelle.
+
+Tout le laboratoire réside dans `build/duo/`, ignoré par Git. Le monde plat
+`duo-flat-160`, graine 160, sert aux interfaces et aux échanges ; il ne valide
+pas le terrain Sanctuary. Aucun monde personnel ouvert ou modifié.
+Le module `sanctuary-test` fournit les personnages uniquement avec
+`-Dsanctuary.duo=true`. Il ne fait pas partie du pack normal.
+
+## Préparer et lancer
+
+```sh
+export JAVA_HOME=$(/usr/libexec/java_home -v 25)
+./gradlew :sanctuary-test:exportDuoLaunch --max-workers=1 -Dorg.gradle.jvmargs=-Xmx1G
+python3 scripts/duo_lab.py prepare
+python3 scripts/duo_lab.py server
+# Dans un autre terminal :
+python3 scripts/duo_lab.py client
+```
+
+L'export permet ensuite de lancer Java directement, sans conserver un processus
+Gradle pendant la séance. Préparer à nouveau ne remplace aucun fichier existant.
+Le client rejoint automatiquement `127.0.0.1:25575`. Au premier accès,
+choisir la couleur et le familier dans HELLO_WORLD puis entrer dans Sanctuary.
+Depuis la console serveur : `op KokaLab` donne les commandes au client de test.
+
+Le serveur écoute seulement sur loopback et utilise des identités hors ligne
+pour ce laboratoire. Ce profil ne doit pas être exposé sur le réseau. La liaison
+authentifiée d'un compte web exige toujours un vrai serveur en mode en ligne ;
+elle n'est pas contournée par les outils du laboratoire.
+
+Réglages de départ : serveur 256–768 Mio de heap, vue 4 chunks, simulation 3 ;
+client 512–2048 Mio, vue 6, simulation 4, 30 FPS, fenêtre 1280×720. La mémoire
+native, graphique et macOS s'ajoute au heap. Aucun engagement de tenir dans
+une consommation totale de 2,75 Gio. Ne pas exécuter la compilation en même
+temps qu'une séance. Augmenter seulement après mesure :
+
+```sh
+python3 scripts/duo_lab.py server --memory 1024
+python3 scripts/duo_lab.py client --memory 2560
+```
+
+Le mode fichier reste le défaut. Pour une préparation neuve avec le site local :
+
+```sh
+python3 scripts/duo_lab.py prepare --storage database --server-id UUID_DU_SERVEUR \
+  --jdbc jdbc:mariadb://127.0.0.1:33077/BASE_DE_TEST
+SANCTUARY_COMMUNITY_DB_PASSWORD='' python3 scripts/duo_lab.py server
+```
+
+La base doit déjà avoir le schéma communautaire v3. Le site doit utiliser le
+même identifiant de serveur. Aucun schéma ni sauvegarde n'est migré ici.
+
+## Personnages et séances
+
+```text
+/duo spawn Alice
+/duo spawn Bob
+/duo list
+/duo remove Alice
+/duo trace start
+/duo trace stop
+```
+
+Les personnages portent le préfixe `Lab_`, sont créatifs et apparaissent près
+de la source de commande. Limite de quatre, noms uniques de 1–12 caractères
+ASCII alphanumériques ou `_`. Ce sont des ServerPlayer sans transport réseau
+ni rendu, pas des IA et pas des clients réseau supplémentaires. On peut les
+cibler avec les commandes natives, par exemple `tp Lab_Bob ~2 ~ ~`.
+Ils ne valident pas seuls le protocole d'un deuxième client réel.
+
+La trace consigne noms de test, dimension, positions et angles toutes les deux
+secondes dans `build/duo/server/duo-sessions/`. Activation explicite, arrêt au
+bout de cinq minutes maximum ou à la fermeture du serveur. Pas de frappe clavier,
+mot de passe, navigateur ou audio enregistré.
+
+Pour la relecture visuelle, identifier la fenêtre Minecraft puis lancer :
+
+```sh
+python3 scripts/duo_lab.py windows
+python3 scripts/duo_lab.py record --window ID_FENETRE_MINECRAFT --seconds 120
+```
+
+Une séquence PNG horodatée toutes les deux secondes, un index HTML et une fiche
+de notes sont écrits dans `build/duo/sessions/`. Ctrl-C termine la capture ; limite
+de cinq minutes. macOS peut demander l'autorisation de capture. Cette version
+ne produit pas une vidéo continue et peut manquer une interaction très courte.
+On ne démarre une capture qu'au début d'une scène annoncée.
+
+## Trois premières scènes
+
+1. Ouvrir la Gazette, retrouver un auteur, lire un article et répondre. Vérifier
+   que l'autre interface retrouve la réponse, puis noter les hésitations.
+2. Créer une demande avec lieu et matériaux, la suivre, lire son infobulle sur
+   la carte, ouvrir la discussion puis arrêter le suivi.
+3. Afficher deux figurants, tester les interactions de proximité et comparer
+   la fluidité à un seul joueur. Garder un véritable second client pour une
+   vérification réseau ultérieure si nécessaire.
+
+Le récap Discord se trouve dans `discord-beta130-160.md` ; les originaux des
+quatre illustrations sont copiés avec provenance dans `build/discord-beta130-160/`.
+
+## Vérifications
+
+- `./gradlew check build assemblePack` : 252 GameTests, 229 réussites et les
+  mêmes 23 échecs que beta.159. Aucun échec ajouté ; comparaison dans
+  `build/duo160-server-failures.json`, log `build/beta160-check-build.log`.
+- Contrôles restants, compilation, pack et client natif Vulkan réussis avec la
+  suite serveur déjà exécutée exclue (`-x :sanctuary:runGameTest`) : 137 tâches,
+  `build/beta160-release.log`. Le test `ShaderDefaults160ClientChecks` vérifie
+  préférence absente, objet vide, ON explicite, OFF enregistré et réactivation,
+  avec intensité personnelle conservée. Marqueur `SHADER160_DEFAULTS_PASS`.
+- Module de test reconstruit après ajustement du transport sans réseau : build
+  réussi. L'export de lancement inclut les arguments fournis par Loom et élimine
+  son argfile imbriqué, que Java ne peut pas réinterpréter depuis un autre argfile.
+- Serveur réel à 768 Mio : démarrage sur loopback, monde plat neuf ; création de
+  quatre acteurs, doublon et cinquième refusés, retrait et acteur absent vérifiés.
+  Le journal produit 56 observations JSON valides puis s'arrête sur commande.
+- Client réel séparé, Vulkan, 2048 Mio, shader OFF : connexion jusqu'à l'écran
+  HELLO_WORLD vérifiée visuellement. La création du profil et le parcours en jeu
+  avec le joueur restent à faire ensemble ; aucune session ergonomique humaine
+  terminée ni validation d'un deuxième client réseau revendiquée.
+- Mesure ponctuelle avant l'entrée du joueur : serveur ~313 Mio de heap utilisé,
+  client au menu ~289 Mio. Ce ne sont ni des pics ni une mesure de RAM système
+  totale. Les figurants ne possèdent ni sockets ni fenêtre graphique.
+- Capture ciblée macOS essayée sur quatre secondes : séquence PNG, manifeste,
+  index HTML et fiche de notes créés. Aucun enregistrement continu ou micro.
+- Export MRpack : intégrité ZIP, version et JAR embarqué vérifiés. Les 29 ressources
+  de shaders sont inchangées depuis beta.159. JAR et packs beta.154–159 conservés.
+- Skill personnel `sanctuary-session-notes` installé et validé séparément dans
+  `~/.codex/skills/` pour classer les dictées en Markdown. Il ne change pas le
+  modèle du tour courant ; Luna/low peut être choisi dans une tâche dédiée.
+
+Le serveur local utilise la base de développement du site, schéma v3 déjà présent,
+sous le même scope. Aucune validation de liaison de comptes hors ligne : cette
+opération reste réservée au mode authentifié. Aucun déploiement public, canal
+packwiz, serveur personnel ou instance Prism modifié.
+
+## Artefacts locaux
+
+- `mods/sanctuary/build/libs/sanctuary-beta.160.jar` — SHA-256
+  `4c19e620e989050488c9a96aaddaf897a74115a9fb4c5099e5518ae32db5b2e8`.
+- `build/Sanctuary-beta.160.mrpack` — SHA-256
+  `272e3460f35c8d9a4de689d30e4d952c3121923ba5fe30a23c83b3e76bd23bac`.
+- `build/duo/Jouer.command` et `Serveur.command` : raccourcis locaux de séance.
+

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.159
-pack_version=beta.159
+mod_version=beta.160
+pack_version=beta.160
 resource_pack_version=beta.121
 maven_group=fr.koka.sanctuary
 jei_version=30.32.0-sanctuary.3

mods/sanctuary-test/build.gradle

@@ -16,5 +16,39 @@ processResources {
     filesMatching('fabric.mod.json') { expand(values) }
 }
 loom { runs { client { runDir 'run/quick-test' } } }
+loom {
+    runs {
+        duoServer {
+            server()
+            name 'Sanctuary duo lab'
+            runDir '../../build/duo/server'
+            vmArg '-Xms256m'
+            vmArg '-Xmx768m'
+            vmArg '-Dsanctuary.duo=true'
+        }
+        duoClient {
+            client()
+            name 'Sanctuary duo client'
+            runDir '../../build/duo/client'
+            vmArg '-Xms512m'
+            vmArg '-Xmx2G'
+            programArgs '--graphicsBackend', 'vulkan', '--username', 'KokaLab', '--width', '1280', '--height', '720'
+        }
+    }
+}
+// Export the Loom launcher so play sessions do not retain a Gradle JVM.
+tasks.register('exportDuoLaunch') {
+    dependsOn tasks.named('runDuoServer').get().taskDependencies.getDependencies(tasks.named('runDuoServer').get())
+    dependsOn tasks.named('runDuoClient').get().taskDependencies.getDependencies(tasks.named('runDuoClient').get())
+    doLast {
+        ['server': 'runDuoServer', 'client': 'runDuoClient'].each { kind, taskName ->
+            def launch = tasks.named(taskName).get()
+            def destination = rootProject.layout.buildDirectory.file("duo/${kind}.args").get().asFile
+            destination.parentFile.mkdirs()
+            def arguments = launch.allJvmArgs.findAll { !it.toString().startsWith('@') } + ['-classpath', launch.classpath.asPath, launch.mainClass.get()] + launch.args + launch.argumentProviders.collectMany { it.asArguments().toList() }
+            destination.text = arguments.collect { '"' + it.toString().replace('\\', '\\\\').replace('"', '\\"') + '"' }.join('\n') + '\n'
+        }
+    }
+}
 tasks.named('test') { failOnNoDiscoveredTests=false }
 tasks.named('jar') { from(rootProject.file('LICENSE')) { rename { 'LICENSE_sanctuary_test' } } }

mods/sanctuary-test/src/main/java/fr/koka/sanctuarytest/DuoLab.java

@@ -0,0 +1,136 @@
+package fr.koka.sanctuarytest;
+
+import com.mojang.authlib.GameProfile;
+import com.mojang.brigadier.arguments.StringArgumentType;
+import fr.koka.sanctuary.operator.OperatorService;
+import java.net.InetSocketAddress;
+import java.net.SocketAddress;
+import java.nio.charset.StandardCharsets;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.UUID;
+import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
+import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
+import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;
+import net.minecraft.commands.CommandSourceStack;
+import net.minecraft.commands.Commands;
+import net.minecraft.network.Connection;
+import net.minecraft.network.protocol.Packet;
+import net.minecraft.network.protocol.PacketFlow;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ClientInformation;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.server.network.CommonListenerCookie;
+import net.minecraft.world.level.GameType;
+
+/** Optional development module only. No sockets, renderer or additional JVM per actor. */
+final class DuoLab {
+    private static final Map<String, ServerPlayer> ACTORS = new LinkedHashMap<>();
+    private static java.io.BufferedWriter trace;
+    private static int ticks;
+    private static long traceStarted;
+    private DuoLab() { }
+
+    static void register() {
+        // An explicit JVM opt-in keeps the ordinary quick-test pack unchanged.
+        if (!Boolean.getBoolean("sanctuary.duo")) return;
+        CommandRegistrationCallback.EVENT.register((dispatcher, registries, environment) ->
+            dispatcher.register(Commands.literal("duo").requires(OperatorService::canCommand)
+                .then(Commands.literal("trace")
+                    .then(Commands.literal("start").executes(c -> trace(c.getSource(), true)))
+                    .then(Commands.literal("stop").executes(c -> trace(c.getSource(), false))))
+                .then(Commands.literal("spawn").then(Commands.argument("name", StringArgumentType.word())
+                    .executes(c -> spawn(c.getSource(), StringArgumentType.getString(c, "name")))))
+                .then(Commands.literal("remove").then(Commands.argument("name", StringArgumentType.word())
+                    .executes(c -> remove(c.getSource(), StringArgumentType.getString(c, "name")))))
+                .then(Commands.literal("list").executes(c -> {
+                    c.getSource().sendSuccess(() -> Component.translatable("sanctuary_test.duo.list", String.join(", ", ACTORS.keySet())), false);
+                    return ACTORS.size();
+                }))));
+        ServerTickEvents.END_SERVER_TICK.register(server -> {
+            if (trace != null && System.nanoTime() - traceStarted >= 300_000_000_000L) closeTrace();
+            if (trace == null || ++ticks % 40 != 0) return;
+            try {
+                for (var player : server.getPlayerList().getPlayers()) {
+                    var row = new com.google.gson.JsonObject();
+                    row.addProperty("time", java.time.Instant.now().toString());
+                    row.addProperty("player", player.getGameProfile().name());
+                    row.addProperty("actor", ACTORS.containsValue(player));
+                    row.addProperty("dimension", player.level().dimension().identifier().toString());
+                    row.addProperty("x", player.getX()); row.addProperty("y", player.getY()); row.addProperty("z", player.getZ());
+                    row.addProperty("yaw", player.getYRot()); row.addProperty("pitch", player.getXRot());
+                    trace.write(row.toString()); trace.newLine();
+                }
+                trace.flush();
+            } catch (java.io.IOException error) {
+                org.slf4j.LoggerFactory.getLogger("sanctuary-duo").error("Trace stopped: cannot write session", error);
+                closeTrace();
+            }
+        });
+        ServerLifecycleEvents.SERVER_STOPPED.register(server -> { ACTORS.clear(); closeTrace(); });
+    }
+
+    private static int trace(CommandSourceStack source, boolean start) {
+        closeTrace();
+        if (start) try {
+            var folder = java.nio.file.Path.of("duo-sessions");
+            java.nio.file.Files.createDirectories(folder);
+            var path = folder.resolve("positions-" + System.currentTimeMillis() + ".jsonl");
+            trace = java.nio.file.Files.newBufferedWriter(path, StandardCharsets.UTF_8, java.nio.file.StandardOpenOption.CREATE_NEW);
+            traceStarted = System.nanoTime(); ticks = 0;
+        } catch (java.io.IOException error) {
+            source.sendFailure(Component.translatable("sanctuary_test.duo.trace_failed")); return 0;
+        }
+        source.sendSuccess(() -> Component.translatable("sanctuary_test.duo.trace_" + (start ? "started" : "stopped")), false);
+        return 1;
+    }
+
+    private static void closeTrace() {
+        if (trace != null) try { trace.close(); } catch (java.io.IOException ignored) { }
+        trace = null;
+    }
+
+    private static int spawn(CommandSourceStack source, String name) {
+        if (!name.matches("[A-Za-z0-9_]{1,12}") || ACTORS.size() >= 4
+                || source.getServer().getPlayerList().getPlayerByName("Lab_" + name) != null) {
+            source.sendFailure(Component.translatable("sanctuary_test.duo.invalid"));
+            return 0;
+        }
+        String fullName = "Lab_" + name;
+        var profile = new GameProfile(UUID.nameUUIDFromBytes(("SanctuaryDuo:" + fullName).getBytes(StandardCharsets.UTF_8)), fullName);
+        var player = new ServerPlayer(source.getServer(), source.getLevel(), profile, ClientInformation.createDefault());
+        source.getServer().getPlayerList().placeNewPlayer(new SinkConnection(), player, CommonListenerCookie.createInitial(profile, false));
+        var position = source.getPosition();
+        player.teleportTo(source.getLevel(), position.x + 2, position.y, position.z, java.util.Set.of(), 0, 0, false);
+        player.setGameMode(GameType.CREATIVE);
+        ACTORS.put(name, player);
+        source.sendSuccess(() -> Component.translatable("sanctuary_test.duo.spawned", fullName), false);
+        return 1;
+    }
+
+    private static int remove(CommandSourceStack source, String name) {
+        var player = ACTORS.remove(name);
+        if (player == null) {
+            source.sendFailure(Component.translatable("sanctuary_test.duo.missing", name));
+            return 0;
+        }
+        source.getServer().getPlayerList().remove(player);
+        source.sendSuccess(() -> Component.translatable("sanctuary_test.duo.removed", name), false);
+        return 1;
+    }
+
+    private static final class SinkConnection extends Connection {
+        private net.minecraft.network.PacketListener listener;
+        SinkConnection() { super(PacketFlow.SERVERBOUND); }
+        @Override public <T extends net.minecraft.network.PacketListener> void setupInboundProtocol(net.minecraft.network.ProtocolInfo<T> protocol, T listener) { this.listener = listener; }
+        @Override public net.minecraft.network.PacketListener getPacketListener() { return listener; }
+        @Override public void flushChannel() { }
+        @Override public void send(Packet<?> packet) { }
+        @Override public void send(Packet<?> packet, io.netty.channel.ChannelFutureListener listener) { }
+        @Override public void send(Packet<?> packet, io.netty.channel.ChannelFutureListener listener, boolean flush) { }
+        @Override public boolean isConnected() { return true; }
+        @Override public boolean isConnecting() { return false; }
+        @Override public boolean isMemoryConnection() { return true; }
+        @Override public SocketAddress getRemoteAddress() { return new InetSocketAddress("127.0.0.1", 0); }
+    }
+}

mods/sanctuary-test/src/main/java/fr/koka/sanctuarytest/QuickTestMod.java

@@ -16,6 +16,7 @@ public final class QuickTestMod implements ModInitializer {
     }
     public void onInitialize(){
         QuickTestWorld.enable();
+        DuoLab.register();
         PayloadTypeRegistry.clientboundConfiguration().register(Mode.TYPE,Mode.CODEC);
         ServerConfigurationConnectionEvents.CONFIGURE.register((handler,server)->{
             if(ServerConfigurationNetworking.canSend(handler,Mode.TYPE))

mods/sanctuary-test/src/main/resources/assets/sanctuary_test/lang/en_us.json

@@ -1,3 +1,11 @@
 {
-  "generator.sanctuary_test.flat": "Sanctuary — Quick Test"
+  "generator.sanctuary_test.flat": "Sanctuary — Quick Test",
+  "sanctuary_test.duo.list": "Lab actors: %s",
+  "sanctuary_test.duo.invalid": "Name: 1–12 letters/digits/_; up to 4 actors, unique names.",
+  "sanctuary_test.duo.spawned": "%s spawned nearby (test actor).",
+  "sanctuary_test.duo.missing": "Lab actor not found: %s",
+  "sanctuary_test.duo.removed": "Lab actor removed: %s",
+  "sanctuary_test.duo.trace_failed": "Cannot write session log.",
+  "sanctuary_test.duo.trace_started": "Position log started (one sample every 2 seconds).",
+  "sanctuary_test.duo.trace_stopped": "Position log stopped."
 }

mods/sanctuary-test/src/main/resources/assets/sanctuary_test/lang/fr_fr.json

@@ -1,3 +1,11 @@
 {
-  "generator.sanctuary_test.flat": "Sanctuary — Test rapide"
+  "generator.sanctuary_test.flat": "Sanctuary — Test rapide",
+  "sanctuary_test.duo.list": "Personnages labo : %s",
+  "sanctuary_test.duo.invalid": "Nom : 1–12 lettres/chiffres/_ ; 4 personnages maximum, noms uniques.",
+  "sanctuary_test.duo.spawned": "%s créé à proximité (personnage de test).",
+  "sanctuary_test.duo.missing": "Personnage labo introuvable : %s",
+  "sanctuary_test.duo.removed": "Personnage labo retiré : %s",
+  "sanctuary_test.duo.trace_failed": "Impossible d’écrire le journal de séance.",
+  "sanctuary_test.duo.trace_started": "Journal des positions démarré (une mesure toutes les 2 secondes).",
+  "sanctuary_test.duo.trace_stopped": "Journal des positions arrêté."
 }

mods/sanctuary/build.gradle

@@ -128,6 +128,9 @@ tasks.named('processGametestResources') {
     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 defaults160 = providers.gradleProperty('sanctuaryDefaults160ClientTests').map { it.toBoolean() }.getOrElse(false)
+    inputs.property('defaults160', defaults160)
+    if (defaults160) filter { line -> line.replace('fr.koka.sanctuary.gametest.SanctuaryClientRenderTests', 'fr.koka.sanctuary.client.shader.ShaderDefaults160ClientChecks') }
     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') }

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

@@ -0,0 +1,40 @@
+package fr.koka.sanctuary.client.shader;
+
+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.loader.api.FabricLoader;
+
+/** Exercise the real preference loader in the isolated native client. */
+public final class ShaderDefaults160ClientChecks implements FabricClientGameTest {
+    public void runTest(ClientGameTestContext context) {
+        context.runOnClient(client -> {
+            var path = FabricLoader.getInstance().getConfigDir().resolve("sanctuary-shaders.json");
+            try {
+                byte[] previous = Files.exists(path) ? Files.readAllBytes(path) : null;
+                var cache = VanillaLight.class.getDeclaredField("preferences");
+                cache.setAccessible(true);
+                try {
+                    Files.deleteIfExists(path);
+                    cache.set(null, null);
+                    check(!VanillaLight.enabled(), "Fresh install disables shaders");
+                    Files.createDirectories(path.getParent());
+                    Files.writeString(path, "{}"); cache.set(null, null);
+                    check(!VanillaLight.enabled(), "Missing setting uses OFF");
+                    Files.writeString(path, "{\"enabled\":true,\"pbrIntensity\":73}"); cache.set(null, null);
+                    check(VanillaLight.enabled() && VanillaLight.pbrIntensity() == 73, "Explicit ON and tuning retained");
+                    VanillaLight.setEnabled(false); cache.set(null, null);
+                    check(!VanillaLight.enabled() && VanillaLight.pbrIntensity() == 73, "OFF persists without losing tuning");
+                    VanillaLight.setEnabled(true); cache.set(null, null);
+                    check(VanillaLight.enabled(), "Manual reactivation persists");
+                    System.out.println("SHADER160_DEFAULTS_PASS");
+                } finally {
+                    if (previous == null) Files.deleteIfExists(path); else Files.write(path, previous);
+                    cache.set(null, null);
+                }
+            } catch (Exception error) { throw new AssertionError(error); }
+        });
+        context.takeScreenshot("shader160-native-client");
+    }
+    private static void check(boolean value, String message) { if (!value) throw new AssertionError(message); }
+}

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

@@ -15,7 +15,8 @@ public final class VanillaLight {
     private static Preferences preferences;
     private VanillaLight() { }
     private static final class Preferences {
-        boolean enabled=true;
+        // Opt-in on fresh installations; explicit saved choices remain authoritative.
+        boolean enabled=false;
         Boolean naturalWater; // Legacy OFF is an explicit opt-out in both world types.
         Boolean sanctuaryNaturalWater;
         Boolean ordinaryNaturalWater;

packwiz/pack.toml

@@ -1,6 +1,6 @@
 name = "Sanctuary"
 author = "KOKA99CAB"
-version = "beta.159"
+version = "beta.160"
 pack-format = "packwiz:1.1.0"
 
 [index]

scripts/duo_lab.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env python3
+"""Local, isolated duo lab. No personal saves, accounts or launcher settings touched."""
+import argparse
+import datetime as dt
+import json
+import os
+from pathlib import Path
+import subprocess
+import time
+import uuid
+import html
+
+ROOT = Path(__file__).resolve().parents[1]
+LAB = ROOT / "build" / "duo"
+
+
+def create(path, text):
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if not path.exists():
+        path.write_text(text)
+
+
+def prepare(args):
+    server = LAB / "server"
+    create(server / "server.properties", """server-ip=127.0.0.1
+server-port=25575
+online-mode=false
+white-list=false
+enforce-secure-profile=false
+enable-query=false
+enable-rcon=false
+level-name=duo-flat-160
+level-type=sanctuary_test:flat
+level-seed=160
+gamemode=creative
+difficulty=peaceful
+max-players=6
+view-distance=4
+simulation-distance=3
+pause-when-empty-seconds=30
+spawn-protection=0
+motd=Sanctuary DUO — local test lab
+""")
+    create(server / "eula.txt", "eula=true\n")
+    config = {"mode": args.storage, "serverId": args.server_id or str(uuid.uuid4()),
+              "jdbcUrl": args.jdbc, "user": "root", "passwordEnv": "SANCTUARY_COMMUNITY_DB_PASSWORD"}
+    create(server / "config/sanctuary-community.json", json.dumps(config, indent=2) + "\n")
+    create(LAB / "client/config/sanctuary-shaders.json", '{"enabled":false}\n')
+    create(LAB / "client/options.txt", "renderDistance:6\nsimulationDistance:4\nmaxFps:30\nenableVsync:true\nguiScale:2\nlang:fr_fr\npauseOnLostFocus:false\n")
+    print("Prepared", LAB, "— existing files preserved. Server: 127.0.0.1:25575")
+
+
+def launch(args):
+    java_home = os.environ.get("JAVA_HOME")
+    if not java_home:
+        java_home = subprocess.check_output(["/usr/libexec/java_home", "-v", "25"], text=True).strip()
+    java = str(Path(java_home) / "bin/java")
+    argfile = LAB / (args.command + ".args")
+    if not argfile.is_file():
+        raise SystemExit("Run ./gradlew :sanctuary-test:exportDuoLaunch first.")
+    if not 512 <= args.memory <= (2048 if args.command == "server" else 3072):
+        raise SystemExit("Memory must be 512–2048 MiB (server) or 512–3072 MiB (client).")
+    # JVM overrides must precede the main class, therefore rewrite a temporary argfile.
+    lines = argfile.read_text().splitlines()
+    lines = [f'"-Xmx{args.memory}m"' if line.startswith('"-Xmx') else line for line in lines]
+    if args.command == "client":
+        lines += ['"--quickPlayMultiplayer"', '"127.0.0.1:25575"']
+    runtime = LAB / (args.command + "-runtime.args")
+    runtime.write_text("\n".join(lines) + "\n")
+    os.chdir(LAB / args.command)
+    print(f"Starting {args.command}: heap cap {args.memory} MiB; native/GPU memory is additional.", flush=True)
+    os.execv(java, [java, "@" + str(runtime)])
+
+
+def record(args):
+    if not 1 <= args.seconds <= 300:
+        raise SystemExit("Sessions are limited to 1–300 seconds.")
+    windows = json.loads(subprocess.check_output(["swift", str(ROOT / "scripts/minecraft_windows.swift")], text=True))
+    if args.window not in [window["id"] for window in windows]:
+        raise SystemExit("This ID is not a visible Minecraft window. Run the windows command first.")
+    # Explicit window ID prevents accidentally recording another screen or app.
+    session = LAB / "sessions" / dt.datetime.now().strftime("%Y%m%d-%H%M%S")
+    session.mkdir(parents=True)
+    create(session / "notes.md", "# Séance duo\n\nScène :\nAttendu :\nObservations ergonomiques :\nVérifications fonctionnelles :\nDécisions :\n")
+    (session / "manifest.json").write_text(json.dumps({"window": args.window, "duration": args.seconds,
+        "interval": 2, "audio": False, "format": "timestamped PNG sequence", "started": dt.datetime.now().astimezone().isoformat()}, indent=2))
+    print("Recording selected Minecraft window only, no audio:", session, flush=True)
+    started = time.monotonic()
+    try:
+        while time.monotonic() - started < args.seconds:
+            elapsed = time.monotonic() - started
+            output = session / f"{elapsed:07.2f}.png"
+            subprocess.run(["/usr/sbin/screencapture", "-x", "-o", "-l", str(args.window), str(output)], check=True)
+            time.sleep(2)
+    except KeyboardInterrupt:
+        pass
+    frames = sorted(session.glob("*.png"))
+    rows = "\n".join(f'<figure><figcaption>{html.escape(frame.stem)} s</figcaption><a href="{frame.name}"><img loading="lazy" src="{frame.name}"></a></figure>' for frame in frames)
+    (session / "index.html").write_text('<!doctype html><meta charset="utf-8"><title>Séance Sanctuary</title>'
+        '<style>body{background:#171c1a;color:#f2f2e7;font:16px system-ui;margin:24px}main{display:grid;grid-template-columns:repeat(auto-fit,minmax(320px,1fr));gap:20px}figure{margin:0}img{width:100%}</style>'
+        '<h1>Séance Sanctuary</h1><p>Une capture toutes les deux secondes. Cliquer pour voir en grand.</p><main>' + rows + '</main>')
+    print("Session saved:", session)
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    sub = parser.add_subparsers(dest="command", required=True)
+    setup = sub.add_parser("prepare")
+    setup.add_argument("--storage", choices=["file", "database"], default="file")
+    setup.add_argument("--server-id")
+    setup.add_argument("--jdbc", default="jdbc:mariadb://127.0.0.1:33077/sanctuary_community_tasks158_interop")
+    sub.add_parser("windows", help="List only visible Minecraft window IDs")
+    for command, memory in [("server", 768), ("client", 2048)]:
+        item = sub.add_parser(command)
+        item.add_argument("--memory", type=int, default=memory)
+    capture = sub.add_parser("record")
+    capture.add_argument("--window", type=int, required=True, help="Verified Minecraft window ID; never the desktop")
+    capture.add_argument("--seconds", type=int, default=120)
+    args = parser.parse_args()
+    if args.command == "prepare":
+        prepare(args)
+    elif args.command == "windows":
+        subprocess.run(["swift", str(ROOT / "scripts/minecraft_windows.swift")], check=True)
+    elif args.command == "record":
+        record(args)
+    else:
+        launch(args)
+
+
+if __name__ == "__main__":
+    main()

scripts/minecraft_windows.swift

@@ -0,0 +1,13 @@
+import CoreGraphics
+import Foundation
+
+// Only list Minecraft/Java game windows, never titles from other applications.
+let windows = CGWindowListCopyWindowInfo([.optionOnScreenOnly, .excludeDesktopElements], kCGNullWindowID) as? [[String: Any]] ?? []
+let matches = windows.compactMap { window -> [String: Any]? in
+    let owner = window[kCGWindowOwnerName as String] as? String ?? ""
+    let title = window[kCGWindowName as String] as? String ?? ""
+    guard ["java", "Minecraft"].contains(owner), title.hasPrefix("Sanctuary - ") || title.hasPrefix("Minecraft") else { return nil }
+    return ["id": window[kCGWindowNumber as String] ?? 0, "pid": window[kCGWindowOwnerPID as String] ?? 0, "title": title]
+}
+let data = try JSONSerialization.data(withJSONObject: matches, options: [.prettyPrinted, .sortedKeys])
+print(String(data: data, encoding: .utf8)!)