PBZModLoader — завантажувач модифікацій

  • Phantom Blade Zero — PBZModLoader — завантажувач модифікацій
Автор:
LLKKFF
Розмір:
12.76 MB
Дата:
Сьогодні, 02:08
Завантажень:
3
0.0 / 10
Ще ніхто не оцінив файл

Створили свій мод?

Завантажте його на VGTimes: файл вийде під вашим ніком, зі лічильником завантажень.
Завантажити файл Як це працює

Цей мод є завантажувачем модифікацій для 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(). Вона використовується для зупинки таймерів, відписки від подій і звільнення ресурсів. Підтримується асинхронне очищення з очікуванням його завершення.
Назва та опис файлу були перекладені Показати оригінал (RU)Показати переклад (UK)
PBZModLoader — загрузчик модификаций

Данный мод представляет собой загрузчик модификаций для 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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.

Корисні посилання:

Коментарі 0