Easter Holidays

EasterHolidays

Transform your Minecraft server into an Easter wonderland with egg hunts, special mobs, epic boss battles, and tons of festive features!

🎨 Official EasterHolidays Resource Pack Available!

Enhanced Visuals with EggLauncher Resource Pack

• Download: Modrinth - EggLauncher Pack
• Custom models for all Easter Eggs (6 unique designs)
• Animated Easter Egg Launcher (Osterblaster 3000)
• Fully compatible with v1.2.4+
• Use /easter pack in-game for more info

🎮 Core Features

Easter Egg Hunt

• 3 egg rarities (Normal, Golden, Diamond) with custom loot tables
• Eggs spawn dynamically around players on grass blocks
• Configurable spawn rates and lifetimes
• Resource Pack Ready: Pre-configured for custom egg models!

Special Easter Content

• Rare glowing Easter Bunnies that give rewards when caught
• Easter Boss with 4 unique attack patterns
• Themed mobs: Easter Chicks and ✨ Sheep
• Carrot Gardens that spawn randomly
• NEW: Easter Egg Launcher with magazine system & infinite ammo mode

Player Progression

• SQLite database for persistent statistics
• Leaderboards for competitive players
• 15+ achievements to unlock
• Daily quests with rewards
• Collectible titles system
• Personal Easter baskets

Fun Activities

• Bunny Hop Challenge (timed jumping game)
• ✨ Trail effects for players
• Easter Egg Launcher (shoots eggs with custom effects)
• Bunny Hop Pads for super jumps
• Special events: Egg Wave, Bunny Parade, ✨ Trail

🌍 Multi-World Support (NEW in v1.2.4!)

Configure Easter features for multiple worlds simultaneously:

# Enable for specific worlds
easterWorlds:
  - "world"
  - "world_nether"
  - "creative"

# Or enable for ALL worlds
easterWorlds: "ALL"

⚙️ Technical Details

Compatibility

• Minecraft: 1.21.x
• Platforms: Paper, Folia, Purpur, Spigot, Bukkit
• Java: 21 or newer
• Multi-core: Full Folia support with async scheduling
• FoliaLib: Updated to 0.4.4 (fixes task wrapping issues)

Integrations (all optional)

• PlaceholderAPI: 11 placeholders for scoreboards/chat
• BS CustomJukebox: Automatic Easter music
• WorldGuard/GriefPrevention: Respects protected regions

📦 Quick Start

1. Download EasterHolidays-1.2.4.jar
2. (Optional) Get the Resource Pack
3. Place JAR in your server's plugins/ folder
4. Restart server
5. Use /easter on to activate
6. Plugin auto-configures for resource pack compatibility!

🎯 Commands & Permissions

Player Commands (easter.user)

• /easter status - View current status
• /easter stats - Check your statistics
• /easter leaderboard - See top players
• /easter trail - Toggle ✨ trail
• /easter pack - Get resource pack info

Admin Commands (easter.admin)

• /easter on/off - Enable/disable Easter mode
• /easter reload - Reload configuration
• /easter boss - Spawn Easter Boss
• /easter event <type> - Start special events
• /easter launcher [infinite] - Get launcher or toggle infinite ammo
• /easter spawnegg [type] - Spawn eggs for testing

🎨 Resource Pack Configuration

The plugin comes pre-configured for the EggLauncher Resource Pack:

# Default configuration (works with resource pack)
easterEggs:
  itemMaterial: "STICK"  # Changed from EGG for pack compatibility
  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

📊 Privacy & Performance

• Metrics: Uses bStats #30349 for anonymous statistics (can be disabled)
• Updates: Checks Modrinth for new versions (can be disabled)
• Performance: Optimized with connection pooling and async operations
• Database: SQLite with HikariCP connection pooling

🌍 Languages

Fully translated in English and German (/plugins/EasterHolidays/messages_en.yml)

📜 License

MIT - Free to use and modify!

🆕 What's New in v1.2.4

• 🌍 Full multi-world support
• 🎨 Resource pack integration with EggLauncher Pack
• 🔫 /easter launcher infinite command for admins
• 🥚 /easter spawnegg for testing custom models
• 🐛 Fixed FoliaLib task wrapping exception
• 📦 Changed default item from EGG to STICK for pack compatibility

---

Perfect for Easter events, family-friendly servers, or adding seasonal content to your world!