✨ Easter Eggs ✨ [1.8 - 1.21.4] icon

✨ Easter Eggs ✨ [1.8 - 1.21.4] -----

The most customizable Easter Eggs plugin



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.
[​IMG]


Close view of the Easter Eggs.
[​IMG]

The Easter Eggs control menu allows you to teleport, remove, remove all, and copy the eggs.
[​IMG]

The functionalities of the menu are as follows.

[​IMG]















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.
,
[​IMG]
,
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.
,
My Other Plugins:
[​IMG] [​IMG] [​IMG] [​IMG] [​IMG]

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.
Copyright 2024 © Berke Akçen
Resource Information
Author:
----------
Total Downloads: 61
First Release: Apr 11, 2024
Last Update: Dec 19, 2024
Category: ---------------
All-Time Rating:
4 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings