API консоли

Когда игра запущена, GP-Next предоставляет глобальный объект:

window.gpNext

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

Совет

Если вы не уверены, какие команды доступны, начните с:

gpNext.help()

Перед использованием

игра полностью загрузилась
GP-Next успешно инициализирован
у вас открыта консоль разработчика

Если вы хотите сначала экспортировать исходные JSON для Features, Props или языков, откройте Исходные данные.

Панель

`gpNext.toggle()`

Показывает или скрывает панель GP-Next.

Без параметров.

Пример

gpNext.toggle()

Патчи и состояние

`gpNext.init()`

Повторно запускает процесс загрузки патчей.

Возвращаемое значение

Обычно возвращает текущий результат загрузки патчей.

`gpNext.reload()`

Повторно считывает файлы патчей с диска и применяет их заново.

Это одна из самых часто используемых команд.

Пример

await gpNext.reload()

Основные поля результата

loaded: список загруженных типов
skipped: пропущенные типы
errors: список ошибок
packs: обнаруженные datapack-пакеты
disabledPacks: отключенные datapack-пакеты
singleFile: информация об однофайловых патчах
editsPack: информация о пакете ручных правок
editsCount: количество ручных правок
extraLanguages: зарегистрированные дополнительные языки
plantRegistry: отладочная информация динамического реестра растений

Пример

const status = gpNext.status()
console.log(status.packs)
console.log(status.errors)

Редактирование данных

`gpNext.setObjectsData(type, alias, key, value)`

Изменяет одно поле в записи типа Objects.

Параметры

type: имя типа объекта, например PlantProps
alias: основной alias целевой записи, например peashooter
key: имя изменяемого поля
value: новое значение

Пример

gpNext.setObjectsData('PlantProps', 'peashooter', 'SunCost', 50)

`gpNext.setObjectsData(type, alias, patchObject)`

Сливает объект в objdata целевой записи.

Параметры

type: имя типа объекта
alias: основной alias целевой записи
patchObject: объект, который нужно влить в запись

Пример

gpNext.setObjectsData('PlantProps', 'peashooter', {
  SunCost: 50,
  Cooldown: 2
})

Примечание

Это изменение во время выполнения. Оно удобно для отладки и быстрой проверки, но не создает за вас полноценный datapack автоматически.

Экспорт и восстановление

`gpNext.exportJson(type, useOriginal = false, autoDownload = true)`

Экспортирует JSON-тип.

Параметры

type: имя типа, например PlantFeatures
useOriginal: true экспортирует исходные данные, false - текущие runtime-данные
autoDownload: true открывает окно сохранения, false выводит результат в консоль

Пример

await gpNext.exportJson('PlantProps')
await gpNext.exportJson('PlantProps', true)
await gpNext.exportJson('PlantProps', false, false)

`gpNext.exportLang(useOriginal = false, autoDownload = true)`

Экспортирует текущую языковую таблицу MultiLanguage.lyrics.

Полезные случаи

проверить, применился ли языковой пакет
сравнить текущий расширенный результат языков
экспортировать исходную языковую таблицу для сравнения

Пример

await gpNext.exportLang()
await gpNext.exportLang(true)

`gpNext.restoreOriginal(type)`

Восстанавливает один тип до исходного состояния.

Пример

gpNext.restoreOriginal('PlantFeatures')

`gpNext.listOrigins()`

Показывает все типы, для которых сейчас есть исходные копии.

`gpNext.hasOrigin(type)`

Проверяет, есть ли для типа исходная копия.

Эта команда существует, но использует низкоуровневый путь _timeScale и не так безопасна, как штатные варианты 1x / 1.5x на странице Trainer. В большинстве случаев лучше переключать скорость через интерфейс.

Cheats

`gpNext.cheats.setSun(value)`

Напрямую устанавливает текущее количество солнца.

Пример

gpNext.cheats.setSun(9999)

`gpNext.cheats.addSun(value = 1000)`

Добавляет солнце.

Пример

gpNext.cheats.addSun()
gpNext.cheats.addSun(500)

`gpNext.cheats.winLevel()`

Мгновенно завершает текущий уровень победой.

Примечание

В некоторых тестовых или sandbox-сценах лучше рассматривать это как временный ярлык, а не как часть стабильного рабочего процесса.

добавления новых растений
клонирования растений
поиска проблем с сопоставлением идентичности растений

Пример

const info = gpNext.debug.getPlantRegistry()
console.log(info)

gpNext.version

`gpNext.debug`

Это пространство имен для отладки, а не просто булев переключатель.

Сейчас чаще всего используется:

gpNext.debug.getPlantRegistry()

Примеры

Перезагрузить патчи и проверить состояние

await gpNext.reload()
console.log(gpNext.status())

Быстро проверить значения растения

gpNext.setObjectsData('PlantProps', 'peashooter', {
  SunCost: 50,
  Cooldown: 2
})

Экспортировать текущие данные в консоль

await gpNext.exportJson('PlantProps', false, false)

Экспортировать исходную языковую таблицу

await gpNext.exportLang(true)