ВЕРСИИ (104)

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [3.0.0] - 2026-10-23 JAUML grows from a JSON config library into the common library for NightBeam mods. Every 2.x API is kept with unchanged signatures; mods built against 2.x keep working. ### Added - **Typed configs** (`tn.naizo.jauml.config`): `JaumlConfig.bind(subdir, name, MyConfig.class)` binds a plain Java class to a JSON file. `@Comment` text and `@Range` bounds are written as `//` comment lines, comments are accepted when reading, missing keys get defaults, wrong types are coerced, out-of-range values are clamped, and change listeners, `update`, `reload`/`reloadIfChanged` and `JsonMigrator` migrations are supported. - **Platform facade** (`tn.naizo.jauml.platform`): `Platform` (loader, physical side, game and config directories, Minecraft version, mod versions with range checks) and `Services.load` for a mod's own `META-INF/services` implementations. Replaces the per-mod MultiLoader `Services`/`IPlatformHelper` copy. - **Server events and scheduler** (`tn.naizo.jauml.server`): `ServerEvents` (starting, started, stopping, stopped, tick start/end, `currentServer()`), `PlayerEvents` (join, leave) and `Scheduler` (`runLater`, `runRepeating`, `queueServerWork`), fired from Fabric API, NeoForge and Forge events. - **`Event<T>`** (`tn.naizo.jauml.event`): a small prioritized listener list for mods' own events. - **Utilities**: `Version`/`VersionRange` (Maven ranges, comparators, `~`/`^`, wildcards) and `Cooldowns` (per-key cooldowns on any clock). - **`PlatformProvider`** default methods: `getGameDirectory`, `isPhysicalClient`, `getModVersion`, `getModName`, `getLoadedModIds`, `getMinecraftVersion`. - Root Gradle build (`./gradlew buildAll`, `testAll`, `cleanAll`, `syncVersion -PmodVersion=x.y.z`) and a CI workflow that tests and builds every workspace. - `-Djauml.selfTest=true` boot check that logs every server event and a scheduler run, plus GameTest server runs (`runGameTestServer`, `runGametest`) in the 26.x loader modules and 1.20.1 Forge to use it without a EULA prompt. ### Changed - **Supported Minecraft versions: 1.20.1, 1.21.1, 26.2 and 26.3.** The 1.21.11 and 26.1.2 workspaces are removed. - Each jar declares only its own Minecraft version (`[26.2,26.3)`, `[26.3,26.4)` instead of `[26.x,27)`). - On Fabric, JAUML recommends Fabric API; without it configs still work and server events stay idle with a warning. - Fabric 1.20.1 now needs Fabric Loader 0.16.10 or newer (the minimum of current Fabric API 0.92.12). - `JaumlConfig.isCompatible` accepts 2.x requirements (`API_BASELINE_MAJOR = 2`). - `JaumlConfigLib` stays deprecated but is no longer marked for removal; its signatures are pinned by a test. - `Constants.MOD_VERSION` reads `JaumlConfig.LIBRARY_VERSION`, and a test fails if it drifts from `gradle.properties`. - Platform providers are loaded once and shared (`PlatformUtil`, `JaumlInitializer` and `JaumlConfig` no longer each scan `ServiceLoader`). - Loader entrypoints no longer log template "Hello world" messages. - **Toolchains**: 26.2 and 26.3 on Gradle 9.8.1, Fabric Loom 1.19.3 and ModDevGradle 2.0.148; Fabric API 0.165.0+26.3 / 0.161.0+26.2 / 0.116.17+1.21.1 / 0.92.12+1.20.1; NeoForge 26.3.0.95 (stable) / 26.2.0.93 / 21.1.264; Forge 47.4.28; Parchment 2024.11.17 for 1.21.1; Fabric Loom 1.10.5 for 1.21.1. ### Removed - Minecraft 1.21.11 and 26.1.2 builds (use JAUML 2.3.1 on those versions).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.1] - 2026-09-30 ### Added - Minecraft **26.3** MultiLoader workspace (Fabric and NeoForge), matching the existing `26.2` layout. ### Changed - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.1**. - **Build (26.3)**: Gradle 9.7.0, Fabric Loom 1.18.2, and ModDevGradle 2.0.148 (required for NeoForge 26.3 artifact generation).

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## [2.3.0] - 2026-09-10 ### Added - **`ConfigFile`**: `asJsonObject()` / `getRoot()` returning a deep clone of the root JSON object. - **`ConfigFile`**: Path-based accessors — `getByPath`, `setByPath`, `getStringByPath`, `getIntByPath`, `getBooleanByPath`, `getDoubleByPath` (with default-value overloads). - **`ConfigFile`**: `setBackupRotation(int)` for multi-generation `.bak` rotation on corrupted config recovery. - **`ConfigFile`**: `reloadIfChanged()` to reload only when file size or mtime changed. - **`ConfigFile`**: `setStableSave(boolean)` opt-in deterministic save via `JsonLib.stableStringify`. - **`JaumlConfig`**: `invalidate(String, String)`, `invalidate(Path)`, and `clearCache()` for cache management. - **`JsonMigrator`**: `setPreferredVersionKey(String)` to control which version key is read and updated during migration. - **`JsonLib`**: `detectVersion(JsonElement, String preferredKey)` overload checking a preferred key first. - **`JaumlInitializer`**: `initializeWithDemoConfig()` for explicit demo config workflow; `initialize()` now skips demo config write in production. - **`JsonSchema`**: Optional constraint keywords — `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `additionalProperties: false`, and `minItems`/`maxItems`. Schemas that omit these keywords behave exactly as before. - **`tn.naizo.jauml.util`**: Optional utility package — `PlatformUtil`, `JaumlLogger`, `ModuleVersion`, and `Lifecycle` helpers. Additive only; core config API unchanged. ### Changed - **Build (Phase 4)**: Explicit `compileOnly` Gson and SLF4J API dependencies in all MultiLoader workspaces; `26.1.2` migrated from `buildSrc` to composite `build-logic` (aligned with `26.2`). See `BUILD.md`. - **`ConfigFile`**: `save()` now writes atomically via a temp file and `Files.move` (with `ATOMIC_MOVE` when supported). - **`JaumlInitializer`**: `initialize()` logs compatibility and library version but only writes demo config in development environments or when `-Djauml.writeDemoConfig=true`. - **Version alignment**: `LIBRARY_VERSION`, all workspace `gradle.properties`, and all `MOD_VERSION` constants bumped to **2.3.0**. - **README**: Fixed usage example to use `asJsonObject()` and typed getters instead of nonexistent `config.get()`. ### Fixed - Documentation and migration guide updated for 2.3.0 compatibility matrix while preserving 2.0 API support.

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-neoforge-26.2-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-neoforge-26.1.2-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-neoforge-1.21.11-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-neoforge-1.21.1-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-forge-1.20.1-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-fabric-26.2-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-fabric-26.1.2-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-fabric-1.21.11-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-fabric-1.21.1-2.1.1.jar

## Jauml 2.1.1 ### Bug Fixes * Fixed Fabric/NeoForge 26.1.2 crash from stub MixinMinecraft missing @Mixin (#3/#4). ### File * jauml-fabric-1.20.1-2.1.1.jar

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

### Added - **`JsonLib`**: Modern JSON utility class providing: - `safeParse` for exception-free parsing. - `strictParse` to enforce standard RFC 8259 compliance. - `stableStringify` for key-sorted deterministic JSON serialization. - `deepClone` for clean nested JSON copies. - `getByPath` and `setByPath` for dot-bracket path navigation (e.g. `settings.users[0].name`). - `merge` to recursively combine configuration layers. - `normalize` to apply type coercion and default templates to user configurations. - `detectVersion` for finding schema version tags. - **`JsonSchema`**: Embedded lightweight JSON Schema validator supporting type checks, required keys constraint, object property validation, and array item schema checking. - **`JsonMigrator`**: Sequence-based directed BFS path-finding migrator for sequential version upgrades. - **`JsonException`**: Unified, typed exception class for all library errors. - **`JaumlInitializer`**: Mod-level startup checker verifying configuration health, executing migrations, and performing library/app compatibility checks. - **JUnit 5 Test Framework**: Shared test suite inside `common-shared` running tests natively across all supported Minecraft versions. - **Launch Verification script**: PowerShell runner `verify_launch.ps1` to clean, compile, run tests, and package mod jars automatically. ### Changed - **`ConfigFile`**: Enhanced in-place with: - Graceful recovery of corrupted config files (backs up corrupted configs to `.json.bak` and re-creates clean configs from default templates). - Implicit type coercion and template normalization during loads. - Schema validation check support. - Auto-migrations before initialization. - **`JaumlConfig`**: Added overloaded `open` methods supporting schemas, migrators, and default templates. Added runtime checks (`LIBRARY_VERSION` and `isCompatible`).

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

* Standardized Java toolchain configuration across all supported versions. * Added `targetJavaVersion` support for consistent Java compilation. * Fixed NeoForge metadata generation by exposing `neoforge_version_range`. * Updated `neoforge.mods.toml` files to use proper `versionRange` values. * Added the correct NeoForge dependency declaration. * Fixed and reordered Minecraft dependency metadata for `1.21.11`. * Normalized TOML fields such as `modId`, `type`, `ordering`, and `side`. * Updated `NeoForgePlatformHelper` to use `FMLEnvironment.isProduction`. * Added Gradle publishing/component fixes for `26.1.2`. * Set NeoForge component variants to target JVM 21. * Added custom Gradle attributes to separate Java and resource configurations.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

- Optimized start-up process and fixed some issues.

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

Added 3 new methods * **`clearArray`** * **`removeArrayElement`** * **`getArrayAsList`**

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.

- Switched build system from **`net.minecraftforge.gradle`** to **NeoForged `moddev.legacyforge`**. - Improved array search: - The `find` method now also matches **substrings** in the array, allowing for more flexible and accurate search results. - Updated **Mod Icon** with a new design.