Adresses des commandes et de l’interface
Référence : US 1.2, SHA-256 et limites dans REPRISE-IA.md. Adresses virtuelles, base 0x00400000. Les noms sont des noms de travail sauf mention d’une référence externe. Les octets requis figurent dans Controller/src/ui_signatures.h et les signatures FFB historiques dans InputTrace/src/trace_signatures.h.
Entrées natives actuellement interceptées
| Adresse | Usage / convention | Preuve et réserve |
|---|---|---|
| 0x005C11A0 | Défauts du canal, thiscall, retour char | Appel Reset UI à 0x004ACDE4 ; retour 0x004ACDE9 reconnu. Plugin applique ses défauts immédiatement |
| 0x005B8A90 | Nom d’affectation joypad, thiscall(action, secondary), ret 8 | Recherche native des axes puis boutons puis POV. Remplacée par des tokens d’icône ; secondaire = deuxième correspondance |
| 0x005C1840 | Traitement normal joystick, thiscall sans argument de pile | Hook de synchronisation des réglages et navigation FrontEnd |
| 0x005C2100 | Début configuration, thiscall(action, secondary), ret 8 | Écrit +0x33C et +0x340 puis appelle 0x005B9120. Crucial pour ne pas manquer les captures |
| 0x005B8460 | Affecter bouton, thiscall(button), ret 4 | Écrit l’action à canal+0x18+button*4 et termine capture. Ne désactive pas l’axe analogique d’origine |
| 0x005B8250 | Affecter axe, thiscall(offset, sign), ret 8 | Switch des actions 1..4 ; champs +0x344..+0x368. Hook refuse les gâchettes pour la direction des pads gérés |
| 0x005C1720 | Affecter POV, thiscall(pov index), ret 4 | Déduit la direction depuis l’état natif, écrit +0x58 puis remet +0x33C à zéro |
| 0x004FF9D0 | Texte localisé, hash en EDX | Extension des textes des lignes Options |
| 0x00539650 | Sélection d’option, thiscall(index) | Ajout des deux lignes de profil dans Options/Joueur |
| 0x004CFAF0 | Destructeur principal du menu d’options | Retire l’entrée du cache des écrans. Variante pause non interceptée à ce stade |
| 0x004ACE00 | Construction des catégories Controls, thiscall sans argument | Filtrage après construction native, table compacte et sélection préservée |
| 0x004ACBF0 | Traitement périodique Controls, thiscall sans argument | Vérification de la présence, mise à jour des catégories hors capture |
Sites de rendu milieu de fonction
| Adresse | Registres / pile à l’entrée du stub |
|---|---|
| 0x0051C36E | EBP texte, EBX police ; SP+0x10 x, +0x18 y, +0x14 flags, +0x38 couleur, +0x5C objet rendu, +0x60 info |
| 0x0050BD94 | EDI texte, SP+0x28 largeur, SP+0x10 police |
| 0x00537085 | ESI FEString, SP+4 pointeur texte large remplacé pour les invites |
| 0x005370B5 | EAX objet FE, type +0x18, flags +0x1C ; rafraîchissement pendant changement de profil |
Frame pushad du stub : EDI[0], ESI[1], EBP[2], ancien ESP[3], EBX[4], EDX[5], ECX[6], EAX[7], flags[8]. Le SP natif initial est frame+36 octets. FXSAVE/FXRSTOR requis pour les callbacks C++/SDL. La police donne la taille à +0x24.
Fonctions appelées, pas détournées
| Adresse | Usage |
|---|---|
| 0x0055DBD0 | FESendKeystroke(unsigned key), cdecl, retour C3 ; 'Q' ouvre la sortie native dans l’essai utilisateur |
| 0x00519FC0 | AddPoly natif ; texture du poly à +144 |
| 0x004901D0 | GetTextureInfo(hash,0,0) |
| 0x00577AB0 | Chargement des chunks TPK ; retour traité void, pas bool |
| 0x00512570 | Résolution texte localisé large pour les correspondances de secours |
| 0x00575620 | Allocation du jeu |
| 0x0051E230 | Constructeur de ligne Toggle |
| 0x0054EF30 | Ajout de ligne au menu d’options |
| 0x0050C900 | SetLanguageHash objet/hash |
| 0x005B8720 | Classe de périphérique à partir de +0x234 |
| 0x004ACAA0 | Sélecteur de périphérique de Controls, messages gauche/droite |
Champs de canal
| Offset | Contenu |
|---|---|
| +0x08 / +0x0C | Masques d’action bas/haut, bits actifs bas |
| +0x10 / +0x11 | Accélérateur / frein natifs (octets) |
| +0x12 / +0x13 | Direction / pédales combinées, réutilisées pour la navigation |
| +0x18 | Actions jeu boutons [16 DWORD] |
| +0x58 | Actions jeu POV [16 DWORD, 4 directions par POV] |
| +0x98 / +0xD8 | Actions menu boutons / POV |
| +0x118 / +0x158 | Tables secondaires jeu boutons / POV |
| +0x198 | Table secondaire menu boutons |
| +0x230 | Index de canal matériel |
| +0x234 | Type DirectInput ; clavier 0x13, joystick 0x14, gamepad 0x15, driving 0x16 |
| +0x33C / +0x340 | Action en capture / colonne 0 Primary, 1 Secondary |
| +0x344 | Offsets de quatre axes [direction, accélérateur, frein, pédales combinées] |
| +0x354 | Signes des quatre axes, DWORD +1/-1 |
| +0x364 | Activation des quatre axes, quatre octets |
| +0x368 | Mode pédales combinées |
Le bloc de persistance du plugin n’est pas la structure native contiguë : lire Bindings et read/write. Ne pas memcpy tout le canal sur disque. Deux slots natifs sont traités par les hooks de profils même si la façade SDL expose jusqu’à quatre pads.
Variables globales et actions
0x00838974 : identifiant du dialogue natif actif, zéro en l’absence de dialogue ; écrit à 0x0055822E, effacé à 0x00540AA4. Utilisé pour laisser Quit Game en texte seul dans la confirmation même si le hash est identique à l’invite de menu. Signature d’ancrage : 0x00540A60.
0x00835930 : début réel de la table des catégories Controls, entrée de 12 octets {catégorie, valeur non interprétée, index canal}. 0x00835938 est seulement le premier champ canal. Voir VISIBILITE-CONTROLS.md pour la correction du diagnostic historique.
0x0086FFB4 : tableau IDirectInputDevice8A*, index slot*4.
0x00870760 : gestionnaire natif d’entrées et FFB ; pas une structure SDL.
0x0086FF80 : nombre d’axes actionneurs FFB, pas un pointeur d’effet.
0x008654A4 : état GameFlow, FrontEnd=3.
0x0083AA04 : type de page Options, Joueur=3 dans le chemin adapté.
0x00835938 : table de canaux des pages Controls ; sélection globale 0x008364EC.
0x007A3C18 : coefficient natif -0.0127 impliqué dans les conversions analogiques.
Actions jeu : 1 accélérer, 2 freiner, 3/4 direction, 5 frein à main, 6 nitro, 7 rapport supérieur, 8 inférieur, 9 vue arrière, 10 caméra ; annexes à vérifier individuellement avant de les renommer.
Actions menu : 0x1F valider, 0x22 retour, 0x23 personnaliser, 0x2E preset, 0x2F quitter. Écrire uniquement 0x2F dans le masque n’a pas ouvert la confirmation dans l’essai utilisateur.
POV par défaut du plugin : haut 0x0F, gauche 0x10, droite 0x11, bas 0x12. Intitulés exacts à confirmer avec la page utilisateur.
Le code de référence WFP GPL-3.0 est conservé localement et épinglé par commit dans Controller/third_party/wfp/SOURCE.md. Les conventions ci-dessus ont été rapprochées de la capture réelle ; elles ne sont pas portables à une autre version du jeu sans vérification.