Вход

Регистрация

Восстановление доступа

KotlinLangForge

KotlinLangForge

|

btwonion

Инструмент для разработки модов на Kotlin с поддержкой NeoForge.

Мод KotlinLangForge для Minecraft — библиотека для разработки модов на Kotlin

KotlinLangForge предоставляет адаптер языка Kotlin для загрузчика NeoForge, позволяя разработчикам создавать моды на Kotlin. Мод включает в себя набор стандартных библиотек Kotlin и утилит, упрощающих работу с событиями и зависимостями. Он поддерживает автоматическую регистрацию слушателей событий и предоставляет доступ к специфическим контейнерам для модов.

🛠️ Интеграция в проект

Чтобы использовать KotlinLangForge в своём моде на NeoForge, необходимо добавить конфигурацию в файл neoforge.mods.toml. Укажите мод-лоадер как klf и версию загрузчика [1,). После этого ваш класс @Mod должен быть объявлен либо как объект, либо как класс с публичным конструктором. Конструктор может принимать до четырёх аргументов: IEventBus, ModContainer, KotlinModContainer и Dist. Обратите внимание: для версий языка-провайдера до 3.0 (Minecraft 1.20.4 и младше) в build.gradle.kts следует использовать директиву modImplementation, а для новых версий — implementation.

Конфигурация и зависимости

Для сборки проекта добавьте репозиторий `dev.nyon` и подключите библиотеку, указав версию языка-провайдера (`$lpVersion`) и загрузчика (`$loader`).

Версии языка-провайдера

Версия MinecraftВерсия языка-провайдераПоддерживаемые загрузчики
1.16.51.0Forge
1.17.1 - 1.20.42.0Forge, NeoForge
1.20.5 - 1.21.83.0NeoForge
1.21.9 - 26.x3.1NeoForge

📡 Регистрация событий

Для автоматической регистрации слушателей событий используйте аннотацию @EventBusSubscriber на классе или файле. Библиотека автоматически обнаружит все методы, имеющие параметры событий, и определит, какую шину событий использовать. Для тонкой настройки параметров слушателя можно добавить аннотацию @SubscribeEvent. Шина модов (Mod Bus) доступна через верхнеуровневое объявление dev.nyon.klf.MOD_BUS.

⚠️ Оговорка для разработчиков Forge

Приватные слушатели событий не обрабатываются на платформе Forge и приведут к крашу сервера. Убедитесь, что ваши методы-слушатели имеют публичный доступ.

📦 Встроенные библиотеки

В дистрибутив KotlinLangForge включены стандартные библиотеки Kotlin и утилиты для упрощения разработки. Среди них стандартная библиотека Kotlin (kotlin-stdlib), поддержка рефлексии (kotlin-reflect), модули для сериализации (kotlinx-serialization), корутины (kotlinx-coroutines), работа с датой и временем (kotlinx-datetime), а также инструменты для работы с I/O (kotlinx-io) и атомарные операции (atomicfu). Все зависимости обновлены до актуальных версий (например, kotlin-stdlib:2.4.20).

Связанные материалы

Автор: btwonion · Лицензия: GPL-3.0-only

B

btwonion

1 проект

|

0 скачиваний

Войдите, чтобы поставить оценку и оставить отзыв.

Отзывов пока нет — будьте первым!
Канал Файл Игра Модлоадер Язык Скачиваний Загружен
Релиз KotlinLangForge-2.14.1-k2.4.20-3.1+neoforge.jar 7.83 MB 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3 NeoForge 0 16.09.2026
Релиз KotlinLangForge-2.14.1-k2.4.20-3.0+neoforge.jar 7.83 MB 1.20.5, 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 0 16.09.2026
Релиз KotlinLangForge-2.12.2-k2.4.10-3.1+neoforge.jar 7.61 MB 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 NeoForge 0 18.07.2026
Релиз KotlinLangForge-2.12.2-k2.4.10-3.0+neoforge.jar 7.61 MB 1.20.5, 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 0 18.07.2026