Что такое Crafting

Crafting — платформа для модов к Minecraft Java 26.3. Ты пишешь моды на CraftScript, её собственном языке, или на Kotlin (и Java), через API, которое не зависит от кода игры.

Идея

Мод для Crafting никогда не вызывает Minecraft напрямую. Он вызывает Crafting: «дай игроку этот предмет», «сообщи, когда кто-то сломает блок», «создай этот блок с такой прочностью». Crafting знает, как сделать каждую из этих вещей в запущенной версии игры.

Когда выходит новая версия Minecraft, обновляется именно Crafting. Твой мод остаётся тем же файлом и продолжает работать. Точные правила этого обещания — на странице Твой мод не ломается.

Два языка, один API

	Для чего подходит
CraftScript	Чтобы начать, не зная Java, и для большинства модов: контент, события, команды, игровая логика. Обычные текстовые файлы .craft, которые перезагружаются при сохранении. В нём есть типы, классы и модули на случай, когда мод разрастается. Руководство
Kotlin	Большие моды со статическими типами и полноценной IDE или моды, которым нужно то, что есть только здесь: фоновая работа и библиотеки Java. Java использует тот же API. Руководство

Оба работают бок о бок в одной игре. Можно начать на CraftScript и перенести на Kotlin только ту часть, которой это нужно.

Что есть уже сегодня

Версия

0.1.0, в разработке. Собирается из исходников.

Игра

Minecraft Java 26.3, клиент и выделенный сервер.

API

Предметы, блоки с одним или несколькими дропами, рецепты, все серверные события, игроки, блоки и сущности, команды и права, таймеры, блоки любой формы, собственные существа со своим поведением и 3D-моделью (они появляются сами, их можно приручать, разводить и ездить на них, они летают, стреляют и используют анимации по ключевым кадрам), руды, которые генерируются в мире, собственные звуки и частицы, формы и элементы на экране, мир, игроки, сохранённые данные, настройки в файлах и сеть между клиентом и сервером. Всё это — и из CraftScript, и из Kotlin. Также охвачены эффекты, атрибуты и экипировка, броня, оружие и перезарядка, события сущностей и собственные клавиши.

Наборы шейдеров

Наборы шейдеров как данные, устанавливаются копированием папки. Смотри Наборы шейдеров.

Что дальше

1. Установи Crafting в лаунчер или на сервер.
2. Напиши свой первый мод и протестируй его, не открывая игру.
3. Прочитай Как организовать мод, пока он не разросся.