✨ lEasterEggs | New Easter Eggs Plugin! | [1.13-1.16.5] 2.1.3

Native Minecraft Version:

1.16

Tested Minecraft Versions:

• 1.13
• 1.14
• 1.15
• 1.16

Source Code:

https://github.com/TadiklCZE/lEasterEggs2

Languages Supported:

English & Custom

The plugin is being recoded! Contact me on discord, if you want to request any new features!

lEasterEggs is a new plugin with unique features and interactive GUI, where you can edit your Eggs by just clicking! You can make unlimited easter eggs with unlimited actions, all is up to you!​

Features

• Unlimited Easter Eggs
• Per-Player particle effects
• Commands Tab-Complete
• EasterEggs Editor menu
• EasterEgg Animation
• HeadDatabase Plugin support
• Unlimited amount of Per-Egg rewards
• Actions system (Message, Command, more soon...)
• Sound on finding an egg
• Sound on clicking at an already found egg
• Particle on clicking at an already found egg
• Customizable Messages
• Customizable Permissions
• Customizable Sounds
• Random Skin Feature
• You can make an Easter Egg from any Skull/Block!
• Customizable Predefined Commands for Eggs!
• Random Easter Egg Skin Feature
• PlaceholderAPI Plugin Support
  • %eastereggs_found%
  • %eastereggs_total%
• Fireworks!
• Customizable Title
• Actions when a player find all Easter Eggs
• Fully Customizable GUI Editor
  Hex colors support
• Easy to configure!
• Two Easter eggs claiming methods (Walk & Click)

​

Showcase​

Eggs Editor (Main Page)
​

Easter Egg effects (Animation, Firework, Sounds, Actions & more)

List of easter eggs (via command)

EasterEggs help message
​

Spoiler: config.yml

Code (Text):

# Values for item given via the /ee give command
eggItem:
  block: PLAYER_HEAD
  displayName: "#BA77CCEaster Egg&f Block &7(Place)"
  lore:
    - ""
    - "&7Place to create a new Egg!"
  texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjU2ZjdmM2YzNTM2NTA2NjI2ZDVmMzViNDVkN2ZkZjJkOGFhYjI2MDA4NDU2NjU5ZWZlYjkxZTRjM2E5YzUifX19

settings:

  # Methods: CLICK/WALK/BOTH
  # CLICK: Player has to click at the block
  # WALK: Player has to walk on the egg
  # BOTH: Both methods will work
  claimingMethod: CLICK

  # Time in seconds. Really recommend to keep there this number. If your Easter Eggs aren't loaded and you use multiverse, you can increase this number
  # Delayed EasterEggs & Players data loading - Good if your server uses Multiverse
  delayedLoading: 100

  # Interval for AUTO-SAVING. Higher number = Better performance (Number is in ticks)
  autosave: 100 #20 = 1 second // 100 = 5 seconds

  # Default actions for new Easter Eggs.
  defaultActions:
    - "msg: &eYou have found an Easter Egg!"
    - "cmd: give %player% minecraft:diamond 1"

  # Commands sent when you find all easter eggs
  foundAllEggsActions:
    - "msg: &eYou found all Easter Eggs!"

  # Skin Textures for random egg given via the /ee give random command
  randomEggTextures:
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjU2ZjdmM2YzNTM2NTA2NjI2ZDVmMzViNDVkN2ZkZjJkOGFhYjI2MDA4NDU2NjU5ZWZlYjkxZTRjM2E5YzUifX19
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNThiOWUyOWFiMWE3OTVlMmI4ODdmYWYxYjFhMzEwMjVlN2NjMzA3MzMzMGFmZWMzNzUzOTNiNDVmYTMzNWQxIn19fQ==
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTViOGRjYmVhMjdmNDJmNWFlOTEwNDQ1ZTA1ZGFjODlkMzEwYWFmMjM2YTZjMjEyM2I4NTI4MTIwIn19fQ==
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTg4OWYxMWM4ODM4YzA5ZTFlY2YyZjgzNDM5ZWJjYjlmMzI0ZTU2N2IwZTlkYzRiN2MyNWQ5M2U1MGZmMmIifX19
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjNkNjliMjNhZTU5MmM2NDdlYjhkY2ViOWRhYWNlNDQxMzlmNzQ4ZTczNGRjODQ5NjI2MTNjMzY2YTA4YiJ9fX0=
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzc2NTk1ZWZmY2M1NjI3ZTg1YjE0YzljODgyNDY3MWI1ZWMyOTY1NjU5YzhjNDE3ODQ5YTY2Nzg3OGZhNDkwIn19fQ==
    - eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjY0NDMwZTQ5M2ZlYjVlYWExNDU1ODJlNTRlNzYxYTg2MDNmYjE2Y2MwZmYxMjY4YTVkMWU4NjRlNmY0NzlmNiJ9fX0=

  particles:
    # Particles of not found Easter Eggs. (They are respawning in intervals [cooldown setting])
    notFound:
      enabled: true
      type: VILLAGER_HAPPY
      count: 7
      # How often do the particles spawn
      cooldown: 20
      # In what distance does a player need to be to see particles (Set 0 to disable)
      maxDistance: 0
    # Particles of already found Easter Eggs. They are spawned when a player click an easter egg
    alreadyFound:
      enabled: true
      type: VILLAGER_ANGRY
      count: 7

  sounds:
    # Sound of not found Easter Egg. Played when a player click at an easter egg
    notFound:
      enabled: true
      type: UI_TOAST_CHALLENGE_COMPLETE
      pitch: 2
      volume: 10
    # Sound of already found Easter Egg. Played when a player click at an easter egg
    alreadyFound:
      enabled: true
      type: ENTITY_VILLAGER_NO
      pitch: 1
      volume: 10

  permissions:
    eggBreak: eastereggs.break
    eggPlace: eastereggs.place
    eggList: eastereggs.list
    eggTp: eastereggs.tp
    eggFound: eastereggs.found
    createEgg: eastereggs.create
    editEgg: eastereggs.edit
    giveEgg: eastereggs.give
    setEgg: eastereggs.set
    reload: eastereggs.reload
    menu: eastereggs.menu

  # Words to cancel the edit mode (When you want to edit Easter Eggs's action).
  cancellationWords:
    - "cancel"
    - "stop"

  titles:
    eggFound:
      title: "&e&lEASTER EGGS"
      subtitle: "&fYou found an easter egg! &7(%found%/%total%)"
      fadeIn: 0
      stay: 50
      fadeOut: 0

  # An animation when you click at not found easter egg.
  animation:
    enabled: true
    material: PLAYER_HEAD
    texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjU2ZjdmM2YzNTM2NTA2NjI2ZDVmMzViNDVkN2ZkZjJkOGFhYjI2MDA4NDU2NjU5ZWZlYjkxZTRjM2E5YzUifX19

  firework:
    enabled: true
    power: 0

# Configurable GUIs. Can be skipped as players can't open any of these menus, they are for admins ONLY!
inventories:
  main:
    title: "&d&lEE &8| Eggs List (Page %page%)"
    size: 45
    items:
      prevPage:
        material: ARROW
        name: "&ePrevious Page"
        slot: 39
      nextPage:
        material: ARROW
        name: "&eNext Page"
        slot: 41
      close:
        material: IRON_DOOR
        name: "&cClose"
        slot: 40
      border:
        material: BLACK_STAINED_GLASS_PANE
        name: "&f "
        slots:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 36
          - 37
          - 38
          - 42
          - 43
          - 44
      eggs:
        material: PAPER
        name: "&dEaster Egg &7#%id%"
        slots:
          - 9
          - 10
          - 11
          - 12
          - 13
          - 14
          - 15
          - 16
          - 17
          - 18
          - 19
          - 20
          - 21
          - 22
          - 23
          - 24
          - 25
          - 26
          - 27
          - 28
          - 29
          - 30
          - 31
          - 32
          - 33
          - 34
          - 35
  editor:
    title: "&d&lEE &8| Egg Editor (ID #%id%)"
    size: 45
    items:
      teleport:
        material: ENDER_PEARL
        name: "&eTeleport to the Egg"
        slot: 22
      delete:
        material: BARRIER
        name: "&cDelete to the Egg"
        slot: 24
      back:
        material: OAK_DOOR
        name: "&eBack"
        slot: 40
      actions:
        material: PAPER
        name: "&eActions 1"
        lore:
          - ""
          - "&7Click to open"
        slot: 20
      border:
        material: BLACK_STAINED_GLASS_PANE
        slots:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 36
          - 37
          - 38
          - 39
          - 41
          - 42
          - 43
          - 44
  actionslist:
    title: "&d&lEE &8| Actions List (Page %page%)"
    size: 45
    items:
      actions:
        command:
          name: "&eAction %id% &7(Command)"
          material: COMMAND_BLOCK
          lore:
            - "&f"
            - "&7Command: &e%string%"
        message:
          name: "&eAction %id% &7(Message)"
          material: PAPER
          lore:
            - "&f"
            - "&7Message: &e%string%"
        slots:
          - 9
          - 10
          - 11
          - 12
          - 13
          - 14
          - 15
          - 16
          - 17
          - 18
          - 19
          - 20
          - 21
          - 22
          - 23
          - 24
          - 25
          - 26
          - 27
          - 28
          - 29
          - 30
          - 31
          - 32
          - 33
          - 34
          - 35
      commandAction:
        material: ORANGE_STAINED_GLASS_PANE
        name: "&eAdd Command Action"
        slot: 43
      messageAction:
        material: WHITE_STAINED_GLASS_PANE
        name: "&eAdd Message Action"
        slot: 44
      prevPage:
        material: ARROW
        name: "&ePrevious Page"
        slot: 39
      nextPage:
        material: ARROW
        name: "&eNext Page"
        slot: 41
      back:
        material: OAK_DOOR
        name: "&eBack"
        slot: 40
      border:
        material: BLACK_STAINED_GLASS_PANE
        name: "&f "
        slots:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 7
          - 8
          - 36
          - 37
          - 38
          - 42

messages:
  # Messages for the list command
  list:
    syntaxe: "&d#%id% &7- "
    teleport: "&f[Teleport]"
    teleportClick: "&eClick to teleport"
    edit: "&e[Edit]"
    editClick: "&eClick to edit"
    footer:
      prevArrow: "&7<<< "
      prevPageHover: "&eClick to open"
      noPrevArrow: "&8<<< "
      noPrevPageHover: "&7No previous page"
      nextArrow: " &7>>>"
      nextPageHover: "&eClick to open"
      noNextArrow: " &8>>>"
      noNextPageHover: "&7No next page"
      pageInfo: "&7(%current%/%max%)"
      pageInfoHover: "&fTotal eggs amount: &e%total%"

  usage:
    syntaxe: "&cInvalid Command Usage! &7Usage: &f/ee %arguments%"
    argument: "<%arg%>"
  help:
    - ""
    - "&f                    &d&lEASTER EGGS"
    - ""
    - "&d  ▉▉▉     &d→ &f/ee give &7- Gives you the Easter Egg block"
    - "&d ▉▉▉▉    &d→ &f/ee menu &7- Opens the Easter Eggs Menu"
    - "&d ▉▉▉▉    &d→ &f/ee reload &7- Reloads the plugin"
    - "&d▉&b▉&d▉&3▉&d▉   &d→ &f/ee create &7- Creates an Egg from holding Block"
    - "&3▉&d▉&b▉&d▉&b▉   &d→ &f/ee set &7- Sets an Easter Egg to looking Block"
    - "&d▉▉▉▉▉   &d→ &f/ee list &7- A list of all Easter Eggs"
    - "&d ▉▉▉▉    &d→ &f/ee found &7- An amount of found Easter Eggs"
    - ""
    - "&f &7&oMade by MrLarkyy_"
    - ""
  reload: "&ePlugin has been reloaded!"
  noPermission: "&cYou have no permission to do that!"
  noEggs: "&cNo eggs found..."
  found: "&cYou have already found this Easter Egg!"
  foundAmount: "&eYou have found &6%found%/%total%&e Easter Eggs!"
  eggBreak: "&eYou just &6Broke &ethe Easter Egg!"
  eggPlace: "&dYou just placed a new Easter Egg!"
  eggGive: "&eYou have been given the Easter Egg block!"
  eggRemoved: "&cYou just &4Removed&c the Easter Egg!"
  teleported: "&eYou have been teleported to the Egg!"
  mustBeNumber: "&cYou must type a number!"
  invalidID: "&cThere is no Easter Egg with this ID!"
  actionRemoved: "&cYou just &4Removed&c the action!"
  actionAdded: "&eYou have added a new action!"
  actionCancelled: "&cYou have &4Cancelled&c adding the action!"
  typeAction: "&7Type the action into the chat please...\n&7Type &ocancel&7 to cancel the action."
  onlyPlayer: "&cThis command can be sent only ingame!"
  noBlockInHand: "&cYou are not holding any block!"
  eggBlockCreated: "&eYou have created the Easter Egg Block!"
  eggBlockSet: "&eYou have set an Easter Egg to the looked block!"
  mustLookAtBlock: "&cYou are not looking at block!"
  alreadyEditing: "&cYou are editing an Easter Egg right now!\n&cType &4cancel&c to cancel the action..."

How to install & use

Installing is really pretty easy, just drop EasterEggs.jar into your plugins folder and start your server.
Then hold a random Skull with, or without Skin, or block and type /ee create. This will register your item as an Easter Egg and then you can just place it
If you want to edit actions of an easter egg, you can check /ee menu, where is a full list of all eggs and you can edit commands there.
​

Commands

/ee menu - menu with all easter eggs listed (Eggs editor)
/ee list [page] - full list of created Easter Eggs
/ee edit <id> - opens GUI Editor of defined Easter Egg
/ee tp <id> - teleports you to an Easter Egg
/ee create - create an easter egg from item that you are holding
/ee give [random/hdb:<id>/texture] - gives you an easter egg
/ee found - types you an amount of found easter eggs
/ee set - sets looking block as an easter egg
/ee reload - reloads the plugin
​

Support

If you need any help, please contact me on SpigotMC/discord
My discord is LARKYY#0001, or you can join my discord server https://discord.gg/QjbXsA4wVr
​

Planned Features

- More Action types (Sound, Broadcast)
- SQL storage
- Player Data Reset Command
- Remove all Easter Eggs Command

Suggestions?...

​