Що таке 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. Прочитай Як організувати мод, перш ніж він розростеться.