AllItemsMini – Mini All Items Challenge

[2.2.0] - 2026-05-26

🎉 New Features

• Added: Update checker now filters by the running Minecraft version. Modrinth versions whose game_versions array does not include the server's exact or major.minor line are skipped, so a 1.22 release is never advertised to a 1.21 server.

🐛 Bug Fixes

• Fixed: /aic reload after a blacklist change no longer inflates or deflates the submitted-count. Already-handed-in items that survive the new filter remain "done"; the order is repartitioned (done first, pending after) and index is recomputed accordingly.
• Fixed: pendingOffhand and the new tick-dedup map are now ConcurrentHashMap — on Folia, events for different players fire on different region threads, and the previous HashMap could corrupt under concurrent put/remove.
• Fixed: Explicit guard against double submission when both HAND and OFF_HAND events fire in the same physical right-click. Previously this was implicitly prevented by nulling the offhand mid-handler — fragile if the API ever changes.
• Fixed: mergeDefaults() now explicitly loads the packaged config.yml and calls setDefaults() before copyDefaults(true), so new config keys are actually written on update (the old call had no defaults set on second start and silently no-op'd).
• Fixed: Msg.getKey() now uses Locale.ROOT for lowercasing, avoiding the Turkish-locale I → ı bug that would break every translation lookup on tr_TR servers.
• Fixed: PlayerQuitEvent offhand-restore now falls back to Inventory.addItem() / drop if the offhand was somehow refilled between submission and quit — no item loss.
• Fixed: Eliminated the double saveState() call at challenge completion (stopGame() already persists).
• Fixed: UpdateChecker.isNewer() now considers a remote release newer than a local pre-release with the same numeric components (e.g. 2.1.0 > 2.1.0-rc.1).
• Fixed: /aic usage in plugin.yml now lists the timer subcommand.
• Fixed: Offhand-restore lambda no longer silently drops a submitted item if the offhand slot was refilled by another plugin / auto-pickup between submission and the next tick — falls back to Inventory.addItem() and drops any overflow at the player's feet, mirroring the PlayerQuitEvent handler.

🔧 Changes

• Changed: Replaced deprecated Bukkit.broadcastMessage(String) with an Adventure Component-based broadcast() helper using LegacyComponentSerializer.legacySection().
• Changed: Replaced deprecated Player.sendActionBar(String) with the Component overload.
• Changed: Replaced deprecated JavaPlugin.getDescription().getVersion() with getPluginMeta().getVersion() (Paper 1.20.6+ migration).
• Changed: loadBlacklistFromConfig() no longer also loads the language — split into loadBlacklistFromConfig() and loadLanguageFromConfig(). Method names now match what they do.
• Changed: Broadcast of BROADCAST_START moved from CommandHandler into AllItemsMini.startGame() so the safe() wrapper covers the full effect of the /aic start command (no more "Error" message after a successful start if broadcast throws).
• Changed: Logger messages unified to English throughout (AllItemsMini, UpdateChecker) — previously a mix of German and English.
• Changed: Gson now declared explicitly as a provided dependency in pom.xml (was relied on transitively from Paper).
• Changed: /aic timer tab-completion now also suggests the German aliases an/aus/pause/resume that the command already accepted.

🗑️ Removed

• Removed: Unused Lang.fromSystemLocale() method.

[2.1.0] - 2026-04-24

🎉 New Features

Folia Support

• Added: Full Folia compatibility via runtime detection - the plugin now works on both Paper and Folia servers
• Added: SchedulerUtil utility class that automatically selects the correct scheduler API (BukkitScheduler on Paper, regionized schedulers on Folia)

Modrinth Update Checker

• Added: Automatic update check against the Modrinth API on server startup
• Added: Semantic version comparison (SemVer) - correctly determines if a remote version is newer
• Added: In-game update notification for admins (players with allitems.admin) on join
• Added: Configurable via update-check: true/false in config.yml
• Added: Update messages in all 4 languages (DE, EN, FR, ES)

Tab-Complete

• Added: Tab-completion for /aic subcommands (start, stop, reset, show, skip, timer, reload)
• Added: Tab-completion for /aic timer options (on, off, start, stop, reset)

bStats Metrics

• Added: bStats integration for anonymous usage statistics

🐛 Bug Fixes

• Fixed: Race condition in offhand item submission - items are now tracked in a pending map and restored via PlayerQuitEvent if the player disconnects during the 1-tick restoration window
• Fixed: Invalid materials in progress.yml (e.g., after a Minecraft version update) are now counted and logged with a summary warning instead of being silently dropped
• Fixed: BossBar is now explicitly removed via Bukkit.removeBossBar() on plugin disable instead of just clearing players

🔧 Changes

• Changed: Plugin now officially supports all 1.21.x versions (1.21, 1.21.1, ... 1.21.11+) via api-version: "1.21" and folia-supported: true
• Changed: Unobtainable item filter is now string-based instead of hardcoded enum references - automatically adapts to the running server version
• Changed: Config automatically merges missing keys on startup via copyDefaults - new config options are added without overwriting existing values

🗑️ Removed

• Removed: Unused exportDefaultLanguageFiles() method from MessageProvider

📁 New Files

• src/main/java/org/example/allitems/SchedulerUtil.java - Platform-agnostic scheduler wrapper
• src/main/java/org/example/allitems/UpdateChecker.java - Async Modrinth update checker

---

[2.0.0] - 2026-01-11

🎉 Major Features

YAML-Based Multi-Language System

• Added: Complete YAML-based translation system replacing hardcoded messages
• Added: French (fr_FR) language support
• Added: Spanish (es_ES) language support
• Added: Live-reloadable translations via /aic reload without server restart
• Added: Automatic fallback to English for missing translation keys
• Added: Lazy loading and in-memory caching for optimal performance
• Added: Thread-safe language file operations using ConcurrentHashMap

Developer Documentation

• Added: Comprehensive Javadoc (in English) for all classes and methods
• Added: Class-level documentation for AllItemsMini with features overview
• Added: Detailed method documentation for MessageProvider (237 lines)
• Added: Complete documentation for ChallengeTimer state management
• Added: Full Javadoc for CommandHandler routing logic
• Added: Enhanced documentation for Lang enum with locale detection
• Added: Documented Msg enum with YAML key conversion

Code Modernization

• Improved: MessageProvider now uses modern Java 21 features
• Improved: Added @NotNull and @Nullable annotations throughout codebase
• Improved: Enhanced null-safety with explicit checks and fallbacks
• Improved: Modernized stream operations and lambda expressions
• Improved: Better error handling with proper exception logging
• Improved: Improved code organization and separation of concerns

🔧 Changes

• Changed: Default language is now English (was German) - BREAKING CHANGE
• Changed: Msg enum simplified to pure key enum (removed hardcoded translations)
• Changed: Lang enum expanded with fileName field for YAML file mapping
• Changed: MessageProvider constructor now requires JavaPlugin instance
• Changed: Language loading moved to runtime instead of compile-time

📁 New Files

• src/main/resources/lang/de_DE.yml - German translations (47 keys)
• src/main/resources/lang/en_US.yml - English translations (47 keys)
• src/main/resources/lang/fr_FR.yml - French translations (47 keys)
• src/main/resources/lang/es_ES.yml - Spanish translations (47 keys)

🐛 Bug Fixes

• Fixed: Language reload now properly clears cache and reloads all files
• Fixed: Invalid format strings now log warnings instead of crashing
• Fixed: Missing translation keys now show placeholder instead of null

📚 Documentation

• Updated: README.md with comprehensive language system documentation
• Updated: README.md with developer documentation section
• Updated: README.md with language customization instructions
• Added: Reference to CHANGELOG.md in README

⚠️ Breaking Changes

• Default language changed from German to English Migration: Add language: de to your config.yml to restore German

[1.3.1] - 2025-12-18

Fixed

• CRITICAL: Fixed item duplication bug where items were duplicated upon submission due to the offhand item not being removed before restoration in the next tick.
• CRITICAL: Fixed armor piece swap bug where armor pieces would swap with equipped armor and disappear instead of being properly submitted. Items are now immediately removed from the offhand before restoration to prevent Minecraft's auto-equip behavior.
• Fixed race condition where players disconnecting or changing their offhand between submission and restoration could cause issues. Added online check and offhand state validation before restoration.
• Removed redundant null checks for ItemStack instances (modern Bukkit never returns null, only AIR).
• Fixed encoding issue in code comment.