Easter Holidays

[1.3.4] - 2026-05-10

Bug Fixes

Folia Compatibility

• Fixed Folia Cleanup Thread-Safety: All cleanup methods (/easter cleanup, /easter off, plugin shutdown) now use scheduler.runForEntity() / scheduler.runAtLocation() instead of accessing entities directly from the command thread. Fixes IllegalStateException on Folia servers.
  • EasterEggManager, EasterBunnyManager, ThemedMobManager - Entity access via entity scheduler
  • EasterBossManager - Changed runAtLocation to runForEntity for entity removal
  • CarrotGardenManager, BunnyHopPadManager - Block operations via location scheduler
  • BunnyHopChallengeManager - Player potion effects via entity scheduler
• Fixed Folia Scoreboard Crash: initializeDamageScoreboard() in EasterBossManager threw UnsupportedOperationException on Folia. Scoreboard API is now wrapped in try-catch and gracefully disabled on Folia servers.
• Fixed Folia Scoreboard Reset Crash: handleBossDeath() and spawnBoss() scoreboard operations now wrapped for Folia compatibility.

Easter Boss

• Fixed BossBar NPE & Duplicate Update: Removed duplicate setProgress() call without null-check in startBossAI() that caused NPE when BossBar was disabled.
• Fixed BossBar Cleanup NPE: Added null-check before bossBar.removeAll() in cleanup.
• Fixed Damage Sidebar Persisting After /easter killboss and /easter off: cleanup() did not reset player scoreboards - only handleBossDeath() (natural death) did. Sidebar now properly removed on all cleanup paths.
• Added Missing BossBar Config: Added easterBoss.bossBar section (enabled, color, style, range) to default config - values were used in code but never exposed in config.yml.

Easter Egg Cleanup

• Fixed Eggs Not Being Removed on /easter off: Cleanup checked item.getCustomName() (entity name) but Easter Eggs only have a display name on the ItemStack, not on the entity. Now correctly checks item.getItemStack().getItemMeta().getDisplayName().
• Fixed Language-Dependent Cleanup: Cleanup only matched English name "Easter Egg" but not German "Osterei". Now checks both languages plus the active language file dynamically.

Bunny Hop Pads

• Fixed Placement: Hop pad now spawns on top of the block the player is looking at (target block + 1) instead of replacing a block or spawning at the player's feet. Checks for free space above target block.
• Fixed Invalid Block Type: Changed default blockType from LIGHT_BLUE_SLAB (does not exist) to LIGHT_BLUE_CONCRETE.
• Fixed Extreme Boost Power: Changed default boostPower from 50.0 to 3.0 (reasonable value).

Commands & Events

• Fixed Event "parade" Not Recognized: Added "parade" as alias for "bunny-parade" in command handler and tab-completion.

Improvements

Easter Title GUI

• Improved Locked Title Display: Locked titles now show the title name (grayed out), the unlock requirement, and a visual progress bar instead of just "??? Locked".
• Added Progress Tracking: Each locked title shows current progress (e.g., |||||||||| 12/25) based on the player's egg/bunny stats.

[1.3.3] - 2026-04-29

Bug Fixes

• Fixed Folia Scheduler Crash: EasterBasketManager used the Bukkit Scheduler (runTaskTimerAsynchronously, runTaskAsynchronously) which throws UnsupportedOperationException on Folia. Replaced with FoliaSchedulerHelper for full Folia compatibility.

[1.3.2] - 2026-04-22

New Features

In-Game Loot Table Management

• New Admin Command: /easter drops - Manage loot tables and egg type chances without editing config files
  • Supports tiers: common, rare, legendary, boss (Easter Boss loot)
  • /easter drops list <tier> - View all items in a loot table
  • /easter drops add <tier> <MATERIAL:amount> - Add items to a loot table
  • /easter drops remove <tier> <index> - Remove items by index number
  • /easter drops chance - View current egg type spawn chances
  • /easter drops chance <type> <percent> - Set spawn chance for normal/golden/diamond/ eggs
  • Permission: easter.admin.drops
  • Changes are saved to config.yml immediately (no restart required)
  • Full tab-completion for all sub-commands and arguments

Configurable Egg Type Chances

• Egg type spawn chances are now configurable via config.yml instead of hardcoded
  • easterEggs.typeChances.normal (default: 94%)
  • easterEggs.typeChances.golden (default: 5%)
  • easterEggs.typeChances.diamond (default: 1%)
  • Warning when total doesn't add up to 100%

[1.3.1] - 2026-04-21

New Features

Give Loot Command

• New Admin Command: /easter giveloot <player> <tier> - Give loot rewards to players via command
  • Supports tiers: common, rare, legendary, boss
  • Uses the configured loot tables from config.yml
  • Gives a random item from the selected tier
  • Alias: /easter loot
  • Permission: easter.admin.giveloot
  • Full tab-completion for player names and tiers
  • Multi-language support (EN/DE)

Bug Fixes

Easter Boss & Region Protection

• Fixed Boss Invincibility Exploit in GriefPrevention Claims: Players could claim the land where the Easter Boss spawned, making it invincible to anyone except the claim owner
  • Added HIGHEST priority event handler that bypasses region protection for Easter Boss damage
  • All players can now damage the Easter Boss regardless of claim ownership
  • Prevents the exploit where players claim land under the boss to grief other players

Title System

• Fixed Race Condition on Player Load: Title data is now initialized synchronously before async database load, preventing data loss when players interact with the title GUI immediately after joining
• Fixed Single Title Unlock Bug: updateTitle() now unlocks ALL titles a player qualifies for, not just the highest one. Previously, a player with 500 eggs would only get "Epic Egg Hunter" but not the lower-tier titles
• Fixed Thread Safety Issues: TitleData.selectedTitle is now volatile, and unlockedTitles uses a thread-safe ConcurrentHashMap.newKeySet() instead of a regular HashSet
• Fixed Potential NullPointerExceptions: Added null checks for ItemMeta in title GUI creation (both title items and clear button)
• Fixed Fragile GUI Lock Detection: Title GUI now checks Material.GRAY_DYE instead of checking display name for "Locked" text, which failed with non-English languages
• Fixed Shutdown Data Loss Risk: Replaced Thread.sleep(2000) with CompletableFuture.allOf().get(5s) to properly wait for all async save operations to complete

Command System

• Added /easter title select none and /easter title select clear: Players can now remove their title via command instead of only through the GUI

Database Repair

• Added titles.db to /easter dbrepair: Title database is now included in all repair operations (check, fix, backup) alongside statistics and baskets

Improvements

• Invalid Title Logging: parseTitles() now logs a warning when encountering unknown title entries in the database instead of silently skipping them

[1.3.0] - 2026-04-06

🐛 Bug Fixes

Command System

• Tab-Completion: Added missing commands to auto-complete
  • Added aliases: lb, top for leaderboard
  • Added aliases: repairdb for dbrepair
  • Added aliases: jukebox for music
  • Added resource pack commands: pack, resourcepack, texturepack
  • All commands now properly appear in tab-completion

Leaderboard System

• Fixed "Unknown User" Bug: Players in leaderboard now show correct names
  • Automatically resolves player names using Bukkit OfflinePlayer API
  • Updates database with resolved names to prevent future issues
  • Handles old database entries with missing or invalid names
  • Improved name resolution for offline players

Easter Basket System

• Fixed Item Loss Bug: Items no longer disappear from baskets
  • Added backup mechanism during save operations
  • Improved transaction handling with proper rollback on errors
  • Added auto-save every 5 minutes for modified baskets
  • Asynchronous saving to prevent main thread blocking
  • Better error handling and recovery
  • Fixed race conditions during inventory close events

🔧 Improvements

• Database Operations: More robust error handling and logging
• Performance: Asynchronous basket saving reduces server lag

📖 Documentation

• Updated plugin.yml: Complete command documentation with all aliases
• Improved help text: Added all command variations and options