Введение в GP-Next

Совет

Эта страница относится к официальным версиям, начиная с 0.7.1.

GP-Next

GP-Next - это встроенная панель для моддинга, отладки и вспомогательных функций времени выполнения в PvZ2 Gardendless. В одной панели собраны:

Patcher: управление packs/, patches/, ручными правками и перезагрузкой патчей
Data: просмотр, сравнение, экспорт, восстановление и редактирование игровых данных во время работы
Trainer: модификаторы для боев, карты мира и песочницы
Cloud: загрузка, скачивание и сравнение облачных сохранений
Settings: язык, частота кадров, настройки прокрутки, Runtime Extensions, HP Overlay и другое
Guide / About / Log: встроенная документация, справка по командам консоли и журналы работы

Если у вас установлена официальная версия, GP-Next уже встроен в игру. В игре нажмите F10 или кнопку в левом верхнем углу, чтобы открыть панель.

Что понадобится

JSON-редактор, например VSCode или Notepad++
Базовое понимание структуры JSON

Если вы собираетесь редактировать растения, зомби, магазин или тексты, удобно держать открытыми две страницы:

Быстрый старт

1. Откройте панель

зайдите в игру
нажмите F10
откройте вкладку Patcher

2. Откройте папку

Во вкладке Patcher нажмите "Open Folder", чтобы открыть папку gp-next/ в каталоге данных игры.

3. Создайте datapack

Рекомендуемый способ - хранить изменения в packs/имя-вашего-мода/pack.json и jsons/, а не раскладывать отдельные JSON-файлы вручную.

4. Перезагрузите патчи

Вернитесь во вкладку Patcher в игре и нажмите Save & Reload, либо перезапустите игру.

5. Проверьте результат

Если вы не уверены, сработал ли патч, откройте вкладку Data, найдите нужную запись и посмотрите текущие данные прямо в игре.

Что читать дальше

Документация GP-Next разделена по темам:

сначала прочитайте Структура и приоритет
затем Правила слияния
потом Datapacks и pack.json

Если вы делаете пакет перевода, переходите к Языковые пакеты и lang.json.

Если вы хотите сделать линию уровней растений, значки уровней или страницу уровня в альманахе, переходите к Уровни растений.

Если вы хотите менять порядок узлов карты мира, ветки, подарочные коробки, порталы или общую runtime-структуру карты, переходите к Карте.

Если вам важнее работа внутри игры, чем структура файлов, сразу переходите к:

Ключевые моменты

packs/ поддерживает и папки, и .zip
patches/ сохранен в основном для совместимости со старыми однофайловыми рабочими процессами
ручные правки из вкладки Data сохраняются в __gpn_edits/ и имеют самый высокий приоритет
массивы в GP-Next по умолчанию заменяются целиком, а не сливаются по индексам
reloadPatches() часто достаточно для многих runtime-расширений, полный перезапуск нужен не всегда
внизу интерфейса показывается версия GP-Next и можно проверить обновления с официального сайта

Если вы пока не знаете, как выглядит исходный JSON нужного типа, сначала откройте Исходные данные. Эта страница лучше всего подходит для просмотра структуры перед изучением полей.