Christmas Season

[2.3.0] - 2026-07-03

Major Update: Minecraft 26.x support, full Adventure API migration, and a deep thread-safety/reliability overhaul of the entire 2.2.0 feature set.

Upgrade Priority: HIGH - contains critical Folia fixes and data-safety hardening

Added

• Minecraft 26.x support - one JAR covers 1.21.3-1.21.11 (Java 21) AND the year-based 26.x versions (Java 25); compiled against Paper API 26.1.2.build.72-stable, api-version: "1.21" remains the minimum
• Gift chest protection - hoppers and explosions can no longer empty/destroy gift chests; gift chests carry a PersistentDataContainer marker so cleanup can never delete player chests (configurable via gifts.protectChests)
• Orphaned mob cleanup - event mobs whose chunks were unloaded during /xmas off are removed automatically when their chunks load while the event is inactive
• Config validation on startup/reload - warns about unknown materials in loot tables and an invalid biome.target
• Tab completion for /xmas now includes biome names from the registry

Changed

• Full Adventure API migration - Component-based entity/item/chest names and broadcasts, RegistryAccess instead of Registry.BIOME, zero deprecated API usage in the build
• Reliable /xmas off restore - completion is tracked per chunk (atomic counters); failed chunks keep their snapshots and are retried on the next run; accurate final statistics; reentrancy guard against double /xmas off; /xmas on during a running restore can no longer leak the database
• Folia hardening of the 2.2.0 feature line - all entity-scheduler tasks use retired-callbacks (killed event mobs no longer clog the spawn caps), one shared FoliaLib instance, spawn limits re-checked inside region tasks
• JAR size reduced from ~13.6 MB to ~5 MB (excluded unused SQLite natives)
• /xmas reload restarts ALL managers, so new config values apply immediately
• Language files normalized to & color codes; literal & ("Wichtel & Elfen") no longer mangled; console logs free of raw color codes
• Removed ~200 lines of dead code (legacy 2D snapshot format, disabled seed-restore machinery)

Compatibility

• Paper/Purpur/Folia only - plain Spigot is no longer supported (Adventure API required)
• Minimum is Minecraft 1.21.3 - on 1.21.1/1.21.2 the plugin fails with IncompatibleClassChangeError (Biome changed from enum to interface in 1.21.3)

Verified

• Live function tests on Paper 26.2 (Java 25), Paper 1.21.11 and Folia 1.21.11 with bot-driven end-to-end runs: biome bubble, 180-208-chunk restores without errors, backup commands, kill-wave spawn-cap test - zero exceptions