🥚 Egg Hunt Minigame

Compete, explore, and collect!

Egg Hunt is a fast-paced competitive minigame where players search for hidden eggs across the map to earn points and dominate the leaderboard. With dynamic mechanics and full configurability, every match feels unique and exciting.

🎮 Gameplay

Players compete in rounds by collecting eggs of different colors. Each egg gives a specific number of points (fully configurable), and the player with the highest score wins the match.

• 🟢 Multiple egg types (including a 4th egg type)
• ⚙️ Customizable scoring system
• 🏆 Competitive round-based gameplay
• 🔊 Sound effects for collecting each egg type

⚙️ Features

• ✔ Lobby system with minimum player requirement
• ✔ Fully configurable settings (points, timers, players)
• ✔ Advanced player statistics (wins, losses, points, matches)
• ✔ Easy in-game setup using commands
• ✔ Dynamic egg spawn system
• ✔ Permissions system for better server management
• ✔ Generated permissions file (easy integration with systems like LuckPerms)
• ✔ Configurable messages with full color support
• ✔ Improved /egghunthelp command (players/admins see different info)
• ✔ Economy integration with /eggsell <amount> command
• ✔ Support for custom economy commands (executed via console)
• ✔ Configurable sounds (egg collection, teleportation, notifications)

🔥 Dynamic Egg Spawn System

Create as many egg spawn points as you want and let the game randomly select them each round.

Example:

• 100 spawn locations saved
• 50 randomly selected per match

➡️ Every game feels different
➡️ No repetitive gameplay

🧭 End-Game Features

• Eggs appear on the compass near the end of the round (default: last 30 seconds, configurable)
• Sound notification when markers appear
• Round countdown is only visible during the last 10 seconds

🛠️ Commands

🎮 Player Commands

• /egghuntjoin – Join the game
• /egghuntleave – Leave the game
• /egghuntstats – View your statistics
• /egghuntlist – Show list of players in the game
• /egghunthelp – Show help menu
• /eggsell <amount> – Convert your points into money (if economy is enabled)

👑 Admin Commands

• /egghuntsetlobby – Set lobby spawn
• /egghuntsetstart – Set game start location
• /egghuntsetserverspawn – Set spawn after the game
• /egghuntaddeggspawn – Add egg spawn at your location
• /egghuntlisteggspawns – List all egg spawn points
• /egghuntshowlocations – Show saved locations (lobby, server spawn, start)

🏆 Leaderboards

• /eggtoppkt – Top players by points
• /eggtopwins – Top players by wins

🎨 Customization

• All messages are stored in the message config file — you can fully translate and customize them
• You can freely change text colors
• Sounds, markers, timers, and gameplay elements are configurable
• To use custom egg or marker textures, create your own asset pack and replace/add textures in the appropriate folders

🚀 Why You’ll Love It

• Dynamic and unpredictable gameplay
• Easy setup directly in-game
• Highly configurable for any server
• Competitive and replayable