Guide d'installation

La moitié des histoires d'horreur sur les forums de modding ne sont pas des problèmes de code. Ce sont des problèmes d'installation déguisés en faux rapport de crash. Ma première vraie session s'est finie à 2 h du matin sur un script qui ne se chargeait jamais, et le code allait bien : Windows cachait l'extension du fichier et Defender avait discrètement mis un hook en quarantaine. Ce guide met ton atelier au carré du premier coup, pour que tu ne perdes jamais cette nuit-là.

Fais les étapes dans l'ordre, et valide chaque maillon avant d'ajouter le suivant. Cette seule habitude rend chaque problème ultérieur facile à localiser.

Prépare Windows

Deux réglages de l'Explorateur, avant tout le reste. Active « Afficher les fichiers, dossiers et lecteurs cachés », et désactive « Masquer les extensions des fichiers dont le type est connu ». Sans ça, tu ne peux pas distinguer un vrai MyScript.cs d'un faux MyScript.cs.txt, et tu ne peux pas voir les fichiers de log que tout le monde te dira de lire.

Occupe-toi ensuite de l'antivirus. Le modding fonctionne en injectant du code dans le jeu, ce qui ressemble exactement à un malware pour Windows Defender. Au mieux, il verrouille un fichier pendant que tu compiles. Au pire, il place ScriptHookV en quarantaine sans avertissement, et tu passes des heures à chercher un problème dans ton code alors que le binaire a simplement été bloqué. Ajoute ton dossier de jeu et ton dossier de projets aux exclusions, dans un PowerShell en Administrateur :

Add-MpPreference -ExclusionPath "C:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto V"
Add-MpPreference -ExclusionPath "C:\Dev\GTAProjects"

Connais ton dossier de jeu

Tout s'installe par rapport à la racine de GTA V, le dossier qui contient GTA5.exe. Le loader et les hooks vivent directement ici, à côté de l'exécutable. S'ils atterrissent ailleurs, le jeu démarre vanilla et rien ne se charge.

Grand Theft Auto V/
  GTA5.exe                 le jeu
  dinput8.dll              le loader (intercepte le démarrage)
  ScriptHookV.dll          le hook natif
  ScriptHookVDotNet.asi    le pont .NET
  ScriptHookVDotNet3.dll   l'API C# que tes mods référencent
  scripts/                 tes mods compilés vivent ici

Un avertissement sur les permissions : si le jeu est sous Program Files (x86), Windows protège ce dossier, et ton IDE peut échouer à copier une DLL fraîchement compilée dans scripts/. Si ça t'arrive, accorde la permission d'écriture sur le dossier scripts, ou installe le jeu sur un lecteur sans cette protection.

Installe la chaîne de chargement, maillon par maillon

N'installe jamais tout d'un coup. Ajoute un maillon, prouve qu'il marche, puis ajoute le suivant.

1. Installe ScriptHookV : place ScriptHookV.dll et dinput8.dll à la racine du jeu, avec le NativeTrainer.asi fourni. Lance le jeu et appuie sur F4. Si le menu du trainer apparaît, le hook natif marche.
2. Installe ScriptHookVDotNet : place ScriptHookVDotNet.asi et ScriptHookVDotNet3.dll à la racine du jeu. Lance, puis appuie sur Inser. Si un petit message de rechargement clignote, le pont .NET est vivant.
3. Crée le dossier scripts/ s'il n'existe pas. C'est là que vont tes propres mods compilés.

Si un maillon échoue, tu sais exactement lequel, parce que tu les as testés isolément.

Installe l'IDE et le framework

Installe Visual Studio 2022 Community, et assure-toi d'avoir .NET Framework 4.8. C'est important : ScriptHookVDotNet vise .NET Framework, pas .NET Core ni .NET 8. Compiler contre le mauvais framework est une des raisons les plus fréquentes pour qu'une DLL compile mais ne se charge jamais.

Visual Studio te donne trois choses qu'un éditeur de texte ne peut pas : l'IntelliSense pour découvrir l'API en tapant, les diagnostics du compilateur en direct pour que les erreurs remontent immédiatement, et un débogueur que tu peux attacher au GTA5.exe en cours pour voir exactement quelle ligne a figé le jeu.

L'astuce du retour propre

Garde un geste de secours en poche : renommer ou supprimer dinput8.dll désactive toute la chaîne de mods et démarre le jeu propre en quelques secondes. Chaque fois que tu ne sais pas si un bug est le tien ou celui de l'installation, reviens en vanilla, confirme que le jeu va bien, puis remets ta couche. Ce test de deux secondes m'a sauvé plus de soirées que n'importe quel débogueur.

Tu es prêt

Si le trainer s'est ouvert, si le message de rechargement a clignoté, et si Visual Studio compile contre .NET Framework 4.8, ton atelier est réel. Le guide suivant t'aide à finir d'installer ton établi : ton éditeur, et la question de savoir si et comment ajouter un assistant IA à ton workflow. Après ça, P0 met cette installation à l'épreuve.