Fabric Language Kotlin [1.14 — 26.1.1]

Fabric Language Kotlin — использование Kotlin для модов на Fabric для Minecraft 1.21.11 — это библиотечный мод, который добавляет в загрузчик Fabric поддержку языка программирования Kotlin и его стандартной библиотеки. Без него моды, написанные на Kotlin, попросту не запустятся, поэтому Fabric Language Kotlin входит в обязательные зависимости десятков популярных проектов на Fabric.

Что добавляет мод

В отличие от контентных модов, Fabric Language Kotlin не добавляет в игру ни блоков, ни предметов, ни мобов. Его задача — служить «прослойкой» между JVM-частью Minecraft и Kotlin-кодом сторонних модов. Установив его один раз, вы получаете рабочее окружение для целого класса модификаций.

• Поддержка языка Kotlin. Мод подгружает Kotlin Runtime и регистрирует языковой адаптер kotlin в Fabric Loader, благодаря чему точки входа модов (ModInitializer, ClientModInitializer и др.) могут быть написаны на Kotlin.
• Стандартная библиотека Kotlin. В classpath попадают kotlin-stdlib, kotlin-reflect, kotlinx-coroutines и kotlinx-serialization — то, что чаще всего требуется авторам модов.
• Совместимость по ABI. Все Kotlin-моды используют одну и ту же версию рантайма из Fabric Language Kotlin, поэтому не возникает дубликатов классов и конфликтов версий стандартной библиотеки.
• Поддержка корутин. Авторам модов доступны coroutines для асинхронных задач — например, фоновой загрузки данных или работы с сетью без блокировки главного потока.
• Лёгкий вес. Сам по себе мод не нагружает ни процессор, ни память: его влияние на FPS и TPS неотличимо от нуля, расходуется лишь немного оперативной памяти под библиотеки.

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

Инструкция, как установить Fabric Language Kotlin — использование Kotlin для модов на Fabric для Minecraft 1.21.11, ничем не отличается от установки любого другого Fabric-мода:

1. Установите Fabric Loader нужной версии через официальный установщик и хотя бы один раз запустите профиль Fabric, чтобы появилась папка mods.
2. Нажмите кнопку скачать Fabric Language Kotlin — использование Kotlin для модов на Fabric для Minecraft 1.21.11 на этой странице и сохраните JAR-файл.
3. Откройте папку .minecraft/mods (на Windows — %appdata%\.minecraft\mods, на Linux — ~/.minecraft/mods).
4. Перенесите скачанный JAR в папку mods не распаковывая.
5. Запустите Minecraft через профиль Fabric. В списке модов на главном экране должен появиться Fabric Language Kotlin.

Когда я ставил мод впервые, ошибся и положил файл в mods внутри Forge-профиля — игра, разумеется, его проигнорировала. Убедитесь, что вы кладёте JAR именно в Fabric-сборку.

Требования и зависимости

• Загрузчик: Fabric Loader. С Forge, NeoForge и Quilt напрямую несовместим (для Quilt используется свой форк — Quilt Kotlin Libraries).
• Java: та же версия, что требуется выбранной версии Minecraft. Для 1.14–1.15 достаточно Java 8, для более новых сборок — Java 17 и выше.
• Fabric API: сам Fabric Language Kotlin его не требует, но почти все Kotlin-моды требуют — практичнее ставить оба.
• ОЗУ: минимальный объём, выделенный Minecraft, — 2 ГБ; рекомендуется 4 ГБ при наличии других модов.
• Зависимости-библиотеки: сторонние не нужны — Kotlin Runtime упакован внутрь JAR.

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

Файл, представленный на этой странице, ориентирован на ветки 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2. Для других версий (1.16, 1.18, 1.19, 1.20, Fabric Language Kotlin — использование Kotlin для модов на Fabric для Minecraft 1.21.11 1.20.1, 1.21) у мода существуют отдельные сборки — версия библиотеки должна соответствовать версии Minecraft и Fabric Loader.

Конфликтов с контентными модами практически не бывает: Fabric Language Kotlin работает на уровне ClassLoader и не вмешивается в игровую логику. Возможные проблемы:

• одновременная установка устаревшей и новой версий FLK — оставьте только один JAR;
• попытка использовать его на Forge-сборке без моста вроде Sinytra Connector — не сработает;
• несоответствие версии Kotlin требованиям конкретного мода — обновите Fabric Language Kotlin до последней совместимой с вашей версией MC.

Часто задаваемые вопросы

Нужно ли скачивать Fabric Language Kotlin, если я не программист?

Да, если в вашем сборке есть хотя бы один Kotlin-мод (например, Roughly Enough Items в некоторых версиях, Skyblocker, Patchouli-аналоги). Без FLK такие моды не загрузятся, и игра выпадет в краш-репорт с сообщением о невозможности найти языковой адаптер kotlin.

Будет ли мод тормозить игру?

Нет. Это библиотека: она инициализируется при запуске и далее не выполняет фоновой работы. Влияние на FPS и TPS не фиксируется даже на слабых машинах.

Можно ли поставить его на сервер?

Да, и это обязательно, если на сервере используется хотя бы один Kotlin-мод серверной/общей стороны. Положите JAR в папку mods сервера так же, как на клиенте.

Чем отличается от Quilt Kotlin Libraries?

QKL — отдельный проект для загрузчика Quilt, с собственным API поверх Kotlin. Fabric Language Kotlin проще: он лишь подключает рантайм Kotlin к Fabric. Если вы играете на Fabric, нужен именно Fabric Language Kotlin — использование Kotlin для модов на Fabric для Minecraft 1.21.11.