A third-person action-adventure that combines fast-paced combat with the aesthetics of wuxia—a Chinese genre about martial arts masters. The game... 更多信息
PBZModLoader — 模组加载器
-
下载 (12.76 MB)2026年11月6日, 02:08pbzmodloader-zagruzchik-modifikacijj_1793920128_569768.zip
此模组是 Phantom Blade Zero 的模组加载器，支持 javascript 和 TypeScript。稳定版 1.0.0 支持自动检测已安装的模组、内置 TypeScript 编译器，以及通过 Alt + F5 快捷键在不重启游戏的情况下重新加载模组。
加载器支持 Steam 和 WeGame 版本。玩家无需安装 Node.js、npm 或额外编译器。另提供可选的开发者模板，其中包含 SDK 0.3.3。已在游戏中直接验证加载器和模组可在 WeGame 上运行。
特色：
- 自动检测 mods/<ID>/main.ts 或 main.js 文件夹中的模组；
- TypeScript 文件的加载优先级高于 javascript；
- 内置原生 TypeScript 编译器；
- 无需安装 Node.js、npm 或额外编译器；
- 可通过 mods.ini 启用或停用单个模组；
- 使用 Alt + F5 热重载模组；
- 支持在重载时清理资源；
- 显示加载成功、错误及跳过模组的通知；
- 支持 Steam 和 WeGame；
- 额外提供基于 SDK 0.3.3 的模组开发模板。
兼容性与要求：
- Windows x64；
- 正版 Phantom Blade Zero；
- 加载器稳定版 1.0.0；
- 支持 Steam 的原始签名结构以及 2026 年 11 月 4 日的游戏更新。
游戏更新后，加载器可能也需要更新。如果签名不匹配或检测到多个可能匹配项，加载器会跳过相应模组。加载器本身不需要其他 Nexus Mods 模组。
安装：
- 关闭游戏，并打开包含 ProjectPBZ 目录的 Phantom Blade Zero 根目录；
- 将主压缩包直接解压到游戏根目录，并合并 ProjectPBZ 和 platform 目录。不要额外创建嵌套的 PBZModLoader 文件夹；
- 确认 version.dll 与游戏可执行文件位于同一目录，而不是与启动器放在一起；
- 压缩包中为 Steam 和 WeGame 分别提供了 DLL：platform/steam/version.dll 和 platform/wegame/version.dll；
- 通过所用平台的常规客户端启动游戏。
建议在更新加载器前备份模组和配置。更新时需要替换 version.dll、bootstrap.js、manager.js 和内置编译器，同时保留自己的 mods.ini 文件和模组文件夹。
如果使用的是旧版本，目录为 ProjectPBZ/Mods/PBZModLoader，则需要将配置和模组迁移至 ProjectPBZ/PBZModLoader，并更新 DLL。
安装和管理模组：
- 每个模组都应放入 ProjectPBZ/PBZModLoader/mods 路径下的独立文件夹中。示例路径：
mods/my-mod/main.js。 - 文件夹名称建议使用拉丁字母、数字、下划线和连字符。请勿安装额外的 dist 文件夹。
- 新模组会自动检测。使用 ProjectPBZ/PBZModLoader/mods.ini 文件管理模组：my-mod=0 — 停用模组。my-mod=1 — 启用模组；
- 如果没有对应条目，模组默认启用。
- 如需完全停用加载器，请在配置文件的 [Loader] 部分将 Enabled=0，然后重启游戏。
热重载（Alt + F5）：
- 要应用更改，请将文件保存到已安装的模组文件夹中，切回游戏并按 Alt + F5。如果模组是在本地构建的，请先将生成的文件复制到已安装的文件夹中。
- 重载会作用于整个模组组，包括新增的模组、已移除的模组，以及通过 mods.ini 停用的模组。只有游戏位于前台时，快捷键才有效。加载器不会自动监视文件更改。
- 为正确清理资源，模组应导出 stop() 函数。该函数用于停止计时器、取消事件订阅并释放资源。支持异步清理，并会等待清理完成。
Данный мод представляет собой загрузчик модификаций для Phantom Blade Zero, поддерживающий javascript и TypeScript. Стабильная версия 1.0.0 включает автоматическое обнаружение установленных модификаций, встроенный компилятор TypeScript и возможность перезагрузки модов без перезапуска игры с помощью сочетания клавиш Alt + F5.
Загрузчик поддерживает версии игры для Steam и WeGame. Для игроков не требуется устанавливать Node.js, npm или дополнительные компиляторы. Также доступен необязательный шаблон для разработчиков, включающий SDK 0.3.3. Работа загрузчика и модификаций на WeGame проверена непосредственно в игре.
Особенности:
- Автоматическое обнаружение модификаций в папке mods/<ID>/main.ts или main.js;
- Приоритет загрузки файлов TypeScript перед javascript;
- Встроенный нативный компилятор TypeScript;
- Отсутствие необходимости устанавливать Node.js, npm и дополнительные компиляторы;
- Возможность включать и отключать отдельные модификации через mods.ini;
- Горячая перезагрузка модификаций с помощью Alt + F5;
- Поддержка функций очистки ресурсов при перезагрузке;
- Отображение уведомлений об успешной загрузке, ошибках и пропущенных модификациях;
- Поддержка Steam и WeGame;
- Дополнительный шаблон для разработки модификаций с SDK 0.3.3.
Совместимость и требования:
- Windows x64;
- Лицензионная версия Phantom Blade Zero;
- Стабильная версия загрузчика 1.0.0;
- Поддержка оригинальной структуры сигнатур Steam и обновления игры от 4 ноября 2026 года.
После обновления игры загрузчику может потребоваться обновление. Если сигнатуры не совпадают или обнаружены неоднозначные соответствия, загрузчик пропускает соответствующие модификации. Для работы самого загрузчика другие модификации с Nexus Mods не требуются.
Установка:
- Закрыть игру и открыть корневую папку Phantom Blade Zero, содержащую директорию ProjectPBZ;
- Распаковать основной архив непосредственно в корневую папку игры, объединив директории ProjectPBZ и platform. Не создавать дополнительную вложенную папку PBZModLoader;
- Убедиться, что файл version.dll находится рядом с исполняемым файлом игры, а не лаунчером;
- В архиве предусмотрены отдельные DLL для Steam и WeGame: platform/steam/version.dll и platform/wegame/version.dll;
- Запустить игру через обычный клиент используемой платформы.
Перед обновлением загрузчика рекомендуется сохранить резервные копии модификаций и конфигурации. При обновлении необходимо заменить version.dll, bootstrap.js, manager.js и встроенный компилятор, сохранив собственные файлы mods.ini и папку с модификациями.
Если используется старая версия с расположением ProjectPBZ/Mods/PBZModLoader, необходимо перенести конфигурацию и модификации в ProjectPBZ/PBZModLoader, а также обновить DLL.
Установка и управление модификациями:
- Каждую модификацию необходимо поместить в отдельную папку по пути ProjectPBZ/PBZModLoader/mods. Пример расположения:
mods/my-mod/main.js. - Для названий папок рекомендуется использовать латинские буквы, цифры, подчёркивания и дефисы. Не следует устанавливать дополнительные папки dist.
- Новые модификации обнаруживаются автоматически. Для управления ими используется файл ProjectPBZ/PBZModLoader/mods.ini: my-mod=0 — отключение модификации. my-mod=1 — включение модификации;
- Если запись отсутствует, модификация включена по умолчанию.
- Для полного отключения загрузчика необходимо установить параметр Enabled=0 в разделе [Loader] файла конфигурации и перезапустить игру.
Горячая перезагрузка (Alt + F5):
- Для применения изменений необходимо сохранить файлы в установленной папке модификации, переключиться в игру и нажать Alt + F5. Если модификация собирается локально, готовые файлы предварительно нужно скопировать в установленную папку.
- Перезагрузка применяется ко всей группе модификаций, включая добавленные, удалённые и отключённые через mods.ini. Сочетание клавиш работает только тогда, когда игра находится на переднем плане. Автоматического отслеживания изменений файлов нет.
- Для корректной очистки ресурсов модификации должны экспортировать функцию stop(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.
有用的链接：
