A third-person action-adventure that combines fast-paced combat with the aesthetics of wuxia—a Chinese genre about martial arts masters. The game... Read more
PBZModLoader — Mod Loader
-
Download (12.76 MB)November 6, 2026, 02:08 AMpbzmodloader-zagruzchik-modifikacijj_1793920128_569768.zip
This mod is a mod loader for Phantom Blade Zero that supports javascript and TypeScript. Stable version 1.0.0 includes automatic detection of installed mods, a built-in TypeScript compiler, and the ability to reload mods without restarting the game using the Alt + F5 keyboard shortcut.
The loader supports the Steam and WeGame versions of the game. Players do not need to install Node.js, npm, or additional compilers. An optional developer template that includes SDK 0.3.3 is also available. The loader and mods have been tested in-game on WeGame.
Features:
- Automatically detects mods in the mods/<ID>/main.ts or main.js folder;
- Prioritizes TypeScript files over javascript;
- Built-in native TypeScript compiler;
- No need to install Node.js, npm, or additional compilers;
- Enable or disable individual mods through mods.ini;
- Hot-reload mods with Alt + F5;
- Supports resource cleanup functions during reloads;
- Displays notifications for successful loads, errors, and skipped mods;
- Supports Steam and WeGame;
- Optional mod development template with SDK 0.3.3.
Compatibility and requirements:
- Windows x64;
- Licensed copy of Phantom Blade Zero;
- Stable version 1.0.0 of the loader;
- Supports the original Steam signature structure and the game update dated November 4, 2026.
The loader may need to be updated after a game update. If signatures do not match or ambiguous matches are detected, the loader skips the affected mods. No other Nexus Mods mods are required for the loader to work.
Installation:
- Close the game and open the Phantom Blade Zero root folder containing the ProjectPBZ directory;
- Extract the main archive directly into the game root folder, merging the ProjectPBZ and platform directories. Do not create an additional nested PBZModLoader folder;
- Make sure version.dll is located next to the game executable, not the launcher;
- The archive includes separate DLLs for Steam and WeGame: platform/steam/version.dll and platform/wegame/version.dll;
- Launch the game through the regular client for your platform.
Before updating the loader, it is recommended that you back up your mods and configuration. To update, replace version.dll, bootstrap.js, manager.js, and the built-in compiler, while keeping your own mods.ini file and mods folder.
If you are using an older version with the ProjectPBZ/Mods/PBZModLoader folder structure, move your configuration and mods to ProjectPBZ/PBZModLoader and update the DLLs.
Installing and managing mods:
- Place each mod in its own folder at ProjectPBZ/PBZModLoader/mods. Example path:
mods/my-mod/main.js. - Folder names should use Latin letters, numbers, underscores, and hyphens. Do not install additional dist folders.
- New mods are detected automatically. Manage them using the ProjectPBZ/PBZModLoader/mods.ini file: my-mod=0 disables the mod; my-mod=1 enables the mod;
- If an entry is missing, the mod is enabled by default.
- To disable the loader completely, set Enabled=0 in the [Loader] section of the configuration file and restart the game.
Hot reload (Alt + F5):
- To apply changes, save the files in the installed mod folder, switch to the game, and press Alt + F5. If you build the mod locally, copy the resulting files to the installed folder first.
- Reloading applies to the entire group of mods, including those that have been added, removed, or disabled through mods.ini. The keyboard shortcut works only when the game is in the foreground. File changes are not monitored automatically.
- For proper resource cleanup, mods must export a stop() function. It is used to stop timers, unsubscribe from events, and release resources. Asynchronous cleanup is supported, and the loader waits for it to finish.
Данный мод представляет собой загрузчик модификаций для 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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.
Useful links:
