冲刺希利雅德山 — 模组指南

一个适用于 GTA V Legacy（剧情模式）的模组：你直播间收到的礼物会变成游戏里的动作，每次获胜都会给悬浮窗的 Win 计数 +1。

TikForge GTA V 模组把你的 TikTok 直播和游戏连接起来：礼物、关注和点赞会触发 80 种动作（车辆、通缉等级、天气、敌人、黑洞、GTA 2 视角……），而你要在时限内从机场冲到希利雅德山顶。模组直接和网站通信，中间不需要任何其它程序。

所需条件

• PC 版 GTA V Legacy（Steam、Epic 或 Rockstar）。不是 Enhanced 版本，也不支持主机：最近购买 GTA V 的玩家往往只有 Enhanced 版，Legacy 版其实就在同一个游戏库里。
• 剧情模式。这个模组在 GTA Online 里不能用，也不要在联机中使用：会有封号风险。
• Windows 10/11，需要 .NET Framework 4.8（系统已自带）。
• 一个 TikForge 账号，并已在控制台（连接直播）里连接好直播。

安装

在控制台 → 游戏 → GTA V → 冲刺希利雅德山，下载模组压缩包，解压后：

1. 如果 GTA V 正在运行，先关闭它。
2. 双击 installa.bat：会请求管理员权限（因为 GTA V 装在 Program Files 里），自动查找游戏所在文件夹（Steam、Epic、Rockstar — 找不到会让你手动选择），下载或更新 Script Hook V 和 ScriptHookVDotNet，并把模组复制到 GTA V\scripts\。
3. 以剧情模式打开 GTA V，按 F10：会打开模组菜单。如果能看到，就说明安装成功了。

压缩包里还有一份 LEGGIMI.txt，内容和本指南一样。installa.bat 只在第一次安装时需要用：之后的更新模组会自己完成（见下文）。

将模组连接到网站

1. 在控制台 → 游戏 → GTA V → 冲刺希利雅德山：点密钥旁边的 复制。
2. 在游戏里：F10 → Mod → 从剪贴板粘贴密钥。
3. 菜单会显示"网站已连接"，控制台里的徽章也会变成 GTA 已连接。密钥会保存下来：下次会自动连接。

如果换了电脑，或者怀疑有人拿到了你的密钥：在控制台里点 重新生成，再粘贴新的密钥。重新连接到网站 和 删除密钥 这两个选项在同一个菜单里。

更新

不需要重新下载任何东西：每次启动时（以及通过 F10 → Mod → 检查更新），模组都会向网站确认有没有新版本，如果有就下载、校验完整性并安装。当出现"TikForge：已更新到 vX"时，按 INS 重新加载脚本，或者直接重启 GTA。想关掉这个自动功能可以取消勾选"启动时自动更新"。

礼物 → 动作

动作和礼物的关联在控制台的 事件与动作 标签页里设置：

1. 新建动作 → 类型选 GTA V → 从下拉菜单选择动作。同一行最多可以放 5 个 GTA V 动作。
2. 每个动作只会显示它需要的字段：星级（通缉等级）、车辆型号（生成车辆，留空为随机）、持续秒数（用于限时效果）、数量（用于批量生成）。其他动作没有参数。
3. 新建事件 → 选择具体礼物、关注、点赞、订阅……→ 关联到动作上。事件必须在当前选中的档案里。
4. 用模拟事件可以在不开播的情况下测试一切：动作会真的在游戏里发生。

模组自带的 TikForge.mapping.json 文件（礼物档位 → 动作，F10 → Mod → 重新加载）仍作为本地备用方案存在；一旦连接了网站，就以"事件与动作"里的规则为准。

80 种动作

和控制台下拉菜单里的一样，按分类列出。持续时间和数量是默认值：可以在动作那一行修改。

希利雅德山挑战赛

F10 → 希利雅德山挑战 → 开始 / 结束挑战：你会被传送到机场，倒计时开始，GPS 指向希利雅德山顶的金色圆圈。你需要到达那里，并在圆圈里停留够规定的秒数，同时观众们会给你添乱或帮你一把。每次获胜（或时间耗尽）后，挑战会自动重新开始。

菜单选项

• 倒计时 — 到达山顶的时限（分钟）。
• 圆圈内秒数 — 需要在金色圆圈内完成的倒数秒数（7-20 秒）。
• 指向山顶的 GPS — 自动在山顶设置路标。
• 屏幕计时器 — 显示在屏幕上方中央的倒计时。
• 悬浮窗 — 血条、距离米数和百分比。
• 获胜提示 — 挑战结束时的大字提示。
• 游戏规则 — 始终生效的规则：始终白天、通缉等级开/关、玩家无敌、小地图上方显示 TikForge 字样。
• 观众名字 — 在通过礼物生成的行人和车辆上方显示 TikTok 昵称，颜色固定不变。

悬浮窗、Win 与预设档案

• 每次获胜都会给网站悬浮窗（Overlay 标签页 → Win）的 Win 计数器 +1。游戏内没有任何计数器：一切以悬浮窗为准。
• Win 计数器跟随当前选中的事件与动作档案：切换档案就会看到该档案对应的胜场数。
• 游戏页面里有一个适配 OBS/TikTok Live Studio 的 1080×1920 悬浮窗，以及一个已配好 26 条规则 的档案（16 个礼物 → 动作，Win 档位 ±1/2/3/6/10）：可以用代码 GTA-CHILIAD 或 JSON 文件导入到事件与动作里。
• 要用礼物手动增减 Win 数，可使用 悬浮窗 Win 控制 动作。

常见问题

• F10 打不开菜单 — 缺少 Script Hook V 或 ScriptHookVDotNet：GTA V\ 目录下必须要有 ScriptHookV.dll、dinput8.dll 和 ScriptHookVDotNet3.dll。重新运行 installa.bat；如果下载失败，可以手动下载（dev-c.com 和 GitHub）后复制到 GTA V 文件夹里。
• Script Hook V 提示游戏版本不受支持 — GTA V 更新了，但 Script Hook V 还没跟上：等几天出新版本，再重新运行 installa.bat。
• 复制过程中提示"访问被拒绝" — GTA V 正在运行，或者你拒绝了管理员权限。
• 模组已连接但礼物没有反应 — 需要在控制台里连接好直播，并且 GTA V 动作要在当前选中的事件与动作档案里。
• 某个动作"什么都没发生" — 查看日志：%LOCALAPPDATA%\TikForge\TikForge.log。同一个目录里还有 TikForge.settings.json 和 TikForge.mapping.json。
• 卸载 — 删除 GTA V\scripts\ 目录下的 TikForge.dll、Fleck.dll 和 Newtonsoft.Json.dll。

需要帮助？

如果遇到问题或有疑问，欢迎在我们的 Discord 上开一个工单。

在 Discord 上开工单