UEBridge - 面向UE4SS的Lua桥接器

⚠️ 开发者工具 — 非游戏玩法模组
该模组本身不改变任何内容，也不添加任何游戏玩法内容。它是为模组制作者、逆向工程师和开发者搭建的通信桥梁，便于其外部脚本或AI编程代理在引擎运行时与之实时交互。

什么是UEBridge？
UEBridge 允许您电脑上运行的外部程序与当前活动会话进行通信 黎明行者之血 通过 UE4SS.

不必每次检查偏移量、验证对象引用或调整变量时都重启游戏，UEBridge可在引擎主线程内实时执行你的查询。

• AI 编程代理（MCP）： 将Claude Code、Claude Desktop、Cursor、Codex或任何Model Context Protocol客户端直接连接到运行中的游戏。
• 实况对象检查： 查询激活中 U类 实时检查实例、查看反射属性、变量类型及内存值。
• 运行时操控： 修改属性，调用 UFunction并传入参数，或实时评估原始Lua代码片段。
• 快照与差异： 在标签下跟踪任意对象的属性变化，播放，然后查看发生了什么变化。只读。
• 引擎指令与输出： 执行控制台命令或触发UE4SS模式转储器(美国地图, jmap, uht, cxx, 演员, 物件, 静态网格体) 通过编程方式。
  

工作原理与安全性
UEBridge 使用一种极简的、基于文件的 IPC（进程间通信）协议：

• 每50毫秒，游戏内Lua循环会检查一个文件是否存在。 request.json 在 ue4ss\bridge\.
• 当请求出现时，它会通过游戏线程执行。 在游戏线程中执行.
• 它将执行结果写入 .json 并产生结果。
  

安全与隐私：

• ❌ 无开放网络套接字或端口。
• ❌ 无后台守护进程或子进程执行。
• ❌ 零外部下载或遥测。
• 只有已在您电脑上本地运行、且对游戏文件夹拥有文件系统写入权限的软件，才能与其通信。
  

需求

• UE4SS 安装于 《黎明行者之血》. UEBridge不注册任何原生C++钩子；其Lua完全通过引擎线程执行，因此与你的UE4SS设置所使用的任何钩子配置均兼容。
• Python 3.10+（仅在使用命令行或MCP服务器时需要）。
  

安装与验证

解压模组
直接将下载的压缩包解压到存放游戏的文件夹中 ue4ss 目录和游戏可执行文件：

<Steam库>\steamapps\common\The Blood of Dawnwalker\Dawnwalker\Binaries\Win64\

存档结构与您的游戏文件夹对应，文件将自动放置到：

ue4ss\Mods\UEBridge\

不 mods.txt 需要编辑： 包含的内容 已启用.txt 文件会自动打开它。

2. 验证其已加载
启动游戏并检查 ue4ss\UE4SS.log. 你应该看到：

[UEBridge] v1.1.0 已就绪

3. 卸载
删除 ue4ss\Mods\UEBridge 文件夹，如果存在的话，还有临时 ue4ss\bridge 目录。



配置（scripts\settings.lua)
你可以在内部配置安全权限和模式 ue4ss\Mods\UEBridge\scripts\settings.lua:

• enabled = false — 暂时禁用桥接，无需卸载。
• allow_writes = false — 强制启用严格的只读模式。任何内容都不得通过桥接器改变游戏状态。
• allow_eval = false — 在保持结构化检查工具激活的同时，拒绝原始 Lua 评估。
• poll_ms = 50 — 请求文件的检查频率（单位：毫秒）。最小值为50，低于此值将被强制设为50。
• bridge_dir = "C:\\path" — 请求/响应文件夹的绝对路径覆盖（默认： ue4ss\bridge).
  

连接外部工具与AI代理（MCP服务器）

读写IPC请求文件的程序是 ue-bridge, 一款轻量级 Python 包。它能自动检测任何正在运行的 UE4SS 游戏，在 Binaries\Win64 配置中未包含路径的文件夹。

快速执行/安装：

uvx ue-bridge

或通过标准pip安装：

pip install ue-bridge

Claude桌面版配置
将以下模块添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ue-bridge": {
      "command": "uvx"
      "args": ["ue-bridge"]
    }
  }
}

Claude Code

claude mcp add ue-bridge -- uvx ue-bridge

光标 / 其他 MCP 客户端
通过 uvx ue-bridge （或者，使用pip， ue-bridge / python -m ue_bridge) 作为你的 MCP 服务器命令。参见 GitHub 自述文件 如需完整的客户端配置代码片段、工具架构和命令行指令，请参阅相关文档。



兼容性与验证
UEBridge 与具体游戏无关，可在任何受 UE4SS 支持虚幻引擎游戏上运行。已在以下平台上测试并验证：

• 无笑圣人的灯笼 (Steam版本，UE 5.8，项目 圣愚)
• 黎明行者之血 (Steam构建版, UE 5.5.4)
  

制作人员与许可

• 源码 littleRabbit94/ue桥接 (MIT许可证)
• 建立在 RE-UE4SS UE4SS-RE团队制作（MIT许可证）
• 使用AI编程代理工作流编写。