PBZModLoader — cargador de mods

  • Phantom Blade Zero — PBZModLoader — cargador de mods
Autor:
LLKKFF
Tamaño:
12.76 MB
Fecha:
Hoy, 02:08
Descargas:
3
0.0 / 10
Nadie ha calificado el archivo

¿Has hecho tu propio mod?

Cárguelo en VGTimes: el archivo saldrá bajo su apodo, con un contador de descargas.
Subir archivo Cómo funciona

Este mod es un cargador de mods para Phantom Blade Zero compatible con javascript y TypeScript. La versión estable 1.0.0 incluye detección automática de los mods instalados, un compilador de TypeScript integrado y la posibilidad de recargar mods sin reiniciar el juego mediante el atajo Alt + F5.

El cargador es compatible con las versiones del juego para Steam y WeGame. Los jugadores no necesitan instalar Node.js, npm ni compiladores adicionales. También hay disponible una plantilla opcional para desarrolladores que incluye el SDK 0.3.3. El funcionamiento del cargador y de los mods en WeGame se ha probado directamente en el juego.

Características:

  • Detección automática de mods en la carpeta mods/<ID>/main.ts o main.js;
  • Prioridad de carga de los archivos TypeScript sobre javascript;
  • Compilador nativo de TypeScript integrado;
  • No es necesario instalar Node.js, npm ni compiladores adicionales;
  • Posibilidad de activar y desactivar mods individuales mediante mods.ini;
  • Recarga rápida de mods con Alt + F5;
  • Compatibilidad con funciones para limpiar recursos durante la recarga;
  • Notificaciones sobre cargas correctas, errores y mods omitidos;
  • Compatibilidad con Steam y WeGame;
  • Plantilla adicional para desarrollar mods con el SDK 0.3.3.

Compatibilidad y requisitos:

  • Windows x64;
  • Una copia con licencia de Phantom Blade Zero;
  • Versión estable del cargador: 1.0.0;
  • Compatible con la estructura de firmas original de Steam y con la actualización del juego del 4 de noviembre de 2026.

Es posible que sea necesario actualizar el cargador después de una actualización del juego. Si las firmas no coinciden o se detectan coincidencias ambiguas, el cargador omite los mods correspondientes. No se necesitan otros mods de Nexus Mods para que funcione el cargador.

Instalación:

  • Cierra el juego y abre la carpeta raíz de Phantom Blade Zero, que contiene el directorio ProjectPBZ;
  • Extrae el archivo principal directamente en la carpeta raíz del juego, combinando los directorios ProjectPBZ y platform. No crees una carpeta PBZModLoader anidada adicional;
  • Asegúrate de que el archivo version.dll esté junto al ejecutable del juego, no junto al lanzador;
  • El archivo incluye DLL independientes para Steam y WeGame: platform/steam/version.dll y platform/wegame/version.dll;
  • Inicia el juego desde el cliente habitual de la plataforma que utilices.

Se recomienda hacer copias de seguridad de los mods y de la configuración antes de actualizar el cargador. Para actualizarlo, sustituye version.dll, bootstrap.js, manager.js y el compilador integrado, pero conserva tus propios archivos mods.ini y la carpeta de mods.

Si utilizas una versión antigua cuya ruta es ProjectPBZ/Mods/PBZModLoader, mueve la configuración y los mods a ProjectPBZ/PBZModLoader y actualiza también la DLL.

Instalación y gestión de mods:

  • Coloca cada mod en una carpeta independiente dentro de ProjectPBZ/PBZModLoader/mods. Ejemplo de ruta:
    mods/my-mod/main.js.
  • Se recomienda usar letras latinas, números, guiones bajos y guiones en los nombres de las carpetas. No instales carpetas dist adicionales.
  • Los mods nuevos se detectan automáticamente. Para gestionarlos, utiliza el archivo ProjectPBZ/PBZModLoader/mods.ini: my-mod=0 — desactiva el mod. my-mod=1 — activa el mod;
  • Si no hay ninguna entrada, el mod está activado de forma predeterminada.
  • Para desactivar el cargador por completo, establece Enabled=0 en la sección [Loader] del archivo de configuración y reinicia el juego.

Recarga rápida (Alt + F5):

  • Para aplicar los cambios, guarda los archivos en la carpeta del mod instalado, vuelve al juego y pulsa Alt + F5. Si el mod se compila localmente, primero debes copiar los archivos generados en la carpeta de instalación.
  • La recarga se aplica al grupo completo de mods, incluidos los añadidos, eliminados y desactivados mediante mods.ini. El atajo solo funciona cuando el juego está en primer plano. No hay detección automática de cambios en los archivos.
  • Para limpiar correctamente los recursos, los mods deben exportar la función stop(). Esta función se utiliza para detener temporizadores, cancelar suscripciones a eventos y liberar recursos. También se admite la limpieza asíncrona, esperando a que termine.
El nombre y la descripción del archivo fueron traducidos. Mostrar original (RU)Mostrar traducción (ES)
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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.

Enlaces útiles:

Comentarios 0