# Chest
Chest is a premium loot table management plugin for Paper servers. It provides a complete system for creating, editing, and distributing custom loot tables across your world, with built-in WorldEdit integration for large-scale container population.
---
## Requirements
- **Java 21** or higher
- **Paper 1.20.4** or higher
- **Valid license key** — Chest is a premium plugin and requires activation at [lode.gg](https://lode.gg/plugin/chest/configure)
## Dependencies
| Dependency | Type | Purpose |
|---|---|---|
| Bookshelf | Soft | Lodestone core library providing menu management and utilities |
| WorldEdit | Soft | Enables the `populate selection` command for region-based container filling |
| FastAsyncWorldEdit | Soft | Alternative to WorldEdit; provides the same selection-based functionality |
All-in-all, you **do not** need to install any additional plugins.
## Features
- **Loot Table Management** — Create, edit, and delete custom loot tables through an in-game GUI or the API. Each table supports weighted items for rarity control.
- **Populate Command** — Fill containers (chests, barrels, shulker boxes) within a radius or WorldEdit selection with loot from one or more tables. Supports both custom and vanilla Minecraft loot tables.
- **Vanilla Loot Table Support** — Reference any vanilla loot table by its namespaced key (e.g., `minecraft:chests/simple_dungeon`) alongside custom tables.
- **Merged Tables** — Combine multiple loot tables into a single population pass, with items drawn randomly from the merged pool.
- **Silent Mode** — Toggle progress notifications on or off for large populate operations.
- **WorldEdit Integration** — Use your WorldEdit selection to define the populate region instead of specifying coordinates and radius manually.
## Installation
1. Purchase and download Chest from [lode.gg](https://lode.gg/plugin/chest).
2. Place the `Chest.jar` file into your server's `plugins/` directory.
3. Start the server once to generate the default configuration files.
4. Configure your license key at [lode.gg/plugin/chest/configure](https://lode.gg/plugin/chest/configure) using your server's IP and port.
5. Restart the server. Chest will validate the license on startup and enable itself.
## Quick Start
1. Run `/chest` to open the loot table management GUI.
2. Create a new loot table and add items with weights.
3. Use `/populate nearby <radius> <loot_table_name>` to fill containers around you.
---
## Related Pages
- [[Chest/Server Owners/Configuration]] — Config file reference
- [[Chest/Server Owners/Commands]] — Full command and permission listing
- [[Lead/Developers/Overview]] — Developer integration guide
- [[Lead/Developers/API Reference]] — Chest-API class reference