Easter Egg Hunt icon

Easter Egg Hunt -----

Plugin where players search for hidden eggs and earn rewards. Fully customizable, perfect for events

Download Now
53.5 KB .jar



EasterEggs
A fully customizable Easter egg hunt plugin for Paper 1.21

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
​

✦ Overview

EasterEggs lets you set up themed egg hunts directly in your Minecraft world. Hide custom player-head eggs anywhere, configure milestone and completion rewards for each hunt, and let your players race to find them all. Everything is configured via simple YAML files — no in-game setup wizards, no bloat.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Features

  • Multiple independent hunts — run several hunts simultaneously, each with its own eggs and rewards.
  • Custom head textures — use any base64 skin texture. A curated list of Easter-themed heads is included.
  • Particle effects — pastel-colored dust particles float above unfound eggs, visible within a configurable radius.
  • Milestone & completion rewards — fire console commands at any egg count threshold and when all eggs are found.
  • Multilingual — ships with English and French. Switch with a single line in config.yml. Every message is editable.
  • PlaceholderAPI support — expose hunt progress on scoreboards, holograms, or any PAPI-compatible plugin.
  • Two placement workflows — place eggs instantly with a command, or hand out special head items that register themselves when placed.
  • Egg protection — non-admins cannot break eggs. Admins who break an egg have it removed from the hunt automatically.
  • Texture picker GUI — browse and pick any loaded texture directly from a chest inventory.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Commands

Code (Text):

/ee help                        Show the help page
/ee hunt list                   List all available hunts
/ee hunt select <id>            Set your active hunt
/ee progress [player]           View egg-finding progress bars
 

Code (Text):

/ee hunt create <id>            Create a new hunt
/ee hunt delete <id>            Delete a hunt and all its eggs
/ee place [texture#]            Place an egg at your location
/ee give [hunt] [qty] [texture] Give yourself egg-placer head items
/ee remove <id>                 Remove an egg by ID
/ee list [page]                 List all eggs in the selected hunt
/ee near [radius]               Show nearby eggs across all hunts
/ee tp <id>                     Teleport to an egg
/ee reset <player> [hunt]       Reset a player's progress
/ee resetall [hunt]             Reset progress for all players
/ee eggmenu [hunt]              Open the texture picker GUI
/ee reload                      Reload config, language and textures
 

Code (Text):

/ee status [hunt]               Show every online player's egg count
 

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Permissions

Code (Text):

eastereggs.admin     Full access to all admin commands     Default: OP
eastereggs.status    Access to /ee status                  Default: OP
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Configuration

All configuration lives in config.yml . No database required — everything is stored in flat YAML files.

Code (YAML):

lang : en   # en | fr

particles:
  enabled : true
  radius : 20       # Max distance (blocks) to see particles
  interval : 10     # Ticks between each pulse (20 = 1 second)

textures :
  - "<base64 skin value>"   # Add as many textures as you like
  # https://minecraft-heads.com/

rewards:
  my_hunt:
    on-complete :
      - "eco give %player% 5000"
      - "crates key give %player% legendary 1"
    milestones:
      10 :
        - "eco give %player% 1000"
      25 :
        - "eco give %player% 2500"
 

Language
Set lang: fr or lang: en in config.yml . Every message, title, and subtitle is editable in the lang/ files. Leave any value empty ( "" ) to disable that message entirely.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ PlaceholderAPI

Code (Text):

%eastereggs_found%               Total eggs found (all hunts)
%eastereggs_total%               Total eggs across all hunts
%eastereggs_status%              "found/total" across all hunts

%eastereggs_found_<hunt>%        Eggs found in a specific hunt
%eastereggs_total_<hunt>%        Total eggs in a specific hunt
%eastereggs_percent_<hunt>%      Completion percentage in a specific hunt
%eastereggs_status_<hunt>%       "found/total" for a specific hunt
 

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Requirements

  • Paper 1.21 or newer
  • Java 21 or newer
  • PlaceholderAPI (optional)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

✦ Support

For help, bug reports, or feature requests, join our Discord server:


Made with ❤ by Golf​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 11
First Release: May 5, 2026
Last Update: May 5, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings
Ask Questions / Get Support