Easter Holidays

[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

[1.2.9] - 2026-04-05

✨ New Features

Boss Damage Tracking System

• Live Damage Scoreboard: Shows top 5 damage dealers during boss fights
  • Real-time updates with damage values and percentages
  • Automatically displayed to players within 50-block radius
  • Clean, color-coded display on the sidebar
  • "Waiting for combat..." message before first damage
  • Configurable via easterBoss.damageTracking.scoreboard
• Post-Battle Damage Report: Detailed chat report when boss is defeated
  • Complete damage breakdown for all participants
  • Percentage-based damage distribution
  • Top 10 damage dealers displayed with rankings (configurable)
  • Medal system (⭐ Gold/Silver/Bronze) for top 3 players
• MVP System: Special recognition for the highest damage dealer
  • MVP announcement broadcast to all players
  • Special title animation and sound effects for MVP
  • Unique rewards for top damage dealer
  • Fully configurable (broadcast, animation, sounds)
• Multi-Language Support: Full EN/DE translations for all damage tracking features

Boss Sound Configuration

• Customizable Sound Settings: All boss sounds are now configurable
  • Spawn sound (volume, pitch, enable/disable)
  • Death sound (volume, pitch, enable/disable)
  • Attack sounds (volume, pitch, enable/disable)
• Volume Control: Set volume from 0.0 to 2.0 for each sound type
• New config section: easterBoss.sounds

  sounds:
    spawn:
      enabled: true
      volume: 2.0  # 0.0-2.0
      pitch: 0.5   # 0.0-2.0
  

🔧 Improvements

Configuration System

• Enhanced ConfigMigrator: Now correctly compares full version numbers (1.2.8 vs 1.2.9)
• Automatic Config Updates: New settings are added without losing existing configuration
• Better Migration Detection: Explicitly checks for all new config sections
• Improved Logging: Shows exactly which config options were added during migration

Damage Tracking Accuracy

• Overkill Protection: Damage is correctly capped at boss's remaining health
• Environmental Damage Tracking: Fire, fall damage, etc. now properly tracked
• TNT Damage Attribution: TNT damage is now credited to the player who placed it
• Event Priority Fix: Uses MONITOR priority for accurate final damage values

Scoreboard Display

• Immediate Display: Scoreboard shows instantly when boss spawns
• Better Player Detection: Improved range detection for showing/hiding scoreboard
• Consistent Updates: Fixed timing issues with scoreboard updates
• Automatic Cleanup: Scoreboard properly removed when players leave range

🐛 Bug Fixes

• Fixed ConfigMigrator not detecting version changes properly

📝 Technical Changes

• Added value clamping for all sound volumes (0.0-2.0 range)
• Improved debug logging for sound settings and damage tracking
• Better thread safety for damage tracking maps
• Optimized scoreboard update frequency (configurable)

[1.2.8] - 2026-04-05

✨ New Features

Configurable Permission System

• Flexible Feature Permissions: Server admins can now control which features require permissions
• Per-Feature Configuration: Each feature (hoppad, launcher, trail, etc.) can be made public or restricted
• Added new permissions section in config.yml:

  permissions:
    requirePermissionFor:
      hoppad: false    # Everyone can use hop pads!
      launcher: true   # Requires permission
  

• Live Reload: Permission changes take effect with /easter reload - no restart needed
• Backwards Compatible: All existing permissions continue to work as before
• Added comprehensive permission documentation in PERMISSIONS_GUIDE.md

Automatic Configuration Migration

• No More Config Deletion! Updates automatically add new config options without losing existing settings
• Smart Migration: Only missing options are added, existing values are preserved
• Automatic Backups: Creates backup before any migration (config.yml.backup)
• Backup Rotation: Maintains only 2 backups to keep plugin folder clean:
  • config.yml.backup - Latest backup
  • config.yml.backup.old - Previous backup
• Version Tracking: Config version tracked at file end with prominent warning
• Detailed Logging: Shows exactly which options were added during migration
• Old timestamped backups are automatically cleaned up

🔧 Improvements

Configuration

• Config Version Location: Moved to end of file with clear warning message:

  # ============================================================================
  # WARNING: DO NOT MODIFY THE CONFIG VERSION!
  # This is used for automatic configuration updates.
  # ============================================================================
  config-version: "1.2.8"
  

• Better Organization: Permission settings grouped logically in config
• Cleaner Updates: Future plugin updates won't require config deletion

📚 Documentation

• Added PERMISSIONS_GUIDE.md - Complete guide for the new permission system
• Added CONFIG_MIGRATION.md - Technical details about automatic config updates
• Updated examples showing how to configure permissions for different server types

🛠️ Technical

• Added PermissionManager class for centralized permission handling
• Added ConfigMigrator class for automatic configuration updates
• Improved config file I/O operations for reliable migration
• Migration runs automatically on plugin startup when needed

[1.2.7] - 2026-04-03

🔒 Security & Bug Fixes

Fixed

• Critical: Easter Basket Item Duplication Bug

  • Fixed a critical exploit allowing players to duplicate items from Easter Baskets
  • Added EasterBasketGUIListener to properly handle inventory interactions
  • Players can no longer remove items from the basket GUI (view-only mode)
  • Exchange button functionality preserved and working correctly
  • Prevents all forms of item extraction including click and drag events
  • Fixed issue where player's own inventory became unusable in basket GUI

• Boss Spawn & Boss Bar Issues

  • Fixed boss repeatedly attempting to spawn in protected regions
  • Added region protection checks to findSafeSpawnLocation() method
  • Fixed orphaned boss bars appearing without actual boss
  • Added cleanup routine for dead bosses and their boss bars
  • Boss spawn timer now resets when spawn fails due to region protection
  • Fixed Purpur compatibility: Boss now spawns on correct regional thread
  • Fixed boss spawn warning timer running repeatedly instead of once (changed runGlobalTimer to runGlobalTaskLater)

• Easter Basket Improvements

  • Items are now individually removable from basket while preventing duplication
  • Basket contents sync on inventory close to prevent item loss
  • Exchange button (slot 26) remains protected
  • Full item management support: take, place, and organize items freely

• Boss Entity Removal on Folia/Purpur

  • Fixed /easter killboss command not removing boss entities on Folia/Purpur servers
  • Boss entity removal now runs on the correct regional thread
  • /easter off command now properly cleans up all boss entities
  • Boss removal is now thread-safe across all server platforms

Compatibility

• Server Platform Support:
  • Fixed thread-safety issue preventing boss spawns on Purpur servers
  • Boss entity spawning now uses proper regional thread execution
  • Fixed Folia chunk access error: findSafeSpawnLocation now runs on regional thread
  • Full compatibility with Paper, Spigot, Purpur, and Folia

Known Issues (Non-Critical)

• FoliaLib 0-tick Warning: Harmless informational warning about 0-tick delays being auto-corrected to 1 tick
  • Does not affect functionality - FoliaLib handles this automatically
  • Can be suppressed via config if desired
• JOML Unsafe Deprecation Warning: Server startup warning about sun.misc.Unsafe::objectFieldOffset
  • NOT caused by EasterHolidays - comes from Minecraft's JOML library
  • Does not affect plugin functionality
  • Will be resolved by Mojang/JOML maintainers in future releases

Security

• Inventory Protection:
  • Easter Basket GUI is now fully protected against manipulation
  • All inventory click and drag events are properly cancelled
  • Ensures basket contents remain synchronized with database
  • Player inventory remains fully functional while viewing basket

[1.2.6] - 2026-04-02

🐰 Boss Improvements & Combat System

Added

• Boss Fall Damage Protection:

  • Easter Boss is now immune to fall damage
  • Prevents boss from dying to environmental damage during jump attacks

• Group Loot System:

  • All players who dealt damage to the boss receive rewards
  • Damage tracking system for fair loot distribution
  • Rewards include Golden Carrots, Enchanted Golden Apple, Diamonds, and Emeralds
  • Special effects (Regeneration, Strength, Speed, Jump Boost, Luck) for all participants

Fixed

• Boss Respawn Timer:

  • Fixed immediate boss respawn after death
  • Properly enforces 60-minute minimum interval between spawns
  • Added multiple safeguards against timer bypass
  • lastBossSpawn correctly initialized and maintained

• Boss Health Configuration:

  • Fixed health value exceeding Minecraft's 1024 limit
  • Server config properly set to 1000 health
  • Default config set to 500 for safety

• Boss Bar Management:

  • Boss bar properly removed on boss death
  • Fixed potential memory leaks from lingering boss bars

• Complete Region Protection Integration:

  • All Easter features (Eggs, Bunnies, Carrot Gardens, Boss) now respect WorldGuard and GriefPrevention protected areas
  • Configurable via regionIntegration settings with allowInClaims: false

Changed

• Boss Death Rewards:
  • Changed from killer-only to all damage dealers
  • More cooperative gameplay experience
  • Encourages teamwork in boss fights