NilKit API
by TamKungZ_
NilKit API is a developer toolkit library for NilLoader, supplying reusable utilities for legacy Minecraft mod development.
What it does
NilKit API collects helpers that mod authors can call from their own code. These include a lightweight event bus with cancellable events and listener priorities, typed annotation-based listeners, premain hijack lifecycle helpers, reflection helpers for version-dependent Minecraft code, and SRG/CSRG mapping utilities with mapping inspection, reversal and chaining lookup. A general-purpose KDL parser and writer is included for richer project and mod metadata.
The library cuts down the repeated code that authors write around event handling, reflection, mappings and project metadata. Minecraft-specific functionality still depends on the mappings structure of the target game version. NilLoader itself, including its loading lifecycle, is maintained separately, and NilKit complements NilLoader rather than replacing it. The official NilLoader project is required to use it.
Key features
Lightweight event bus
An event bus supports cancellable events and listener priorities, so handlers can run in a defined order.
Annotation-based listeners
Typed listeners are registered through annotations, which reduces manual wiring in mod code.
Mapping utilities
SRG and CSRG mappings can be inspected, reversed and chained through a lookup interface.
Reflection helpers
Helper methods handle reflection on Minecraft code whose structure differs between game versions.
Gallery
Compatibility
Latest build for each game version and loader.
26.x3 of 3 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x2 of 2 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
51 older game versions (1.2.1 – 1.13) not shown. All files on Modrinth
Use cases
Legacy mod development
Authors maintaining mods across many older game versions can share event, reflection and mapping code instead of rewriting it.
Metadata handling
The bundled KDL parser and writer let a mod keep richer project and mod metadata in a readable format.
Who it’s for: The library is for mod developers who build on NilLoader and want shared utilities for events, reflection, mappings and metadata. Players who only install finished mods have no use for it.
Questions
Does NilKit API need NilLoader?
Which Java version does NilKit API target?
Does NilKit API have to be installed on both sides?
Are the Minecraft-specific parts tied to one version?
In the catalog
NilKit API is one of 3,514 Library mods on ModsFinder. 15,189 mods support Minecraft 26.1.2.
More from TamKungZ_
What the author says
An independent utility API and developer toolkit for mods built with NilLoader. NilKit is not part of the official NilLoader project and is not required to use NilLoader.
Official listing
- Modrinth page
- modrinth.com/mod/nilkit
- Owner
- TamKungZ_
- Published
- 2026-03-21
- Updated on Modrinth
- 2026-08-06
- Facts verified
- 2026-10-15