Skip to content

Commands

Every command is registered through Paper's Brigadier system, so you get full tab-completion and inline argument hints in-game. There are two groups: player commands for opening and managing your own chests, and admin commands (/ee) for managing other players' chests.

Player commands

/enderchest/ec
Permission:enhancedechest.command.open
Open your ender chest. What opens depends on how many chests you own and whether you have chosen a main chest:
  • One chest: opens it directly.
  • Several chests, with a main set: opens your main chest directly.
  • Several chests, no main set: opens the management menu so you can pick one.
Your first chest is created automatically at the default size the first time you open it. A new chest is never made main automatically; you choose it yourself (see /eclist).
/enderchest #<index>/enderchest <name>/ec
Permission:enhancedechest.command.open
Open one specific chest, skipping the menu. Pass either its number as #<index> (e.g. /ec #2) or its custom name (e.g. /ec Loot). Tab-completion suggests your own chests. An unknown index or name reports an error instead of opening a different chest.
/eclist
Permission:enhancedechest.command.open
Always open the management menu listing all your chests, even if you have a main set. From there you can, per chest: Open it, Rename it, or Set as main (the chest that /ec and block right-click open directly). The main chest is marked with a gold .

Right-clicking an ender chest block

Right-clicking a placed ender chest block opens your chest with the same routing as /ec (single chest → direct; several + main set → main; several without a main → menu). The block itself needs no permission to use; only the enhancedechest.command.open permission unlocks opening by command and the ability to set a main chest. A player without that permission who owns several chests therefore always lands on the management menu.

Admin commands

All admin commands live under /enhancedechest (alias /ee). Every subcommand requires the base permission enhancedechest.command.admin and the command-specific permission listed on each row below.

/ee add <player> <size> [count] [duration]
Permission:enhancedechest.admin.add
Give a player a new chest. <size> is the slot count, a multiple of 9 from 9 to 54. The optional [count] creates several chests at once (defaults to 1). The optional [duration] (pass it after a count, e.g. /ee add Steve 54 1 7d) makes them temporary chests that expire after that time (e.g. 7d, 1h, 1d_12h); omit it for permanent chests. Each new chest is added at the next free index and is not made main.
/ee resize <player> <index> <size>
Permission:enhancedechest.admin.resize
Change the slot count of an existing chest. Growing, or shrinking with no items in the cut-off slots, is a plain resize. Shrinking below occupied slots spills the overflow items into a temporary chest rather than destroying them. Permission-granted chests cannot be resized this way; their size is fixed by the granting permission.
/ee delete <player> <count> [force]
Permission:enhancedechest.admin.delete
Delete the <count> newest chests (the highest indices) a player owns. By default any items they hold are spilled into a temporary chest so nothing is lost; add the literal force to hard-delete them, discarding their contents immediately. The player's first chest (lowest index) is always kept, so this can never leave them with no chest; if only the first chest remains, nothing is deleted. Permission-granted chests are skipped entirely. If you delete a player's main chest, they simply have no main until they pick a new one.
/ee view <player> [list | index]
Permission:enhancedechest.admin.view
Open another player's ender chest yourself. The player does not need to be online. You join the same live inventory the owner sees, so there is no risk of item duplication.
  • No argument: if they own one chest it opens directly; with several, a picker menu of their chests opens so you can choose one.
  • list: always open the picker menu, even if they only own one chest.
  • <index>: open that specific chest by number (e.g. /ee view Steve 2); tab-completion suggests the target's chests.
Permissions: with enhancedechest.admin.view alone you can look but not touch: every attempt to move an item is blocked. Add enhancedechest.admin.edit to also take and add items.
On Paper the admin and the player can edit the same chest at the same time. On Folia only one person can have a chest open at a time, so if the other is already using it you'll be asked to try again shortly.
/ee reload
Permission:enhancedechest.admin.reload
Reload the configuration and language files from disk without restarting the server.
/ee migrate run <player>/ee migrate run all
Permission:enhancedechest.admin.migrate.run
Import vanilla ender chest contents into the plugin's storage, either for a single online <player> or for everyone with all. Each player's vanilla chest is migrated into their chest #1 only once.

Offline players

/ee add, /ee resize, /ee delete and /ee view all work on offline players (anyone who has joined the server before); their chests live in the database, not on the player object. Tab-completion suggests offline names too: start typing and matching offline players appear alongside online ones (marked Player (offline); the list is capped so a huge roster can't flood the menu). Only /ee migrate run requires the player to be online, since it reads their live vanilla ender chest.

Durations

Duration units are s (second), m (minute), h (hour), d (day), w (week), mo (month, ≈30 days) and y (year, ≈365 days). Combine components with underscores, e.g. 1d_12h, 2w, 1mo. A month and a year are approximations.