# Zeph’s EggHunt<\/p>\n
Give your player’s an activity to do this Easter! An Easter Egg hunt built for Nexo so you get real Egg Models for players to hunt. Hide eggs around your world for players to find, or let the server scatter them automatically near players as they explore. Both modes work at the same time.<\/p>\n
## How It Works<\/p>\n
### Event Eggs (Admin Hidden)
\nUse a placement wand to hide Nexo furniture eggs around your world. Every player can find and claim each egg once. Once someone collects an egg, it changes to a “claimed” look just for them.<\/p>\n
### Random Eggs (Player Spawning)
\nEvery few minutes, each online player has a chance of an egg popping up somewhere nearby. A chime plays when it spawns, and optional particles and ambient sounds pulse to help players track it down. If nobody grabs it, it despawns after a timeout.<\/p>\n
### The Wand
\nYou get a blaze rod wand via `\/egghunt wand`. Right-click a block to place an egg facing your direction. Left-click to cycle tiers \u2014 there’s also a **Random** option that rolls a weighted tier each time you place. Sneak + right-click removes the nearest egg.<\/p>\n
### Tiers and Visual Variety
\nSet up as many tiers as you want. Each tier can have multiple Nexo furniture IDs, so you get visual variety while sharing the same reward pool. The plugin picks one randomly when placing.<\/p>\n
### Rewards
\nRewards are just strings in the config. No nested YAML, no type declarations:
\n“`yaml
\n– “diamond 5”
\n– “golden_apple 1 &eShiny Apple”
\n– “cmd: eco give {player} 500”
\n“`
\nEqual chance per line. Want one to show up more? Add it twice.<\/p>\n
### Action Bar
\nAction bar shows the collection process. Action bar shows up in the world set by the config. By default, it’s set to “event” if you plan to hide the eggs in an event world. You can change it to “world” to make the action bar show up in the main world. Collecting a random egg shows a quick one-shot confirmation. Both are configurable.<\/p>\n
### Stats and Leaderboard
\nEvent eggs and random eggs are tracked separately. Players can check their own stats with `\/egghunt stats`, and the leaderboard shows top collectors across both modes. Top hunters are announced when the event ends.<\/p>\n
### PlaceholderAPI
\nOptional \u2014 everything works without it. But if you have PlaceholderAPI, you get placeholders for player counts, event status, leaderboard positions, and more. Useful for scoreboards, tab, holograms, or whatever you’re running.<\/p>\n
| Placeholder | What it returns |
\n|—|—|
\n| `%egghunt_collected%` | Player’s total eggs |
\n| `%egghunt_event_collected%` | Player’s event eggs |
\n| `%egghunt_random_collected%` | Player’s random eggs |
\n| `%egghunt_total%` | Server-wide total collected |
\n| `%egghunt_active%` | Whether the event is running |
\n| `%egghunt_rank%` | Player’s leaderboard position |
\n| `%egghunt_top_1_name%` | #1 collector’s name |
\n| `%egghunt_top_1_count%` | #1 collector’s count |<\/p>\n
## Commands<\/p>\n
| Command | Permission | What it does |
\n|—|—|—|
\n| `\/egghunt stats` | `egghunt.stats` | Your personal stats breakdown |
\n| `\/egghunt leaderboard` | `egghunt.leaderboard` | Top collectors |
\n| `\/egghunt start` | `egghunt.admin` | Start the event |
\n| `\/egghunt stop` | `egghunt.admin` | End the event, show results |
\n| `\/egghunt wand` | `egghunt.admin` | Get the placement wand |
\n| `\/egghunt clear [admin|player|all]` | `egghunt.admin` | Remove eggs by mode |
\n| `\/egghunt cleanup` | `egghunt.admin` | Clean up orphaned entities |
\n| `\/egghunt reload` | `egghunt.admin` | Reload config |
\n| `\/egghunt status` | `egghunt.admin` | Event info at a glance |
\n| `\/egghunt debugspawn` | `egghunt.admin` | Force-spawn a test egg nearby |
\n| `\/egghunt reindex` | `egghunt.admin` | Re-link entity IDs after chunk issues |<\/p>\n
## Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `egghunt.admin` | op | All admin commands |
\n| `egghunt.collect` | true | Collect eggs |
\n| `egghunt.stats` | true | View personal stats |
\n| `egghunt.leaderboard` | true | View leaderboard |<\/p>\n
## Requirements<\/p>\n
– **Paper 1.21.4+** (not Spigot \u2014 uses Paper APIs)
\n– **Java 21**
\n– **Nexo** for the egg furniture models
\n– **ProtocolLib** for per-player visuals<\/p>\n
**Optional:** PlaceholderAPI for scoreboards, tab, holograms, etc.<\/p>\n
## Egg Models
\nThis plugin doesn’t include any models \u2014 you’ll need Nexo furniture items set up for your eggs. The ones we use on Cobble & Commons are from MCModels and work great out of the box:<\/p>\n
**Easter Egg Collection on MCModels**<\/p>\n
Highly recommended if you want a polished look without building your own. Just drop them into your Nexo config and match the furniture IDs in the EggHunt config.<\/p>\n
## Try It Live
\nWant to see it in action before setting it up? Come check it out on **Cobble & Commons** \u2014 the server where this plugin was built and tested. We run seasonal egg hunts with both modes active.<\/p>\n
**Server Address:** `mc.cobblecommons.com`<\/p>\n","protected":false},"excerpt":{"rendered":"
Easter Egg Hunt for Nexo Egg Models<\/p>\n","protected":false},"featured_media":173818,"template":"","meta":{"_minecraft_slug":"zephs-egghunt","_minecraft_project_id":"zsdGMPSG","_minecraft_author":"RedZephon","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":4,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"zephs-egghunt.zip","_minecraft_size_bytes":66954,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:48.633188Z","_minecraft_date_created":"2026-04-11T19:16:56.399284Z","_minecraft_date_modified":"2026-04-05T15:45:47.698734Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/zephs-egghunt","_minecraft_icon_attachment_id":173818,"_minecraft_imported_at":"2026-06-09T23:01:23+00:00","_minecraft_import_hash":"a171969b860ae28c651420e448455a18","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,89,866,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-173817","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n