A fully customizable plugin that allows you to manage enderchests on your server!

Install:

1. Download the jar from the Download tab.
2. Drop it into the server's plugins/ folder.
3. Restart the server (do not use /reload in production).

Main important things:

• Edit how everything looks
• Who have access to what
• Create infinite amount of enderchests which you can fully configure
• Blacklist some items (if you want to)
• Configure on-action sounds

Compatibility:

• This plugin is a standalone which means NO OTHER PLUGINS REQUIRED (i would recommend permission plugin tho)
• It was built on Java 21, mostly tested on Java 21, 1.21.4 and Java 25, 26.3 (also Java 21 is required at least)

Some additional features:

• Admin view for other enderchests (it has to be there)
• Admin-bypass view (where you can access other player's enderchests even if they dont have access to those)
• Use different databases (H2, SQLite, MySQL)
• Easily migrate between databases (you can use H2 and when you need to switch just configure MySQL in the config and migrate from H2 to MySQL whenever you want)
• Easily reload whole configuration (literally everything you can edit it will be reloaded with one command, no restart required)

Commands:

Command	Description
/enderchest	Fast access to the Enderchests Menu
/enderchest [player]	Admin access to view other players' enderchests
/aenderchest migration [old format] [new format]	Easily migrate between different storage formats
/aenderchest reload	Reload plugin's configuration

Aliases: /ec, /hucznyec, /hucznyenderchest & /aec, /ahucznyec, /ahucznyenderchest

Permisisions:

Permission	Description
hucznyenderchest.command	Access to /enderchest command
hucznyenderchest.others	View other players' enderchests
hucznyenderchest.others.modify	Modify other players' enderchests
hucznyenderchest.others.exempt	Bypass players from having other admins to view their enderchests
hucznyenderchest.others.exempt.modify	Bypass players from having other admins to modify their enderchests
hucznyenderchest.admin	Access to /aenderchest and all sub-commands

Default configuration:

protect:
  # Cooldown between switching from different pages (maybe it will be usefull, maybe it blocks some exploits idk but its cool)
  switch-cooldown: 250
  # Blacklisted items from putting into your enderchest
  blacklist:
    - BARRIER
    - BEDROCK
    - COMMAND_BLOCK
    - REPEATED_COMMAND_BLOCK
    - CHAIN_COMMAND_BLOCK
databases:
  type: H2 # Your database type: H2, SQLite, MySQL
  file: "storage.db" # for SQLite
  connection: # for MySql connection
    address: 'localhost'
    port: 3306
    database: 'hucznyenderchest'
    user: 'root'
    password: 'password'
settings:
  # Should the plugin open enderchest when you right-click an enderchest block?
  listen-to-block: true
# "pages" (a cool name for "guis")
pages:
  # there are two gui types, "selector" and "enderchest"
  # "selector" is where you select your enderchest,
  # "enderchest" is the actual item-storage menu (which is below selector config)
  selector:
    # here you can setup how items with type "actions" look
    # more about them later
    actions:
      back:
        first:
          material: BARRIER
          displayname: "&cThis is the first page!"
          lore: []
          glowing: false
        default:
          material: ARROW
          displayname: "&cPrevious page!"
          lore:
          - "&7Click to go to page &f%previous%"
          glowing: false
      next:
        last:
          material: BARRIER
          displayname: "&cThis is the last page!"
          lore: []
          glowing: false
        default:
          material: ARROW
          displayname: "&aNext Page!"
          lore:
          - "&7Click to go to page &f%next%"
          glowing: false
    # here you can create multiple selector pages (yes you can have how much enderchests you want)
    # in each page you have to set values, but the most important are "slots" (which are just item types and where do they belong)
    # there are three item types (in selector gui)
    # "actions" - items that do something (back-page, next-page)
    # "decoration" - items that do absolutely nothing (like some glass etc.)
    # "enderchests" - items that when clicked they open up an actuall enderchest
    pages:
      - page: # to create a new page just copy and paste it below previous pages
        title: "&8Enderchests Page 1/2" # the title of this page
        size: 3 # size of the page
        slots: # and the actuall slots! (items)
          actions: # items with type "actions"
            # "previous" means previous page
            # "next" means next page
            # and its layout is slot:id (wooooooow)
            18: PREVIOUS 
            26: NEXT
          decoration: # items with type "decoration"
            # decorations items do nothing when clicked 
            # also it sets the name to "&7" (so basically a blank character)
            # so when you hover at the item it doesnt show "Black Stained Glass Pane" rather a blank name
            # also the layout is slot:id (in this case slot:material) BUT instead of individual slots 
            # its actually a range of slots so you dont have to copy+paste it like 30 times
            0;8: BLACK_STAINED_GLASS_PANE
            19;25: BLACK_STAINED_GLASS_PANE
          enderchests: # items with type "enderchests"
            # enderchests also use layout "slot:id"
            # you can configure different id's later in the config
            9: 1
            10: 2
            11: 3
            12: 4
            13: 5
            14: 6
            15: 7
            16: 8
            17: 9
      - page: # the same as before!
        title: "&8Enderchests Page 2/2"
        size: 3
        slots:
          actions:
            18: PREVIOUS
            26: NEXT
          decoration:
            0;8: BLACK_STAINED_GLASS_PANE
            19;25: BLACK_STAINED_GLASS_PANE
          enderchests: 
            # page 2 of selector menus looks the same but instead of
            # having enderchest ids from 1-9, there are from 10-18
            # of course, you can configure it however you want
            # maybe remove page 2 and use only 1, maybe do 3 more
            9: 10
            10: 11
            11: 12
            12: 13
            13: 14
            14: 15
            15: 16
            16: 17
            17: 18
  # there you can configure actuall enderchests
  # you can edit how do the enderchests show up in the selector menu
  # but also how an acutal opened enderchest look!
  enderchests:
    # actions item type is the same as before
    actions:
      back:
        first:
          material: BARRIER
          displayname: "&cThis is the first page!"
          lore: []
          glowing: false
        default:
          material: ARROW
          displayname: "&cPrevious page!"
          lore:
          - "&7Click, to go to page &f%previous%"
          glowing: false
      next:
        first:
          material: BARRIER
          displayname: "&cThis is the last page!"
          lore: []
          glowing: false
        default:
          material: ARROW
          displayname: "&aNext page!"
          lore:
          - "&7Click, to go to page &f%next%"
          glowing: false
      # but we also have third action type "mainmenu"
      # it just goes back from the "enderchest" page to the "selector" page
      mainmenu:
        material: NETHER_STAR
        displayname: "&eMain menu"
        lore:
        - "&7Click, to go to the &fmain menu&7!"
        glowing: false
    # later in the config you can use {STATUS_STORAGE}
    # to quick show how much items are in the enderchest
    # you can easily change how the placeholder will look
    placeholders:
      status:
        storage:
          full: "&cFULL"
          mid: "&e{COUNT}x ITEM(S)"
          empty: "&aEMPTY"
    # here instead of coppying "-page"
    # you actually put an ID (which you use in the selector page > page > enderchests)
    # and the same as before, you can use an individual ID or put a range of them
    1;3:
      displayname: "&7Enderchest &fPLAYER" # displayname when you hover the item in the selector menu
      title: "&7Opened: Enderchest #{ID}" # title when you actually open this(those) enderchest(s)
      lore:
        # unlocked is when you have access to that enderchest
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        # locked is when you dont (cool!)
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      # permission-node is obviously the requried permission for that enderchest
      permission-node: "hucznyenderchest.player"
      # size of enderchest when opened
      size: 6
      # item types and where they belong when you open an actual enderchest
      slots:
        # "decoration" and "actions" are the same
        # but there is a new item type called "items"
        # this is where the items are stored, so players can PUT there items
        # and those will be saved
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
    # and then its the same for every enderchest(s) id(s)...
    4;6:
      displayname: "&7Enderchest &eVIP"
      title: "&7Opened: Enderchest #{ID}"
      lore:
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      permission-node: "hucznyenderchest.vip"
      size: 6
      slots:
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
    7;9:
      displayname: "&7Enderchest &6SVIP"
      title: "&7Opened: Enderchest #{ID}"
      lore:
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      permission-node: "hucznyenderchest.svip"
      size: 6
      slots:
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
    10;12:
      displayname: "&7Enderchest &dMVIP"
      title: "&7Opened: Enderchest #{ID}"
      lore:
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      permission-node: "hucznyenderchest.mvip"
      size: 6
      slots:
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
    13;15:
      displayname: "&7Enderchest &bGVIP"
      title: "&7Opened: Enderchest #{ID}"
      lore:
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      permission-node: "hucznyenderchest.gvip"
      size: 6
      slots:
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
    16;18:
      displayname: "&7Enderchest &5UVIP"
      title: "&7Opened: Enderchest #{ID}"
      lore:
        unlocked:
        - ""
        - "&8» &7Access: &2&l✔"
        - "&8» &7Storage: {STATUS_STORAGE}"
        - ""
        - "&8» &7Click, to &aopen&7!"
        locked:
        - ""
        - "&8» &7Access: &4&l✘"
        - ""
        - "&8» &7You &ccant &7open that enderchest!"
      permission-node: "hucznyenderchest.uvip"
      size: 6
      slots:
        items:
          - 0;44
        decoration:
          46;48: BLACK_STAINED_GLASS_PANE
          50;53: BLACK_STAINED_GLASS_PANE
        actions:
          45: "previous"
          49: "mainmenu"
          53: "next"
# message configuration!!!
messages:
  # if someone types /ec it opens up their enderchest OR someone other's
  # or it throws up an error message, so you dont need help message for "/ec"
  # but when you use /aec you actually have to put some arguments, 
  # so doing /aec by itself (or /aec help) will show up this message!
  help:
    - ""
    - "&7 &8» &e/aec &7help &8- &fShows this message"
    - "&7 &8» &e/aec &7migration [old format] [new format] &8- &fEasily migrate files from one format to another &8(H2, SQLite, MySQL)"
    - "&7 &8» &e/aec &7reload &8- &fReloads the config &8(any database-change in the config requires restart!)"
    - ""
  usage:
    unknow-player: "&8» &7This player has not been found in the database!"
    unknow-argument: "&8» &7Unknow argument. Type &c/aec help &7to see some more info."
  database-not-loaded: "&8» &7Database is configured wrong, we cant access your enderchest, sorry."
  blacklist: "&8» &7You can't put this item in the enderchest."
  reload: "&8» &7Succesfully reloaded the plugin &f&lHucznyEnderchest&r&7."
  migration:
    success: "&8» &7Succesfully migrated files from &c%previous% format &7to &a%new% format"
    failed: "&8» &7While doing the migration something went wrong.. check the console for more info!"
    usage: "&8» &7Correct ussage: &c/aec migration [old format] [new format]"
    known-errors:
      same_databases: "&8» &7The database formats you typed as &cold &7and &cnew &7are &cthe same&7!"
      unknow: "&8» &7The database format you typed &f{arg} &7has not been found!"
  permission:
    cant-see-others: "&8» &7You can't open enderchests that aren't yours."
    cant-modify-others: "&8» &7You can't modify enderchests that aren't yours."
    cant-see-exempt: "&8» &7You can't open this player's enderchests."
    cant-modify-exempt: "&8» &7You can't modify this player's enderchests."
    cant-open: "&8» &7You don't have access to this enderchest."
    cant-use-fast-command: "&8» &7You don't have access to use the &f/enderchest &7command."
    cant-use-commands: "&8» &7You don't have access to use this command."
    cant-use-unlock: "&8» &7You don't have access to use this function."
# sounds configuration!!!
# to disable just type ""
sounds:
  # when you click on an enderchest which you dont have access to
  click-locked: "ENTITY_VILLAGER_NO"
  # when you open an enderchest menu
  open: "BLOCK_ENDER_CHEST_OPEN"
  # when you close an enderchest menu
  close: "BLOCK_ENDER_CHEST_CLOSE"
  # when you change the page to the next
  next: "BLOCK_NOTE_BLOCK_BELL"
  # when you change the page to the previous
  previous: "BLOCK_NOTE_BLOCK_BELL"