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

Let players get random rewards by finding easter eggs!

  1. TadiklCZE
    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
    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)
    upload_2021-4-2_19-6-10.png

    Easter Egg effects (Animation, Firework, Sounds, Actions & more)
    [​IMG]
    List of easter eggs (via command)
    upload_2021-4-2_19-10-20.png
    EasterEggs help message
    upload_2021-4-2_19-11-6.png
    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?...


Recent Reviews

  1. Bing_Yanchi
    Bing_Yanchi
    5/5,
    Version: 2.1.3
    Great plugin!
    Looking forward to supporting SQL soon!
    ............................
    1. TadiklCZE
      Author's Response
      Hey! Thank you for your review, I will try to look at this soon! ^^
  2. Ducki0210
    Ducki0210
    5/5,
    Version: 2.1.2
    Just WOW, nothing to add...
    (It's a wonderful and beautiful plugin, i recommend it ^^)
    1. TadiklCZE
      Author's Response
      Thank you very much for your review! ^^
  3. Bownser
    Bownser
    5/5,
    Version: 2.1.1
    amazing plugin, simple setup but powerful features make this plugin the best of its kind
    1. TadiklCZE
      Author's Response
      Thank you very much! It really means a lot for me!
  4. Cobrex
    Cobrex
    5/5,
    Version: 2.1.0
    Really nice plugin, easy to use and configure. My players had a lot of fun hunting for the eggs. Ty
    1. TadiklCZE
      Author's Response
      Thank you for your review!
  5. AntonioRush
    AntonioRush
    5/5,
    Version: 2.1.0
    Work perfect the dev is very friendly and open minded, i highly suggest getting this plugin it can be used for way more than just Easter
    1. TadiklCZE
      Author's Response
      Thank you very much! Means a lot ^^
  6. CyborgManCZ
    CyborgManCZ
    5/5,
    Version: 2.0.3
    Great plugin, recommend! <3 Friendly developer, and nicely coded! 10/10. ......,
  7. Syrus1337
    Syrus1337
    5/5,
    Version: 2.0.2
    Spigot Version: 1.16.5
    This version is working fine now

    Thank you for your quick fix!
    1. TadiklCZE
      Author's Response
      No problem! Have fun!
  8. Syrus1337
    Syrus1337
    2/5,
    Version: 2.0.1
    GUI - fancy and working
    But the main functionality isn't working.
    PlayerInteraction throws nullpointer exceptions when the eggs is placed and a player tries to collect them.

    Sniped: Could not pass event PlayerInteractEvent to Leastereggs v1.0-SNAPSHOT org.bukkit.event.EventException: null

    The default enabled particle effects spams the console aswell with null pointer exceptions.

    [Leastereggs] Plugin Leastereggs v1.0-SNAPSHOT generated an exception while executing task 629 java.lang.NullPointerException: null at cz.larkyy.leastereggs.runnables.EggParticles.run(EggParticles.java:34) ~[?:?]
    1. TadiklCZE
      Author's Response
      Please report bugs to PMs. I have already fixed this issue, but just trying it.
  9. WanterWL
    WanterWL
    5/5,
    Version: 2.0.1
    Nice plugin, continue in work. ^^
    Good luck....................................
  10. TheMartyCZ
    TheMartyCZ
    5/5,
    Version: 2.0.1
    Best Easter Egg plugin ever! <3 Developer is friendly and fast.
    I love ya!
    I use 1.16.5 ssspigot.
    1. TadiklCZE
      Author's Response
      Thank you for the review <3