Commands

Commands

Player commands

/deposit

Searches for allowed containers within the player's search radius and moves matching items from their inventory into them.

• Only items that already have at least one matching item sitting in a nearby container are moved. A completely empty container is never used as a target, no matter how close it is.
• Containers are tried nearest-first. If the nearest matching container is full, QuickDeposit automatically tries the next nearest one, and so on.
• If a container can only take part of a stack, the rest is moved on to further containers in the same run.
• Nothing is ever deleted. Anything that doesn't fit anywhere stays in the player's inventory exactly as it was.
• By default, the hotbar and off-hand are skipped (configurable, see Configuration) so tools, food, etc. that are actively being held aren't swept away by accident.
• Worn armor is never touched, regardless of any setting.
• Subject to the cooldown configured in config.yml, unless the player has quickdeposit.bypass.cooldown.
• Does nothing (with a message explaining why) in a world that's currently blacklisted, or - in whitelist mode - not on the whitelist. See Configuration and /qd worlds below.

Requires: quickdeposit.use (granted to everyone by default).

/deposit all

Identical to /deposit, except the hotbar and off-hand are always included, regardless of the protect-hotbar / protect-offhand settings. Worn armor is still never touched.

Requires: quickdeposit.use and quickdeposit.all (both granted to everyone by default).

Admin commands

All admin commands live under /qd (alias for /quickdeposit).

/qd info

Shows the plugin version, the global radius (with its min/max bounds), the configured matching mode and cooldown, and - if run by a player - that player's own effective radius and whether it's an individual override or the global default.

Requires: quickdeposit.admin.info.

/qd reload

Reloads config.yml and playerdata.yml from disk, and re-checks whether WorldGuard, GriefPrevention and LuckPerms are currently installed. Use this after hand-editing config.yml, or after installing/removing one of the optional integration plugins, instead of restarting the server.

Requires: quickdeposit.admin.reload.

/qd radius

Shows the current global radius and its configured minimum/maximum.

Requires: quickdeposit.admin.radius.

/qd radius global <radius>

Sets the global default search radius immediately (no restart needed) and saves it to config.yml. Rejected with an error if <radius> is outside the configured minimum/maximum.

Requires: quickdeposit.admin.radius.

/qd radius player <player> <radius>

Gives one specific player their own search radius, overriding the global default for them (and only them). Stored by UUID in playerdata.yml, so it survives name changes. Also rejected if outside the configured bounds.

Requires: quickdeposit.admin.radius.

/qd radius reset <player>

Removes a player's individual radius override, so they go back to using the global default.

Requires: quickdeposit.admin.radius.

/qd container list

Shows the current global on/off state for every supported container type.

Requires: quickdeposit.admin.container.

/qd container list <player>

Shows the effective container settings for one specific player - i.e. after taking their permissions into account, not just the global config. Each line is tagged [GLOBAL] or [PERMISSION] depending on where that value actually came from (see Permissions for the priority rules). If the target player is offline and LuckPerms isn't installed, this falls back to showing the global values only, with a note explaining that.

Requires: quickdeposit.admin.container.

/qd container global <type> <on|off>

Enables or disables a container type server-wide, immediately, and saves it to config.yml. Valid <type> values are: chest, trapped-chest, barrel, shulker-box, hopper, dispenser, dropper.

Requires: quickdeposit.admin.container.

/qd worlds

Shows the current world mode (BLACKLIST or WHITELIST) and the current list of worlds it applies to.

Requires: quickdeposit.admin.worlds.

/qd worlds mode <blacklist|whitelist>

Switches between blacklist and whitelist mode immediately and saves it to config.yml. Switching modes does not clear the list - the same world names are simply interpreted the other way around.

Requires: quickdeposit.admin.worlds.

/qd worlds add <world>

Adds a world to the list (blacklist or whitelist, depending on the current mode). The world must currently exist/be loaded - unknown names are rejected.

Requires: quickdeposit.admin.worlds.

/qd worlds remove <world>

Removes a world from the list.

Requires: quickdeposit.admin.worlds.

Enabling/disabling commands

Both top-level commands can be turned off completely, server-wide, via plugins/QuickDeposit/commands.yml - see Configuration. There's no permission to bypass this; a disabled command refuses to run for everyone, including operators.

Tab completion

All /qd subcommands, container type names, on/off, world names, and online player names tab-complete automatically.

Tab-completion is also permission-aware in both directions:

• A player who has no relevant permission at all never sees /deposit or /qd show up when they tab-complete a bare /.
• A player who has some but not all /qd permissions (e.g. only quickdeposit.admin.radius) only sees the subcommands they can actually use when they tab-complete /qd .
• A disabled command (via commands.yml) is hidden from tab-completion for everyone, regardless of permissions.

This is cosmetic, not a security boundary by itself - every command still checks permissions again when it actually runs, exactly as before.