scripthookvdotnet

Hook de script communautaire V .NET (SHVDN)

Il s'agit d'un plugin ASI pour Grand Theft Auto V, basé sur le ScripThook C ++ par Alexander Blade, qui permet des scripts en cours d'exécution dans n'importe quel .NET Langue en jeu.

La page des problèmes doit être principalement utilisée pour les rapports de bogues et les idées d'amélioration ciblées. Les questions liées au script GTA V en général sont mieux sur la page des discussions ou dans les forums dédiés à cet objectif.

Exigences

• C ++ Script Hook V par Alexander Blade
• .NET Framework ≥ 4.8
• Visual C ++ redistribuable pour Visual Studio 2019 x64

Téléchargements

Les versions stables peuvent être téléchargées à partir de la page des versions. Vous devez utiliser le fichier ASI et les fichiers DLL pour les API dans une archive de la même version que la structure interne peut être modifiée sans préavis.
Si vous utilisez la version du jeu V1.0.3258.0 ou version ultérieure, utilisez la version nocturne nightly.89 ou version ultérieure (voir ci-dessous pour les détails de la version nocturne), ou rétrograder le jeu en V1.0.3179.0 ou plus tôt! v3.6.0 et v3.5.1 ont un problème de compatibilité avec la version du jeu V1.0.3258.0 et versions ultérieures de jeu!

Pour les constructions plus récentes, consultez les constructions nocturnes. Vous n'avez pas à vous connecter à GitHub pour télécharger des versions nocturnes.
Voici quelques-unes des notes que vous devez connaître lors de l'utilisation d'une version nocturne (de v3.6.0):

• La version API par défaut pour les scripts brutes est passée de V2 à V3.
  • Pour les utilisateurs : Si vous avez des scripts bruts sans notation de version API par nom de fichier, vous devrez spécifier dans les versions nocturnes. Vous pouvez spécifier une version API en ajoutant un point et un numéro de version juste avant le nom d'extension (par exemple Script.cs à Script.2.cs ).
• Les paramètres .ini sont modifiés. Vous devez utiliser le fichier .ini provenant d'une version nocturne. SHVDN n'ajoute actuellement pas de paramètres manquants.
• Des messages d'avertissement sont ajoutés pour les scripts construits contre l'API V2, qui n'est pas aussi maintenu que le V3 et n'aura pas de nouvelles fonctionnalités. Cela ne signifie pas que l'API V2 ne recevra même pas de correctifs de compatibilité pour les nouvelles mises à jour du jeu dans un avenir proche . Ces messages sont imprimés pour exhorter les utilisateurs à demander aux auteurs du script de migrer vers l'API V3.
• Certains scripts peuvent ne pas fonctionner qui reposent sur le fil principal du processus de jeu (pour la logique du jeu).
  • En effet, nous avons dû utiliser un thread dédié autre que le thread principal pour éviter d'utiliser la fibre de ScripThookV, de sorte que les utilisateurs n'auront pas de problèmes de compatibilité cruciaux avec Rage Plugin Hook et les scripts C ++ qui utilisent des blocs d'essai. Bien que nous recherchons toujours comment faire cocher SHVDN dans le fil de jeu principal en accrochant une fonction dans le processus de jeu, nous n'en avons pas trouvé.

Pour les développeurs de scripts, veuillez noter que les nouvelles API incluses dans de nouvelles constructions nocturnes mais non incluses dans aucune versions stables sont sujettes à changement sans préavis, il n'est donc pas conseillé d'utiliser aucune d'entre elles pour les versions publiques / de production de vos scripts. En d'autres termes, vous devriez construire vos scripts contre des versions stables, mais pas les versions nocturnes, sauf si vous créez vos scripts pour tester certaines des nouvelles API ajoutées dans les versions nocturnes, vous n'utiliserez donc pas accidentellement quoi que ce soit non disponible dans aucune versions stables. La construction de scripts contre les versions nocturnes peut rendre les scripts qui ne fonctionnent pas comme prévu dans les versions SHVDN différentes des versions contre lesquelles ils sont construits!

Installation

• Extraire tous les fichiers du dossier racine du fichier zip dans votre dossier de jeu, sauf pour README.txt et les 2 dossiers.
  • Les fichiers XML dans le dossier Docs sont fournis uniquement sous forme de documentation API pour les développeurs de scripts.
• Lorsque vous mettez à jour, assurez-vous toujours de mettre à jour au moins tous les fichiers ASI et .DLL ensemble! Aucun support ne sera fourni si vous les sélectionnez en cerisier et que cela cause des problèmes! Les fichiers suivants sont ceux que vous devez mettre à jour ensemble:
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

Contributif

Vous aurez besoin de Visual Studio 2019 ou supérieur pour ouvrir le fichier de projet et le Script Hook V SDK extrait dans / SDK.

Toute contribution au projet est accueillie, il est recommandé d'utiliser les demandes de traction GitHub.

Licence

ScripThookVDOTnet est principalement distribué selon les termes de la licence ZLIB. Voir la licence et le droit d'auteur pour plus de détails.