NilLoaderSDK API

Mod

Utilities and helper SDK for NilLoader mod development. The purpose is to make developing older versions of Minecraft easier.

Type

Mod

Modrinth Downloads

100

Modrinth ID

bEmV8Hhn

Last Updated

Jun 12, 2026

Description

NilLoaderSDK

NilLoaderSDK is a Java 8 utility SDK for NilLoader-based Minecraft mods (legacy versions).

It provides:

metadata helpers for NilLoader + KDL
runtime bootstrap for KDL-only mods
reflection/remapping helpers
event bus and lifecycle events
NIO networking utilities

Why NilLoaderSDK?

NilLoaderSDK is not only metadata tooling. It is a practical utility layer for legacy NilLoader mod development, with reusable APIs that reduce boilerplate and speed up feature development.

Use it when you want a single toolkit for lifecycle dispatching, reflection/remapping, networking, event handling, and modernized metadata support.

Key Features

Lifecycle + Entrypoint system
- premain / hijack dispatching via ServiceLoader, JVM properties, and properties file
- Default SDK modules for centralized startup flow
Event bus for mod architecture
- Lightweight event system with cancellable events and priority ordering
- Lifecycle events for pre/post entrypoint dispatch hooks
Networking stack (Java NIO)
- Client/server implementations with packet registry and codec
- Optional auto-network bridge for fast integration
Reflection + remapping helpers
- Utilities for interacting with obfuscated legacy internals safely and repeatedly
Metadata bridge (CSS + KDL)
- Supports .nilmod.css and .nilsdkmod.kdl
- KDL-only runtime bootstrap for SDK-aware mods when root CSS is absent
- Dependency policy support (requires, safeload, load order hints)
Diagnostics for pack/mod developers
- Verbose bootstrap pipeline logs
- Loaded-mod table output:
  - ID | Name | Version | Authors | License

Metadata Example (.nilsdkmod.kdl)

nilmod { name "My Mod" description "Example mod" authors "Author" version "1.0.0" } entrypoints { premain "com.example.MyPremain" hijack "com.example.MyHijack" } nilloadersdk { requires "nilloader" "nilloadersdk" load_after "nilloadersdk" icon "assets/mymod/icon.png" modurl "https://modrinth.com/mod/my-mod" sourceurl "https://github.com/example/my-mod" license "MIT" credits "Author" }

Dependency (Gradle)

repositories { maven { url "https://repo.tamkungz.me" } } dependencies { implementation "me.tamkungz.nilloadersdk:nilloadersdk:2.0.1" }

Repository: https://repo.tamkungz.me

Keywords (for search)

NilLoader, NilLoaderSDK, Minecraft 1.4.7, legacy Minecraft modding, Java 8 modding, entrypoint framework, event bus, NIO networking, reflection helper, remapping tools, KDL metadata, nilmod SDK.