scripthookvdotnet

社区脚本钩v .net（SHVDN）

这是基于Alexander Blade的C ++ Scripthook的Grand Theft Auto V的ASI插件，该插件允许在游戏中以任何.NET语言编写的脚本运行。

问题页面应主要用于错误报告和重点增强想法。一般而言，与GTA V脚本有关的问题，在讨论页面或专门针对此目的的论坛上更好。

要求

• Alexander Blade的C ++脚本钩V V
• .NET框架≥4.8
• Visual C ++可用于Visual Studio 2019 x64的重新分布

下载

可以从“发行”页面下载稳定的构建。您需要在可以更改内部结构的同一版本的档案中使用ASI文件和API的DLL文件，而无需通知。
如果您使用的是游戏版本v1.0.3258.0或更高版本，请夜间使用夜间版本nightly.89或更高版本（有关夜间版本的详细信息，请参见下文），或将游戏降级到v1.0.3179.0或更早！ v3.6.0和v3.5.1与游戏版本v1.0.3258.0及以后的游戏版本有兼容性问题！

对于较新的版本，请查看夜间构建。您不必登录Github即可下载夜间版本。
以下是您在使用夜间版本时应该注意的一些笔记（来自v3.6.0）：

• RAW脚本的默认API版本从V2更改为V3。
  • 对于用户：如果您的原始脚本不使用文件名表示API版本表示法，则需要在夜间版本中指定。您可以通过在扩展名称之前添加点和版本号来指定API版本（例如Script.cs to Script.2.cs ）。
• .INI设置已更改。您应该使用每晚发布的.INI文件。 SHVDN当前不会添加丢失的设置。
• 添加了针对V2 API构建的脚本的警告消息，该脚本不像V3 ONE那样维护，并且不会具有任何新功能。这并不意味着V2 API甚至不会在不久的将来获得新游戏更新的兼容性修复。打印这些消息是为了敦促用户要求脚本作者迁移到V3 API。
• 某些脚本可能无法依靠游戏过程的主线程（用于游戏逻辑）。
  • 这是因为我们必须使用除主线程以外的专用线程以避免使用Scripthookv的光纤，因此用户不会与使用Try-Catch块的Rage Plugin Hook和C ++脚本存在关键的兼容性问题。尽管我们仍在搜索如何通过在游戏过程中挂接函数在主游戏线程中shvdn tick的方法，但我们尚未找到一个。

对于脚本开发人员，请注意，新的夜间构建中包含的新API，但在任何稳定版本中都不包含在不通知的情况下会发生更改，因此不建议将其中的任何一个用于脚本的公共/生产构建。换句话说，除非您构建脚本来测试一些新的API，否则您应该根据稳定版本构建脚本，而不是夜间版本，因此您不会意外使用任何稳定版本中不可用的内容。针对夜间版本构建脚本可能会使脚本无法按照SHVDN版本的意图工作，这与它们构建的版本不同！

安装

• 除了README.txt和2个文件夹外，从zip文件中将所有文件中的所有文件提取到游戏文件夹中。
  • Docs文件夹中的XML文件仅作为脚本开发人员的API文档提供。
• 更新时，请始终确保至少将所有ASI和.DLL文件更新在一起！如果您挑选它们，将不会提供支持，这会导致问题！以下文件是您必须一起更新的文件：
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

贡献

您需要Visual Studio 2019或更高版本才能打开项目文件和提取到 /SDK的脚本挂钩SDK。

欢迎对该项目的任何贡献，建议使用GitHub拉的请求。

执照

ScripthookvDotnet主要根据ZLIB许可证的条款分发。有关详细信息，请参见许可证和版权。