LifePlay-Revival/Docs/Migration/etat/U58/U7/U7-T17-DOC.md

Fiche U7-T17 — Niveau N1 — Modèle prévu lp-writer | utilisé lp-writer (Sonnet 5.5) — Agent lp-writer — Skills lp-doc, lp-paths, sk-protocol

# U7-T17 — Documentation moddeurs et skills après U7

Source des faits : `etat/U58/U7/U7-SUIVI.md`, `U7-T7-IMPL.md`, `U7-T8b-BUILD.md`. Aucun commit, aucun autre fichier touché.

## Fichiers modifiés (4)
Fins de ligne : les 4 fichiers sont en LF avant et après (établi : `Grep '\r$'` en mode count = 0 sur chacun ; méthode
validée sur `Config\DefaultEngine.ini`, CRLF, 132 lignes trouvées). Pas de BOM ajouté (édition par remplacement exact).

### a) `D:\Game\LifePlay-Sandbox-5.8\Docs\Modding\Creating_Asset_Mods.md` (worktree ue5.8)
Sections modifiées : en-tête (UE 5.8), § 2 Requirements, § 4 (note sur les champs obligatoires), § 4b (ligne
`MODULE_GAME_VERSION`), **nouveau § 7b Compatibility checks**, § 8 Troubleshooting (3 lignes).
```diff
-*LifePlay Revival addition (UE 5.5).
+*LifePlay Revival addition (UE 5.8).
-Unreal Engine **5.5** (Epic
+Unreal Engine **5.8** (Epic
-(for example `Releases/2026.10.4/` for LifePlay 2026.10.4)
+(for example `Releases/2026.10.2.0/` for LifePlay 2026.10.2.0)
-`D:\Game\Launcher\Engine\UE_5.5`)
+`D:\Game\Launcher\Engine\UE_5.8`)
+ **The fields "mesh", "head", "cap_slots", "diffuse" and "strands_opacity" are mandatory** in every entry: set them
+ to "auto" ... (HairPipeline.ps1 stops with an error message that does not say which field is the cause)   [après le JSON, § 4]
-... If an **enabled** mod declares another version than the game, the game shows a "Mod version warning" window (once per session) |
+... The game checks it at startup against its own version, see [section 7b](#7b-compatibility-checks). A mod without this key is loaded, with a warning |
+## 7b. Compatibility checks   (3 contrôles : moteur / version min 2026.10.2.0 / version max = jeu ; mod refusé non chargé,
+  fenêtre "Mod compatibility warning", "(not loaded)" grisé, 3 cases Settings > Misc à ses risques, effet au redémarrage ;
+  décocher un mod de coiffures : coiffures retirées des listes, personnage qui en porte une la garde, voulu en V2.0)
+| mod V2.0 dans jeu V1.x : `Invalid pak file version (12)` ... retirer le mod ou mettre le jeu à jour |
+| mod V1.x dans jeu V2.0 : "built with an older engine", "(not loaded)" -> reconstruire avec BuildMod.ps1 |
+| HairPipeline : erreur peu claire -> champ obligatoire manquant, mettre "auto" |
```
Écarts de mise en forme : § 7b numéroté « 7b » (comme « 4b ») pour ne pas renuméroter Troubleshooting. Le texte
« Mod version warning » (ancien comportement, supprimé par T7) est remplacé par le renvoi au § 7b. La phrase d'en-tête
« after LifePlay 2026.10.4 (V1.4) » est laissée (historique).

### b) `D:\Game\LifePlay-Sandbox\Tools\claude\skills\lp-build\SKILL.md`
§ 2 (après la ligne Journal/Build.bat) et § 4 (Builds empaquetés). Rien retiré.
```diff
+- **Compiler le jeu avec `-NoUBA`** (règle U6) : `.\Tools\Build.ps1 -Lot <lot> -Target LifePlay -Config <cfg> -ExtraArgs '-NoUBA'`.
+  UBA a donné des C1001/C2206 non déterministes sous mémoire engagée élevée.
+- **Un build de test ne s'écrit jamais dans un dossier d'archive existant** : toujours un `-ArchiveDir` neuf (piège U7-T8b).
```
`-ExtraArgs` existe dans `D:\Game\LifePlay-master 5.8\Tools\Build.ps1` (3 occurrences, établi).

### c) `...\skills\lp-validate\SKILL.md` — § 5 (contrôles en jeu)
```diff
+- **Copie d'une sauvegarde de test** : copier `Saved\SaveGames` ET `Content\Saves` (sans le second, `Player.lpcharacter`
+  est absent et le menu d'actions manque : SAV1 / ERR-042).
+- **Contrôle d'une copie d'essai avant de la confier à l'utilisateur** : l'exe est présent et son binaire est identique
+  à celui du build (MD5 ou taille) ; piège U7 : une copie vide a été livrée.
```

### d) `...\skills\lp-paths\SKILL.md` — nouvelle section avant « Inventaires types »
```diff
+## Sources binaires des mods et dossier etat/
+- `ModSources/<id>/Content/` est ignoré par git (`.gitignore:38` de l'addon) : ... copier depuis
+  `D:\Game\LifePlay-Sandbox\ModSources\<id>\Content` (copie, MD5 contrôlés ; U7-T15). État actuel : copié dans
+  `D:\Game\LifePlay-Sandbox-5.8` le 2026-10-09.
+- `Docs\Migration\etat\` est organisé en `etat/<projet>/<lot>/` ; index `etat/INVENTAIRE.md`, correspondances `etat/MAPPING.csv`.
```

## Incertitudes / à confirmer
- Libellés exacts des 3 cases Misc : seul `Mods: engine check (restart)` est cité en entier (SUIVI:28, T8b:14) ; les
  deux autres sont connus par `Mods: min version` / `Mods: max version` (T8b:14, :64). Le guide ne cite que le premier
  et dit « les libellés commencent par `Mods:` ». À confirmer par l'orchestrateur.
- `.gitignore:38`, `INVENTAIRE.md`, `MAPPING.csv` : repris de la fiche, non relus à la source (fichiers de l'addon
  et de `etat/` non ouverts).
- Les dates/liens du guide (ancre `#7b-compatibility-checks`) non rendus ; à vérifier dans un visualiseur Markdown.
- **Critère 8 non rejoué** : cet agent n'a pas d'outil shell ; `git -C D:\Game\LifePlay-Sandbox-5.8 status` et
  `git -C D:\Game\LifePlay-Sandbox status` sont à lancer par l'orchestrateur. Attendu : addon 5.8 = `Creating_Asset_Mods.md`
  seul modifié ; addon 5.5 = les 3 `SKILL.md` (si les skills sont suivis par git dans ce checkout ; sinon rien).

Suite : orchestrateur doit lancer les deux `git status`, relire les diffs et commiter (addon 5.8 pour le guide ; addon
5.5 pour les skills), état : 4 fichiers édités, rien commité.