ChorusEnderchest

Chorus EnderChest

Advanced, multi-page and fully customizable EnderChest for Paper 26.2.
Everything is purple by default, every message and menu is editable, and hex colors work everywhere.

By Controll3r24.

Features

• Permission-based size: 1 to 6 rows per player.
• Multiple pages: give players several EnderChest pages, with a clean page menu and a navigation row (previous / menu / next).
• Rename pages and pick icons: players choose their own page names and menu icons.
• Hex colors everywhere: &#9D4EDD, #9D4EDD, `, &x&9&D&4&E&D&D, classic & codes, plus and `.
• Every message is editable in messages.yml, every menu title, item, material, slot, lore and sound in config.yml.
• Item blacklist by material, name and lore.
• Admin tools: open, edit or clear any player's EnderChest, even offline players who joined before.
• Safe saving: atomic file writes, automatic backup of the previous version, async saving, autosave, and a corrupt-file recovery that restores the backup.
• Anti-dupe design: each page exists only once in memory, so an owner and an admin looking at the same page share the very same inventory.
• Smart interaction: the vanilla Ender Chest block opens the custom GUI with right click only (left click still breaks it), and sneaking with an item in hand still lets you place blocks.
• Configurable restrictions: disabled worlds, creative mode block, open cooldown.
• No items lost when permissions change: if a player loses rows, their items stay stored and come back when the rows return.

Requirements

• Paper 26.2 (or newer 26.x builds)
• Java 25

Installation

1. Put ChorusEnderChest-1.0.0.jar in your plugins folder.
2. Start the server.
3. Edit plugins/ChorusEnderChest/config.yml and messages.yml, then run /ec reload.

Commands

Aliases: /ec, /echest, /enderchest

Command · Description
/ec · Open your EnderChest (page menu if you have several pages)
/ec · Open a specific page
/ec menu · Open the page menu
/ec rename · Rename a page
/ec icon [reset] · Use the item in your hand as the page icon
/ec open [page] · Open another player's EnderChest
/ec clear [page\ · all] · Clear an EnderChest
/ec reload · Reload config.yml and messages.yml

Permissions

Permission · Description · Default
chorusenderchest.use · Open your own EnderChest · everyone
chorusenderchest.customize · Rename pages and change icons · everyone
chorusenderchest.rename.color · Use colors in page names · op
chorusenderchest.rows. · Number of rows · none (see defaults.rows)
chorusenderchest.pages. · Number of pages (N = settings.max-pages) · none (see defaults.pages)
chorusenderchest.admin.open · Open other players' EnderChests · op
chorusenderchest.admin.edit · Edit other players' EnderChests (otherwise view only) · op
chorusenderchest.admin.clear · Use /ec clear · op
chorusenderchest.admin.reload · Use /ec reload · op
chorusenderchest.bypass.cooldown · Ignore the open cooldown · op
chorusenderchest.bypass.world · Ignore disabled worlds · op
chorusenderchest.bypass.gamemode · Ignore the creative restriction · op
chorusenderchest.bypass.blacklist · Store blacklisted items · op
chorusenderchest.* · Everything · op

Operators automatically get every rows and pages permission. Use a permissions plugin (for example LuckPerms) and test with a non-op account.

When a player has more than one page, the navigation row uses the last row of the inventory, so those players get at most 5 storage rows per page. Set page.nav-row.enabled to false to disable it.

Configuration highlights

settings:
override-vanilla-block: true
sneak-bypass: true
allow-creative: true
disabled-worlds: []
cooldown-seconds: 0
autosave-seconds: 300
keep-backups: true
max-pages: 9

defaults:
rows: 3
pages: 1

blacklist:
materials: []
name-contains: []
lore-contains: []

Placeholders available in titles, menus and messages are written in curly braces, for example {page}, {name}, {player}, {items}, {slots}, {target}, {max}, {seconds}, {item}.

Data

Player data lives in plugins/ChorusEnderChest/data/.yml. Each save keeps the previous version as .yml.bak.

Support

Found a bug or have an idea? Open an issue on the project page.