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.