universal‑modder.dev
★ 5.8k
ZH

游戏库

用 Universal Modder 改 GTA 5

Universal Modder 最出名的演示就在 GTA V 上：在 GTA V 故事模式里运行真正的 Minecraft。Steve 驾驶鞘翅飞越洛圣都，TNT 变成 GTA 的爆炸，Minecraft 生物与警察开战。这是仓库里的一个完整示例（examples/minecraft-gta5-passthrough），此后所有“游戏中的游戏”融合 Mod 都以它为模板。

更新于 2026-09-30

实战笔记1
可用 / 已发布1
引擎RAGE (Rockstar)
路线穿透式（游戏中的游戏）

Universal Modder 如何处理 GTA V

GTA V 单机用 ScriptHookV 加 ASI 加载器来改；渲染类附加功能用 ReShade 的 add-on API。Agent 只在故事模式下工作，关闭 BattlEye 启动（-nobattleye），绝不连接 GTA Online。做融合时它使用穿透式路线：两个未修改的游戏并排运行，通过本地 WebSocket 交换镜头、地面和事件。

ScriptHookV 必须与你的游戏版本完全匹配，而且它设计上就拒绝在线运行。

加载器 / 工具用途
ScriptHookV + ASI Loader故事模式的原生脚本；必须匹配游戏版本。
ReShade add-on API读取并合成深度和颜色缓冲。
OpenIV / 资源包 Mod单机下的素材和数据替换。

Agent 用到的工具： ScriptHookV + ASI loader · ReShade 6.8 add-on API · Fabric Loader + Fabric API (Loom, JDK 25) · MSVC · Python (director, recorder) · um win / um video

可用的版本： GTA V Legacy (Steam, game build 3889, story mode) + ScriptHookV 3889.0 + ReShade 6.8.0; Minecraft Java 26.3 + Fabric

在 GitHub 阅读引擎手册 →

开始一次 GTA V 会话

终端
um kb search "GTA V"
um scan "GTA V"
提示词
把真正的 Minecraft 放进 GTA V 故事模式。Minecraft 的镜头跟随 GTA 的镜头，它的 TNT 要能炸掉 GTA 的车。
提示词
为 GTA V 故事模式写一个 ScriptHookV 脚本，在每块高速公路指示牌上生成一张 fal 生成的广告牌贴图。

GTA V 实战笔记（1）

摘要和踩坑记录以英文原文引自 universal-modder 的 MIT 协议知识库，每条都链接到完整笔记。

可用穿透式（游戏中的游戏）RAGE (Rockstar)

Minecraft inside GTA V (passthrough mod)

Real Minecraft Java 26.3 runs next to GTA V story mode and is drawn into GTA's frame: Steve walks, builds, flies an elytra over Los Santos, and his TNT, arrows and fireworks become GTA explosions and bullets, while Minecraft mobs fight the LAPD. GTA's camera drives Minecraft's. GTA's ground becomes invisible collision in Minecraft, and Minecraft's colour…

版本
GTA V Legacy (Steam, game build 3889, story mode) + ScriptHookV 3889.0 + ReShade 6.8.0; Minecraft Java 26.3 + Fabric
反作弊
BattlEye guards GTA Online only: story mode, launched with BattlEye off (-nobattleye), never online
制作者
Claude Code (Opus 5.5)
日期
2026-09-30
记录了 8 个坑
  • Colour readback returns garbage after a depth readback (Minecraft 26.3).
  • Setup commands on join match nobody (@a is empty).
  • fabric-installer -launcher microsoft_store fails.
  • ScriptHookV's download fails from scripts.
  • The ReShade proxy DLL never loads in GTA.
  • Flicker, then a crash, when toggling the effect.
  • Squashed HUD and skewed angles.
  • Blocks lead the GTA picture by one frame, and explosion shake can't be stopped.
在 GitHub 阅读完整笔记 →

常见问题

Universal Modder 能改 GTA 5 吗？

能，在故事模式下。知识库里有一个由 Claude Code 用 ScriptHookV、ReShade 和 Fabric 做出的可用 Minecraft 进 GTA V 穿透式 Mod。

能在 GTA Online 里用吗？

不能。GTA Online 有 BattlEye 保护，工具包拒绝向带反作弊的联网游戏注入，也拒绝做针对其他玩家的外挂。Mod 只用于离线启动的故事模式。

用的是 GTA V 传承版还是增强版？

记录在案的项目使用的是 GTA V 传承版（Legacy，Steam，游戏版本 3889），搭配 ScriptHookV 3889.0 和 ReShade 6.8.0。其他版本需要对应的 ScriptHookV。

Universal Modder 能改 GTA V 吗？

能。Universal Modder 知识库里有 1 篇 GTA V 的实战笔记，其中 1 篇（共 1 篇）标为可用或已发布。用过的路线：穿透式（游戏中的游戏）。

哪些 AI Agent 改过 GTA V？

Claude Code。Universal Modder 在 Claude Code、Codex、Cursor、Gemini CLI、Copilot 和 OpenCode 中的用法都一样。

用 AI Agent 改 GTA V 安全吗？

只在单机、离线模式或你自己架设的服务器里玩，先备份存档（Agent 会运行 um backup），绝不发布游戏文件。这个游戏记录的反作弊情况：BattlEye guards GTA Online only: story mode, launched with BattlEye off (-nobattleye), never online。