模组简介

脚本钩子(Script Hook V)是专门面向《侠盗猎车手5 增强版》模组开发者与自定义玩法玩家的底层核心类库工具,它的核心作用是打通自定义ASi插件与游戏原生脚本函数之间的调用通道,让第三方制作者编写的各类自定义脚本模组能够直接读取、调用游戏本身内置的原生函数资源,实现原本游戏原生不支持的各类自定义玩法、功能修改效果。所有后续基于脚本框架开发的自定义功能模组,几乎都需要依赖这款底层工具才能正常运行,没有它的支撑,绝大多数的自定义脚本类修改器、玩法扩展模组都无法在游戏内加载生效。

功能要点

  • 提供完整的游戏原生脚本函数调用接口,所有符合开发规范的自定义*.asi格式插件都可以通过该类库调取游戏本身的内置逻辑,无需额外反向编译游戏核心文件即可实现功能扩展
  • 内置最新版本的ASI加载器组件,用户无需额外单独安装基础加载工具,就能直接识别加载放置在游戏根目录下的所有符合格式要求的*.asi后缀插件文件
  • 自带原生内置修改器示例插件,无需额外下载独立修改器资源,安装完成后即可直接使用基础的内置修改器功能调试各类自定义参数
  • 遵循低耦合设计逻辑,所有基于该工具开发的自定义脚本插件仅依赖核心的ScriptHookV.dll文件运行,当游戏版本更新后,仅需替换对应版本的核心库文件即可让所有旧的自定义脚本恢复正常工作,不需要逐个升级已经安装的第三方脚本插件

前置依赖

使用脚本钩子(Script Hook V)前,你可以搭配本站提供的相关工具获得更完整的脚本模组加载体验:如果你后续需要运行基于.NET框架开发的自定义脚本模组,可搭配 Script Hook V .Net Enhanced 使用;如果你习惯使用第三方整合的全功能加载工具,也可以选择单独安装 终极 ASI 加载器 替代本包内附带的默认加载组件。如果你正在使用 NVE自然视觉增强(NaturalVision Enhanced) 这类大型画面修改模组,脚本钩子作为底层工具完全兼容其运行逻辑,不会和画面增强模组产生核心文件冲突。

安装方法

使用 神尺 管理器的用户,直接在模组站内找到该工具条目选择一键安装即可,管理器会自动识别游戏根目录位置,完成所有核心文件的部署,无需手动调整任何文件路径。如果选择手动安装,你需要先找到《侠盗猎车手5 增强版》的游戏主目录,也就是GTA5.exe程序文件所在的文件夹,从本模组的压缩包内依次取出对应的文件进行部署:首先将核心库文件ScriptHookV.dll复制粘贴到游戏主目录下完成核心类库的部署;之后将本包内附带的ASI加载器文件dinput8.dll同样复制到游戏主目录中,如果你此前曾经安装过旧版本的ASI加载器,对应文件名为dsound.dll,必须先将旧的dsound.dll文件从游戏目录中彻底删除,避免新旧加载器冲突导致插件无法识别;如果你需要使用本包附带的原生内置修改器功能,再将示例插件文件NativeTrainer.asi一并复制到游戏主目录下即可。压缩包内其余未提及的配置文件与说明文件,以压缩包内自带的readme文档说明为准。

注意事项与兼容性说明

这款脚本钩子工具完全无法在《侠盗猎车手5》线上模式环境下使用,程序本身内置了检测逻辑,一旦你进入游戏的多人联机模式,工具会自动触发安全机制关闭整个游戏进程,不要尝试在联机模式下加载该工具,避免出现账号相关的异常问题。该工具仅适配《侠盗猎车手5 增强版》版本,不兼容旧的非增强版游戏客户端,如果你同时安装了多个不同版本的脚本钩子类工具,可能会出现核心文件冲突的问题,建议定期清理游戏目录内多余的dll后缀钩子相关文件。所有需要调用游戏原生函数的自定义脚本模组,都必须依赖该工具才能正常运行,缺少该核心库会直接导致脚本插件加载失败,部分第三方模组的报错提示也会指向缺失ScriptHookV.dll的相关内容。

常见问题

部分用户安装完成后发现自己的自定义ASI插件无法识别,大概率是没有删除旧版的dsound.dll格式旧加载器文件,旧版本的加载器无法兼容新版的增强版游戏,必须替换为包内提供的dinput8.dll文件才能正常工作。部分用户反馈启动游戏后直接弹出关闭提示,大多是因为尝试启动线上模式触发了工具的自动防护机制,退出联机模式回到故事模式环境下即可正常加载所有脚本功能。如果安装后原生内置修改器没有正常调出界面,检查是否遗漏了NativeTrainer.asi文件的复制操作,该文件没有和核心dll文件放置在同一目录下就无法正常启用修改器功能。