commands - rutgerkok/BetterEnderChest GitHub Wiki

The /enderchest command

If you want your players to be able to remotely open or view their Ender Chest, this command is for you. The command is designed to be as simple as possible for your players. The syntax to open your Ender Chest is as follows:

/enderchest

However, behind the scenes it is a complex command. When a player has permission to remotely open his/her own Ender Chest (betterenderchest.command.openinv.self), /enderchest will simply do that. When a player cannot remotely open his/her Ender Chest, but he/she has permission to view it (betterenderchest.command.viewinv.self), /enderchest will open his/her chest in read-only mode.

When you have set PublicEnderChest.showOnUsingCommand to true in the configuration file, the default chest will be opened instead.

It's also possible to open someone else's Ender Chest when you have the permission betterenderchest.command.openinv (or betterenderchest.command.viewinv for read-only access). Please note that these nodes don't have the .self permission. The syntax of the command is still quite simple:

/enderchest <name>

When using an inventory name, the PublicEnderChest.showOnUsingCommand setting in the configuration file is ignored. As you should only give the nodes without the .self suffix to moderators, this shouldn't be a problem for people wanting to block private Ender Chests.

You can put more things in the name parameter, see the bottom of this page for an overview. If you're wondering why the permission nodes are like that, it's because the command is actually an alias for both /betterenderchest openinv [name] and /betterenderchest viewinv [name]. Read more about those below.

The /betterenderchest command

This is the main command of the plugin. It has multiple subcommands. You can get a list of them in-game by typing /betterenderchest.

The permission node of each command is betterenderchest.command.<subcommand>, where <subcommand> is the name of one of the subcommands below.

deleteinv

/betterenderchest deleteinv <name>

Deletes someone's Ender Chest inventory. Use with care. There's no undo option.

give

/betterenderchest give <name> <item> [amount] [damage value]

Gives an item to an Ender Chest inventory. Works exactly like the standard /give command, except that it affects Ender Chests and that it also works on offline players, just like all other commands of BetterEnderChest.

The last two parameters are optional. Amount will default to 1 when omitted and the damage value will default to 0.

list

/betterenderchest list

Lists all cached Ender Chest inventories. Useful for debugging.

openinv

/betterenderchest openinv [name]

Opens an Ender Chest remotely.

When you have set PublicEnderChest.showOnUsingCommand to true in the configuration file, the default chest will be opened when no name is supplied. If it's set to false, your own Ender Chest will be opened.

If you give yor users the permission node betterenderchest.command.openinv.self instead of the normal betterenderchest.command.openinv, they won't be able to supply the name parameter: they will only be able to remotely open their own Ender Chest or only the public Ender Chest, depending on your configuration.

/enderchest is a more user-friendly alias for this command. See the top of this page for more detsils about that command.

viewinv

/betterenderchest viewinv [name]

Views anyone's Ender Chest from anywhere. Editing the chest is not possible.

When you have set PublicEnderChest.showOnUsingCommand to true in the configuration file, the default chest will be opened when no name is supplied. If it's set to false, your own Ender Chest will be opened for viewing.

If you give yor users the permission node betterenderchest.command.viewinv.self instead of the normal betterenderchest.command.viewinv, they won't be able to supply the name parameter: they will only be able to remotely view their own Ender Chest or only the public Ender Chest, depending on your configuration.

/enderchest is a more user-friendly alias for this command. See the top of this page for more detsils about that command.

reload

/betterenderchest reload

Saves and unloads all cached Ender Chests and reloads the configuration files.

swapinv

/betterenderchest swapinv <name1> <name2>

Swaps two Ender Chests.

The name parameter

A lot of commands use the name parameter.

The name is usually the name of a player. The player doesn't have to be online, but the player must have logged in at least once on the server (no problem if it was before BetterEnderChest was installed).

You can also use --publicchest and --defaultchest to open the public Ender Chest and the default Ender Chest. If you don't know what those chests are, please read the installation instructions again.

If you have multiple world groups with different Ender Chests, you can open an Ender Chest from another location using the worldgroup/name syntax. Let's say that Notch has an Ender Chest in the world group called caves and you are in another world group, you can open Notch's Ender Chest of that world group using /enderchest caves/Notch. No need to teleport to that world group first!

⚠️ **GitHub.com Fallback** ⚠️