社区脚本钩子 V .NET (SHVDN)

这是一个适用于《侠盗猎车手V》的ASI插件，基于Alexander Blade开发的C++版ScriptHook，允许在游戏中运行用任何.NET语言编写的脚本。

问题页面主要用于报告错误和提出有针对性的改进想法。与《侠盗猎车手V》脚本编写相关的一般问题，最好在讨论页面或专门的论坛中提出。

要求

• Alexander Blade开发的C++版Script Hook V
• .NET Framework ≥ 4.8
• Visual Studio 2019 x64版Visual C++可再发行组件包

下载

稳定版可以从发布页面下载。 您需要使用相同版本的压缩包中的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开始）时应注意的一些事项：

• 原始脚本的默认API版本从v2更改为v3。
  • 对于用户：如果您有未通过文件名标注API版本的原始脚本，您需要在每日版本中指定。您可以通过在扩展名之前添加点和版本号来指定API版本（例如，将Script.cs改为Script.2.cs）。
• .ini设置已更改。您应使用每日发布版本附带的.ini文件。SHVDN目前不会添加缺失的设置。
• 为针对v2 API构建的脚本添加了警告消息。v2 API的维护程度不如v3，也不会有任何新功能。这并不意味着v2 API在不久的将来甚至不会接收新游戏更新的兼容性修复。这些消息是为了敦促用户要求脚本作者迁移到v3 API。
• 某些依赖游戏进程主线程（用于游戏逻辑）的脚本可能无法正常工作。
  • 这是因为我们不得不使用主线程以外的专用线程来避免使用ScriptHookV的纤程，以便用户不会遇到与RAGE Plugin Hook和使用try-catch块的C++脚本的严重兼容性问题。尽管我们仍在寻找如何通过钩住游戏进程中的函数来让SHVDN在主游戏线程中运行，但我们还没有找到解决方案。

对于脚本开发者，请注意，新的每日构建版本中包含但尚未包含在任何稳定版本中的新API可能会在不通知的情况下发生变化，因此不建议将它们用于脚本的公开/生产版本。 换句话说，除非您构建脚本是为了测试每日版本中添加的一些新API，否则您应该针对稳定版本而不是每日版本构建脚本，这样您就不会意外使用任何稳定版本中不可用的功能。针对每日版本构建脚本可能会导致脚本在与构建时使用的版本不同的SHVDN版本中无法按预期工作！

安装

• 将zip文件中根文件夹内的所有文件（除了README.txt和2个文件夹）解压到您的游戏文件夹中。
  • Docs文件夹中的XML文件仅作为脚本开发者的API文档提供。
• 更新时，始终确保至少同时更新所有asi和.dll文件！如果您只选择性地更新部分文件而导致问题，我们将不提供支持！ 以下是您必须一起更新的文件：
  • ScriptHookVDotNet.asi
  • ScriptHookVDotNet2.dll
  • ScriptHookVDotNet3.dll

贡献

您需要Visual Studio 2019或更高版本来打开项目文件，并将Script Hook V SDK解压到/sdk文件夹中。

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

许可证

ScriptHookVDotNet主要根据zlib许可证的条款分发。 详情请参阅LICENSE和COPYRIGHT文件。