PBZModLoader — carregador de modificações

  • Phantom Blade Zero — PBZModLoader — carregador de modificações
Autor:
LLKKFF
Tamanho:
12.76 MB
Data:
Hoje, 02:08
Downloads:
3
0.0 / 10
Ninguém avaliou o arquivo ainda.

Fez seu mod?

Carregue-o no VGTimes: o arquivo será publicado sob seu nome, com um contador de downloads.
Carregar arquivo Como isso funciona

Este mod é um carregador de modificações para Phantom Blade Zero, com suporte a javascript e TypeScript. A versão estável 1.0.0 inclui detecção automática de modificações instaladas, compilador de TypeScript integrado e a possibilidade de recarregar mods sem reiniciar o jogo usando o atalho Alt + F5.

O carregador é compatível com as versões do jogo para Steam e WeGame. Os jogadores não precisam instalar Node.js, npm ou compiladores adicionais. Também está disponível um modelo opcional para desenvolvedores, que inclui o SDK 0.3.3. O funcionamento do carregador e das modificações no WeGame foi testado diretamente no jogo.

Características:

  • Detecção automática de modificações na pasta mods/<ID>/main.ts ou main.js;
  • Prioridade de carregamento para arquivos TypeScript em relação a javascript;
  • Compilador nativo de TypeScript integrado;
  • Não é necessário instalar Node.js, npm nem compiladores adicionais;
  • Permite ativar e desativar modificações individualmente por meio de mods.ini;
  • Recarregamento rápido de modificações com Alt + F5;
  • Suporte a funções de limpeza de recursos durante o recarregamento;
  • Exibe notificações de carregamento bem-sucedido, erros e modificações ignoradas;
  • Compatível com Steam e WeGame;
  • Modelo adicional para desenvolvimento de modificações com o SDK 0.3.3.

Compatibilidade e requisitos:

  • Windows x64;
  • Uma cópia licenciada de Phantom Blade Zero;
  • Versão estável do carregador 1.0.0;
  • Suporte à estrutura original de assinaturas do Steam e à atualização do jogo de 4 de novembro de 2026.

Após uma atualização do jogo, talvez seja necessário atualizar o carregador. Se as assinaturas não corresponderem ou forem detectadas correspondências ambíguas, o carregador ignorará as modificações correspondentes. Não são necessárias outras modificações do Nexus Mods para que o próprio carregador funcione.

Instalação:

  • Feche o jogo e abra a pasta raiz de Phantom Blade Zero, que contém o diretório ProjectPBZ;
  • Extraia o arquivo principal diretamente na pasta raiz do jogo, mesclando os diretórios ProjectPBZ e platform. Não crie uma pasta PBZModLoader adicional dentro de outra pasta;
  • Verifique se o arquivo version.dll está ao lado do executável do jogo, e não do inicializador;
  • O arquivo inclui DLLs separadas para Steam e WeGame: platform/steam/version.dll e platform/wegame/version.dll;
  • Inicie o jogo pelo cliente habitual da plataforma utilizada.

Antes de atualizar o carregador, recomendamos fazer cópias de segurança das modificações e da configuração. Ao atualizar, substitua version.dll, bootstrap.js, manager.js e o compilador integrado, mantendo seus próprios arquivos mods.ini e a pasta de modificações.

Se estiver usando uma versão antiga com o caminho ProjectPBZ/Mods/PBZModLoader, transfira a configuração e as modificações para ProjectPBZ/PBZModLoader e atualize também a DLL.

Instalação e gerenciamento de modificações:

  • Cada modificação deve ser colocada em uma pasta separada no caminho ProjectPBZ/PBZModLoader/mods. Exemplo de localização:
    mods/my-mod/main.js.
  • Recomendamos usar letras latinas, números, sublinhados e hífens nos nomes das pastas. Não instale pastas dist adicionais.
  • As novas modificações são detectadas automaticamente. Para gerenciá-las, use o arquivo ProjectPBZ/PBZModLoader/mods.ini: my-mod=0 — desativa a modificação. my-mod=1 — ativa a modificação;
  • Se não houver uma entrada, a modificação fica ativada por padrão.
  • Para desativar completamente o carregador, defina o parâmetro Enabled=0 na seção [Loader] do arquivo de configuração e reinicie o jogo.

Recarregamento rápido (Alt + F5):

  • Para aplicar as alterações, salve os arquivos na pasta de instalação da modificação, volte ao jogo e pressione Alt + F5. Se a modificação for compilada localmente, copie primeiro os arquivos prontos para a pasta de instalação.
  • O recarregamento afeta todo o grupo de modificações, incluindo as adicionadas, removidas e desativadas em mods.ini. O atalho funciona somente quando o jogo está em primeiro plano. Não há monitoramento automático de alterações nos arquivos.
  • Para que os recursos sejam limpos corretamente, as modificações devem exportar a função stop(). Ela é usada para interromper temporizadores, cancelar inscrições em eventos e liberar recursos. Há suporte à limpeza assíncrona, aguardando sua conclusão.
O nome e a descrição do arquivo foram traduzidos Mostrar original (RU)Mostrar tradução (PT)
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(). Она используется для остановки таймеров, отписки от событий и освобождения ресурсов. Поддерживается асинхронная очистка с ожиданием её завершения.

Links úteis:

Comentários 0