✨ Easter Eggs ✨ [1.8 - 1.21.11] icon

✨ Easter Eggs ✨ [1.8 - 1.21.11] -----

Create fully customizable Easter Eggs and surprise your players like never before!




Easter Eggs - v2.2.4

Changes & Fixes
  • Fixed an incorrect documentation URL inside the mysql.yml configuration file.
  • Made a minor code-based adjustment and optimization in the User class.
----------, Mar 22, 2026

Easter Eggs - Complete Recode

⚠️ Important Update Notice ⚠️
  • The statistics and database systems have been completely recoded and now use a new serializer to fix previous performance issues.
  • No Backward Compatibility & No Migration: Because of these core changes, older versions are no longer supported. Please be aware that your old statistics will be unusable and obsolete starting from this version, and there is no migration available.

Major Changes & Improvements
  • The entire plugin has undergone a complete recode from the ground up for better performance and stability.
  • All documentation has been thoroughly improved, overhauled, and completely rewritten. Check out the newly revamped docs here: https://docs.despical.dev/easter-eggs/
----------, Mar 15, 2026

  • Fixed some of the command messages not working without reloading the plugin.
  • Updated libraries: Command Framework, Inventory Framework and Commons.
----------, Feb 1, 2026

  • Updated CommandFramework to v1.5.9.
  • Fixed aliases for tab completers not working.
----------, Jan 2, 2026

  • Updated CommandFramework to v1.5.8.
  • Huge performance improvements on the command system.
----------, Dec 31, 2025

  • Fixed wrong relocation causing plugin to not load.
----------, Dec 30, 2025

  • Updated Command Framework to v1.5.7.
  • General performance improvements.
  • Excluded some of the unnecessary folders from the plugin JAR.
----------, Dec 29, 2025

  • Added support for Minecraft 1.21.11.
----------, Dec 25, 2025

  • Migrated to Gradle.
  • Added more detailed log messages.
  • Code-based improvements.
----------, Dec 12, 2025

  • Updated Commons, Command Framework and Inventory Framework libraries.
  • Moved to a new namespace: dev.despical.
----------, Dec 8, 2025

  • Updated the Command Framework library.
  • Optimized the command system and tab completions.
----------, Dec 3, 2025

  • Added "test-on-startup" option to mysql.yml to test the connection on plugin start.
  • Lots of improvements on the MySQL database.
  • Updated the Commons library.
New mysql.yml file:
Code (YAML):
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
#                                                             #
#                     MySQL Configuration                     #
#                                                             #
#    Please ensure MySQL is enabled in config.yml before      #
#    modifying these settings.                                #
#                                                             #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

# The full JDBC URL for the database connection.
# Format: jdbc:mysql://<host>:<port>/<database_name>?<parameters>
#
# You *must* replace '<database_name>' with the actual name of your database.
# Example: jdbc:mysql://127.0.0.1:3306/my_server
#
# The extra parameters (?useSSL=false&autoReConnect=true&createDatabaseIfNotExist=true)
# are recommended for connection stability and convenience.
address
: jdbc:mysql://localhost:3306/<database_name>?useSSL=false&autoReConnect=true&createDatabaseIfNotExist=true

# The username for the MySQL database.
user
: root

# The password for the specified MySQL user.
# Please replace '<your_password>' with your database password.
password
: <your_password >

# The name of the table used to store plugin-specific data.
# It is not recommended to change this value after the initial setup
# unless you are performing a data migration.
table
: eastereggs_stats

# If true, the plugin will attempt to connect to the database during server startup.
# This allows for immediate validation of the credentials and configuration.
# If the connection fails, a detailed error will be logged.
test-on-startup
: true
 
----------, Oct 29, 2025

  • Updated the Commons library.
  • Updated some of the config comments.
  • Fixed some of the item tooltips are broken in Minecraft 1.21.5+.
----------, Oct 23, 2025

  • Now some of the placeholders will return 0 instead of the placeholder name, if the player hasn't found any Easter Egg yet.
----------, Oct 21, 2025

  • Fixed the user data could not be saved to MySQL database.
  • Now the leaderboard supports multi-instance networks (MySQL database must be enabled).
----------, Oct 20, 2025

  • Updated the Commons library.
----------, Oct 18, 2025

  • Update Commons library.
----------, Oct 17, 2025

  • MC 1.21.9 & 1.21.10 support.
----------, Oct 16, 2025

  • MC 1.21.8 support.
----------, Aug 18, 2025

  • Updated Commons library to v1.9.7.
----------, Jul 15, 2025

  • MC 1.21.6 & 1.21.7 support.
----------, Jul 2, 2025


  • Performance and codebase improvements using the new Java features added after JDK 8.
----------, Jun 26, 2025

  • Migrated project from Java 8 to Java 21, updated codebase and dependencies accordingly.
----------, Jun 18, 2025

  • Updated Inventory Framework library to the latest available version.
  • Removed unused debug commands.
----------, Jun 3, 2025

  • Updated Inventory Framework and Commons libraries.
  • Updated default MySQL URL.
----------, May 9, 2025

  • Updated default MySQL stats table name.
  • Fixed the default MySQL database name.
----------, Apr 19, 2025

  • Added PAPI support to some of the plugin messages.
----------, Apr 18, 2025

  • Fixed leaderboard entries are not sorted correctly on flat file storage.
  • Now /eggs savestats command will also update the leaderboard entries.
----------, Apr 17, 2025

  • Introduced a new configuration option to define commands triggered when all Easter Eggs are found.
The changes in the config.yml
Code (YAML):
# Custom commands for 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
:
  # The list of commands to execute when a player finds all the Easter Eggs.
  found-all-the-eggs
: [ ]
  # - "say I found all the Easter Eggs!"
  # - "give %player% diamond 64"
----------, Apr 16, 2025

  • Fixed a small typo.
  • Now MySQL won't waste lost of threads, it's now using a ExecutorService with a single thread.
  • Fixed ExecutorService not shutting down if the MySQL storage is enabled.
v1.9.3 update has been replaced with v1.9.4 due to wrong JAR version was uploaded.
----------, Apr 15, 2025

  • Updated Commons library.
  • Updated XSeries library.
----------, Apr 14, 2025

  • Fixed sometimes an exception occurring in the action bar system.
  • A small improvement in the User class.
----------, Apr 11, 2025

  • Removed the /eastereggs check command.
    • The plugin does the checks for the updates on plugin start.
----------, Apr 9, 2025

  • Fixed the leaderboard is in reverse order for flat file statistics.
----------, Apr 9, 2025

  • Fixed some of the configuration files not getting created on the plugin start.
  • Fixed the leaderboard system caching all the available statistics instead of TOP 10.
  • Performance improvements on the MySQL statements.
----------, Apr 6, 2025

  • Added support for commonly used World Manager plugins.
----------, Apr 2, 2025

  • Support for MC 1.21.5.
----------, Mar 31, 2025

  • Updated Commons library.
    • Updated XSeries to the v13.1.0.
----------, Mar 27, 2025

  • Added an option to disable particle effects.
  • Removed PlayerKickEvent handling.
Changes in the config.yml
Code (YAML):
particles :
  # Should we disable all the particle effects?
  disabled
: false
----------, Mar 20, 2025

  • Fixed placing an old Easter Egg, currently removed from the config.yml file, causing an exception.
  • Updated Commons library.
----------, Feb 19, 2025

  • Code based small improvements.
----------, Feb 16, 2025

  • Fixed sounds not playing on Minecraft 1.21+.
  • Updated Commons library.
----------, Feb 3, 2025

  • Code refactoring and cleaning.
  • Updated Commons library.
  • Fixed PaperMC's Maven repository.
----------, Feb 1, 2025

  • Lots of code based improvements.
In the future updates, this plugin is going to be compiled with Java 21.
----------, Jan 28, 2025

  • Fixed using XMaterial#valueOf instead of XMaterial#matchXMaterial method which breaks the cross-version support
----------, Jan 9, 2025

  • Fixed some of the command messages not reloading by using the reload command.
----------, Jan 6, 2025

  • Updated Command Framework library.
----------, Jan 3, 2025

  • Fixed an issue about the MySQL database.
----------, Dec 27, 2024

  • Updated Commons library for better stability and compatibility.
----------, Dec 19, 2024

  • Support for MC 1.21.4.
----------, Dec 8, 2024

  • Updated Commons library.
  • Code based changes/improvements.
----------, Nov 27, 2024

  • Fixed data saving interval was in ticks not seconds.
----------, Nov 17, 2024

  • Now auto data saving is enabled by default.
----------, Nov 13, 2024

  • Fixed update checker throws an exception if it is disabled.
  • Updated Commons to v1.8.83.
----------, Nov 10, 2024

  • Updated Commons to v1.8.82.
  • Removed all the unnecessary things from the code.
  • Reformatted all the classes according to new changes in the .editorconfig file.
  • Better update checking.
----------, Nov 9, 2024

  • Updated Command Framework library to v1.5.12.
----------, Nov 4, 2024

  • Added a new feature to change the block at the collected Easter Egg's location.
Changes in the config.yml
Code (YAML):
easter-eggs :
  # Spooktacular Halloween!
  candy-basket
:
    # 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
----------, Nov 2, 2024

  • Now caching the leaderboard values for better optimization.
  • Small improvement on the user system.
----------, Oct 31, 2024

  • Added an option to remove the Easter Egg block when a player collect it.
Changes in the config.yml
Code (YAML):
easter-eggs :
  # Spooktacular Halloween!
  candy-basket
:
    texture
: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODdmNTA0Y2RiZjViMjExMjFiODIxODUyOGRjZTU2NzUwNWQ0NTY3ZDdlNzJjZDQzYTQ2M2NkNTFjODAxM2E2In19fQ=="
    # Should we remove the Easter Egg when a player collect it?
    remove-on-collect
:
      enabled
: false
----------, Oct 30, 2024

  • Updated Despical's Commons library to v1.8.81.
  • Updated some of the log messages.
  • Improvements on data storage.
----------, Oct 29, 2024

  • Added support for Minecraft 1.21.2 & 1.21.3.
  • Fixed fireworks not working in Minecraft 1.21.2 & 1.21.3.
  • Now supporting Easter Eggs placed to walls.
  • Removed the update checking when an admin joins to server.
----------, Oct 28, 2024

  • Added permission for the action bar.
Changes in the config.yml
Code (YAML):
action-bar :
  # The permission required for players to view the action bar. Leave it empty to display the action bar to everyone.
  permission
: ""
----------, Oct 19, 2024

  • Now Easter Egg particles won't be displayed if the player and the egg are in different worlds.
----------, Oct 18, 2024

  • Added distance limit to display Easter Egg particles.
Changes in the config.yml
Code (YAML):
particles :
  # 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
----------, Oct 17, 2024

  • Added whitelisted and blacklisted permissions for the Easter Eggs.
  • Added a new placeholder to show how many different type of Easter Eggs has the player found. (%eastereggs_found_different_types%)
  • Fixed some particles appear when an Easter Egg block is not saved properly by the server. Now these non-Easter Egg blocks will be removed and a warning message will be appear in the console.
  • Now interaction with the Easter Eggs will cancel the PlayerInteractionEvent. For example, if you are in the creative mode and interact with an Easter Egg, you'll no longer place a block, etc.

Changes in the config.yml
Code (YAML):
easter-eggs :
  # 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

# Set 'NONE' to disable any.
sounds
:
  # 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

Changes in the messages.yml
Code (YAML):
messages:
  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!"
----------, Oct 16, 2024

  • Fixed Easter Egg skins not showing up in Minecraft 1.21.1.
----------, Oct 14, 2024

  • Added automatically data saving every X ticks. By default, it is disabled.

Changes in the config.yml
Code (YAML):
# Should user data be automatically saved every X ticks? (Set to 0 to only save during server shutdown or reload)
auto-data-saving
: 0
----------, Oct 14, 2024

  • Added /eastereggs savestats command to save the user data manually.
    • Check out the commands section on the resource page for more detailed information about the command.
Changes in the messages.yml
Code (YAML):
messages:
  statistics-saved
: "&aThe user data has successfully saved to the database."
----------, Oct 11, 2024

  • Added /eastereggs info command to display detailed information about the plugin and server environment.
    • Permission: eastereggs.info
    • Can only be executed by players.
  • Code based small changes.
----------, Oct 9, 2024

  • Added %player% placeholder to be used in the action bar messages.
  • Added option to send action bar messages for already found Easter Eggs.
Changes in the config.yml
Code (YAML):
action-bar :
  # Should we only send the action bar messages to the player for the Easter Eggs they haven't found yet?
  only-not-found
: true
----------, Oct 7, 2024

  • Added option to disable the action bar messages for a specific type of Easter Egg.
Changes in the config.yml
Code (YAML):
easter-eggs :
  # To obtain this Easter Egg, use the command: /eggs red_egg
  red_egg
:
    texture
: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNmUzMmE3ZGU3YTY3MmNjNjhmYTdhMjcyYmFhNmE4OWViZDQ0MGMzMmRjZjQ0ZTc3MDU3MDY4OTg5MDQyZjdjNiJ9fX0="
    # Should we disable the action bar messages for this Easter Egg? (Optional, by default the action bar is enabled)
    action-bar-disabled
: false
----------, Oct 6, 2024

  • Added a new Easter Egg for the Halloween.
Changes in the config.yml
Code (YAML):
easter-eggs :
  # Spooktacular Halloween!
  candy-basket
:
    texture
: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODdmNTA0Y2RiZjViMjExMjFiODIxODUyOGRjZTU2NzUwNWQ0NTY3ZDdlNzJjZDQzYTQ2M2NkNTFjODAxM2E2In19fQ=="
    # Spooky Messages
    egg-already-found
: "&cYou 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
----------, Oct 4, 2024

  • Updated Commons, Command Framework and bStats for better performance and compatibility.
----------, Oct 1, 2024

  • Updated Commons to v1.8.4.
  • Updated Command Framework to v1.5.1.
  • Code based small changes.
----------, Sep 22, 2024

  • Updated Easter Egg event constructors, now using the User class instead of Player.
  • Updated config.yml header.
  • Updated Commons library to v1.8.3.
  • Updated shaded library locations.
  • Improvements on hooking PlaceholderAPI.
----------, Sep 9, 2024

  • Added leaderboard placeholders.
New Placeholders:
  • %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.
----------, Sep 7, 2024

  • Fixed no permission message not working.
    • Leave 'messages.no-permission' empty if you don't want to send a message.
  • Cached PlaceholderAPI state for better performance.
Changes in messages.yml
Code (YAML):
messages:
  no-permission
: "&cYou must be admin or higher to use this command!"
----------, Sep 2, 2024

  • Added PAPI support to player messages.
----------, Sep 1, 2024

  • Added 2 new placeholders:
    • %eastereggs_total_type% - The total number of different Easter Egg types.
    • %eastereggs_Egg ID: persistent% - Returns a string whether the specified Easter Egg is persistent or not.
Changes in messages.yml
Code (YAML):
placeholders :
  # %easter_eggs_EGG ID:persistent%
  persistent
: "Persistent"
  not-persistent
: "Not Persistent"
----------, Aug 29, 2024

  • Added EasterEggPlaceEvent to API.
    • Check out the me.despical.eastereggs.api.EasterEggPlaceEvent class for more information.
----------, Aug 26, 2024

  • Added general cooldown feature which allows user to set a general cooldown to collect any type of Easter Eggs.
Changes in messages.yml
Code (YAML):
messages:
  general-cooldown
: "&c&lYou have to wait {0}s before collecting this Easter Egg again!"
Changes in config.yml
Code (YAML):
sounds :
  # 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

# Should players wait a certain amount of time before collecting any Easter Eggs?
general-cooldown
: 0
----------, Aug 24, 2024

  • Added cooldown feature to make players wait before collecting the same type of Easter Eggs.

Changes in config.yml
Code (YAML):
sounds :
  # Sound that is going to be played when player has a cooldown to collect again.
  cooldown
: ENTITY_VILLAGER_NO

easter-eggs
:
  'egg-id'
:
    # Should players wait a certain amount of time before collecting this type of Easter Eggs? (Optional, by default no cooldown)
    cooldown
: 0
 
Changes in messages.yml
Code (YAML):
messages:
  cooldown
: "&c&lYou have to wait {0}s before collecting this Easter Egg again!"
----------, Aug 23, 2024

  • Updated Commons license.
----------, Aug 22, 2024

  • Updated some of the messages.
  • General improvements on the commands.
----------, Aug 21, 2024

  • Updated Command Framework to v1.5.0.
----------, Aug 19, 2024

  • Fixed click event for the help command messages.
----------, Aug 18, 2024

  • Updated help command design.
With this update, there will be a 50% discount until the end of this month.
----------, Aug 17, 2024

  • Support for Minecraft 1.21.1.
  • Updated help command messages.
  • Now check command can be executed by console too.
----------, Aug 11, 2024

  • Now reload command is also going to reload the Easter Eggs.
----------, Aug 8, 2024

  • Moved MySQL configuration to a separated file (mysql.yml).

Changes in config.yml
Code (YAML):
# Should we enable support for MySQL?
mysql-enabled
: false

New file: 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
----------, Aug 3, 2024

  • Fixed left click bugs in Easter Eggs menu.
  • Fixed shift + left click removes of all the Easter Eggs while it only should remove the specific one.
  • Fixed list command format.
  • Fixed players can get damage from Easter Egg firework.
  • Added list command to tab completer.
----------, Aug 2, 2024

  • Updated Command Framework to v1.4.9.
  • Fixed some of the commands sending command usage instead of sending the error message.
  • Fixed some of the commands can be executed by console why it shouldn't be.
----------, Jul 28, 2024

  • Updated config.yml comments.
  • Updated command descriptions.

Updated resource page design.
----------, Jul 25, 2024

  • Updated Command Framework to v1.4.8.
    • Huge improvements on the command system.
----------, Jul 19, 2024

  • Lots of code based performance improvements.
----------, Jul 13, 2024

  • Added new feature to eggs menu.
  • Updated Commons to latest available version.

Changes in messages.yml
Code (YAML):
eggs-menu:
  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."
 

[​IMG]
----------, Jul 11, 2024

  • Fixed sounds can not be played in higher versions of Minecraft that causes to break plugin.
----------, Jul 9, 2024

  • Support for new added sounds in MC 1.17+ such as:
    • BLOCK_COPPER_BULB_BREAK,
    • BLOCK_COPPER_BULB_FALL,
    • BLOCK_COPPER_BULB_HIT,
    • BLOCK_COPPER_BULB_PLACE,
    • BLOCK_COPPER_BULB_STEP,
    • BLOCK_COPPER_BULB_TURN_OFF,
    • BLOCK_COPPER_BULB_TURN_ON,
    • BLOCK_COPPER_DOOR_CLOSE,
    • BLOCK_COPPER_DOOR_OPEN,
    • BLOCK_COPPER_FALL,
    • BLOCK_COPPER_GRATE_BREAK,
    • BLOCK_COPPER_GRATE_FALL,
    • BLOCK_COPPER_GRATE_HIT,
    • BLOCK_COPPER_GRATE_PLACE,
    • BLOCK_COPPER_GRATE_STEP
    • BLOCK_TRIAL_SPAWNER_ABOUT_TO_SPAWN_ITEM,
    • BLOCK_TRIAL_SPAWNER_AMBIENT,
    • BLOCK_TRIAL_SPAWNER_AMBIENT_CHARGED,
    • BLOCK_TRIAL_SPAWNER_AMBIENT_OMINOUS,
    • BLOCK_TRIAL_SPAWNER_BREAK,
    • BLOCK_TRIAL_SPAWNER_CHARGE_ACTIVATE,
    • BLOCK_TRIAL_SPAWNER_CLOSE_SHUTTER,
    • BLOCK_TRIAL_SPAWNER_DETECT_PLAYER,
    • BLOCK_TRIAL_SPAWNER_EJECT_ITEM,
    • BLOCK_TRIAL_SPAWNER_FALL,
    • BLOCK_TRIAL_SPAWNER_HIT,
    • BLOCK_TRIAL_SPAWNER_OMINOUS_ACTIVATE,
    • BLOCK_TRIAL_SPAWNER_OPEN_SHUTTER,
    • BLOCK_TRIAL_SPAWNER_PLACE,
    • BLOCK_TRIAL_SPAWNER_SPAWN_ITEM,
    • BLOCK_TRIAL_SPAWNER_SPAWN_ITEM_BEGIN,
    • BLOCK_TRIAL_SPAWNER_SPAWN_MOB,
    • BLOCK_TRIAL_SPAWNER_STEP.
----------, Jul 9, 2024

  • Support for new added items in MC 1.20 & 1.21.
  • Now players can get a copy of shift clicked Easter Egg in eggs menu.

Changes in messages.yml

Code (YAML):
eggs-menu:
  egg
:
    name
: "&e&l{0}"
    lore
:
     - "&8* &7LEFT  click to teleport."
      - "&8* &7RIGHT click to remove."
      - "&8* &7SHIFT click to get a copy."
----------, Jul 6, 2024

  • Added '/eastereggs copy' command to copy targeted Easter Eggs.
    • Can only be executed by players.
    • Permission: eastereggs.copy
  • Small fix that some of the eggs with specific ids may not work.



Changes in messages.yml

Code (YAML):
messages:
  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."
----------, Jun 30, 2024

  • Added /eastereggs removeall <egg id> command to remove all the Easter Eggs with given id.
    • Permission: eastereggs.removeall
  • Added check command's messages to messages.yml.
  • Now help command will display current command label instead of "eastereggs".

Changes in messages.yml
Code (YAML):
messages:
  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}).\n&3>>&b https://spigotmc.org/resources/easter-eggs.116086/"
    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!"
----------, Jun 25, 2024

  • Added '/eastereggs check' command to check if there is any available updates.
    • Permission: eastereggs.check
    • Only executable by players.
  • Hex color support for command messages.
  • Improvements on command system.
----------, Jun 22, 2024

  • Added support for Minecraft 1.21.
----------, Jun 20, 2024

  • Added command to reset statistics.
    • /eastereggs resetstats [player] [egg id] - eastereggs.resetstats

Changes in messages.yml
Code (YAML):
messages:
  no-player-found
: "&c&lNo player has found with that name!"
  own-stats-reset
: "&a&lYou have successfully reset your all statistics!"
  player-stats-reset
: "&a&lYou have successfully reset {0}''s statistics!"
----------, Jun 19, 2024

  • Added new command to create same Easter Egg with different textures.
    • /eastereggs texture <egg id of new texture>
  • Fixed some of the command descriptions.
  • Fixed short and long arguments size error messages not handled properly.

Changes in messages.yml:

Code (YAML):
messages:
  correct-usage
: "&cCorrect usage: {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."
----------, Jun 15, 2024

  • Fixed NPE on player quit event.
----------, Jun 13, 2024

  • Added sort option to action bar messages.
  • Now action bar messages supports PAPI placeholders.
    • %egg_id% - Closest egg's id (The 'sorted' option should be enabled for more accurate calculations).
    • Other PAPI placeholders.
  • Code based improvements/changes.
Config Changes
Code (Text):
action-bar:
     # Should we sort the eggs nearby the player so that the closest ones are first?
  sort: true
----------, Jun 12, 2024

  • Now Easter Eggs can be non-persistent which means their data won't be stored.
To create non-persistent eggs:
Code (YAML):
easter-eggs:
  "green_present"
: # To get this Easter Egg: /eggs green_present
    texture
: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDA4Y2U3ZGViYTU2YjcyNmE4MzJiNjExMTVjYTE2MzM2MTM1OWMzMDQzNGY3ZDVlM2MzZmFhNmZlNDA1MiJ9fX0="
    # If option is disabled, we won't save the data of this Easter Egg for the players that interacted with this egg.
    # By default, this option is true for all eggs.
    persistent
: false
----------, Jun 10, 2024

  • Now '/egg menu' command accepts multiple egg name.
    • /egg menu red_egg, blue egg, green_present
  • Updated PlaceholderAPI to the latest.
----------, May 29, 2024

Discord: mrdespical

  • Fixed GUIs not working on Mojang mapped servers (MC 1.20.5+).
  • Fixed console spamming "Cannot measure distance between World-1 and World-2", if the egg and player are in different worlds.
----------, May 24, 2024

  • Better support for Minecraft 1.20.5+.
  • Updated Commons library and action bar code.
----------, May 23, 2024

Discord: mrdespical

1.1.1
  • Updated config file's header.
----------, May 16, 2024

Discord: mrdespical

1.1.0
  • Added '/eastereggs list' command to display created Easter Eggs' ids.
    • Permission: eastereggs.list
    • Can be executed by players and console.
  • Updated Command Framework API.
Messages File Changes
Code (YAML):
messages:
  list-command
:
    no-eggs-created
: "&cThere are no eggs created to display!"
    format
: "&aExisting Easter Eggs: &7{0}"
----------, May 7, 2024

Discord: mrdespical

1.0.9
  • Added a new placeholder to show how many easter eggs that player needs to collect in total.
  • Added a new placeholder to show how many easter eggs that player needs to collect for given id.
  • Added a new placeholder to show how many easter eggs that player found in total.
  • Renamed the placeholder identifier to 'eastereggs' from 'easter_eggs'.
  • Relocated the Command Framework package to prevent conflicts with other plugins that also using that framework.
----------, May 2, 2024

Discord: mrdespical

1.0.8
  • Now Easter Eggs can be removed directly using the menu ('/eastereggs menu' command).
Messages File Changes
Code (YAML):
eggs-menu:
  lore
:
   - "&8Left-click to teleport."
    - "&8Right-click to remove this egg."
----------, May 1, 2024

Discord: mrdespical

1.0.7
  • Updated Command Framework to v1.4.6.
  • Updated pom.xml file.
  • Reformatted classes.
----------, Apr 28, 2024

Discord: mrdespical

1.0.6
  • Minecraft 1.20.5 support.
  • New message customization options for eggs menu.

Messages File Changes
Code (YAML):
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
: "&7Id: {0}"
    lore
:
     - "&8Click to teleport."
----------, Apr 25, 2024

Discord: mrdespical

1.0.5
  • Added website section to plugin.yml.
  • Moved messages to another file from default config file.
----------, Apr 19, 2024

Discord: mrdespical

1.0.4
  • Added API for developers.
    • New event FoundNewEggEvent.
  • Fixed players can break Easter Eggs.
    • Added permission to override: eastereggs.break
----------, Apr 16, 2024

Discord: mrdespical

1.0.3
  • Added filtering option to menu command.
    • /eastereggs menu <id to filter>.
  • Updated help command messages.
----------, Apr 13, 2024

Discord: mrdespical

1.0.2
  • Switched back to Java 8, now minimum required Java version is Java 8.
  • Fixed tab completer does not completes '/eastereggs get'.
  • Fixed tab completer does not sort correctly.
----------, Apr 12, 2024

Discord: mrdespical

1.0.1
  • Added update checker.
----------, Apr 11, 2024

Resource Information
Author:
----------
Total Downloads: 133
First Release: Apr 11, 2024
Last Update: Mar 22, 2026
Category: ---------------
All-Time Rating:
7 ratings
Find more info at docs.despical.dev...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings