?

EasterEggHunt

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

How It Works

Admins run /egghunt give <amount> <color> to receive custom egg heads.
Admins place the heads anywhere in the world — each placement is automatically registered.
Players right-click or left-click a registered head to collect it.
A server-wide message announces who found an egg, their total, and how many remain.
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

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

Requirements

Paper 1.21.4 or newer
Java 21+