Aller au contenu principal

Guide d’installation

Ce parcours utilise GTA V Legacy sur PC avec ScriptHookV et ScriptHookVDotNet. On vérifie le chargeur natif, puis le pont .NET, puis un petit script. Si quelque chose échoue, cet ordre indique quel maillon examiner.

Préparer Windows​

Dans l’Explorateur, désactive « Masquer les extensions des fichiers dont le type est connu ». On distingue ainsi MyScript.cs de MyScript.cs.txt. Afficher les fichiers cachés peut aussi aider à retrouver les journaux.

Si un fichier du hook disparaît, consulte Sécurité Windows → Protection contre les virus et menaces → Historique de protection et vérifie sa provenance avant de le restaurer. N’exclus pas tout le dossier du jeu ou des projets par défaut : Microsoft indique que chaque exclusion Defender réduit la protection.

Trouver le dossier du jeu​

Repère le dossier de GTA V Legacy contenant GTA5.exe. Le chargeur et les hooks se placent à côté de cet exécutable. Le projet ScriptHookVDotNet d’origine cible Legacy ; ce guide ne couvre pas une installation Enhanced.

Grand Theft Auto V/
  GTA5.exe                 exécutable du jeu
  dinput8.dll              chargeur ASI
  ScriptHookV.dll          hook natif
  ScriptHookVDotNet.asi    pont .NET
  ScriptHookVDotNet3.dll   API C#
  scripts/                 mods compilés

Si le jeu se trouve dans Program Files (x86), la compilation peut manquer de droits pour copier sa DLL dans scripts/. Vérifie l’erreur réelle et les droits de ce dossier avant de modifier autre chose.

Installer puis vérifier chaque chargeur​

  1. Télécharge ScriptHookV chez son auteur et vérifie sa compatibilité avec ta version du jeu. Place ScriptHookV.dll et le dinput8.dll fourni dans le dossier du jeu. Ajoute le NativeTrainer.asi optionnel pour ce contrôle. Lance le mode histoire et appuie sur F4 : si le menu s’ouvre, le hook natif répond.
  2. Suis le guide d’installation de ScriptHookVDotNet, notamment son avertissement de compatibilité avec les versions récentes de GTA V. Place ScriptHookVDotNet.asi et ScriptHookVDotNet3.dll de la version choisie dans le dossier du jeu. En mode histoire, utilise sa touche de rechargement configurée (généralement Inser) et consulte son journal si rien ne se passe.
  3. Crée scripts/ si nécessaire. Le mod compilé du TP 0 ira dans ce dossier.

Installe un maillon à la fois. Si le trainer fonctionne mais pas un script .NET, le hook natif a déjà passé son contrôle ; lis ensuite le journal de ScriptHookVDotNet.

Choisir une chaîne de compilation C#​

Il faut un éditeur et de quoi compiler une bibliothèque de classes (.NET Framework). Visual Studio Community est une possibilité. VS Code, Rider et d’autres éditeurs conviennent aussi une fois configurés pour la même cible.

Pour les projets utilisés ici, cible .NET Framework 4.8 (net48) et référence l’API ScriptHookVDotNet 3. Les fichiers projet d’InteractV et de Street Riders utilisent cette cible. Un autre framework peut compiler localement sans se charger dans le runtime .NET du jeu.

Garder un contrôle réversible​

Renommer temporairement dinput8.dll désactive la chaîne de chargement ASI. Si le jeu de base fonctionne sans ce fichier, remets-le en place puis examine les journaux du hook ou du script. Note chaque fichier déplacé pour pouvoir restaurer exactement l’installation.

Quand le trainer s’ouvre, que le pont répond et que ton projet compile pour net48, passe à Choisir ses outils, puis au TP 0.