UE4SS脚本兼容补丁封面

UE4SS脚本兼容补丁

影之刃零
工具与前置

MOD介绍

UE4SS C++ 模组  ◆  不更改任何游戏文件  ◆  让 PAK 模组恢复可用  ◆  STEAM 构建版本 26367565

你的 pak 模组又能用了。
2026 年 11 月 4 日的游戏更新导致《影之刃零》拒绝加载任何被修改过的游戏脚本。所有修改了游戏脚本的 JavaScript pak 模组都会导致主菜单损坏。本模组可让它们恢复可用,且不会改动其他任何内容。

▸ 最简单的安装方式: 将下载的文件拖放到 Phantom Blade Mod Manager 上。它会把文件放到正确位置,并同时安装 UE4SS。

已在 GitHub 上开源(GPL-3.0)  ▸  源代码、全部发行版本及更新日志

━━━━━━━━━━━━━━  ◆  ━━━━━━━━━━━━━━

◆ 你需要这个模组吗?
如果某个《影之刃零》模组在更新后停止工作,并显示错误的菜单文本(例如 {Button Text})或导致主菜单损坏,你就需要本模组。这些都是 JavaScript pak 模组,而游戏现在会拒绝加载它们。安装本模组后,它们便可再次加载。如果你的模组都没有失效,就不需要安装。

◆ 概览
▸ 功能:允许《影之刃零》自身列出的脚本再次包含修改内容,从而加载 JavaScript pak 模组
▸ 作用范围:仅限游戏自身列出的 218 个脚本;不会添加新脚本,也不会改动其他任何内容
▸ 类型:UE4SS C++ 模组,不更改任何游戏文件
▸ 需要:适用于《影之刃零》的 UE4SS
▸ 设计上确保安全:会先检查游戏和 UE4SS 的确切构建版本;遇到任何无法识别的构建版本时都会保持关闭
▸ 已测试:Steam 构建版本 26367565(CL-302256_JKS-17280),UE4SS v3.0.1-1195-g1ceefac8

◆ 功能说明

• 让 pak 模组恢复可用: 游戏拒绝加载被修改过的脚本  →  允许游戏自身列出的脚本再次包含模组修改内容,从而正常加载 pak 模组
• 有意限制作用范围:它仅重新允许游戏自身列出的 218 个脚本。它不会加载任何新脚本,也不会改动游戏中的其他任何内容。
• 谨慎运行:它会在执行任何操作前检查游戏和 UE4SS 文件的确切版本。遇到无法识别的构建版本时,它会保持关闭,因此绝不会在错误的版本上运行。
单独使用时,它不会带来任何可见变化。它是一个辅助模组,用于让你安装的其他模组正常发挥作用。

◆ 安装
第一步:安装 UE4SS
本模组需要 UE4SS。官方版 UE4SS 无法在本游戏中启动任何模组,因此请使用专为《影之刃零》制作的版本,例如 UE4SS FIX。
最简单的方法:在 Phantom Blade Mod Manager 中,先安装 UE4SS(UE4SS ▸ 安装 UE4SS… ▸ 从文件安装…,然后选择下载的 UE4SS FIX 文件)。之后将本模组的下载文件拖放到窗口中,再将你的 pak 模组也拖放进去。

手动安装:

• 安装适用于《影之刃零》的 UE4SS,例如 UE4SS FIX。
• 下载主文件。
• 在游戏文件夹中,打开 platform/steam(其中包含较大的 PBZ.exe 的文件夹)。
• 将 zip 压缩包解压到此处。它会添加文件夹 ue4ss/Mods/phantombladezero_cppbypass。UE4SS 会自行启动该模组。
• 像往常一样,将你的 JavaScript pak 模组放入 ProjectPBZ/Content/Paks/~mods。
• 启动游戏。
▸ 确认是否正常运行: platform/steam/ue4ss/Mods/phantombladezero_cppbypass/compatibility.log 中应有一行“Both validators hooked”,并且每个 pak 模组都应有一行“Allowed listed project script”。
▸ 重启:添加、移除或替换此模组后,必须彻底重启游戏。
▸ 卸载:删除文件夹 ue4ss/Mods/phantombladezero_cppbypass,或在管理器中关闭此模组。

◆ 工作原理
游戏会保存一份自带脚本的列表,并拒绝任何被修改过的脚本。此模组会挂钩读取脚本内容的两项检查,并放行游戏列表中原有的脚本(project/… 下的 .js 和 .json 文件)。其他所有脚本仍会接受原本的检查,不作任何改动。因此,编辑了游戏原有脚本的 pak 模组可以正常加载,而其他方面的安全限制不会被削弱:不会运行任何新脚本,游戏其余部分也不会受到影响。模组会在挂钩前通过指纹精确核验 PBZ.exe 和 UE4SS,因此只会在其适配的特定版本上运行。

◆ 兼容性
✔ 需要适用于《影之刃零》的 UE4SS(构建版本 v3.0.1-1195-g1ceefac8)。
✔ 恢复因更新而失效的 JavaScript pak 模组。
✔ 兼容 UE4SS Lua 模组;不会修改任何游戏文件。
⚠ 请勿与 PBZModLoader 等其他脚本加载器同时运行:两者都会修改游戏中的同一项检查,混用情况未经测试。
↻ 游戏或 UE4SS 更新后:此模组仅适配一个特定构建版本。在新版本中,它会保持关闭状态(不会造成危险),而你的 pak 模组也将无法加载,直至此模组的新构建版本发布。
○ 实验性。已在上述构建版本中测试:游戏可以启动,其他 UE4SS 模组仍能正常运行,pak 模组也能加载。

◆ 开源
所有内容均已发布在 GitHub 上,并采用 GNU GPL v3 许可证。你可以查看其具体工作原理、自行构建(python tools/build.py),并核对下载文件是否与代码一致。游戏更新后,可以使用仓库中的工具将其重新适配到新的构建版本。欢迎贡献代码和修复。

◆ 特别鸣谢

• UE4SS 团队及其贡献者——感谢他们开发了运行此模组所需的 RE-UE4SS。
• Tsuda Kageyu 及其贡献者——感谢他们开发了本模组所使用的挂钩库 MinHook。
• PBZModLoader 的作者——其加载器展示了一种限定于特定文件夹的实现方式;本模组采用独立的开源设计。
• S-GAME——感谢其开发《影之刃零》。

━━━━━━━━━━━━━━  ◆  ━━━━━━━━━━━━━━
KINTARO 制作的更多《影之刃零》模组

• 《影之刃零》模组管理器 - 安装、启用、停用、更新和移除模组及 UE4SS
• UE4SS 修复版 - 已为《影之刃零》配置完毕的 UE4SS
• 动作取消 - 可通过闪避或防御取消自己的攻击动作(PAK 模组;需要本模组)
• 解锁 66 天 - 首次游玩即可进入“66 天”模式(PAK 模组;需要本模组)
• 以刃为生 - 无葫芦:闪避和精准格挡可为你恢复生命值
• 被动恢复 - 生命值会自行恢复
• 魔女时间 - 闪避或精准格挡可使整个世界减速
• 天堂或地狱 - 格挡或闪避后,每次攻击都能一击必杀
• 凡人暮色 - 死亡一次即会结束当前“66 天”流程

由 Kintaro 制作。采用 GNU 通用公共许可证第 3 版:可自由使用、修改和分享,修改后的版本也必须以相同许可证保持开源。请在 GitHub 上查看源代码,并确认下载内容与其一致。UE4SS 由 UE4SS-RE 团队制作;MinHook 由 Tsuda Kageyu 及其他贡献者制作。《影之刃零》归 S-GAME 所有。