PBZModLoader — program ładujący modyfikacje

  • Phantom Blade Zero — PBZModLoader — program ładujący modyfikacje
Autor:
LLKKFF
Rozmiar:
12.76 MB
Data:
Dziś, 02:08
Pobrań:
3
0.0 / 10
Jeszcze nikt nie ocenił pliku

Zrobiliście swój mod?

Prześlij go na VGTimes: plik zostanie opublikowany pod twoim nickiem, z licznikiem pobrań.
Prześlij plik Jak to działa

Ten mod to program ładujący modyfikacje do Phantom Blade Zero, obsługujący javascript i TypeScript. Stabilna wersja 1.0.0 zawiera automatyczne wykrywanie zainstalowanych modyfikacji, wbudowany kompilator TypeScript oraz możliwość przeładowywania modów bez ponownego uruchamiania gry za pomocą skrótu Alt + F5.

Program obsługuje wersje gry na Steam i WeGame. Gracze nie muszą instalować Node.js, npm ani dodatkowych kompilatorów. Dostępny jest również opcjonalny szablon dla twórców, zawierający SDK 0.3.3. Działanie programu ładującego i modyfikacji na WeGame zostało sprawdzone bezpośrednio w grze.

Funkcje:

  • Automatyczne wykrywanie modyfikacji w folderze mods/<ID>/main.ts lub main.js;
  • Pliki TypeScript mają priorytet ładowania przed javascript;
  • Wbudowany natywny kompilator TypeScript;
  • Nie ma potrzeby instalowania Node.js, npm ani dodatkowych kompilatorów;
  • Możliwość włączania i wyłączania poszczególnych modyfikacji za pomocą mods.ini;
  • Szybkie przeładowywanie modyfikacji skrótem Alt + F5;
  • Obsługa funkcji czyszczenia zasobów podczas przeładowywania;
  • Powiadomienia o pomyślnym załadowaniu, błędach i pominiętych modyfikacjach;
  • Obsługa Steam i WeGame;
  • Dodatkowy szablon do tworzenia modyfikacji z SDK 0.3.3.

Zgodność i wymagania:

  • Windows x64;
  • Licencjonowana wersja Phantom Blade Zero;
  • Stabilna wersja programu ładującego 1.0.0;
  • Obsługa oryginalnej struktury sygnatur Steam oraz aktualizacji gry z 4 listopada 2026 roku.

Po aktualizacji gry może być konieczna aktualizacja programu ładującego. Jeśli sygnatury się nie zgadzają lub wykryte zostaną niejednoznaczne dopasowania, program pominie odpowiednie modyfikacje. Do działania samego programu ładującego nie są potrzebne inne modyfikacje z Nexus Mods.

Instalacja:

  • Zamknij grę i otwórz główny folder Phantom Blade Zero zawierający katalog ProjectPBZ;
  • Rozpakuj główne archiwum bezpośrednio do głównego folderu gry, łącząc katalogi ProjectPBZ i platform. Nie twórz dodatkowego, zagnieżdżonego folderu PBZModLoader;
  • Upewnij się, że plik version.dll znajduje się obok pliku wykonywalnego gry, a nie launchera;
  • Archiwum zawiera osobne pliki DLL dla Steam i WeGame: platform/steam/version.dll oraz platform/wegame/version.dll;
  • Uruchom grę za pomocą standardowego klienta używanej platformy.

Przed aktualizacją programu ładującego zaleca się utworzenie kopii zapasowych modyfikacji i konfiguracji. Podczas aktualizacji należy zastąpić pliki version.dll, bootstrap.js, manager.js i wbudowany kompilator, zachowując własny plik mods.ini oraz folder z modyfikacjami.

Jeśli używasz starszej wersji z lokalizacją ProjectPBZ/Mods/PBZModLoader, przenieś konfigurację i modyfikacje do ProjectPBZ/PBZModLoader, a także zaktualizuj plik DLL.

Instalowanie i zarządzanie modyfikacjami:

  • Każdą modyfikację należy umieścić w osobnym folderze w lokalizacji ProjectPBZ/PBZModLoader/mods. Przykładowa ścieżka:
    mods/my-mod/main.js.
  • W nazwach folderów zaleca się używać liter łacińskich, cyfr, podkreśleń i łączników. Nie należy instalować dodatkowych folderów dist.
  • Nowe modyfikacje są wykrywane automatycznie. Do zarządzania nimi służy plik ProjectPBZ/PBZModLoader/mods.ini: my-mod=0 — wyłącza modyfikację. my-mod=1 — włącza modyfikację;
  • Jeśli wpisu nie ma, modyfikacja jest domyślnie włączona.
  • Aby całkowicie wyłączyć program ładujący, ustaw parametr Enabled=0 w sekcji [Loader] pliku konfiguracyjnego i uruchom grę ponownie.

Szybkie przeładowywanie (Alt + F5):

  • Aby zastosować zmiany, zapisz pliki w folderze zainstalowanej modyfikacji, przełącz się do gry i naciśnij Alt + F5. Jeśli modyfikacja jest kompilowana lokalnie, gotowe pliki trzeba najpierw skopiować do jej zainstalowanego folderu.
  • Przeładowanie obejmuje całą grupę modyfikacji, w tym dodane, usunięte i wyłączone za pomocą mods.ini. Skrót klawiszowy działa tylko wtedy, gdy gra jest na pierwszym planie. Zmiany plików nie są śledzone automatycznie.
  • Aby poprawnie zwalniać zasoby, modyfikacje muszą eksportować funkcję stop(). Służy ona do zatrzymywania timerów, odłączania się od zdarzeń i zwalniania zasobów. Obsługiwane jest asynchroniczne czyszczenie z oczekiwaniem na jego zakończenie.
Nazwa i opis pliku zostały przetłumaczone Pokaż oryginał (RU)Pokaż tłumaczenie (PL)
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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.

Przydatne linki:

Komentarze 0