Plugin de commandes SDL3 pour les options natives
État du 17 novembre 2026 : validation utilisateur de la révision 4 sur la Xbox 360 Controller : A/B corrects dans les menus, accélération et freinage fonctionnels après Go. La trace native avait identifié un frein d'environ 50 % au repos ; le passage à la plage complète des axes corrige ce défaut. Cette validation ne couvre pas encore tous les modèles de manettes, la reconnexion et la persistance des affectations après redémarrage.
Architecture et installation
NFSU2_SDLInput.asi intercepte DirectInput8Create dans le processus du jeu, puis fournit une interface DirectInput 8 ANSI pour les manettes dont l'état est lu via SDL3. La capture a confirmé l'utilisation de IID_IDirectInput8A par NFSU2.
Le jeu conserve ses fonctions de lecture, ses scanners d'événements, ses menus d'affectation et sa sauvegarde de commandes. L'objectif est de rendre les entrées SDL3 compatibles avec ces chemins existants, sans les remplacer par ceux d'XtendedInput.
Les fichiers EXE et les données d'origine ne sont pas modifiés par ce plugin. Le point d'interception est appliqué en mémoire à l'API DirectInput du processus. Le mod n'installe pas de périphérique Windows virtuel ni de pilote.
Installation de test : NFSU2-dev/scripts/NFSU2_SDLInput.asi, configuration à côté dans NFSU2_SDLInput.ini, DLL SDL3 x86 dans la racine de la copie de développement. Le prototype de vibrations reste un plugin séparé ; les nouveaux périphériques ne prétendent pas fournir des axes DirectInput à retour de force.
Entrées exposées
| Objet DirectInput | Source SDL3 | Remarque |
|---|---|---|
| X / Y | Stick gauche | Zone morte configurable |
| Z | RT / R2 | Axe indépendant : minimum au repos, maximum à fond |
| Rx / Ry | Stick droit | Zone morte configurable |
| Rz | LT / L2 | Axe indépendant : minimum au repos, maximum à fond |
| POV 0 | Croix directionnelle | Huit directions ; neutre 0xFFFFFFFF |
| Bouton 1, index interne 0 | Bouton Sud, A / Croix | Validation attendue ; correction de l'inversion constatée au premier essai |
| Bouton 2, index interne 1 | Bouton Est, B / Cercle | Retour attendu ; correction à confirmer en jeu |
| Autres boutons | X/Y, épaules, Start/Retour, clics sticks, Guide et boutons supplémentaires | Seuls les contrôles présents sur le matériel peuvent produire des entrées |
SDL3 normalise les positions physiques : « Sud » correspond par exemple à A sur Xbox et à Croix sur PlayStation. Sur une manette Nintendo, les inscriptions ne correspondent pas forcément aux noms Xbox utilisés dans le tableau.
Le plugin expose au plus 22 boutons normalisés, selon les capacités réelles du périphérique. Le jeu peut ne pas proposer tous ces boutons dans son interface. Les touches tactiles, gyroscopes et gâchettes adaptatives ne sont pas convertis en commandes natives dans cette version.
Les gâchettes sont distinctes ; elles peuvent être enfoncées simultanément. La plage demandée par le jeu avec DIPROP_RANGE est respectée : -10000 au repos, +10000 à fond dans le format natif observé. Correction de la révision 4 : le repos centré des versions précédentes était erroné ; les callbacks natifs recevaient 128/255 à pédale relâchée. Le frein restait ainsi appliqué à environ 50 %, même lors d'une accélération au clavier.
Configuration
[Input]
Enabled=1
LeftDeadzonePercent=18
RightDeadzonePercent=20
TriggerDeadzonePercent=5
SwapAB=0
Diagnostics=0
SwapAB=1 inverse les deux positions de face dans la manette présentée au jeu. Ce réglage pourra servir à un profil dont les conventions de confirmation diffèrent ; il ne réécrit pas les affectations sauvegardées par NFSU2.
Un fichier optionnel scripts/gamecontrollerdb.txt peut ajouter des mappings SDL3 pour des manettes qui ne sont pas reconnues par les profils intégrés. Aucun fichier communautaire n'est téléchargé ni ajouté automatiquement dans cette version.
Compatibilité des chemins DirectInput
Implémentés : acquisition/libération, capacités, énumération des objets, formats de données standard et personnalisés, lecture immédiate, événements mis en tampon, noms d'objets, plage d'axes, zone morte, identité logique de slot et statut de connexion.
Le clavier et la souris sont transférés à l'implémentation DirectInput réelle. Les volants et les joysticks non identifiés comme doublons d'une manette SDL3 sont conservés dans l'énumération. La suppression des doublons de manettes s'appuie sur l'identifiant produit VID/PID DirectInput et celui lu par SDL3 ; les périphériques sans identifiant comparable demandent une vérification particulière.
Les slots logiques utilisent des GUID stables pour éviter de changer de profil de commandes à chaque lancement. Leur attribution suit les périphériques ouverts par SDL3 ; la persistance de l'ordre de plusieurs périphériques identiques n'est pas garantie.
Les appels DirectInput effectués par d'autres modules, notamment par SDL3 lui-même, ne sont pas remplacés : l'interception vérifie que le site appelant se trouve dans l'image du jeu avant de fournir l'interface normalisée.
Les fonctions BuildActionMap, SetActionMap, le panneau de contrôle Windows et les effets DirectInput ne sont pas émulés par ce plugin. NFSU2 doit utiliser les chemins classiques de format/lecture observés. La compatibilité avec les options du jeu demande un essai réel ; accepter le format de données ne suffit pas à la prouver.
Tests et état constaté
build.ps1 -Target InputTest construit le programme de test. Son exécution a vérifié 32 conditions, dont :
- neutralisation de la dérive et conservation des extrêmes des sticks ;
- neutralité et pleine course des gâchettes ;
- RT et LT simultanées dans le format standard et un format personnalisé ;
- boutons de confirmation/annulation dans le paquet normalisé ;
- neutralité des POV supplémentaires absents ;
- événements analogiques et boutons mis en tampon, lecture PEEK sans consommation puis consommation normale ;
- requêtes natives de plage et de noms d'objets ;
- signalement d'une déconnexion ;
- transfert de création du clavier, conservation du volant et d'un joystick non associé ;
- remplacement d'une manette physique associée par un unique périphérique normalisé.
Le programme utilise des échantillons simulés et une racine DirectInput de test. Il ne certifie pas, à lui seul, les menus du jeu, chaque périphérique SDL3 ou les comportements de reconnexion de NFSU2.
La révision 3 ajoute un essai réel de l'API SDL avec une manette virtuelle locale : 12 000 lectures sur 18,925 secondes, RT maintenue, LT alternée, puis relâchement et réappui. Les valeurs restent correctes et aucun événement manette ne s'accumule ; un événement SDL utilisateur extérieur aux manettes est conservé. Cette manette virtuelle n'est ni un pilote Windows ni un remplacement de la manette physique dans le jeu. L'essai ne démontre pas l'absence de blocage des scanners natifs.
Les deux ASI partagent sdl_poll.h : actualisation explicite avec SDL_UpdateGamepads, puis purge des événements joystick/gamepad qu'ils ne consomment pas. La détection des branchements repose toujours sur l'énumération. Un autre mod qui consommerait ces mêmes événements SDL demanderait une coordination. Référence : SDL_UpdateGamepads.
Premier chargement réel confirmé dans le journal : appels du jeu à 0x005D281F et 0x005D0092, création du slot SDL 0 et format 272 octets accepté avec 32 champs exposés. Le premier essai utilisateur a échoué sur les boutons et l'affectation ; cela confirme que les contrôles simulés ne prouvent pas la compatibilité native. En révision 2, Diagnostics=1 enregistre les changements d'acquisition, les propriétés et au plus 600 relevés d'état espacés de 500 ms par périphérique. Il ne corrige pas à lui seul l'affectation des gâchettes.
Résultats automatiques : SDLINPUT-TEST-RESULTATS.txt. Diagnostic de lancement : NFSU2-dev/scripts/sdl-input.log.
Désactivation et suite
Jeu fermé, mettre [Input] Enabled=0 ou renommer le fichier .asi avec une extension différente. La copie NFSU2-test ne reçoit pas ce plugin expérimental.
À valider : A/B, affectation et sauvegarde de RT/LT, conduite, reconnexion, libellés des options et autres modèles de manettes. Les glyphes Xbox/PlayStation dans les écrans ne sont pas encore remplacés.
Références : en-têtes du SDK Windows local et documentation Microsoft GetDeviceState, Acquire, SetProperty.