PBZModLoader — mod yükleyicisi

  • Phantom Blade Zero — PBZModLoader — mod yükleyicisi
Yazar:
LLKKFF
Boyut:
12.76 MB
Tarih:
Bugün, 02:08
İndirmeler:
3
0.0 / 10
Henüz kimse dosyayı değerlendirmedi.

Kendi modunuzu mu yaptınız?

Bunu VGTimes'a yükleyin: dosya, kullanıcı adınızla birlikte, indirme sayacıyla çıkacak.
Dosya Yükle Bu nasıl çalışır

Bu mod, javascript ve TypeScript destekleyen Phantom Blade Zero mod yükleyicisidir. 1.0.0 kararlı sürümü; yüklü modların otomatik olarak algılanmasını, yerleşik TypeScript derleyicisini ve Alt + F5 tuş kombinasyonuyla oyunu yeniden başlatmadan modları yeniden yükleme olanağını içerir.

Yükleyici, oyunun Steam ve WeGame sürümlerini destekler. Oyuncuların Node.js, npm veya ek derleyiciler kurması gerekmez. Ayrıca SDK 0.3.3 içeren isteğe bağlı bir geliştirici şablonu da mevcuttur. Yükleyicinin ve modların WeGame üzerindeki çalışması doğrudan oyun içinde test edilmiştir.

Özellikler:

  • mods/<ID>/main.ts veya main.js klasöründeki modların otomatik olarak algılanması;
  • TypeScript dosyalarının javascript dosyalarına göre yükleme önceliği;
  • Yerleşik yerel TypeScript derleyicisi;
  • Node.js, npm ve ek derleyicileri kurma gereksiniminin olmaması;
  • mods.ini üzerinden belirli modları etkinleştirme ve devre dışı bırakma;
  • Alt + F5 ile modları yeniden yükleme;
  • Yeniden yükleme sırasında kaynak temizleme işlevlerinin desteği;
  • Başarılı yükleme, hata ve atlanan modlarla ilgili bildirimler;
  • Steam ve WeGame desteği;
  • SDK 0.3.3 içeren ek mod geliştirme şablonu.

Uyumluluk ve gereksinimler:

  • Windows x64;
  • Phantom Blade Zero'nun lisanslı sürümü;
  • Yükleyicinin 1.0.0 kararlı sürümü;
  • Steam'in özgün imza yapısının ve 4 Kasım 2026 tarihli oyun güncellemesinin desteklenmesi.

Oyun güncellendikten sonra yükleyicinin de güncellenmesi gerekebilir. İmzalar eşleşmiyorsa veya belirsiz eşleşmeler algılanırsa yükleyici ilgili modları atlar. Yükleyicinin kendisinin çalışması için Nexus Mods'tan başka modlar gerekmez.

Kurulum:

  • Oyunu kapatın ve ProjectPBZ klasörünün bulunduğu Phantom Blade Zero kök klasörünü açın;
  • Ana arşivi doğrudan oyunun kök klasörüne çıkarıp ProjectPBZ ve platform klasörlerini birleştirin. Ek bir PBZModLoader alt klasörü oluşturmayın;
  • version.dll dosyasının başlatıcıyla değil, oyunun çalıştırılabilir dosyasıyla aynı klasörde bulunduğundan emin olun;
  • Arşivde Steam ve WeGame için ayrı DLL dosyaları bulunur: platform/steam/version.dll ve platform/wegame/version.dll;
  • Oyunu kullandığınız platformun normal istemcisi üzerinden başlatın.

Yükleyiciyi güncellemeden önce modlarınızın ve yapılandırmanızın yedeklerini almanız önerilir. Güncelleme sırasında version.dll, bootstrap.js, manager.js ve yerleşik derleyiciyi değiştirin; kendi mods.ini dosyanızı ve mod klasörünüzü koruyun.

ProjectPBZ/Mods/PBZModLoader dizinini kullanan eski bir sürümünüz varsa yapılandırmayı ve modları ProjectPBZ/PBZModLoader konumuna taşıyın ve DLL'yi de güncelleyin.

Modları kurma ve yönetme:

  • Her mod, ProjectPBZ/PBZModLoader/mods yolunda kendine ait ayrı bir klasöre yerleştirilmelidir. Örnek konum:
    mods/my-mod/main.js.
  • Klasör adlarında Latin harfleri, rakamlar, alt çizgiler ve tireler kullanılması önerilir. Ek dist klasörleri kurmayın.
  • Yeni modlar otomatik olarak algılanır. Modları yönetmek için ProjectPBZ/PBZModLoader/mods.ini dosyasını kullanın: my-mod=0 — modu devre dışı bırakır. my-mod=1 — modu etkinleştirir;
  • Bir kayıt yoksa mod varsayılan olarak etkinleştirilir.
  • Yükleyiciyi tamamen devre dışı bırakmak için yapılandırma dosyasının [Loader] bölümündeki Enabled=0 parametresini ayarlayıp oyunu yeniden başlatın.

Modları yeniden yükleme (Alt + F5):

  • Değişiklikleri uygulamak için kurulu mod klasöründeki dosyaları kaydedin, oyuna geçin ve Alt + F5 tuşlarına basın. Mod yerel olarak derleniyorsa hazırlanan dosyaları önce kurulu klasöre kopyalayın.
  • Yeniden yükleme işlemi; eklenen, silinen ve mods.ini üzerinden devre dışı bırakılan modlar dâhil tüm mod grubuna uygulanır. Tuş kombinasyonu yalnızca oyun ön plandayken çalışır. Dosya değişiklikleri otomatik olarak izlenmez.
  • Kaynakların düzgün temizlenmesi için modların stop() işlevini dışa aktarması gerekir. Bu işlev zamanlayıcıları durdurmak, olay aboneliklerini kaldırmak ve kaynakları serbest bırakmak için kullanılır. Temizleme işleminin tamamlanmasını bekleyen eşzamansız temizleme desteklenir.
Dosyanın adı ve açıklaması çevrildi Orijinalini göster (RU)Çeviriyi göster (TR)
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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.

Faydalı bağlantılar:

Yorumlar 0