> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/vault-crates/commands-and-permissions.md). # Commands & permissions Quick-reference page. Most of these are detailed elsewhere — this is the at-a-glance summary you can keep open in a tab. ## Commands All commands are prefixed `/tcpvc`. Use `/tcpvc help` in-game for the abbreviated version. | Command | Permission | What it does | | -------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/tcpvc gui` | `tcpvc.admin` | Open the admin GUI ([detailed walkthrough](/plugins/vault-crates/admin-gui.md)). First run on a player shows a welcome Dialog. | | `/tcpvc about` | `tcpvc.admin` | Show the welcome Dialog manually (plugin version + quick-reference + Open GUI / Open docs / Close). | | `/tcpvc set ` | `tcpvc.admin` | Register the looked-at Vault block as a crate of type ``. Range: 8 blocks. Aligns the vault's ominous BlockData flag to match the crate's configured tier(s). | | `/tcpvc unset` | `tcpvc.admin` | Unregister the looked-at Vault block. Strips its PDC and removes the hologram. | | `/tcpvc list [page]` | `tcpvc.admin` | Paginated list of registered vaults in currently-loaded chunks (10 per page). | | `/tcpvc preview [tier]` | `tcpvc.use` | Browse a crate's prize list. Open to all players. | | `/tcpvc key give [tier] [amount]` | `tcpvc.admin` | Issue keys. Tier required when both are configured. | | `/tcpvc key give-all [tier] [amount]` | `tcpvc.admin` | Issue keys to every online player. | | `/tcpvc reset player ` | `tcpvc.admin` | Reset one player's cooldown on every registered vault of the crate. Works for offline players. | | `/tcpvc reset all` | `tcpvc.admin` | Wipe every cooldown (per-player + server-wide lock + rewarded\_players NBT) on every registered vault of the crate. | | `/tcpvc reset group ` | `tcpvc.admin` | Reset cooldowns for every player (online + offline via LuckPerms) holding the permission node. Falls back to online-only without LuckPerms. | | `/tcpvc reload` | `tcpvc.admin` | Reload `config.yml`, `crates.yml`, `loot-templates.yml` and `messages.yml` without restarting. | | `/tcpvc update [check\|download\|restore\|status]` | `tcpvc.admin` | Check for and install plugin updates (esmp.fun licences only). | | `/tcpvc help` | `tcpvc.admin` | Show the command help. | ### Notes * **`/tcpvc update`** *(1.1.0+)* — checks esmp.fun for a newer build, authenticated with your licence key. Subcommands: `check` (default), `status`, `download` (verify + stage for the next restart), `restore` (roll back to the previous jar), and `ignore ` / `unignore `. Behaviour is gated by `update.mode` in `config.yml` — in the default `notify` mode nothing downloads. Staged updates install on the next server restart. **Available for esmp.fun licences only**; Voxel installs get a pointer to their marketplace instead. See [**config.yml → Updates**](/plugins/vault-crates/config-yml.md#updates-section). * **``** — the crate id from `crates.yml`. Tab-completes against configured crates. * **`[tier]`** — `normal` or `ominous`. Optional when the crate has only one tier configured. * **`[amount]`** — 1..64. Default 1. * **`/tcpvc set` and `/tcpvc unset`** are **player-only** commands — they need a looked-at block. The console can't run them. * **`/tcpvc gui` and `/tcpvc about`** are also player-only — they open Dialogs / inventories which need a viewer. * **`/tcpvc reset group `** requires LuckPerms installed for the offline-player resolution. Without LuckPerms the scope automatically narrows to online players + you get a one-line chat notice. ## Permissions Set in your permissions plugin (LuckPerms, PermissionsEx, etc.) or `plugin.yml` of a separate permissions configuration. | Permission | Default | What it grants | | ----------------------- | -------- | -------------------------------------------------------------------------------------------------- | | `tcpvc.admin` | OP | All administrative operations: help, GUI, set/unset, list, key give, reset, reload, update, about. | | `tcpvc.use` | everyone | Open registered vaults, browse loot previews. | | `tcpvc.bypass.droplock` | OP | Pick up vault loot drops regardless of the owner-lock window. | ### How the open-flow permission gate works Players need `tcpvc.use` to open vaults — but it defaults to `true` for everyone, so you don't usually grant it explicitly. Negate it (`tcpvc.use: false` in a LuckPerms group) only if you want to **deny** opening for specific players (e.g. jailed users, players in PvE-only regions). ### How the bypass permission works When a player's inventory is full and crate loot drops at their feet, the dropped items are **owner-locked** — only the original opener can pick them up for the configured grace window (`crates.drop-on-full-inventory.owner-grace-seconds` in `config.yml`, default 30 seconds). `tcpvc.bypass.droplock` overrides this. Players with the permission can pick up any vault drop regardless of who opened it. Default OP — useful for staff cleaning up dropped items, or for players in a "shared loot" region. ## Tab completion Every argument position has tab-completion: * After `/tcpvc` → list of subcommands. * After `/tcpvc key` → `give` / `give-all`. * After `/tcpvc key give` → online player names. * After `/tcpvc key give Steve` → configured crate ids. * After `/tcpvc key give Steve common` → `normal` / `ominous`. * After `/tcpvc key give-all` → configured crate ids. * After `/tcpvc key give-all common` → `normal` / `ominous`. * After `/tcpvc preview` → configured crate ids. * After `/tcpvc preview common` → `normal` / `ominous`. * After `/tcpvc set` → configured crate ids. * After `/tcpvc reset` → configured crate ids. * After `/tcpvc reset common` → `player` / `all` / `group`. * After `/tcpvc reset common player` → online player names. ## Aliases The command also responds to `/vaultcrate` and `/vaultcrates` — configured in the plugin's `plugin.yml` (inside the JAR). If those conflict with another plugin on your server, remap or disable them via the server's `commands.yml` aliases section, then restart. *** Next: [**config.yml reference →**](/plugins/vault-crates/config-yml.md) · [**messages.yml →**](/plugins/vault-crates/messages-yml.md)