# VaultCrates<\/p>\n
**A feature-rich, fully animated crate plugin for Paper 1.21.x**<\/p>\n
No NMS \u00b7 No legacy libraries \u00b7 No external hologram plugin required<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **12 unique animations** \u2014 particles, sounds and visual effects for every style —<\/p>\n ## \ud83d\udccb Requirements<\/p>\n – **Paper** (or forks) 1.21 \u2013 1.21.4+ ### Optional soft-dependencies – **Vault** + economy plugin \u2014 key shop & economy commands —<\/p>\n ## \ud83d\ude80 Quick Start<\/p>\n 1. Drop the JAR into `plugins\/` —<\/p>\n ## \ud83c\udfac Animations<\/p>\n | Name | Style | —<\/p>\n ## \ud83c\udf10 Languages<\/p>\n | Code | Language | Drop a `messages_ ---<\/p>\n ## \ud83d\uddc4\ufe0f Storage<\/p>\n | Type | Notes | ---<\/p>\n ## \u2699\ufe0f Crate config example<\/p>\n ```yaml HologramLines: KeyCrate: Prizes: ---<\/p>\n ## \ud83d\udcca PlaceholderAPI<\/p>\n | Placeholder | Returns | Custom events: `CrateOpenEvent` (cancellable), `CrateOpenedEvent`, `CrateKeyUseEvent`<\/p>\n","protected":false},"excerpt":{"rendered":" A feature-rich, fully animated crate plugin for Paper 1.21.x with IA, Vault, PlaceholderAPI and Citizens support<\/p>\n","protected":false},"featured_media":165304,"template":"","meta":{"_minecraft_slug":"vaultcrates","_minecraft_project_id":"yjvMVJWc","_minecraft_author":"itsLarss_","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vaultcrates.zip","_minecraft_size_bytes":4474571,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:16:42.166067Z","_minecraft_date_created":"2026-05-05T23:56:32.764217Z","_minecraft_date_modified":"2026-04-27T21:35:32.864112Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vaultcrates","_minecraft_icon_attachment_id":165304,"_minecraft_imported_at":"2026-06-09T17:39:00+00:00","_minecraft_import_hash":"3452b640d06400a08c6bd83287715f33","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,844,88,89,866,127,128,867,129,91],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165303","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Physical & Virtual Keys** \u2014 NBT-tagged items with anti-dupe UUID tracking
\n– **Pity system** \u2014 guaranteed drop after N opens per rarity
\n– **Reward limits** \u2014 global and per-player caps per reward
\n– **Key shop** \u2014 players buy keys with in-game money via `\/vc shop`
\n– **Pouches** \u2014 right-clickable reward bags with random number ranges
\n– **Holograms** \u2014 floating Text Display entities, no external plugin needed
\n– **Placement ID system** \u2014 each placed crate gets a unique ID (`\/vc remove
\n– **In-game GUI editor** \u2014 edit crates without touching YAML files
\n– **Reward preview** \u2014 paginated GUI with normalised drop percentages
\n– **Best Prizes** \u2014 guaranteed bonus reward from a separate pool
\n– **Bundled items** \u2014 give multiple items alongside the main reward
\n– **Selectable rewards** \u2014 players pick their prize from N options
\n– **Milestones** \u2014 bonus rewards after X total crate opens
\n– **Reward footer** \u2014 auto-appended lore showing reward type and rarity
\n– **NPC support** \u2014 Citizens, ZNPCs, ZNPCsPlus, FancyNpcs, or any entity
\n– **Multi-language** \u2014 English, German, French, Spanish built-in + custom locale support
\n– **Multi-database** \u2014 JSON (default), SQLite or MySQL
\n– **Developer API** \u2014 events, programmatic crate opening, key management<\/p>\n
\n– **Java 21+**<\/p>\n
\nAll are fully optional and loaded via reflection:<\/p>\n
\n– **PlaceholderAPI** \u2014 placeholders in messages & holograms
\n– **ItemsAdder \/ Oraxen \/ Nexo** \u2014 custom block & item models
\n– **ExecutableItems \/ MMOItems** \u2014 custom items as rewards
\n– **Citizens \/ ZNPCs \/ ZNPCsPlus \/ FancyNpcs** \u2014 NPC-to-crate linking<\/p>\n
\n2. Restart the server
\n3. `\/vc getcrate ExampleRound` \u2014 get a crate block
\n4. Place it in the world
\n5. `\/vc key give
\n6. Right-click the crate!<\/p>\n
\n|—|—|
\n| `ROUND` | Slot machine \u2014 cycles and locks on the winner |
\n| `ROUND2` | Mystery boxes \u2014 BARRIER boxes orbit with lightning reveal |
\n| `QUICK` | Slot machine \u2014 fast version (~3 s) |
\n| `COSMIC` | Double counter-rotating orbital rings |
\n| `DISPLAY` | Single item cycles and lands on the winner |
\n| `PYRAMID` | Three-tiered rotating pyramid |
\n| `CONTRABAND` | Items float up and vanish one-by-one |
\n| `INSTANT` | Particle burst, reward given instantly |
\n| `AIR_STRIKE` | Items fall from height with lightning |
\n| `BREAKOUT` | Items burst outward and arc back |
\n| `METEOR_SHOWER` | Items rain down with flame trails |
\n| `YIN_YANG` | Two rings converge in a yin-yang pattern |<\/p>\n
\n|—|—|
\n| `en` | English (default) |
\n| `de` | German \/ Deutsch |
\n| `fr` | French \/ Fran\u00e7ais |
\n| `es` | Spanish \/ Espa\u00f1ol |<\/p>\n.yml` in the plugin folder and set `Language: ` to add any language. Regional locale codes (`en_us`, `pt_br`, etc.) are supported with automatic fallback.<\/p>\n
\n|---|---|
\n| `JSON` | Default, zero setup |
\n| `SQLITE` | File-based SQL, bundled driver |
\n| `MYSQL` | Full MySQL\/MariaDB, auto table creation |<\/p>\n
\nAnimation: ROUND
\nBlock: ENDER_CHEST
\nSize: 1<\/p>\n
\n - \"&6&lMy Crate\"
\n - \"&7Right-click to open\"<\/p>\n
\n Require: true
\n Material: TRIPWIRE_HOOK
\n Name: \"&6&lMy Key\"
\n MatchNBT: true<\/p>\n
\n diamond:
\n Name: \"&b&lDiamond\"
\n Rarity: epic # common | rare | epic | legendary | jackpot | mega_jackpot
\n Chance: 10.0
\n Material: DIAMOND
\n GiveItem: true
\n```<\/p>\n
\n|---|---|
\n| `%vaultcrates_keys_
\n| `%vaultcrates_opens_
\n| `%vaultcrates_pity_
\n| `%vaultcrates_is_animating%` | `true` \/ `false` |<\/p>\n