KubeJS ComputerCraft: периферия для любых блоков в Minecraft

KubeJS ComputerCraft добавляет периферию ComputerCraft к любым блокам через скрипты KubeJS для Minecraft. Узнайте, как установить и настроить мод.

KubeJS ComputerCraft

Если вы когда-нибудь мечтали превратить обычную печь, сундук или собственный механизм в полноценную периферию для компьютеров ComputerCraft, то KubeJS ComputerCraft — именно тот инструмент, который закрывает эту потребность. Дополнение связывает мощь скриптового движка KubeJS с миром ComputerCraft, позволяя регистрировать периферийные устройства на основе практически любого блока. Больше не нужно ждать, пока автор мода добавит поддержку вашего механизма — вы делаете это сами, через простые и понятные скрипты.

Мод ориентирован на продвинутых игроков и создателей сборок, но при этом не требует глубоких знаний Java. Достаточно базового понимания JavaScript и структуры KubeJS. В статье разберём, что умеет дополнение, как его установить и с чего начать писать первые скрипты.

Что даёт KubeJS ComputerCraft для Minecraft

Главная функция мода — регистрация периферии. Вы указываете блок, задаёте имя периферии и описываете методы, которые сможет вызывать компьютер. Всё это происходит в стартовых скриптах KubeJS, то есть на этапе загрузки мира. Дополнение поддерживает как Forge, так и Fabric, что делает его универсальным решением для большинства современных сборок.

Особенность реализации — разделение методов на два типа. Первый, mainThreadMethod, выполняется в основном потоке игры и потому имеет доступ к данным блока: например, к значению BurnTime у печи. Но вызывать такой метод можно не чаще одного тика, иначе производительность просядет. Второй тип, обычный method, ограничений по частоте вызовов не имеет, зато не может читать большую часть данных мира — зато отлично подходит для простых действий вроде установки блока или возврата строки.

  • Регистрация периферии для любого блока через событие computercraft.peripheral.
  • Два типа методов: с доступом к данным и без ограничений по вызовам.
  • Поддержка Forge и Fabric в актуальных версиях Minecraft.
  • Работа через startup_scripts — без правки исходников модов.

Как установить KubeJS ComputerCraft

Перед установкой убедитесь, что в сборке уже есть KubeJS и ComputerCraft (или его форк вроде CC: Tweaked) — без них дополнение работать не будет. Дальше всё стандартно: скачайте KubeJS ComputerCraft, соответствующий вашей версии Minecraft и загрузчику, и поместите файл в папку mods. Обратите внимание, что в списке последних файлов на странице проекта обычно виден только самый свежий билд, поэтому нужную версию стоит искать во вкладке со всеми файлами.

Если не хочется вручную подбирать совместимые версии, лаунчер foxygame.net предлагает каталог дополнений, где KubeJS ComputerCraft можно добавить в сборку буквально парой кликов и сразу получить корректный набор зависимостей. После установки запустите игру один раз, чтобы мод создал необходимые папки, и переходите к скриптам.

Первый скрипт: периферия для печи

Создайте файл в папке kubejs/startup_scripts и подключите событие регистрации периферии. Внутри вызовите registerPeripheral, указав идентификатор блока и имя периферии. Затем добавьте метод burnTime через mainThreadMethod, который вернёт значение BurnTime из данных блока. Так компьютер сможет узнавать, сколько ещё будет гореть печь, и строить на этом автоматизацию.

Для методов без доступа к миру используйте обычный method. Например, метод say_hi может установить алмазный блок над контейнером и вернуть текстовое сообщение. Это демонстрирует, как из Lua-кода на компьютере управлять окружением через периферию.

Совместимость и версии

KubeJS ComputerCraft для Minecraft развивается вместе с KubeJS, поэтому версии нужно подбирать внимательно: для старых сборок на 1.18 и 1.19 подойдут одни билды, для 1.20 и новее — другие. Загрузчик тоже важен: на Forge и Fabric используются разные артефакты, и путать их нельзя. Всегда сверяйтесь с описанием файла перед скачиванием.

Советы по написанию скриптов

  • Не злоупотребляйте mainThreadMethod — каждый вызов нагружает основной поток.
  • Проверяйте аргументы, приходящие из Lua, чтобы избежать ошибок выполнения.
  • Тестируйте периферию на одиночном мире перед добавлением в сборку.
  • Держите скрипты в отдельных файлах для удобства поддержки.

Вывод

KubeJS ComputerCraft — это мост между скриптовой гибкостью KubeJS и функциональностью ComputerCraft. Он открывает дорогу к кастомной периферии без ожидания обновлений от авторов модов и без написания Java-кода. Если вы создаёте сборку с акцентом на автоматизацию и программирование, это дополнение заслуживает места в вашем списке. Начните с простого примера с печью, а дальше экспериментируйте: возможности ограничены только вашей фантазией и структурой блоков в мире.