# Commands
Chest registers two top-level commands: `/chest` and `/populate`. Both use the CommandAPI for tab completion and argument validation.
---
## /chest
The base command for managing loot tables.
| Subcommand | Usage | Permission | Description |
|---|---|---|---|
| *(none)* | `/chest` | `lodestone.chest.commands.chest` | Opens the loot table management GUI (player only). |
| `version` | `/chest version` | `lodestone.chest.commands.chest` | Displays the current Chest plugin version. |
| `reload` | `/chest reload` | `lodestone.chest.commands.reload` | Reloads all loot tables from disk. |
| `silent` | `/chest silent` | `lodestone.chest.commands.silent` | Toggles silent mode on or off. When enabled, progress notifications for large populate operations are hidden. |
---
## /populate
Fills containers in the world with items from one or more loot tables. Supports custom loot tables and vanilla loot tables (using namespaced keys like `minecraft:chests/simple_dungeon`).
| Subcommand | Usage | Permission | Description |
|---|---|---|---|
| `selection` | `/populate selection <loot_tables>` | `lodestone.chest.commands.populate` | Populates containers within your current WorldEdit selection. Requires WorldEdit or FastAsyncWorldEdit. |
| `at` | `/populate at <world> <location> <radius> <loot_tables>` | `lodestone.chest.commands.populate` | Populates containers within the specified radius around the given location. Radius range: 1-2000. |
| `nearby` | `/populate nearby <radius> <loot_tables>` | `lodestone.chest.commands.populate` | Populates containers within the specified radius around the executing player. Radius range: 1-2000. Player only. |
---
## Populate Flags
Flags are appended to the `<loot_tables>` argument to control populate behavior.
| Flag | Description |
|---|---|
| `-c` | Include chests in the populate scan. |
| `-b` | Include barrels in the populate scan. |
| `-s` | Include shulker boxes in the populate scan. |
| `-f` | Force refill containers, even if they are not empty. |
| `-w` | Wipe container contents before populating. |
| `-l <value>` | Set the minimum number of items per container (default: 3). |
| `-h <value>` | Set the maximum number of items per container (default: 6). |
If none of `-c`, `-b`, or `-s` are specified, both chests and barrels are included by default.
### Examples
```
/populate nearby 50 my_loot_table
/populate nearby 100 dungeon_loot -c -f -l 2 -h 8
/populate at world 0 64 0 200 minecraft:chests/simple_dungeon my_custom_table -b -w
/populate selection rare_drops common_drops -c -b -s -l 1 -h 4
```
---
## Permissions Summary
| Permission | Description |
|---|---|
| `lodestone.chest.commands.chest` | Access to the `/chest` base command and GUI. |
| `lodestone.chest.commands.reload` | Access to `/chest reload`. |
| `lodestone.chest.commands.silent` | Access to `/chest silent`. |
| `lodestone.chest.commands.populate` | Access to all `/populate` subcommands. |
---
## Related Pages
- [[Chest/Server Owners/Overview]] — Plugin overview and installation
- [[Chest/Server Owners/Configuration]] — Config file reference