KubeJS — скриптуем всё, что движется

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

С чего начать?

Всё просто: установи мод и запусти игру один раз. KubeJS самостоятельно создаст папку kubejs в директории Minecraft, наполнив её примерами скриптов. Дальше — дело техники.

Важно понимать разницу между типами скриптов:

• startup-скрипты выполняются только один раз при загрузке игры. Они нужны для регистрации предметов, настройки конфигов и прочих глобальных вещей, которые должны существовать с самого начала.
• server/data-скрипты загружаются при входе в мир. Их стихия — очистка энтити (тот самый clearlag), кастомные сообщения при входе игроков и всё, что связано с игроком и миром.

Видео-гайд для версии 1.19.2

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

Можно ли перезагружать скрипты?

Да, команда /reload в твоём распоряжении. Но не стоит ожидать, что всё подхватится на лету. Часть изменений потребует полного перезапуска игры, некоторые — только перезахода в мир, а что-то применится мгновенно. Зависит от того, что именно ты меняешь.

Нужна помощь или готовые решения?

Если JavaScript для тебя тёмный лес, не отчаивайся. На KubeJS Wiki ты найдёшь кучу примеров и уже готовых скриптов, которые можно адаптировать под свои нужды.

Вопросы, идеи, баги?

Не нашёл ответ на свой вопрос в вики? Хочешь предложить фичу или сообщить о баге? Добро пожаловать на страницу поддержки KubeJS.