Untitled draft

Kotlin for Forge — мод для підтримки мови Kotlin у Minecraft

Kotlin for Forge — це бібліотека, яка додає в Minecraft підтримку модів, написаних мовою програмування Kotlin. Forge і NeoForge за замовчуванням запускають моди на Java; цей мод додає окремий завантажувач мови та готові бібліотеки Kotlin, без яких такі проєкти не стартують. Для звичайного гравця це службовий мод: окремо він нічого не змінює в грі, але потрібен, коли інший установлений мод побудовано на Kotlin.

Навіщо потрібна ця бібліотека

Частина авторів пише свої проєкти не на Java, а на Kotlin — спорідненій мові, що працює на тій самій віртуальній машині. Щоб такий мод завантажився, грі потрібні самі бібліотеки Kotlin і прошарок, який пояснює завантажувачу, як ініціалізувати код цією мовою. Саме це й постачає ця бібліотека.

Якщо мод, що вимагає цю бібліотеку, поставити без неї, гра не запуститься: на екрані з'явиться повідомлення про відсутню обов'язкову залежність, а в журналі — рядок про незнайдений завантажувач kotlinforforge. Один установлений файл обслуговує всі моди на Kotlin одразу, тому кожному з них не доводиться вкладати власну копію середовища мови.

Що містить мод

Бібліотека постачає повний набір середовища Kotlin: стандартну бібліотеку та рефлексію, корутини для асинхронних задач і серіалізацію JSON. Цей набір підключається один раз і стає доступним усім модам на Kotlin у збірці.

Окрім самих бібліотек, мод додає завантажувач мови KotlinLanguageProvider, який дозволяє авторам оголошувати головний клас проєкту мовою Kotlin, а також набір допоміжних функцій для типових задач у коді. Для гравця ці деталі залишаються «під капотом»: уся робота бібліотеки припадає на етап завантаження гри, а не на сам ігровий процес. Файл важить близько 6–7 МБ і працює як на клієнті, так і на сервері.

Як вибрати правильну версію

Головна складність із цією бібліотекою — підібрати файл під свою збірку. Номер версії мода не збігається з версією Minecraft: наприклад, гілка 6.x виходить для нових збірок на NeoForge, тоді як 5.x обслуговує Forge на 1.21. Тому орієнтуватися треба не на «найновіший» файл узагалі, а на той, що відповідає вашій версії гри та завантажувачу.

На сторінці завантаження є фільтр за версією Minecraft і за завантажувачем. Найнадійніший спосіб — виставити у фільтрі точну версію гри (наприклад, 1.21.11) і свій завантажувач (Forge чи NeoForge), після чого взяти верхній файл зі списку.

Старіші збірки гри, аж до 1.14, обслуговують ранні гілки бібліотеки — потрібний файл знаходиться тим самим фільтром на сторінці завантаження.

Типові помилки

Більшість проблем із цією бібліотекою зводяться до двох ситуацій.

Бібліотеки немає взагалі. Якщо в папку mods додали мод на Kotlin, але не поставили саму бібліотеку, гра завершиться помилкою про відсутню залежність ще до головного меню. Рішення — додати відповідний файл Kotlin for Forge у ту саму папку.

Версія не підходить. Застара або зібрана під інший завантажувач бібліотека спричиняє збій під час запуску. У журналі гри це видно як помилку ініціалізації або конфлікт модулів. Рішення те саме — підібрати файл точно під версію гри й завантажувач.

Висновок

Kotlin for Forge дає Minecraft змогу запускати моди, написані мовою Kotlin, і робить це через одну спільну бібліотеку замість того, щоб кожен такий мод носив власну копію середовища. Окремо цей мод нічого не додає в гру — його ставлять лише тоді, коли цього вимагає інший установлений проєкт. Бібліотека знадобиться кожному, хто збирає модпак або ставить окремі моди, у залежностях яких указано Kotlin for Forge.