Easter Egg Hunt!

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 21 or newer - Java 21+