Minimum Java Version: Java 8
Support:
https://discord.gg/uXVU8jmtpU
Easter Eggs
Easter Eggs is a Minecraft plugin that allows you to add cool, interactive Easter Eggs to your server.
Features
- Minecraft Version Support: Compatible with Minecraft 1.8 - 1.21.4.
- Per-Player Particles: Individual particle effects for each player.
- Custom Head Textures: Unique head textures for Easter Eggs.
- Varied Textures: Different textures for the same type of Easter Egg.
- Custom Particles: Unique particle effects for different eggs.
- Custom Messages: Personalized messages for each type of Easter Egg.
- Command Execution: Custom commands executed for different Easter Eggs.
- Leaderboard Placeholders: Display players with the most Easter Eggs found.
- Sound Effects: Unique sound effects when players find an egg.
- Cooldown: Make players wait a certain amount of time before collecting the same type of Easter Eggs.
- General Cooldown: Make players wait a certain amount of time before collecting any type of Easter Eggs.
- Firework Effects: Custom fireworks when players discover a new Easter Egg.
- Action Bar Messages: Notifications when players are close to an egg.
- GUI Display: Interface to view and manage created Easter Eggs.
- Unlimited Eggs: No limit on the number of Easter Eggs you can create.
- Data Storage: Supports both flat file and MySQL for data storage.
- Hex Color Support: Hex color codes supported (requires Minecraft 1.16+).
-
- Whitelisted Permissions: Only allow players that has the required permissions to collect Easter Eggs.
- Blacklisted Permissions: Prevent from players that has the blacklisted permissions to collect Easter Eggs.
- Developer API: API available for developers.
- PlaceholderAPI Support: Integration with PlaceholderAPI, offering 11+ different placeholders.
Images | Videos
Plugin Showcase
General view of the Easter Eggs.
Close view of the Easter Eggs.
The Easter Eggs control menu allows you to teleport, remove, remove all, and copy the eggs.
The functionalities of the menu are as follows.
Commands and Permissions
All commands can be used with the labels /eastereggs, /eggs, and /egg.
- /eastereggs <egg id> - eastereggs.get - Gives an Easter Egg with the provided ID, if it exists.
- Use /eastereggs get <egg id> if you have an Easter Egg named with a command argument such as 'help', 'reload' or 'menu'.
- /eastereggs menu [id to filter] - eastereggs.menu - Opens the Easter Eggs menu.
- /eastereggs reload - eastereggs.reload - Reloads the configuration files and Easter Eggs.
- /eastereggs help - eastereggs.help - Displays a list of available commands along with their descriptions.
- /eastereggs list - eastereggs.list - Displays a list of all Easter Egg names.
- /eastereggs resetstats [player] [egg id] - eastereggs.resetstats - Resets all stats or the stats of a specified Easter Egg for the target player.
- /eastereggs savestats - eastereggs.savestats - Saves all the found Easter Egg data to the database manually.
- Use --silent flag if you don't want this command to send a message.
- /eastereggs check - eastereggs.check - Checks for any available updates.
- /eastereggs removeall <egg id> - eastereggs.removeall - Removes all Easter Eggs with the specified ID.
- /eastereggs copy - eastereggs.copy - Copies the Easter Egg that the player is currently looking at.
- /eastereggs texture <id of the new texture> - eastereggs.texture
- Changes the texture of the currently held Easter Egg item. The new Easter Egg can be placed and will be the same type as the previously held Easter Egg.
- /eastereggs info - eastereggs.info - Displays detailed information about the plugin and server environment.
- Permission to break the Easter Eggs: eastereggs.break
- Permission for the tab completion: eastereggs.tabcompleter
- Use eastereggs.* to grant all permissions.
,
,
Configuration Files
,
config.yml
Code (YAML):
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# #
# Easter Eggs #
# Despical #
# #
# Discord Server: https://discord.gg/uXVU8jmtpU #
# Resource Link: https://spigotmc.org/resources/116086/ #
# bStats Metrics: https://bstats.org/plugin/bukkit/EasterEggs/21546/ #
# #
# PlaceholderAPI Placeholders #
# #
# %eastereggs_total% - The total number of Easter Eggs #
# %eastereggs_total_type% - The total number of different Easter Egg types #
# %eastereggs_total_found% - The number of Easter Eggs that the player has found #
# %eastereggs_total:<egg id>% - The total number of Easter Eggs with the given ID #
# %eastereggs_total_left% - The number of Easter Eggs the player still needs to collect #
# %eastereggs_left:<egg id>% - The number of Easter Eggs with the given ID that the player #
# still needs to collect #
# %eastereggs_found:<egg_id>% - The number of Easter Eggs with the given ID that the player #
# has found #
# %eastereggs_ID:persistent% - Returns a string whether the specified Easter Egg is #
# persistent or not #
# %eastereggs_leaderboard_4% - Shows the 4th player's name with the most Easter Eggs found #
# %eastereggs_leaderboard_ - Shows the amount of 4th player with the most found Easter Eggs #
# value_4% #
# #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# Use the section below to create new Easter Eggs.
# Only the texture is required; the other details are optional.
# You can create an unlimited number of different Easter Eggs.
easter-eggs
:
# Spooktacular Halloween!
candy-basket:
texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODdmNTA0Y2RiZjViMjExMjFiODIxODUyOGRjZTU2NzUwNWQ0NTY3ZDdlNzJjZDQzYTQ2M2NkNTFjODAxM2E2In19fQ=="
# Spooky Messages
egg-already-found
:
"&c&lYou already found this Candy Basket!"
new-egg-found
:
"&a&lYou found an Candy Basket! &e&l(&a&l{0}&e&l/&a&l{1}&a&l)\n&e&lFind all of them to earn a &b&lawesome reward&e&l!"
all-eggs-found
:
"&a&lCongratulations! You found all the Candy Baskets!"
# Spooky Particles
particles:
found
: CRIT
not-found
: SMOKE_NORMAL
# Example custom heads website: https://minecraft-heads.com
# Copy the 'Value' under the 'For Developers' section.
green_present
:
# To get this Easter Egg: /eggs green_present
texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDA4Y2U3ZGViYTU2YjcyNmE4MzJiNjExMTVjYTE2MzM2MTM1OWMzMDQzNGY3ZDVlM2MzZmFhNmZlNDA1MiJ9fX0="
# Custom messages for different Easter Eggs.
# If not specified, default messages from the 'messages' section will be used.
egg-already-found
:
"&c&lYou already found this Easter Egg!"
new-egg-found
:
"&a&lYou found an Easter Egg! &e&l(&a&l{0}&e&l/&a&l{1}&a&l)\n&e&lFind all of them to earn a &b&lawesome reward&e&l!"
all-eggs-found
:
"&a&lCongratulations! You found all the Easter Eggs!"
has-blacklisted-perm
:
"&c&lYou don't have enough permission to collect this Easter Egg!"
no-whitelisted-perm
:
"&c&lYou don't have the required permissions to collect this Easter Egg!"
# Set 'NONE' to disable any particle effects.
# Custom particle effects can be defined for different Easter Eggs.
# If not specified, default particles from the 'particles' section will be used.
particles:
found
: CRIT
not-found
: VILLAGER_HAPPY
# Custom commands for different Easter Eggs.
# By default, commands are executed by the console.
# To execute a command as a player, start the command with p:.
#
# Placeholders:
# %player% - Player's name.
# %egg_id% - Easter Egg's id.
commands:
egg-already-found
:
[
]
new-egg-found
:
[
]
all-eggs-found
:
[
]
has-blacklisted-perm
:
[
]
no-whitelisted-perm
:
[
]
# The permission settings.
permissions
:
# The Easter Egg can only be collected by players who possess any of the permissions listed below.
whitelist
:
[
]
# Players with any of the permissions listed below are prohibited from collecting this Easter Egg.
blacklist
:
[
]
# If this option is disabled, the data for this Easter Egg will not be saved for players who interacted with it.
persistent
: true
# Should players wait a certain amount of time before collecting this type of Easter Eggs? (Optional, by default no cooldown)
cooldown
: 0
# Should we disable the action bar messages for this Easter Egg? (Optional, by default the action bar is enabled)
action-bar-disabled
: false
# Should we remove the Easter Egg when a player collect it?
remove-on-collect:
enabled
: false
# Should we change the block at the collected Easter Egg's location?
convert-to
: AIR
# To obtain this Easter Egg, use the command: /eggs red_egg
red_egg:
texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNmUzMmE3ZGU3YTY3MmNjNjhmYTdhMjcyYmFhNmE4OWViZDQ0MGMzMmRjZjQ0ZTc3MDU3MDY4OTg5MDQyZjdjNiJ9fX0="
particles:
found
: CRIT
not-found
: FLAME
# To obtain this Easter Egg, use the command: /eggs pink egg
pink egg:
texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzFhYmU0MWI5ZTExYWYyZmUxMzYyZmFhMTI5MjdhZTU0MGIwMTM4NDRhNWM3NDBjYWFhOTZlNDI4YzZiOGY4MyJ9fX0="
particles:
found
: CRIT
not-found
: CLOUD
# To obtain this Easter Egg, use the command: /eggs blue egg
blue egg:
texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjE1NGJhNDJkMjgyMmY1NjUzNGU3NTU4Mjc4OTJlNDcxOWRlZWYzMjhhYmI1OTU4NGJlNjk2N2YyNWY0OGNiNCJ9fX0="
# Should we enable support for MySQL?
mysql-enabled
: false
# Default particle effects. Set 'NONE' to disable any.
particles:
egg-found
: CRIT
not-found
: VILLAGER_HAPPY
# Particle spawn density. (20 ticks = 1 sec)
interval
: 20
# If the distance between the player and the particle exceeds the value below, the particle won't be displayed. (Set 0 to disable)
distance-limit
: 0
# Should players wait a certain amount of time before collecting any Easter Eggs?
general-cooldown
: 0
action-bar
:
# Should we enable action bar messages?
enabled
: true
# In how many block radius should we start to send action bar to players?
radius
: 9.5
# After many ticks should we move to the next message? (20 ticks = 1 sec)
interval
: 30
# Should we sort the eggs nearby the player so that the closest ones are first?
sort
: true
# Should we only send the action bar messages to the player for the Easter Eggs they haven't found yet?
only-not-found
: true
# The permission required for players to view the action bar. Leave it empty to display the action bar to everyone.
permission
:
""
# Action bar messages.
# %player% - The name of the player.
# %egg_id% - Closest egg's id (The 'sorted' option should be enabled for more accurate calculations).
messages
:
-
"&e&lEASTER EGG NEARBY!"
-
"&b&lEASTER EGG NEARBY!"
-
"&a&lEASTER EGG NEARBY!"
# Set 'NONE' to disable any.
sounds
:
# The sound that is going to be played when players find a new egg.
new-egg-found
: ENTITY_PLAYER_LEVELUP
# The sound that is going to be played when players clicks on an already found egg.
egg-already-found
: ENTITY_VILLAGER_NO
# The sound that is going to be played when players find all the eggs.
all-eggs-found
:
NONE
# The sound that is going to be played when a player tries to collect an Easter Egg and has a blacklisted permission for this egg.
has-blacklisted-perm
:
NONE
# The sound that is going to be played when a player tries to collect an Easter Egg and does not have required permission to collect this egg.
no-whitelisted-perm
:
NONE
# The sound that is going to be played when player has a cooldown to collect a specific type of Easter Egg again.
cooldown
: ENTITY_VILLAGER_NO
# The sound that is going to be played when player has a general cooldown to collect any type of Easter Eggs again.
general-cooldown
: ENTITY_VILLAGER_NO
# General settings for fireworks.
fireworks
:
# Should we spawn some cool fireworks when players find an Easter Egg?
enabled
: true
# Color of the firework - red:green:blue.
color
:
"255:0:0"
# Firework Types:
# BALL
# BALL_LARGE
# STAR
# BURST
# CREEPER
type
: BALL
# Should fireworks have a flicker effect?
flicker
: false
# Should fireworks have a trail?
trail
: false
# Power of the firework.
power
: 0
# After how many ticks should we detonate the firework? (20 ticks = 1 sec)
detonate-after
: 2
# Should user data be automatically saved every X ticks? (Set to 0 to only save during server shutdown or reload)
auto-data-saving
: 0
# Should we check for updates on plugin start/after an admin join?
update-notifier
: true
# No way! You've reached the end! But... where's the dragon?
,
messages.yml
Code (YAML):
# General messages.
# Use %do_not_send% if you do not want message to be sent.
messages:
correct-usage
:
"&cCorrect usage: {0}"
no-permission
:
"&cYou must be admin or higher to use this command!"
no-player-found
:
"&c&lNo player has found with that name!"
no-eggs-created
:
"&cThere are no Easter Eggs to display!"
no-eggs-after-filter
:
"&cThere are no Easter Eggs with that id to display!"
no-presents-found
:
"&cThere is no Easter Egg called like that!"
added-new-egg
:
"&aYou have added a new Easter Egg! Total Eggs: {0}"
removed-egg
:
"&aYou have removed a Easter Egg! Total Eggs: {0}"
reloaded
:
"&aConfiguration file reloaded successfully."
egg-already-found
:
"&cYou already found that egg!"
new-egg-found
:
"&a&lYou found an Easter Egg! &e&l(&a&l{0}&e&l/&a&l{1}&a&l)\n&e&lFind all of them to earn a &b&lsuper reward&e&l!"
all-eggs-found
:
"&a&lCongratulations! You found all the Easter Eggs!"
own-stats-reset
:
"&a&lYou have successfully reset your all statistics!"
player-stats-reset
:
"&a&lYou have successfully reset {0}''s statistics!"
cooldown
:
"&c&lYou have to wait {0}s before collecting this Easter Egg again!"
general-cooldown
:
"&c&lYou have to wait {0}s before collecting this Easter Egg again!"
list-command:
no-eggs-created
:
"&cThere are no eggs created to display!"
format
:
"&aExisting Easter Eggs: &7{0}"
texture-command:
not-a-skull
:
"&cYou are currently not holding an Easter Egg!"
not-an-easter-egg
:
"&cThe currently hold item is not an Easter Egg!"
updated-texture
:
"&aA new Easter Egg with updated texture has added to your inventory."
update-command:
checking-for-update
:
"&3[Easter Eggs] &bChecking for updates, please wait..."
new-update-available
:
"&3[Easter Eggs] &bFound a new update: {0} (current version: {1})."
up-to-date
:
"&3[Easter Eggs] &bNo new updates found, everything is up to date!"
remove-all-command:
removed-eggs
:
"&aAll the Easter Eggs with given id is removed."
no-eggs-created
:
"&cNo eggs created with given id!"
copy-command:
target-a-block
:
"&cPlease target an Easter Egg to copy!"
not-an-egg
:
"&cTarget block is not an Easter Egg!"
copied-egg
:
"&aTarget Easter Egg has added to your inventory."
eggs-menu:
title
:
"Easter Eggs (Total: {0}){1}"
placeholders:
filtered
:
" (Filtered)"
close-item:
material
: BARRIER
name
:
"&cClose"
lore
:
[
]
next-page:
material
: ARROW
name
:
"&aNext Page"
previous-page:
material
: ARROW
name
:
"&aPrevious Page"
egg:
name
:
"&e&l{0}"
lore
:
-
"&8* &7LEFT click to teleport."
-
"&8* &7RIGHT click to remove."
-
"&8* &7SHIFT + RIGHT click to get a copy."
-
"&8* &7SHIFT + LEFT click to remove all."
placeholders
:
# %easter_eggs_EGG ID:persistent%
persistent
:
"Persistent"
not-persistent
:
"Not Persistent"
,
mysql.yml
Code (YAML):
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# #
# MySQL Configuration #
# #
# Enable MySQL from config.yml before editing this file #
# #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# The address of the MySQL database.
address
: jdbc:mysql://localhost:3306/root?useSSL=false&autoReConnect=true
# The username to connect to the database.
user
: root
# The password to connect to the database.
password
: <your_password
>
# The table name to store plugin data in.
table
: eastereggs
,
,
Placeholders
The PlaceholderAPI plugin is required to use these placeholders.
- %eastereggs_total% - The total number of Easter Eggs.
- %eastereggs_total_type% - The total number of different Easter Egg types.
- %eastereggs_total_found% - The number of Easter Eggs that the player has found.
- %eastereggs_total:<egg id>% - The total number of Easter Eggs with the given ID.
- %eastereggs_total_left% - The number of Easter Eggs the player still needs to collect.
- %eastereggs_found_different_type% - The number of different Easter Egg types that the player has found.
- %eastereggs_left:<egg id>% - The number of Easter Eggs with the given ID that the player still needs to collect.
- %eastereggs_found:<egg_id>% - The number of Easter Eggs with the given ID that the player has found.
- %eastereggs_Egg ID: persistent% - Returns a string whether the specified Easter Egg is persistent or not.
- %eastereggs_leaderboard_POSITION% - Shows the player's name in the given position from the leaderboard that includes the players with the most found Easter Eggs.
- %eastereggs_leaderboard_4% - Shows the 4th player's name with the most Easter Eggs found.
- %eastereggs_leaderboard_value_POSITION% - Shows the amount of found Easter Eggs of the player in the given position from the leaderboard that includes the players with the most found Easter Eggs.
- %eastereggs_leaderboard_value_4% - Shows the 4th player's found Easter Eggs amount.
,
Terms of Service
By using this plugin, you agree to the following terms, which may be updated by the author at any time.
- All payments are final and non-refundable.
- Redistribution or resale of this plugin is prohibited.
- You are not permitted to modify, decompile, or extract any part of the plugin's source code.
- Support is provided exclusively to legitimate customers. We cannot offer support for plugins obtained through unauthorized or illegal means.