hucznyEnderChest

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» &