Ponder Overrides: управление подсказками Create через KubeJS
Когда модпак на базе Create обрастает десятками кастомных механизмов, стандартная система интерактивных подсказок Ponder начинает давать сбои. Она привязана к идентификатору блока, а не к его внутреннему содержимому — NBT-тегам. Если у вас три варианта одной машины с общим block ID, игра упрямо показывает одну и ту же сцену, путая игроков. Решение лежит в крошечном, но хирургически точном аддоне Ponder Overrides: управление подсказками Create через KubeJS. Он не ломает ванильную логику Create, а аккуратно перехватывает момент выбора сцены и подставляет нужную — по контексту предмета, его тегам или метаданным.
Зачем переопределять подсказки в сборках с Create
Система Ponder — визитная карточка мода Create. Она через анимированные мини-демонстрации объясняет, как собрать механизм, куда что крутить и зачем. Но в глубоко кастомизированных модпаках один и тот же блок может вести себя по-разному в зависимости от NBT-данных. Например, «продвинутый миксер» и «базовый миксер» делят общий ID, а отличаются лишь тегами внутри предмета. Без Ponder Overrides игрок увидит одну и ту же подсказку для обоих, что ломает прогрессию и запутывает.
Аддон решает эту проблему на корню. Он позволяет через KubeJS-скрипты явно указать, какой именно ponder-сценарий загружать для конкретного предмета. Это критично для сборок вроде Create: Astral, где аккуратная подача механик через Ponder — часть обучающего дизайна. Вы не дублируете блоки ради интерфейса, а просто перенаправляете игрока на релевантную сцену.
Как работает событие ponder.override
Технически всё завязано на клиентский скрипт KubeJS. Вы создаёте файл, например client_scripts/ponder.js, и подписываетесь на событие ponder.override. В колбэке вам доступны три ключевых инструмента:
- event.getItem() — возвращает предмет, который инициировал просмотр подсказки. По его NBT, метаданным или даже названию вы отличаете варианты с одинаковым ID блока.
- event.getTag() — опциональный строковый тег, передаваемый из интерфейса Ponder UI. Он появляется не всегда, но даёт дополнительный контекст, если сцена открыта через специальное меню.
- event.override("namespace:ponder_id") — главный метод. Вызывая его, вы принудительно задаёте, какую сцену показать. Если метод не вызван, Create использует стандартную логику.
Представьте: у вас есть «Энергоячейка» с тремя режимами работы, каждый описан отдельным ponder-сценарием. В скрипте вы проверяете NBT-тег mode у предмета и вызываете event.override("mymod:energy_cell_charge"), ..._discharge или ..._idle. Игрок нажимает кнопку подсказки в инвентаре или JEI — и сразу видит нужную анимацию, без лишних телодвижений.
Практические сценарии использования
Где Ponder Overrides раскрывает себя полностью? Вот несколько типичных ситуаций из реальных сборок:
- Мульти-вариантные машины. Один block ID, но разные NBT-состояния: печь с улучшенным нагревом, охладителем или ускорителем. Каждый вариант требует своей демонстрации сборки.
- Кастомное оборудование с глубокой кастомизацией. Вы добавляете инструменты, которые визуально одинаковы, но по рецептам и логике различаются. Ponder Overrides позволяет показать правильный процесс крафта для каждого.
- Интеграция с гайдами и квестбуками. Если ваш модпак использует Ponder как часть обучения, вы можете через теги (
event.getTag()) открывать разные сцены из одного интерфейса, делая обучение контекстным. - Совместимость с JEI/REI. При просмотре рецептов в JEI игрок может вызвать Ponder для предмета. Без переопределения он получит общую сцену, а с аддоном — именно ту, что соответствует показанному рецепту.
Установка и совместимость с версиями Minecraft
Мод Ponder Overrides: управление подсказками Create через KubeJS работает как клиентский аддон и требует обязательного наличия Create и KubeJS. Он поддерживает Minecraft 1.18.2 и 1.19.2 на загрузчике Forge — именно на этих версиях строятся самые насыщенные технологические модпаки. Для Fabric на данный момент официальной поддержки нет, так как сам Create ориентирован на Forge.
Чтобы скачать Ponder Overrides: управление подсказками Create через KubeJS, достаточно добавить его в папку mods вашего клиента или сервера (работает только на клиенте, но файл можно держать и на сервере для удобства синхронизации). Никаких дополнительных библиотек, кроме KubeJS, не требуется. Если вы пользуетесь лаунчером foxygame.net, установка сводится к паре кликов: найдите мод в каталоге, нажмите «Установить», и лаунчер сам разместит файлы в нужной директории.
Тем, кто ищет Ponder Overrides: управление подсказками Create через KubeJS для Minecraft определённой версии, стоит проверять страницу мода на CurseForge или Modrinth — там всегда указаны актуальные билды. Перед обновлением сборки убедитесь, что ваша версия KubeJS совместима с версией аддона: разработчики обычно синхронизируют релизы.
Как установить и настроить: пошаговая памятка
Процесс внедрения в модпак прост, но требует аккуратности. Вот базовая схема для тех, кто впервые сталкивается с как установить этот инструмент:
- Убедитесь, что в сборке уже есть Create и KubeJS (клиентская часть).
- Скачайте JAR-файл Ponder Overrides под вашу версию Minecraft и поместите в папку
mods. - Создайте в директории
kubejs/client_scriptsфайл с расширением.js(например,ponder_overrides.js). - Пропишите в нём подписку на событие и логику переопределения, как показано в примерах ниже.
- Запустите игру и проверьте работу подсказок из инвентаря, JEI и самого Ponder UI.
Советы по интеграции в модпак
Чтобы не превратить клиентские скрипты в кашу, придерживайтесь нескольких правил:
- Проверяйте от частного к общему. Сначала обрабатывайте самые специфичные NBT-комбинации, а в конце оставляйте fallback на стандартное поведение. Так вы избежите ложных срабатываний.
- Именуйте ponder-сцены единообразно. Например,
mymod:machine_type_action. Это упростит поддержку при обновлении Create, когда внутренние идентификаторы могут измениться. - Тестируйте во всех контекстах. Сцена может открываться из инвентаря (есть предмет), из JEI (может не быть NBT) и из Ponder UI (может передаваться тег). Убедитесь, что для каждого случая есть корректный сценарий.
- Документируйте правила. Если над сборкой работает команда, опишите, какие предметы и какие сцены переопределены. Это спасёт от дублирования и конфликтов.
Пример скрипта: переопределение по NBT
Допустим, у вас есть блок mymod:multi_furnace, а в NBT хранится тег mode со значениями smelt, blast или smoke. Скрипт может выглядеть так:
onEvent('ponder.override', event => {
let item = event.getItem();
if (item.id === 'mymod:multi_furnace') {
let nbt = item.nbt;
if (nbt && nbt.mode === 'blast') {
event.override('mymod:ponder/multi_furnace_blast');
} else if (nbt && nbt.mode === 'smoke') {
event.override('mymod:ponder/multi_furnace_smoke');
} else {
event.override('mymod:ponder/multi_furnace_smelt');
}
}
});Этот код не затрагивает другие предметы, оставляя им стандартное поведение Create. Обратите внимание: если NBT отсутствует (например, при вызове из JEI), мы всё равно даём осмысленную сцену по умолчанию.
Когда Ponder Overrides не нужен
Инструмент узкоспециализированный. Если ваш модпак не вводит кастомные блоки с общим ID и разными NBT, или вы не используете Ponder как обучающий элемент, аддон будет избыточным. Он не повышает производительность, не добавляет контент — только даёт контроль над уже существующей системой подсказок. Но для сборок, где прогрессия завязана на понимание механик, это must-have.
Итог: аккуратный мост между Create и KubeJS
Ponder Overrides: управление подсказками Create через KubeJS — это не просто патч, а элегантное решение для модпак-мейкеров. Вы получаете полный контроль над тем, какую сцену Ponder увидит игрок, не плодя дубликаты блоков и не ломая ванильную логику. Связка KubeJS + событие ponder.override работает на клиенте, легко конфигурируется и не требует глубокого знания Java — достаточно базового понимания JavaScript и структуры NBT. Если ваша сборка строится вокруг Create и вы цените понятные, контекстные подсказки, этот аддон сэкономит вам часы объяснений в чате и сделает прохождение интуитивным.