The Great Egg Hunt | Search and collect easter eggs [1.21.+]

The Great Egg Hunt is an exciting and interactive Minecraft event plugin that brings the joy of an Easter egg hunt to your server! Players can search for hidden eggs, collect them, and earn amazing rewards. Perfect for seasonal events, minigames, or just adding a fun challenge to your world.
Features:

• Placeable Eggs: Admins can place special eggs around the world that players can find and collect.
  
  
• Custom Particle Effects: Each collected egg triggers a configurable particle effect.
  
  
• Rewards System: Players receive rewards based on the number of eggs they collect.
  
  
• Tracking System: The plugin keeps track of how many eggs each player has found.
  
  
• Custom Messages: Fully customizable messages via language.yml.
  
  
• Commands:
  • `/egg` -> gives 1 egg
  • `/egg give <amount>` -> gives egg items
  • `/egg admin [page]` -> open admin GUI
  • `/egg reload` -> reload config and language

Configuration:

• config.yml
  • Set the particle effect displayed when an egg is collected.
    
  • Define rewards for specific numbers of collected eggs.
• language folder
  • Customize all plugin messages to fit your server’s theme.

Permissions:

• `thegreategghunt.egg.give` -> use `/egg` and `/egg give`
• `thegreategghunt.egg.place` -> place egg heads
• `thegreategghunt.egg.break` -> break egg heads
• `thegreategghunt.reload` -> use `/egg reload`
  
• `thegreategghunt.admin` -> use `/egg admin` GUI and manage eggs
  

Placeholder:

Global placeholders

• `%greategghunt_total%` -> total eggs
• `%greategghunt_reward_counts%` -> configured reward counts (comma-separated)

Player placeholders

• `%greategghunt_collected%` -> eggs collected by player
• `%greategghunt_remaining%` -> total minus collected
• `%greategghunt_percent%` -> collected percentage (0-100)
• `%greategghunt_next_reward%` -> next reward count, or `-`
• `%greategghunt_needed_for_next%` -> how many eggs to next reward

Per-egg placeholders
Use the egg id from the admin GUI lore:

• `%greategghunt_egg_exists_<eggId>%`
• `%greategghunt_egg_collected_<eggId>%` -> number of players who collected this egg
• `%greategghunt_egg_world_<eggId>%`
• `%greategghunt_egg_x_<eggId>%`
• `%greategghunt_egg_y_<eggId>%`
• `%greategghunt_egg_z_<eggId>%`

How It Works:

1. Admins place eggs in various locations using the special egg item.
   
   
2. Players explore and collect the eggs by right-clicking them.
   
   
3. Each collected egg is tracked, and a particle effect plays.
   
   
4. Players earn rewards after collecting a certain number of eggs.

Make your server’s next event unforgettable with The Great Egg Hunt!

Support and Feedback
If you have questions, want to report bugs, or have suggestions for new features: https://discord.com/invite/CKrvK4F9EF