✨ AuroraEChest

by ItzPhenix · Plugin package: de.itzphenix.aurorachest

AuroraEChest turns your EnderChest into a multi-page double chest (54 slots): The top 45 slots are free inventory space, while the bottom row is a fixed, locked menu: for flipping through pages, item search, sorting, stats and closing.

⚠️ Requirements: Paper 1.21.x · Java 21 The plugin runs unchanged on all current Paper builds of the 1.21.x series.

📋 Features

• 📃 Multi-page system: 5 pages of 45 usable slots by default, expandable up to 27 pages
• 🎟️ Permission-based extra pages: e.g. auroraechest.pages.6 unlocks page 6
• 🔎 Item search: search across all pages at once, typed in chat directly from the GUI
• 🧹 Sorting: sort the current page with a single click on the hopper
• 📊 Info & statistics: used slots and page count always visible
• 🎛️ AdminGUI: a graphical overview of all players, click a head to open the detail view: open (edit or view only), clear everything or a single page, adjust page count with −1/+1
• 🛡️ Admin safety: read-only mode, target player notification, actions written to the console log
• ⏱️ Command cooldown & 🥊 combat lock: no EnderChest spam and no opening during PvP
• 🌍 World & item blacklists: control where and what may go into the EnderChest
• 🔊 Sounds: open, close, page switch and "denied" freely configurable (volume & pitch)
• 💾 YAML storage: one file per player, configurable autosave, loads and saves run asynchronously on the IO thread
• 🌐 Bilingual: language: en (default) or language: de in config.yml, all texts including GUI labels come from per-language files
• ♻️ Auto config upgrade: new options from updates are added automatically, your existing values are kept

🧾 Commands

Command	Description	Permission
/echest · /enderchest · /ec	Opens your own AuroraEChest	auroraechest.use
/echest <player>	Opens another player's EnderChest (admin view)	auroraechest.admin.open
/aec gui	Opens the graphical AdminGUI (player list → detail view)	auroraechest.admin.gui
/aec open <player>	Opens a player's EnderChest in admin mode	auroraechest.admin.open
/aec clear <player> [page]	Clears the entire EnderChest or just one page	auroraechest.admin.clear
/aec setpages <player> <amount>	Sets a player's page count	auroraechest.admin.setpages
/aec info <player>	Shows page and slot statistics	auroraechest.admin.info
/aec reload	Reloads config.yml and the language file	auroraechest.admin.reload
/aec help	Help overview	—

Right-clicking a real EnderChest block automatically opens AuroraEChest instead of the vanilla chest (can be disabled via behaviour.hook-vanilla-open-event).

🔑 Permissions

Permission	Default	Meaning
auroraechest.use	true	Use your own EnderChest
auroraechest.admin.open	op	Open other players' EnderChests
auroraechest.admin.gui	op	Use the graphical AdminGUI
auroraechest.admin.clear	op	Clear other players' EnderChests
auroraechest.admin.setpages	op	Set other players' page count
auroraechest.admin.info	op	View other players' statistics
auroraechest.admin.reload	op	Reload the configuration
auroraechest.admin.*	false	All admin permissions
auroraechest.pages.<n>	false	Unlocks extra page n (e.g. auroraechest.pages.7)
auroraechest.pages.*	false	Unlocks all extra pages (1–27)
auroraechest.bypass.cooldown	false	Ignore the command cooldown
auroraechest.bypass.worldblacklist	false	Ignore the world blacklist
auroraechest.*	false	All AuroraEChest permissions

⚙️ Configuration (excerpt)

The config.yml is intentionally extensive, every section is commented:

Section	Options
language	en (default) or de, switches all messages and GUI texts
pages	Default & max page count, permission-based extra pages incl. permission prefix
behaviour	Open on join, vanilla EnderChest block/event, command cooldown
restrictions	World blacklist, item blacklist, PvP combat lock + duration
sounds	On/off, all four sounds, volume & pitch
gui	Title formats with {player}, {target}, {page}, {maxpage}
menu	Material for every menu button, filler, toggle search/sort/info, quick jump
storage	YAML backend, autosave on/off + interval
admin	Target notification, console logging, read-only admin view

💡 Language files live under plugins/AuroraEChest/messages_<language>.yml (messages_en.yml = default, messages_de.yml = German) and are created automatically on first startup. All texts including & color codes and hex colors (&#RRGGBB) are fully editable; /aec reload applies changes instantly.

🛠️ Installation

1. Drop the downloaded .jar into your Paper server's plugins folder
2. (Re)start the server
3. Done! Set language in config.yml to your preference and apply it with /aec reload

---

de.itzphenix · AuroraEChest · by ItzPhenix 💜