NFSU2 Documentation

Test du retour de force natif

But

Identifier les appels réellement produits par le jeu. Les deux premiers essais ont été effectués sans sortie de vibration. Le module dispose désormais d'un pont SDL3 optionnel, décrit dans SDL3-PROTOTYPE.md, dont F8 et certains événements ont été confirmés physiquement par l'utilisateur. Les commandes SDL3 ne remplacent pas encore celles du jeu.

Installation de diagnostic

La copie NFSU2-dev contient scripts/NFSU2_InputTrace.asi et scripts/NFSU2_InputTrace.ini avec [Trace] Enabled=1. Le module d'audit seul est conservé sous l'extension .asi.disabled pour éviter une double capture.

Le module vérifie d'abord le SHA-256 de l'EXE, puis les sept premiers octets de chacune des sept fonctions. En cas de différence, il n'active pas les traces. Les interceptions passent ensuite par des trampolines MinHook pour conserver les fonctions originales.

L'initialisation et la création du thread ont lieu dans InitializeASI, hors de DllMain. Le module ne doit pas être déchargé pendant la partie. Fermer le jeu avant de remplacer ou désactiver le plugin.

Essai demandé

  1. Lancer la copie de développement.
  2. Faire une courte course : accélérer, freiner, tourner, heurter un obstacle et provoquer un dérapage.
  3. Facultatif : appuyer brièvement sur F6 juste après le choc et sur F7 juste après le dérapage. Ce sont des repères manuels, pas des détections automatiques.
  4. Quitter le jeu pour finaliser et libérer le fichier de collecte.

Le module lit uniquement ces deux touches lorsque le jeu est au premier plan. Il n'enregistre pas les autres touches.

Résultats

Les paramètres restent des mots de 32 bits sans interprétation automatique. Les identifications « collision », « régime moteur », etc. doivent venir d'une corrélation avec la conduite et d'une vérification des appelants. L'absence d'appels peut aussi provenir des contrôles de capacités du périphérique ; elle ne prouve pas l'absence de retour de force dans le moteur.

Validation automatique

build.ps1 -Target Test vérifie, dans un exécutable séparé :

Résultat initial : PASS. Cela vérifie le mécanisme de trace, pas la justesse de l'interprétation des événements du jeu.

Premier essai en course : un appel de type 0 (a0=0, a1=0x788) près d'un repère de dérapage ; aucun appel des types 1 et 2, quatre repères manuels et aucune perte signalée. La version étendue à sept traces vise à distinguer les autres chemins natifs et les conditions d'activation.

Désactivation

Jeu fermé, régler [Trace] Enabled=0 dans scripts/NFSU2_InputTrace.ini. La copie jouable NFSU2-test reste indépendante de ces essais.

Dépendance

MinHook provient de la copie distribuée avec SafeDiscLoader2 v1.3, révision f27286a. Ses sources et sa licence BSD sont conservées dans third_party/minhook ; la licence est également fournie à côté du plugin installé.