NFSU2 Documentation

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

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.