PBZModLoader

PBZModLoader

用于《影之刃零》的JavaScript和TypeScript模组加载器。自动发现模组,使用内置编译器编译TypeScript,并支持Ctrl+F5热重载。无需安装Node.js。预览版;已在Steam测试,WeGame未验证。

[size=5][b]PBZModLoader[/b][/size]
一个非官方的《影之刃零》JavaScript 与 TypeScript MOD 加载器,使用游戏自带的 PuerTS 运行时。这是一个 MOD 框架;兼容的 MOD 需另行安装。

[size=4][b]推荐:使用 AI Agent 开发你的 MOD[/b][/size]
有想法但没有编程经验?你可以借助 AI 编程 Agent 和随附的 TypeScript 开发模板入门。用自然语言描述你想要的功能,让 Agent 帮你阅读 SDK、编写代码、构建 MOD 并排查错误。PBZModLoader 提供运行时;可选的模板为把想法变成可用 MOD 提供了一个实用的起点。

1. 下载可选的 TypeScript 开发模板,并在你的 AI 编程工具中打开解压后的文件夹。
2. 在做出任何修改之前,先让 Agent 阅读 README.md、vendor/game-api/README.md、src/main.ts 以及 SDK 声明文件。
3. 描述一个小而具体的功能。让 Agent 检查所需的游戏 API 是否存在,并解释任何未经验证的假设,而不是凭空编造 API。
4. 让 Agent 帮助你安装开发依赖,运行 npm run check 和 npm run build,并说明将生成的 MOD 文件夹复制到哪里。
5. 在游戏中测试,然后把观察到的行为和相关的日志行反馈给 Agent,逐步改进 MOD。支持的 MOD 可用 Ctrl+F5 热重载,并保留 stop() 清理逻辑。

开始学习这套工作流程不需要任何编程基础。你能构建什么取决于游戏提供的 API 和功能的复杂程度。AI 生成的代码仍需要类型检查和游戏内测试;仅构建成功并不能证明 MOD 可用。AI 工具是可选的开发辅助,既不随本加载器捆绑,也不是运行本加载器的必需条件。

[b]起始提示词[/b]
[quote]我是编程新手,想用 PBZModLoader 开发一个《影之刃零》MOD。请先阅读这个模板的 README、SDK 文档和示例入口。帮我实现这个功能:[描述你的想法]。检查可用的 API,指出需要在游戏内验证的部分,并从最小可用版本开始。保留 stop() 清理逻辑,运行类型检查和构建,并一步步说明安装和测试方法。不要编造游戏 API,也不要假设游戏内存在 Node.js API。[/quote]
[size=4][b]推荐使用 AI Agent 辅助开发:零编程经验也能开始[/b][/size]
即使没有编程经验,也可以借助 AI 编程 Agent 和随附的 TypeScript 开发模板,尝试把自己的想法做成可运行的 MOD。用自然语言描述你希望实现的功能,让 AI 帮助阅读 SDK、编写代码、编译构建和分析错误;PBZModLoader 负责在游戏中加载运行你的 MOD。
下载 Optional 开发模板,用 AI 编程工具打开模板文件夹,先让它阅读 README、SDK 说明和 src/main.ts,再从一个简单、明确的功能开始。完成 npm run check 和 npm run build 后,将产物安装进游戏,结合实际效果和日志逐步修改。支持热重载的 MOD 可用 Ctrl+F5 调试,并应保留 stop() 清理逻辑。
不需要先成为程序员才能开始,但具体功能能否实现取决于游戏开放的 API 和需求复杂度。AI 可能生成错误代码或不存在的接口,因此仍需类型检查和游戏实测。AI 工具是可选的开发辅助,并非加载器内置功能,玩家运行 MOD 时无需使用 AI。

[b]可直接复制给 AI 的提示词[/b]
[quote]我没有编程经验,想用 PBZModLoader 开发影之刃零 MOD。请先阅读这个模板的 README、SDK 文档和示例入口,帮助我实现:[填写你的功能想法]。先确认可用 API,列出需要游戏内验证的部分,从最小可用版本开始。保留 stop() 资源清理,执行类型检查和构建,并一步步解释安装和测试方法。不要编造游戏 API,也不要假设游戏中存在 Node.js API。[/quote]
[size=4][b]功能特性[/b][/size]
• 自动发现 mods/<ID>/main.ts 或 main.js(TypeScript 优先)。
• 内置原生 TypeScript 编译器:玩家无需安装 Node.js、npm 或额外编译器。
• 可通过 mods.ini 单独启用或禁用各个 MOD。
• Ctrl+F5 热重载,支持清理回调,并在屏幕上显示成功、失败或跳过的状态。
• 包含示例 MOD。可选的 TypeScript 开发模板包含游戏 API SDK 0.3.0。

[size=4][b]兼容性与要求[/b][/size]
Windows x64 以及正版安装的《影之刃零》。预览版 0.3.2-preview。签名基于 Steam 构建 CL-301524_JKS-17219;未来的游戏更新可能需要更新加载器。签名不匹配或有歧义会导致加载器跳过 MOD。
已测试 Steam 主菜单的热重载。该测试未验证关卡切换。WeGame 尚未在实际安装环境中测试;不保证兼容性。加载器本身不需要其他 Nexus MOD。

[size=4][b]安装 — 手动[/b][/size]
1. 退出游戏。打开游戏根目录(包含 ProjectPBZ 的文件夹)。
2. 将主 ZIP 直接解压到该文件夹,合并 ProjectPBZ 和 platform。不要额外多套一层 PBZModLoader 父文件夹。
3. 确认 version.dll 位于实际游戏可执行文件旁边,而不是启动器旁边。压缩包在 Steam 布局下将其放在 platform/steam/version.dll。对于其他布局,请将该 DLL 复制到实际游戏可执行文件旁边。
4. 通过你常用的平台客户端启动游戏。
更新前请备份你的 MOD 和配置。不要覆盖其他工具的 version.dll。请一起更新 DLL、bootstrap.js、manager.js 和内置编译器,同时保留你自己的 mods.ini 和 mods。
使用 ProjectPBZ/Mods/PBZModLoader 的旧版安装必须将其配置和 MOD 迁移到 ProjectPBZ/PBZModLoader,并更新 DLL。

[size=4][b]安装与管理 MOD[/b][/size]
将每个 MOD 文件夹放入 ProjectPBZ/PBZModLoader/mods,例如 mods/my-mod/main.js。文件夹名称请使用字母、数字、下划线或连字符。不要额外安装 dist 文件夹。
新 MOD 会被自动发现。在 ProjectPBZ/PBZModLoader/mods.ini 的 [Mods] 下,设置 my-mod=0 以禁用某个 MOD;删除该条目或使用 my-mod=1 以启用它。要禁用加载器,请在 [Loader] 下设置 Enabled=0 并重启。

[size=4][b]热重载 — Ctrl+F5[/b][/size]
在已安装的 MOD 文件夹中保存更改,切换到游戏并按 Ctrl+F5。本地构建的 MOD 必须先复制到已安装的文件夹中。重新加载应用于整个 MOD 组,包括新增、移除和 [Mods] 开关。热键仅在游戏处于前台时响应;不会自动监视文件。
MOD 必须导出 stop() 以清除定时器、取消订阅事件并释放资源。支持并等待异步清理。清理缺失或失败会保留旧实例并跳过替换。永不结束的 stop() 会阻塞后续重载。地图切换和游戏退出不会自动调用 stop()。
重新加载期间,TypeScript 编译失败会保留旧实例。修复后重试。如果入口执行失败,请在修复后重启游戏,以避免重复的部分初始化。启动时的编译仅转译语法;它不执行完整的类型检查,也不使用 MOD 的 tsconfig.json。

[size=4][b]开发者指南[/b][/size]
下载可选文件“PBZModLoader TS Dev Template - SDK 0.3.0”并解压到开发工作区,而不是游戏文件夹。开发电脑上需要 Node.js 和 npm。
运行 npm ci、npm run check,然后运行 npm run build。编辑 src/main.ts,并将 dist/my-mod 复制到 ProjectPBZ/PBZModLoader/mods。阅读随附的 README 和 SDK 文档,了解 API 限制和热重载清理。
SDK 提供 UE/PuerTS 类型声明,而不是运行时代码。生成的声明并不意味着每个 API 都已测试。游戏提供 ue 和 puerts 模块;不要直接用 Node.js 运行 MOD 入口文件。

[size=4][b]故障排查与卸载[/b][/size]
加载器日志:ProjectPBZ/PBZModLoader/evidence/<run>/loader.log。TypeScript 诊断信息也会出现在相关生成的 MOD 缓存内的 compile.log 中。
ProjectPBZ/Content/JavaScript/PBZModLoader 下的 generated-mods 和 generated-reloads 是自动缓存。游戏运行时不要编辑它们或删除它们。重启会清除/重建缓存。
卸载方法:退出游戏,备份你的 MOD 和设置,然后仅删除本加载器的 version.dll、ProjectPBZ/PBZModLoader 和 ProjectPBZ/Content/JavaScript/PBZModLoader。不要删除游戏整个 Content/JavaScript 文件夹或其他工具的 DLL。
报告问题时,请提供你的游戏构建版本、平台、加载器版本、复现步骤和相关日志行,并先移除任何个人路径或信息。

[size=4][b]致谢[/b][/size]
PBZModLoader 由 LLKKFF 开发。使用游戏自带的 PuerTS 运行时并捆绑 TypeScript 编译器;第三方声明和许可证包含在下载文件中。非官方社区项目,与游戏开发者无隶属关系,也未获其认可。

[size=4][b]中文安装提示[/b][/size]
退出游戏后,将主文件 ZIP 解压到含 ProjectPBZ 的游戏根目录。确认 version.dll 位于实际游戏 EXE 旁;Steam 包默认放在 platform/steam。更新前备份自己的配置和 MOD,不要覆盖其他工具的同名 DLL。
MOD 放入 ProjectPBZ/PBZModLoader/mods/<MOD ID>/,支持 main.ts 或 main.js。游戏前台按 Ctrl+F5 热重载;MOD 必须导出 stop() 清理资源。玩家无需安装 Node.js。开发模板为可选文件,需要在开发电脑安装 Node.js 和 npm。详细中文说明见压缩包中的安装说明和模板 README。
当前为预览版,WeGame 尚未实机验证。