NilKit API

NilKit API provides reusable utilities for mods built around NilLoader, with a particular focus on legacy Minecraft development.

模组前置库实用游戏机制管理

截图

介绍

中文介绍正在准备中，下面暂时显示原文。

<img src="https://raw.githubusercontent.com/NilKitAPI/NilKit-API/refs/heads/main/src/main/resources/assets/nilkit/icon.svg"

width=”40″
alt=””
aria-hidden=”true”>
NilKit API

An independent utility API and developer toolkit for mods built with NilLoader.

Important

NilKit is not part of the official NilLoader project and is not required to use NilLoader.

NilLoader is maintained separately at:
https://git.sleeping.town/Nil/NilLoader

NilKit provides reusable APIs and tooling for legacy Minecraft mod development, with a focus on reducing boilerplate around events, reflection, mappings, metadata, networking, and development utilities.

NilKit 4.1.0 targets Java 8 bytecode and does not require a hard runtime link to a specific Minecraft JAR for its core APIs. Minecraft-specific functionality remains dependent on the mappings and structure of the target game version.

Features

Events and lifecycle

Lightweight event bus
Cancellable events
Listener priorities
premain / hijack lifecycle helpers
Typed and annotation-based listeners

Reflection and legacy Minecraft tooling

Reflection helpers for version-dependent Minecraft code
SRG/CSRG mapping utilities
Mapping inspection, reversal, chaining, and lookup
Integration with the external MinecraftRemapping mapping repository during development

KDL

NilKit includes a general-purpose KDL parser and writer and can use KDL for richer project/mod metadata.

KDL support is optional. NilKit does not require NilLoader mods to use KDL, and standard NilLoader metadata remains fully supported.

Example:

nilmod {
  name "My Mod"
  description "Example mod"
  authors "Author"
  version "1.0.0"
}

entrypoints {
  premain "com.example.MyPremain"
  hijack "com.example.MyHijack"
}

nilkit {
  requires "nilloader" "nilkit"
  load_after "nilkit"

  icon "assets/mymod/icon.png"
  modurl "https://modrinth.com/mod/my-mod"
  sourceurl "https://github.com/example/my-mod"

  license "MIT"
  credits "Author"
}

Networking

Java NIO client/server utilities
Packet registry and codecs
Optional Minecraft-facing network helpers

Developer toolbox

The optional -all.jar also bundles several developer libraries without relocating their public packages:

Byte Buddy
GEB
ClassGraph
SnakeYAML

The normal NilKit artifact does not require these libraries at runtime.

Gradle

repositories {
    maven {
        url = uri("https://repo.tamkungz.me")
    }
}

dependencies {
    implementation "me.tamkungz.nilkit:nilkit:4.1.0"
}