> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticcrates.md).

# ManticCrates

Configurable physical and virtual crates, reward pools, pouches, and cinematic openings.

ManticCrates adds configurable reward crates to a Minecraft server. Build weighted reward pools, require keys or permissions, set limits and cooldowns, and present wins through inventory spins or seasonal cinematic packs.

## See an opening

![A monthly crate reveals its collection of prizes](https://2746822811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCVqlaAAAoPORtPYtxCWn%2Fuploads%2F5qGUxd9hm5LdVK9PjYIu%2Fmanticcrates-monthly3.webp?alt=media)

*A monthly crate reveals its collection of prizes.*

## What you can do

* Create linked physical crates, command-accessible virtual crates, keys, portable multi-prize crate items, and pouches.
* Configure item, command, economy, key, and reroll-credit rewards.
* Use rarity weights, player and server limits, distinct-winner limits, pity rewards, and milestones.
* Customize crate previews, selector positions, menus, holograms, particles, sounds, roll animations, and cinematic reveals.
* Keep rewards safe with queued claims for offline or full-inventory physical-key grants and configurable full-inventory policies.

ManticLib is required. Vault is optional and enables economy costs and rewards. PlaceholderAPI is optional and supplies placeholders to other plugins.

## Documentation

* Getting Started
* Monthly crates and pouches
* Commands and Usage
* Permissions
* Placeholders
* Configuration and in-game editor
* Developer API
* Configuration Files

The live plugin folder is `plugins/ManticCrates/`. Edit common settings and messages in `config.yml` and `messages.yml`; each crate and pouch has its own file.

## Crate selector

Open `/crates` to browse visible crates. Left-click an ordinary crate to open it or right-click to preview it.

![The player crate selector](https://2746822811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCVqlaAAAoPORtPYtxCWn%2Fuploads%2Fs06Mh5WADPYyeaPZe6hG%2Fmanticcrates-crates.png?alt=media)

*The player crate selector.*