Easter Holidays

[1.2.4] - 2026-03-27

🌍 Multi-World Support & Critical Fixes

Added

• Full Multi-World Support: Easter features can now run in multiple worlds simultaneously
  • Configure via easterWorlds list in config.yml
  • Support for "ALL" to enable in every world
  • Legacy easterWorld config still supported for backwards compatibility
• Helper Methods: New isEasterWorld() and getEasterWorlds() methods in main class
• Status Command Update: /easter status now shows all configured Easter worlds
• Debug Mode: /easter debug command shows detailed world configuration and player tracking status
• Resource Pack Tip: OPs receive a one-time notification about the EggLauncher resource pack on first login after server start

Changed

• EasterEggManager: Now spawns eggs in all configured worlds
• EasterBunnyManager: Spawns bunnies across all configured worlds with per-world limits
• CarrotGardenManager: Manages gardens per-world with individual world limits
• ThemedMobManager: Spawns Easter Chicks and Rainbow Sheep in all configured worlds
  • Per-world limits for both mob types
  • Rainbow Sheep counting now per-world instead of global

Fixed

• FoliaLib Update: Updated from 0.4.3 to 0.4.4 to fix task wrapping exception
  • Fixes: IllegalArgumentException: The nativeTask provided must be a BukkitTask
  • Improves compatibility with Paper/Spigot servers
• Multi-World Support: Fixed issue where only the first world in easterWorlds list was working
  • PlayerJoinListener now checks if player's world is an Easter world before starting features
  • Added PlayerWorldChangeListener to handle players moving between worlds
  • Easter features now properly start/stop when players enter/leave Easter worlds
  • Prevents unnecessary task scheduling in non-Easter worlds
• Cleanup Command: Fixed /easter off not cleaning up entities in unloaded worlds
  • All cleanup methods now iterate through configured Easter worlds only
  • Entities in unloaded worlds are skipped with debug messages
  • Cleanup now works correctly across all configured worlds regardless of player location
• Mob Cleanup: Fixed themed mobs not being removed after server restart
  • Changed from exact name matching to substring matching for emoji compatibility
  • Properly handles custom names with special characters

Dependencies

• FoliaLib: 0.4.3 → 0.4.4 (Critical bug fixes for task wrapping)

Resource Pack Integration

• Changed default item from EGG to STICK for resource pack compatibility
• Added /easter pack command for resource pack information
• Integrated with EggLauncher Resource Pack (https://modrinth.com/resourcepack/egglauchner)
• Pre-configured CustomModelData values for the pack

Configuration Example

# Multi-world support
easterWorlds:
  - "world"
  - "world_nether"
  - "creative"
# OR
easterWorlds: "ALL"

# Resource pack ready config
easterEggs:
  itemMaterial: "STICK"
  customModelData:
    common: "4-5"      # egg1, egg2 models
    rare: "2-3"        # egg3, egg4 models
    legendary: "6-7"   # egg5, egg6 models

easterEggLauncher:
  itemMaterial: "STICK"
  customModelData: 1   # osterblaster_3000 model