KubeJS

KubeJS - это мод для Майнкрафт, который навсегда меняет подход к созданию кастомных сборок и настройке серверов. По сути, он встраивает движок JavaScript прямо в игру. Забудьте про компиляцию Java-модов ради пары новых рецептов или стартового набора предметов. Тут вы просто пишете скрипт, и всё работает.

Проект набрал огромную популярность (более 20 миллионов скачиваний) и стал стандартом де-факто для админов. Он поддерживает Fabric, Forge, NeoForge и Quilt, а версии покрывают диапазон от Minecraft 1.18.2 до актуальной 1.21.1.

Что умеет этот мод

Зачем он вообще нужен? Представьте, что вы собираете свой модпак или сервер. Вам нужно убрать ванильный крафт алмазной кирки, добавить свой предмет, или сделать так, чтобы при входе на сервер писалось кастомное сообщение. Обычно для этого пишут отдельный плагин или мод. С KubeJS вы делаете это парой строк в JS.

• Редактирование рецептов и тегов - добавляйте, удаляйте или меняйте крафты верстака, печки и прочего.
• Кастомные предметы и блоки - регистрация новой брони, инструментов, еды и блоков без текстурпаков и программирования на Java.
• События мира и сервера - скриптуйте логику. Например, можно написать свою систему clearlag (очистки дропа) или выдавать новичкам стартовый набор.
• Интеграция с квестовыми модами - добавляйте свои хендлеры для квестов.
• Генерация мира (Worldgen) - меняйте правила генерации структур и биомов.

Как начать работу

После первого запуска с установленным модом в папке с Майнкрафт появится директория kubejs. Там лежат примеры скриптов. Важно понимать разницу между типами скриптов:

• startup_scripts - запускаются один раз при загрузке игры. Сюда пихаем регистрацию предметов, блоков, конфиги. Изменения требуют перезапуска клиента.
• server_scripts (или data) - грузятся при входе в мир. Идеально для смены рецептов, тегов, сообщений при входе и всего, что связано с конкретным миром.

Важные нюансы и советы

Можно ли перезагружать скрипты на лету? Да, команда /reload спасает. Но есть нюанс: не всё можно обновить без рестарта. Регистрацию новых предметов придется делать через полный перезапуск игры, а вот смену рецептов или сообщений - можно прям в процессе.

На слабом железе тяжелые скрипты могут просадить TPS, так что следите за оптимизацией кода. Не пишите бесконечные циклы там, где хватит простого эвента.

Недавно вышла обновленная ветка для NeoForge под Minecraft 1.21.1. Там пофиксили генерацию моделей с tinting для предметов и блоков, а также клиентские биндинги. Если вы сидите на новой версии - обновляйтесь, стабильность стала лучше.

Не знаете JavaScript? Это не проблема. На вики проекта полно готовых примеров и шаблонов. Скопировал, вставил, поменял айди предмета - готово.

Скачайте мод KubeJS, если устали плодить костыли ради мелких правок баланса. Для серверов и сборок это реально must-have. А если вы планируете запустить свой сервер Minecraft с друзьями, хостинг серверов Майнкрафт от BungeeHost позволит установить KubeJS и все нужные скрипты буквально в пару кликов.