LifePlay-Revival/Docs/Migration/etat/REL/KEY2/KEY2-DIAG-01.md

KEY2-DIAG-01 : marche coupée, indicateur de caméra absent et migration non jouée (essai COMMUN-15)

Fiche KEY2-DIAG-01 — Niveau N3 — Modèle prévu opus (Medium) | utilisé Opus 5.5 — Session « Medium · KEY2 » — Skills : sk-protocol, lp-lot. Date : 2026-10-20. Ordre de Big Boss local_104ff22d (KO COMMUN-15). Lecture du code et des journaux, sans copie UE. Le correctif est décrit au § 4 : écrit sous instantané, non compilé.

1. Constats de l'essai (cités par Big Boss et par l'utilisateur)

• Big Boss, COMMUN-15 : « les touches de direction ne fonctionnent plus ZQSD ou WAQSD. C1 toujours un seul axe. Le bouton apply AZERTY fonctionne les + et - ajustent la vitesse ».
• Journal etat\BOSS\COMMUN-15\COMMUN-15_LifePlay_20261020-1040_encours.log:1465-1470 : « M1e : touche Z vue par Slate ; PlayerInput=1 ; marche coupee (menu clavier) ; focus SViewport ».
• Journal …-1034.log:877-878 :
  • « Clavier : ../../../LifePlay/Saved/Config/Windows/LPKeyboard.ini illisible, les touches du jeu sont gardees » ;
  • puis « 51 actions et 17 axes enregistres » (le fichier du joueur est réécrit).
• Utilisateur, dans cette session : « le nom de la caméra à l'écran à disparu ».

2. Cause 1 : la page Clavier compte comme menu ouvert pour toujours (établi par le code)

1. Les réglages intègrent la page Clavier par TakeEmbeddedPage (LPSettingsSubsystem.cpp:873-875). Celle-ci garde le panneau dans Live().Menu et met Live().bEmbedded à vrai (LPKeyboardSubsystem.cpp, TakeEmbeddedPage).
2. À la fermeture des réglages, LPSettingsSubsystem ne fait que replier l'hôte (LPSettingsSubsystem.cpp:528-531). Live().Menu reste valide : seul CloseKeyboardMenu le remet à zéro, et il n'est appelé que pour la fenêtre autonome.
3. IsMenuOpen() rendait Live().Menu.IsValid() && Owner == this (LPKeyboardSubsystem.cpp:807-810 avant correctif) : il reste donc vrai pour toute la partie après une seule visite de l'onglet Clavier.
4. Trois appelants s'en servent pour couper le jeu :
   • la marche, « menu clavier » (LPDirectControlSubsystem.cpp:683-687) : c'est la cause des touches de direction sans effet ;
   • la caméra, MenuOnScreen (LPCameraModeSubsystem.cpp:414-426). Tick en déduit bMenu (:748) et cache l'indicateur de caméra quand bMenu est vrai (:770-773). C'est la cause de « le nom de la caméra à l'écran a disparu ». La même garde coupe sans doute le tangage souris de C1 (constat 3 de Big Boss, estimé) ;
   • la pièce extérieure (LPOutdoorRoomSubsystem.cpp:87-92, PlayerBusy) : LiftSunkPersons ne relève pas le joueur quand PlayerBusy est vrai (:409-412). C'est le personnage enfoncé dans la rue signalé par l'utilisateur (ancien ERR-128) ; les journaux de COMMUN-15 n'ont aucune ligne « releve de » ni « ecarte de » (relevé de Big Boss).
5. Le défaut est antérieur à KEY2 : IsMenuOpen et TakeEmbeddedPage sont inchangés depuis HEAD. KEY2 l'a révélé, car l'essai demandait d'ouvrir l'onglet Clavier pour Apply. Lors des essais précédents, l'onglet n'était sans doute pas ouvert (estimé).

2b. Chemins de fermeture du panneau (vérifiés, piste de CAM2)

Écritures de Live().Menu dans LPKeyboardSubsystem.cpp (grep Live().Menu = et Live().Menu.Reset) : posé par TakeEmbeddedPage (:897, page intégrée) et par OpenKeyboardMenu (:917, fenêtre) ; remis à zéro par CloseKeyboardMenu seul (:938).

Chemin de sortie	Fenêtre autonome	Page intégrée aux réglages
Échap	CloseKeyboardMenu (:737)	Échap n'est pas pris par la page (return false, :732-735) ; ce sont les réglages qui se ferment
Bouton Close	CloseKeyboardMenu (:677)	bouton masqué
Apply, Reset, liste des dispositions, Change, Add, Remove	ne ferment rien (seul bWaiting = false)	idem
Fermeture des réglages	—	hôte replié (LPSettingsSubsystem.cpp:528-531) ; Live().Menu jamais remis à zéro
Fin du sous-système	CloseKeyboardMenu (:828)	idem

Avec le correctif, la page intégrée ne compte comme menu que pendant une capture. Le dernier chemin ouvert était la fermeture des réglages pendant une capture (Change ou Add, puis sortie des réglages) : bWaiting serait resté vrai. Il est fermé par l'annulation de la capture à la fermeture des réglages (§ 4).

3. Cause 2 : le fichier du joueur n'est jamais relu (établi par le code du moteur 5.8)

1. SaveSaved écrit les liaisons sous les clés +ActionMappings et +AxisMappings (AddToSection(InputSection, TEXT("+ActionMappings"), …)). L'ancien fichier du joueur a bien cette forme (copie …_COM15\Windows\LifePlay\Saved\Config\Windows\LPKeyboard.ini.avant : +ActionMappings=(ActionName="ActionX",Key=MouseX), 55 lignes).
2. LoadSaved relit par FConfigFile::Read, puis par GetArray(InputSection, TEXT("ActionMappings")).
3. Dans le moteur 5.8, FConfigFile::Read appelle FillFileFromDisk(this, Filename, false) (ConfigCacheIni.cpp:2216-2219). Le troisième paramètre est bHandleSymbolCommands. Il est faux, donc le + n'est pas retiré du nom de la clé : seul le cas bHandleSymbolCommands traite + - . ! @ * ^ (ConfigCacheIni.cpp:2076-2096).
4. La clé lue s'appelle donc +ActionMappings. GetArray("ActionMappings") ne trouve rien, d'où 0 action et 0 axe, le message « illisible » (LoadSaved), puis la réécriture du fichier par Initialize (if (!LoadSaved()) SaveSaved();).
5. Conséquences :
   • la migration Version=2, placée après ce retour, ne joue jamais ;
   • plus largement, aucune touche changée par le joueur ne survit à un redémarrage. L'Apply AZERTY de COMMUN-15 a été écrit, mais il serait perdu au lancement suivant ;
   • ce défaut est antérieur à KEY2 : la lecture est inchangée depuis HEAD.

4. Correctif (fichier Source/LifePlay/LPKeyboardSubsystem.cpp seul)

Instantané : Tools\Snapshot.ps1 -Lot KEY2-FIX1 (avant : 7501ec6a). Après : 7960e871 ; CRLF gardé (1486 lignes, 1486 CR).

Cause	Changement
1	IsMenuOpen() rend Live().Menu.IsValid() && Owner == this && (!Live().bEmbedded || bWaiting). La page intégrée ne coupe le jeu que pendant une capture de touche. Les réglages ouverts restent vus comme menu par MainMenu_C (LPDirectControlSubsystem.cpp:59-62, MenuOnScreen).
2	LoadSaved lit +ActionMappings et +AxisMappings (forme écrite par SaveSaved), puis ajoute ce qu'il trouve sous ActionMappings et AxisMappings (fichier édité à la main). La migration Version=2 joue ensuite telle qu'écrite.
1 (chemin restant)	LPSettingsSubsystem.cpp, à la fermeture des réglages : si une capture est en cours, CancelWait(). Instantané KEY2-FIX1 (avant : b72671af ; après : 5ff9f26d ; +9 lignes, CRLF gardé, 896 / 896).

Aucun autre fichier n'est touché ; LPCameraModeSubsystem.cpp n'a pas besoin d'être changé (gel CAM2 respecté).

5. Preuves exigées (après BUILD-GO)

1. Build LifePlayEditor et Development à code 0, sans nouvel avertissement.
2. Copier LPKeyboard.ini.avant (ancien fichier) à la place de LPKeyboard.ini, lancer le jeu.
   • Attendu dans le journal : « Clavier : … passe de la version 0 a 2 : N liaisons retirees … », puis « Clavier : X actions et Y axes relus » ; plus aucun « illisible ».
   • Attendu dans le fichier : Version=2, le pavé 4 / 6, Equals, Hyphen et Tilde retirés.
3. Ouvrir les réglages, onglet Clavier, puis les fermer : la marche ZQSD ou WASD répond ; l'indicateur de caméra s'affiche de nouveau ; plus aucune ligne « marche coupee (menu clavier) ». Pendant une capture (Change), la marche est coupée. Variante : Change sur une touche, puis fermer les réglages sans appuyer : la marche répond aussi.
4. Apply AZERTY, quitter, relancer : AZERTY est toujours en place (Layout=AZERTY relu et touches gardées).
5. C1 : le tangage souris est rendu (à confirmer avec CAM2).
6. Rue extérieure : un personnage enfoncé est relevé (ligne « releve de » dans le journal), même après une visite de l'onglet Clavier.

Fichiers à commiter : M Source/LifePlay/LPKeyboardSubsystem.cpp et Source/LifePlay/LPSettingsSubsystem.cpp (avec le reste de KEY2) ; A ce livrable.