From e5b2fc5a793dd933411b6f003149f3dc381dac3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ana=C3=AFs=20Saraiva?=
 <53227802+Kisakay@users.noreply.github.com>
Date: Tue, 20 Oct 2026 00:02:57 +0200
Subject: [PATCH] =?UTF-8?q?nosingleplayer=20:=20README=20=C3=A0=20jour=20(?=
 =?UTF-8?q?1.2.0,=20textures=20MC,=20pi=C3=A8ge=20frame/Vulkan)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 mods/nosingleplayer/README.md | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/mods/nosingleplayer/README.md b/mods/nosingleplayer/README.md
index 3349a67..dfca353 100644
--- a/mods/nosingleplayer/README.md
+++ b/mods/nosingleplayer/README.md
@@ -13,14 +13,27 @@ au serveur unique :
   pas de refmap nécessaire.
 
 Build : `cd mods/nosingleplayer && ./gradlew build` (dans nix-shell racine pour Java 25).
-Jar : `build/libs/nosingleplayer-1.1.9.jar` → copié dans `atlas/.../fabricmods/required/`.
+Jar : `build/libs/nosingleplayer-1.2.0.jar` → copié dans `atlas/.../fabricmods/optionalon/`.
+
+## Textures
+
+MC 26.3 n'expose pas les ressources des mods au ResourceManager (vérifié : le panorama
+vanilla affiche le stock Mojang, pas les `panorama_*.png` du mod). Les PNG sont donc
+lus **dans le jar** et enregistrés via le mécanisme officiel de MC
+(`ReloadableTexture` + `TextureContents`) : c'est MC qui crée la texture GPU et le
+sampler, exactement comme pour ses propres textures.
+
+⚠️ La texture GPU doit être créée **hors de l'extraction du rendu** (ici dans
+`TitleScreen.init`) : la créer pendant l'enregistrement des commandes d'une frame
+invalide le frame entier sur les backends à command encoder (Vulkan) → menu titre
+**entièrement noir** (constaté sur Windows + NVIDIA).
 
 ## Diagnostic
 
 - `-Dsurviepote.customTitle=false` (options JVM du launcher) : repasser au menu **vanilla**
   (panorama vanilla au lieu du fond custom). Sert à isoler un souci de rendu du fond custom.
-- Le mod log au démarrage du menu : `[SurviePote] GPU: <nom> | <vendor> | pilote <driver> | backend <OpenGL|Vulkan>`
-  et `[SurviePote] Fond chargé : <w>x<h>` (ou l'erreur de chargement de la texture).
+- Le mod log au démarrage du menu : `[SurviePote] Texture enregistrée : … (1920x1200)` et
+  `[SurviePote] GPU: <nom> | <vendor> | pilote <driver> | backend <OpenGL|Vulkan>`.
 - Si le fond custom échoue (texture refusée par le GPU, jar corrompu…), le mod se repli
   automatiquement sur le panorama vanilla au lieu de laisser un écran noir.