Ponderer: Инструмент для создания туториалов прямо в игре

Ponderer - мод для Майнкрафт, который переворачивает подход к созданию обучающих сцен-размышлений (Ponder). Помните, как в Create или других модах вы нажимали на предмет, и перед вами всплывала анимация с пояснениями? Так вот, раньше такие штуки делали через PonderJS - отдельный скриптовый язык. А теперь есть способ проще.

Ponderer позволяет создавать эти самые туториалы прямо в мире, без единой строчки кода. Вы просто играете, строите, расставляете камеры, добавляете текст - и готово. Идеально для сборщиков модпаков, админов серверов и тех, кто хочет сделать свой проект понятнее для новичков.

Что конкретно умеет Ponderer

• Создание сцен на лету - из предмета в руке или любого другого. Можно делать разные сцены для одного предмета с разными NBT-данными (например, книги от разных авторов).
• Визуальный редактор - кликаешь по иконке редактирования в левом нижнем углу сцены и меняешь текст, камеру, блоки, сущностей, звуки. Координаты можно выбирать прямо из сцены: левый клик - позиция блока, правый - соседний.
• Копирование/вставка шагов - плюс отмена и повтор через Ctrl+Z и Ctrl+Y. Никаких сюрпризов.
• Выделение областей - держите в руках бумагу (по умолчанию) и сохраняйте структуры для повторного использования.
• Работает из коробки - есть встроенная демо-сцена. Просто возьмите книгу с пером в руку, и увидите пример.
• Локальная перезагрузка - изменили что-то в редакторе? Команда - и всё обновилось без перезапуска игры.
• Многопользовательская синхронизация - можете стягивать и отправлять сцены на сервер. Удобно, когда команда работает над общим модпаком или админ хочет дать игрокам готовые подсказки.
• Конвертация в PonderJS и обратно - если вам удобнее работать со скриптами, можете переключаться.
• Экспорт и импорт ZIP - все сцены и структуры упаковываются в архив для шаринга с сообществом.
• Интеграция с JEI - если стоит, можно кликать или перетаскивать предметы из списка в поля ID. Работает с блоками, предметами и сущностями.
• Настройка BlockState - при расстановке блоков можно указать, куда они смотрят (facing, half и т.д.).
• Поддержка сложных сущностей - лодки, вагонетки, стойки для брони и другие предметные сущности можно переносить через JEI.

Команды для управления

Основные

• /ponderer reload - перезагрузить локальные сцены и обновить индекс.
• /ponderer pull - стянуть изменения с сервера (с проверкой конфликтов).
• /ponderer pull force - принудительно перезаписать локальные данные версией сервера.
• /ponderer pull keep_local - стянуть, но сохранить свои правки где возможно.
• /ponderer push - отправить свои сцены на сервер (с проверкой).
• /ponderer push force - без лишних вопросов.
• /ponderer push <id> - отправить только одну сцену.
• /ponderer push force <id> - принудительно одну сцену.

Работа со сценами

• /ponderer download <id> - импортировать структуру.
• /ponderer new hand - создать сцену из предмета в руке.
• /ponderer new hand use_held_nbt - с NBT текущего предмета.
• /ponderer new hand <nbt> - с указанным NBT.
• /ponderer new <item> - для конкретного предмета.
• /ponderer new <item> <nbt> - предмет + NBT.
• /ponderer copy <id> <target_item> - копировать сцену на другой предмет.
• /ponderer delete <id> - удалить.
• /ponderer delete item <item_id> - удалить все сцены под предметом.
• /ponderer list - открыть UI со списком.

Конвертация

• /ponderer convert to_ponderjs all - все сцены в PonderJS.
• /ponderer convert to_ponderjs <id> - одну сцену.
• /ponderer convert from_ponderjs all - импорт из PonderJS.
• /ponderer convert from_ponderjs <id> - одну.

Экспорт/Импорт

• /ponderer export [filename] - всё в ZIP в config/ponderer/.
• /ponderer import <filename> - загрузить из ZIP.

Кому это пригодится

• Создателям модпаков - чтобы игроки сразу понимали, как работают новые механики. Вместо текстовых гайдов - наглядные сцены.
• Администраторам серверов - можно сделать встроенное обучение для новых игроков: как войти в клан, как работает экономика, где что крафтится.
• Обычным игрокам, которым надоело читать мануалы. Хочется увидеть и повторить.

Почему Ponderer, а не PonderJS

У PonderJS нет горячей перезагрузки. Каждое изменение - это перезапуск игры или долгая перезагрузка модов. А ещё скрипты - это потенциальная дыра в безопасности, особенно на серверах. Ponderer работает через собственный безопасный формат и при этом умеет конвертировать туда-обратно. То есть можно начать в Ponderer, а потом, если захочется, перейти на PonderJS и допилить.

Важно знать

• Мод работает на Fabric (и, вероятно, на Quilt).
• Для интеграции с JEI потребуется сам JEI.
• Все файлы сцен хранятся локально, синхронизация - по вашему желанию.
• Команды работают в мультиплеере, но права доступа регулируются стандартными опциями сервера.

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

Скачать мод Ponderer можно на CurseForge и Modrinth. Для установки нужен Fabric API и версия Minecraft 1.18+ (точнее смотрите в описании версии).