Description
KotlinLangForge
Provides a Kotlin language adapter for Forge and Neoforge
This mod adds a language adapter for Kotlin and provides multiple libraries.
Developer usage
To add your language adapter to your mod, add the following lines to your (neoforge.)mods.toml.
neoforge.mods.toml
modLoader = "klf"
loaderVersion = "[1,)"
Now you can init your mod like any other.
Just make sure your @Mod class is either an object or a class with a public constructor.
The constructor can take the following four arguments (they should never duplicate):
- IEventBus
- ModContainer
- KotlinModContainer
- Dist
If you want to implement the libraries in your mod, import the following dependency, matching the language provider version, your loader and the (latest) version of Kotlin.
Versioning
The "language provider version" is a version only provided by KotlinLangForge. This format is not used by Forge or NeoForge and only serves as a simple differentiation variable between the different language provider implementations over the course of the versions of Minecraft.
| version of Minecraft | language provider version | supported loaders |
|---|---|---|
| 1.16.5 | 1.0 | Forge |
| 1.17.1 - 1.20.4 | 2.0 | Forge, NeoForge |
| 1.20.5 - 1.21.8 | 3.0 | NeoForge |
| 1.21.9 - 26.x | 3.1 | NeoForge |
build.gradle.kts
repositories {
maven("https://repo.nyon.dev/releases")
}
dependencies {
implementation("dev.nyon:KotlinLangForge:2.12.0-2.3.21-$lpVersion+$loader")
}
For lp: <=3.0, you will have to use modImplementation.
Events
To use automatic event listener registration, the @EventBusSubscriber annotation has to be added on the class/file.
Klf then will automatically find all methods that have events in their parameters and will determine which event bus to
use.
Additionally, you can annotate a method with @SubscribeEvent to adjust the listener's parameters.
Note for Forge developers: Private event listeners cannot be processed on Forge and will result in a crash!
Mod Bus: The mod bus is available via the top-level declaration dev.nyon.klf.MOD_BUS.
Included Libraries
- org.jetbrains.kotlin:kotlin-stdlib:2.3.21
- org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.3.21
- org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.3.21
- org.jetbrains.kotlin:kotlin-reflect:2.3.21
- org.jetbrains.kotlinx:kotlinx-serialization-core:1.9.0
- org.jetbrains.kotlinx:kotlinx-serialization-json:1.9.0
- org.jetbrains.kotlinx:kotlinx-serialization-cbor:1.9.0
- org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2
- org.jetbrains.kotlinx:kotlinx-coroutines-jdk8:1.10.2
- org.jetbrains.kotlinx:kotlinx-datetime:0.7.1-0.6.x-compat
- org.jetbrains.kotlinx:kotlinx-io-core:0.8.0
- org.jetbrains.kotlinx:kotlinx-io-bytestring:0.8.0
- org.jetbrains.kotlinx:atomicfu:0.29.0
Other
If you need help with any of my mods, just join my discord server.


