[4.1.0] - 2026-08-06

Byte Buddy patching framework

• Expanded the Byte Buddy integration from a thin helper wrapper into a reusable patching framework designed for Mixin-style runtime transformations.
• Added ByteBuddyPatch as a declarative patch definition API for targeting classes and applying multiple transformations without manually recreating AgentBuilder or transformer boilerplate.
• Added ByteBuddyPatchRegistry for managing multiple patches with deterministic ordering and configurable priorities.
• Added JVM descriptor-based method matching for more reliable targeting across mapped, obfuscated, and legacy Minecraft environments.
• Added patch validation through require(...), allowing transformations to fail immediately when an expected method or target is missing instead of silently continuing with an unapplied patch.
• Added reusable Advice-based injection support for method entry, method exit, constructors, argument modification, return-value modification, and exception handling.
• Added support for replacing complete method implementations through direct Byte Buddy interception.
• Added low-level transformation access through mutate(...), allowing patches to use raw Byte Buddy features such as MemberSubstitution, ASM visitors, field/method definitions, implemented interfaces, and custom builder mutations.
• Kept the underlying Byte Buddy API exposed so advanced transformations are not restricted by the higher-level NilKit abstraction.

Runtime transformation

• Added a NilLoader transformation bridge so registered Byte Buddy patches can participate directly in NilLoader class transformation without requiring Byte Buddy self-attachment.
• Added optional Instrumentation-based installation with retransformation support for environments where already-loaded classes must be patched.
• Preserved explicit Byte Buddy Agent attachment behavior; NilKit still does not automatically invoke ByteBuddyAgent.install() during SDK startup.
• Added composition support so multiple independent patches can safely target the same class through a single transformation pipeline.
• Improved transformation diagnostics and failure behavior for incompatible targets, incorrect mappings, and changed method descriptors.

Documentation

• Added documentation and examples for using the Byte Buddy patch API as a Mixin-style transformation layer.
• Documented patch registration, priorities, required targets, Advice injection, full method interception, and advanced raw Byte Buddy mutations.
• Added examples showing integration through the NilLoader transformer bridge without requiring a Java agent.

Refactor Project

[3.0.2] - 2026-08-06

Developer toolbox

• Added the optional [SDK]-3.0.2-all.jar developer toolbox with Byte Buddy 1.17.6, Byte Buddy Agent 1.17.6, GEB core 0.5.4, ClassGraph 4.8.184, and SnakeYAML 2.6, keeping upstream package names unrelocated for direct imports.
• Added DeveloperToolbox capability checks plus ByteBuddyHelper, ClassGraphHelper, YamlHelper, and GebHelper convenience APIs.
• Byte Buddy self-attachment remains explicit; SDK startup never calls ByteBuddyAgent.install() automatically.
• YAML helpers use SafeConstructor, reject duplicate mapping keys, and cap aliases for safer configuration loading.
• Moved GEB's processor to the Gradle annotationProcessor configuration. It is build-time tooling and is not bundled in the runtime shadow JAR.
• Optional toolbox dependencies are available to SDK compilation/tests but are not published as transitive dependencies of the normal Maven artifact.

Build and publishing

• Ensured assemble/build creates the -all.jar and standalone -mapping-tool.jar alongside the normal JAR.
• Attached both classified JARs to the Maven publication so project-local GPG publishing signs them together with sources/Javadocs.
• Moved signing configuration after classified artifact attachment and added project license/implementation metadata to the standalone mapping-tool JAR.
• Simplified the Windows Gradle launcher to respect the active JAVA_HOME selected by actions/setup-java before scanning other installed JDKs, while still rejecting unsupported Java 25 for Gradle 8.8.
• Preserved service-provider metadata in the shadow JAR and added third-party notices/license files to the distribution.
• Restored GitHub Actions build.yml for Ubuntu/Windows on JDK 17/21 and release.yml for v* tags, including tag/version validation, changelog extraction, SHA-256 checksums, and GitHub Release creation.
• Restored release helper scripts and a submodule guard that detects a missing 160000 Git link for tools/MinecraftRemapping.

Fixed and documented

• Replaced the accidental Gradle snippet previously stored in THIRD_PARTY_LICENSES.md with an actual third-party license inventory.
• Updated stale 3.0.1 metadata and documentation references to the in-development 3.0.2 release.
• Kept complete mapping data outside release artifacts; mapping input continues to come directly from tools/MinecraftRemapping.

[3.0.1] - 2026-08-05

Compatibility

• Removed the SDK's hard bytecode link to net.minecraft.client.Minecraft; McHelper now resolves the mapped Minecraft class lazily through reflection only when Minecraft-specific helpers are called.
• Removed the compile-time game / jarmod Minecraft 1.4.7 dependencies from the SDK build. The core artifact no longer needs a Minecraft JAR to compile.
• Removed unused external ASM 9.5 runtime dependencies; transformer helpers already use the loader's shaded ASM API, avoiding unnecessary ASM classpath conflicts in -all.jar.
• MinecraftAutoNetworkBridge no longer assumes Minecraft 1.4.7. When explicitly enabled it reads -D[sdk].minecraft.version=<version> and disables itself safely if the version or mappings are unavailable.
• Added regression coverage that rejects hard net.minecraft.* type references in the Minecraft-facing SDK classes.

Mapping workflow

• Removed the .remapping staging workflow. tools/MinecraftRemapping is now the single source path for mapping data.
• Gradle mapping generation reads tools/MinecraftRemapping/<version>/mcp2obf.srg directly from the pinned submodule.
• Fixed SimpleRemap so release JARs actually consume the generated mapping subset; 3.0.0 generated GeneratedSrgMappings but never called it.
• Replaced prepareRemapping / import-submodule with direct inspectMinecraftRemapping, inspect-submodule, and submodule-path workflows.
• Updated gen_srg_mappings.py to use project-relative paths instead of a machine-specific absolute Windows path.

Build fixes

• Removed duplicate declarations accidentally left in build.gradle 3.0.0 mapping-generation code.

[3.0.0] - 2026-08-05

Added

• Added agaricusb/MinecraftRemapping as an external Git submodule configuration at tools/MinecraftRemapping, pinned by the bootstrap scripts to 8ca7ba25dfd67eae43b3c73d02603ff6c085a6d7.
• Added a Java 8-compatible SRG/CSRG mapping API: SrgMappingSet and SrgMappings.
• Added MappingToolMain with inspect, reverse, chain, lookup, list-submodule, and import-submodule commands, plus a standalone mapping-tool JAR that contains no mapping data.
• Added Gradle mappingTool and prepareRemapping tasks for local mapping workflows.
• Added MAPPINGS.md documenting mapping-source policy and local-only import behavior.
• Added cross-platform Gradle launcher JVM discovery for Linux/macOS and Windows. JDK 21 and 17 are preferred automatically so a system-wide Java 25 does not break Gradle 8.8.
• Added GitHub Actions build.yml for push/pull-request builds and tests on Ubuntu/Windows with JDK 17/21.
• Added GitHub Actions release.yml for v* tags. Releases are created only after build/tests succeed, include JARs plus SHA-256 checksums, and use the matching CHANGE.md section as the release body.
• Added release helper scripts that verify tag/project version consistency and extract one changelog section.

Changed

• Bumped the SDK and metadata version to 3.0.0.
• Java compilation now targets Java 8 with --release 8 while Gradle itself runs on a supported modern launcher JDK; a dedicated local JDK 8 installation is no longer required for normal builds.
• Complete mapping collections are no longer shipped in the project ZIP/release tree. .remapping/ remains gitignored and is treated as developer-supplied local build input.
• GitHub release responsibilities were separated from normal commit CI: build.yml only validates commits/PRs, while release.yml owns tagged releases.

Fixed

• Fixed Gradle 8.8 startup failing under Java 25 with Unsupported class file major version 69 by selecting a compatible installed launcher JDK before Gradle starts.
• Fixed old mapping workflows relying on copied 100+ MB mapping trees by replacing them with explicit local import tooling and an external submodule reference.
• Mapping parsing now reports conflicting entries instead of silently replacing them, mapping composition keeps method descriptors namespace-correct, and CSRG member resolution no longer depends on class-entry order.

[2.1.0] - 2026-08-05

Added

• Added project-local Maven publishing to ./maven via publishProjectLocal; publications are OpenPGP-signed with the user's normal GnuPG / gpg-agent setup.
• Added inherited event-listener discovery, typed-listener unregistration, and event-bus clearing APIs.
• Added cooldown remaining-time queries and expired-player cleanup.
• Added NIO client/server state inspection (isRunning, isConnected, connection snapshots/counts) and server bound-port lookup.
• Added default listener hooks for unknown packet IDs and exhausted client reconnect attempts without breaking existing listener implementations.
• Added packet-registry inspection helpers (isRegistered, size, clear).
• Added lifecycle controls/state for the automatic Minecraft network bridge, including explicit stop() and automatic recovery after reconnect exhaustion.
• Added regression tests for KDL, cooldown concurrency, and packet codec/registry behavior.

Changed

• Normal build no longer forces loader decompilation; decompileLoader remains an explicit developer task.
• KDL scalar output now uses KDL 2 forms (#true, #false, #null, #inf, #-inf, #nan).
• KDL parsing now accepts common KDL 2 numeric forms, raw strings, quoted property keys, dotted identifiers, nested block comments, and slash-dash node/entry suppression while retaining legacy boolean/null compatibility.
• Event registration is de-duplicated, scans inherited subscriber methods, and preserves deterministic registration order for equal-priority handlers.
• Network listener callback failures are isolated from the selector loop; packet serialization failures no longer disconnect healthy peers.
• Network constructor and packet-registry inputs are validated early with clearer errors.

Fixed

• Fixed TargetFinder returning a nearby player that failed the requested minDot aim threshold and fixed target ranking to prefer alignment with distance as the tie-breaker.
• Fixed CooldownTracker.tryUseGlobal / tryUsePlayer race conditions so a cooldown window cannot be consumed concurrently by multiple callers.
• Fixed entrypoint phase re-entrancy during the pre-dispatch event by installing the active-phase guard before posting the event.
• Fixed NIO server duplicate disconnect callbacks and stale connection entries.
• Fixed NIO client reconnect attempts terminating permanently when opening a replacement channel throws immediately or when a non-blocking connect completes immediately.
• Fixed KDL writer/parser round-trip failures for quoted property keys and KDL 2 scalar values.
• Fixed zero/invalid look-vector and negative-range edge cases in TargetFinder.
• Fixed ReflectHelper.invoke contradicting its documented null-to-primitive-default behavior.
• Fixed automatic network bridge getting stuck with a dead client after reconnect exhaustion.
• Fixed local SRG mapping reads using platform-default encoding and added clearer version validation.

[2.0.1] - 2026-04-08

Added

• Added SDK runtime bootstrap for KDL-only mods (archives with .sdkmod.kdl but no root *.mod.css).
• Added KdlOnlyModBootstrapper to discover/inject such mods from mods/ and [loader]mods/ during SDK premain.
• Added verbose bootstrap diagnostics for KDL-only loading flow (candidate scan, KDL entry detection, metadata parse status, classpath injection, premain invocation).
• Added formatted loaded-mod summary table log:
  • ID | Name | Version | Authors | License

Changed

• Bumped SDK version to 2.0.1 in build and metadata resources.
• DefaultSdkEntrypointModule now runs KDL-only bootstrap before dependency enforcement.

Fixed

• Fixed KDL parser newline/block handling in nested sections, resolving KdlParseException during valid .sdkmod.kdl parsing.
• Improved metadata text decoding for runtime reads (UTF-8/UTF-16 BOM and UTF-16 heuristic fallback) in bridge and SDK metadata IO.
• Fixed KDL-only metadata resolution so injected mods now correctly expose name, version, and entrypoints instead of fallback ? values.

[2.0.0] - 2026-04-08

Added

• Introduced KDL support as a first-class metadata layer in 2.0.0.
  • Prior to 2.0.0, mods relied on the loader's CSS metadata only (*.mod.css).
  • 2.0.0 adds SDK KDL metadata (*.sdkmod.kdl) and runtime bridge integration.
• Introduced a general-purpose KDL toolkit for broad SDK usage (not metadata-only):
  • KdlParser, KdlWriter
  • KdlDocument, KdlNode, KdlValue, KdlParseException
  • Can be used by any system/module that needs KDL parsing/serialization.
• LoaderHelper convenience APIs for easier multi-mod integration and diagnostics:
  • isAllModsLoaded(String...)
  • getFirstLoadedMod(String...)
  • getEntrypoints(String)
  • hasEntrypoint(String, String)
  • getModsWithEntrypoint(String)
  • hasMissingRequiredMods(String)
  • getMissingRequiredModsForLoadedMods()
  • getModsRequiring(String)
• Forge/Fabric-like event architecture for easier mod development:
  • Global SDK access point: [SDK]
  • Event primitives: Event, CancellableEvent, EventPriority, SubscribeEvent
  • Central EventBus with:
    • annotation listener registration (@SubscribeEvent)
    • typed callback registration (listen style)
    • cancellation-aware dispatch flow
  • Lifecycle events:
    • PreEntrypointDispatchEvent (cancellable)
    • PhaseEvent
    • PostEntrypointDispatchEvent
  • Entrypoint dispatcher now emits lifecycle events around phase execution.
  • ModBase now includes convenience methods to register/post/listen events.
• SDK KDL metadata schema expanded with richer mod info fields:
  • modurl
  • sourceurl
  • license
  • credits (multi-value)

Changed

• Bumped SDK version to 2.0.0 in build and metadata resources.
• MetadataBridge now parses .sdkmod.kdl via shared KDL parser (KdlParser) instead of manual string parsing for better compatibility.
• KDL metadata merge now supports both section blocks (mod {}, entrypoints {}) and top-level fallback keys (name, description, authors, version, entrypoints.<phase>).

Fixed

• Removed inconsistent changelog carry-over for 1.0.4 under 2.0.0.

Notes

• New helper methods are Java 8 compatible and return immutable collections where applicable.
• Focus of this update is DX (developer experience): reduce repetitive loader metadata and dependency-check boilerplate in mods.
• Backward compatibility remains intact: CSS metadata stays primary, and KDL is additive for SDK-aware features.