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

# Welcome to KeyCrates

Welcome to the official documentation for KeyCrates.

***

KeyCrates is a highly visual, RNG-based reward system designed to give your players a thrilling way to spend their hard-earned loot. By combining physical map placements with a dynamic spinning UI, this mod brings a premium "mystery box" experience directly to your DayZ server.

Whether you want to set up a Black Market gambling den or reward players for completing high-tier server events, KeyCrates gives you total control over the economy and the dopamine.

***

### ✨ Core Features

* 📊 5-Tier Ecosystem: Fully structured progression spanning from Common to Legendary. Each tier requires its own specific key classname to unlock.
* 🎨 Visual Indicators: Custom 3D floating text and hex-color tags hover above the crates, letting players instantly recognize the tier of the vault they are approaching.
* 🎰 Dynamic Spinning UI: When a key is inserted, the player is locked into a slick, customizable spinning UI that cycles through the potential rewards before landing on their prize.
* 🎲 Weighted RNG Pools: You dictate exactly what drops and how often. Set specific probability weights for every single item to protect your server's high-tier economy.
* 🎒 Kit Support: Don't just drop a single gun. KeyCrates allows you to bundle items into "Kits" (e.g., a "Sniper Set" containing a Ghillie Suit, Rifle, and Ammo) that drop all at once upon a successful roll.
* 🗺️ Static Map Placements: Place the physical crates permanently anywhere on your map using exact XYZ coordinates and orientations.

***

### 📖 Documentation Navigation

Select a section below to start configuring your crates:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td></td><td><strong>Config.json</strong></td><td>Commented config</td><td></td><td></td><td><a href="/lng-docs/keycrates/getting-started/profiles-lng_crates-rewardconfig-json.md">profiles\LNG_Crates\RewardConfig.json</a></td></tr></tbody></table>