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.1-k2.4.0-$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.4.0
• org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.4.0
• org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.4.0
• org.jetbrains.kotlin:kotlin-reflect:2.4.0
• 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.