Мод Kotlin for Forge - Создание модов KFF / 6 JAR / RU

Kotlin for Forge: библиотека для модов на Kotlin​

Kotlin for Forge (KFF) предоставляет языковой загрузчик kotlinforforge и библиотеки Kotlin, нужные готовым модам. Его устанавливают, когда мод требует эту зависимость. Например, она нужна вариантам Inventory Profiles Next и libIPN для Forge или NeoForge. Возможности инвентаря, новые предметы и другие игровые функции добавляют сами моды.

Что находится в загрузке​

Архив kotlin-for-forge-6-files-RU.zip содержит шесть неизменённых авторских JAR и русскую инструкцию README-RU.txt. Размер ZIP — 41 374 425 байт. В одном игровом профиле нужен один подходящий KFF. Выбирать следует по точной версии Minecraft, загрузчику и диапазону KFF, который требуют остальные моды.

Четыре прежних JAR остаются доступны через историю ресурса. В комплект добавлены 4.12.0 для старых веток Forge и 5.10.0 с авторской поддержкой NeoForge 1.21.6–1.21.8. Больший номер версии сам по себе не означает, что файл подходит к вашей игре.

Как установить Kotlin for Forge​

1. В лаунчере уточните точную версию Minecraft и загрузчик профиля. Используйте соответствующий Minecraft Forge или NeoForge. Сохраните требования модов к KFF из их описания или сообщения загрузчика.
2. Скачайте внешний ZIP и распакуйте его в отдельную папку. По списку ниже выберите один JAR из папки kff. Перенесите выбранный JAR целиком в mods именно этого игрового профиля.
3. Сам JAR не распаковывайте и не запускайте как установщик. Не копируйте в mods все шесть файлов: несколько поколений одной языковой библиотеки могут конфликтовать.
4. Добавьте основной мод и остальные его зависимости для той же игры и загрузчика. Для сортировки инвентаря используйте Inventory Profiles Next, а если его версия требует отдельную библиотеку — подходящий libIPN.
5. Запустите нужный профиль через лаунчер. Если загрузчик сообщает об отсутствующем kotlinforforge, сравните полный диапазон из ошибки с выбранным файлом и проверьте, не осталось ли дублей KFF в mods.

Для обычной установки игроку не нужны компилятор Kotlin, среда разработки или отдельный проект мода. KFF размещают на той стороне, где его требуют установленные моды. Клиентский Inventory Profiles Next не требует установки на сервер; для серверных модов зависимости проверяют отдельно.

Какой JAR выбрать​

Ниже приведены версии языкового провайдера и релизные игры из авторского списка, сверенные с содержимым файлов. Minecraft 1.20.5 отсутствует в этих шести релизах: не считайте 1.20.4 или 1.20.6 подходящей заменой только из-за близкого номера.

• KFF 1.17.0 — Forge
  Kotlin-for-Forge-1.17.0-1.16.5.jar
  Minecraft: 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.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5.
  Название файла заканчивается на 1.16.5, но авторский список также включает игры 1.14–1.15.2.
• KFF 2.2.0 — Forge
  kotlinforforge-1.17.1-2.2.0-obf.jar
  Minecraft: 1.17.1.
• KFF 3.12.0 — Forge
  kotlinforforge-3.12.0-all-1.19.2.jar
  Minecraft: 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2.
  Несмотря на 1.19.2 в имени, автор указывает также Minecraft 1.18–1.18.2, 1.19 и 1.19.1.
• KFF 4.12.0 — Forge
  kotlinforforge-4.12.0-all.jar
  Minecraft: 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4.
  В этой инструкции 4.x выбран для Forge. NeoForge для иных сборок проверяйте по отдельному точному релизу.
• KFF 5.7.0 — Forge / NeoForge
  kotlinforforge-5.7.0-all.jar
  Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5.
• KFF 5.10.0 — Forge / NeoForge
  kotlinforforge-5.10.0-all.jar
  Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8.
  Для NeoForge 1.21.6, 1.21.7 и 1.21.8 выбирайте эту ветку; она удовлетворяет минимуму KFF 5.8 у соответствующего IPN.

У файла 1.17.0 версия мода внутри mods.toml записана как 1.16.0, а Implementation-Version языкового провайдера — 1.17.0. Для требования языка FML использует версию провайдера. Здесь сохранён исходный авторский JAR с обеими записями.

Выбор для Inventory Profiles Next и libIPN​

Для текущей подборки IPN и опубликованного комплекта libIPN сверены 32 файла, которым нужен kotlinforforge: 16 IPN и 16 libIPN для Forge/NeoForge. Проверены 45 сочетаний файла и релизной игры. Во всех случаях в этом ZIP есть вариант с подходящим загрузчиком, авторской игрой и версией языкового провайдера. Это проверка метаданных и содержимого JAR; игровой запуск всей сборки не заявляется.

• Forge 1.14–1.16.5: ветка 1.17.0, если она попадает в диапазон установленного мода.
• Forge 1.17.1: 2.2.0. Для 1.17 без патча этот файл автором не заявлен.
• Forge 1.18–1.19.2: 3.12.0. Старый IPN-forge-1.19-1.10.14.jar допускает внутри Minecraft 1.19.2: короткое имя 1.19 не делает его файлом для 1.19 или 1.19.1.
• Forge 1.19.3–1.20.4: 4.12.0. Выбирайте только перечисленные выше точные игры и соблюдайте требования основного мода.
• Forge/NeoForge 1.20.6–1.21.5: 5.7.0 или 5.10.0, если версия удовлетворяет диапазону мода. Например, минимум 5.8 исключает 5.7.0.
• NeoForge 1.21.6–1.21.8: 5.10.0. Авторский список 5.11.0 ограничен играми до 1.21.5 и не подтверждает эти три патча.

Запись [5.8,) означает минимум 5.8 без верхней границы. Если мод задаёт верхнюю границу, её тоже нужно учитывать: номер игры не заменяет проверку диапазона зависимости.

Другие загрузчики и ошибки установки​

Для Fabric нужна отдельная Fabric Language Kotlin. KFF и Fabric Language Kotlin относятся к разным загрузчикам и не взаимозаменяемы.

В другой подборке Kotlin for Forge сохранены 6.2.0, 5.11.0 и другие файлы. У 6.2.0 автор указывает только NeoForge и другие игры, начиная с 1.21.9: не используйте его как универсальную замену KFF 5.x для Forge или старого IPN.

При ошибке сначала сверьте точную игру, Forge/NeoForge и требование к kotlinforforge. Если они совпадают, изучите следующую отсутствующую зависимость в сообщении загрузчика. Переименование JAR, перенос файла другого загрузчика и установка всех поколений KFF не исправляют несовместимость. Классы, вложенные библиотеки, лицензии и ресурсы исходных JAR сохранены без изменений.