EasterEggHunt

A Paper plugin for hiding and finding Easter eggs around your server.

How It Works

1. Admins run /egghunt give <amount> <color> to receive custom egg heads.
2. Admins place the heads anywhere in the world — each placement is automatically registered.
3. Players right-click or left-click a registered head to collect it.
4. A server-wide message announces who found an egg, their total, and how many remain.
5. When the hunt is toggled off, all remaining egg blocks are removed from the world.

Commands

Command	Description	Permission
/egghunt give <amount> <color>	Give yourself egg heads to place	egghunt.admin or egghunt.place
/egghunt list	List all registered egg locations	egghunt.admin
/egghunt count	Check your own egg count	egghunt.find or egghunt.admin
/egghunt count <player>	Check another player's egg count	egghunt.find or egghunt.admin
/egghunt set <player> <amount>	Set a player's egg count	egghunt.admin
/egghunt toggle	Start or stop the hunt (removes all eggs on stop)	egghunt.admin
/egghunt status	Check if the hunt is active	egghunt.find or egghunt.admin
/egghunt lb	Open the leaderboard GUI	egghunt.find or egghunt.admin

Colors

yellow red pink orange blue

Permissions

Permission	Description	Default
egghunt.admin	Full access to all commands	op
egghunt.place	Place and register eggs via /egghunt give	op
egghunt.find	Find eggs and view count/status/leaderboard	true

Installation

1. Drop EasterEggHunt.jar into your Paper server's plugins/ folder.
2. Restart the server.
3. Give eggs with /egghunt give, place them, then toggle the hunt on with /egghunt toggle.

Requirements

• Paper 1.21.4 or newer
• Java 21+