MineCrates – Advanced Crate & Key System
Modern, powerful, and player-friendly crates plugin for PaperMC 1.20.x – 1.21.x

✨ Key Features

• Crate Types
  • Block-bound crates (physical chests) with protection and cooldowns.
  • Virtual crates (openable via commands).
• Keys System
  • Physical keys with customizable items, names, and lore.
  • Virtual keys stored per-player with full PlaceholderAPI support.
  • Key crafting and recipe registration options.
• Reward System
  • Weighted reward pools with rarity tiers.
  • Item rewards (full NBT supported).
  • Command rewards for ultimate flexibility.
  • Configurable broadcasts, messages, and sounds.
• Animations & GUIs
  • Preview GUI: Paginated, filterable reward preview menus.
  • Opening GUI: Two animations – Roulette (strip spin) and Reveal (dramatic reveal).
  • Fully customizable sounds, particles, and MiniMessage text.
• Hooks & Integrations
  • Vault: Charge currency/EXP for opening crates.
  • PlaceholderAPI: Built-in placeholders for keys, cooldowns, last rewards, and more.
  • DecentHolograms: Automatic holograms above crates with live updates.
• Particles & Visuals
  • Idle particle effects around block-bound crates.
  • Particle type, radius, and timing fully configurable.
• Admin Tools
  • /crates command with subcommands: list, preview, open, givekey, giveall, set, reload, testroll.
  • Block protection with bypass permissions.
  • /crates reload hot-reload configs without crashes.

⚡ Compatibility

• Minecraft Versions: Paper 1.20.6 – 1.21.x
• Java: 17+
• Soft Dependencies: Vault, PlaceholderAPI, DecentHolograms (optional, MineCrates runs fine without them).

Installation & Setup
1. Drop the plugin JAR into your /plugins folder.
2. Start the server to generate default config files.
3. Edit crates.yml, rewards.yml, and keys.yml to define crates, keys, and rewards.
4. Bind crates with /crates set <crate> while looking at a block.

Use Cases

• SMP & Survival Servers – Add crates for daily rewards, events, or voting.
• Factions & PvP – Offer loot crates with powerful items or seasonal rewards.
• Mini-Game Networks – Engage players with flashy crate animations and rare prizes.

Support & Updates

• Actively maintained and tested on latest Paper builds.
• Frequent updates for new Minecraft versions.
• Built-in error logging and debug mode.
• Support available via Discord.

✅ Why Choose MineCrates?
Unlike outdated crate plugins, MineCrates is:

• Built exclusively for Paper (no legacy/NMS hacks).
• Lightweight but feature-rich.
• Async data handling = zero lag.
• Polished GUIs, animations, and hologram support.