MekaCrates – Official Documentation
Introduction
MekaCrates is a powerful and fully customizable reward crate plugin for Minecraft servers running Spigot or Paper 1.20.1+. Designed with performance and simplicity in mind, it offers a rich player experience with advanced animations, visual and sound effects, potion rewards, preview systems, and intuitive crate management via GUI or YAML.

Installation

1. Download the MekaCrates .jar file.
   
   
2. Place it into the plugins/ directory of your server.
   
   
3. Start or reload your server.
   
   
4. (Optional but recommended) Install PlaceholderAPI to enable placeholder integration.

Basic Commands
Command Description Permission
/mc help Shows the help menu. mekacrates.help
/mc open <crate> Opens a crate directly. mekacrates.open
/mc preview <crate> Shows the crate preview. mekacrates.preview
/mc give <player> <crate> <amount> Gives virtual keys. mekacrates.give
/mc virtual give <player> <crate> <amount> Adds virtual keys to a player. mekacrates.virtual.give
/mc edit <crate> Opens the crate editing GUI. mekacrates.edit
/mekacrates rewardcommand [crate] [command] will make the item you are holding to be added to the crate as a command reward instead of the item as a reward.
Creating and Managing Crates

1. Use /mc edit <crate> to create or modify crates via the interactive GUI.
   
   
2. You can configure:
   • Rewards and drop chances
     
     
   • Opening, block, particle, and idle animations
     
     
   • Sound effects and potion effects
     
     
   • Hologram text, height, and visibility
     
     
   • Virtual or physical key types

All changes are saved automatically.

Configuration Files

• crates/: contains one .yml file per crate with all settings
  
  
• config.yml: handles global behavior, default effects, cooldowns, and performance
  
  
• lang/: folder with multilingual message files (EN, PT-BR, etc.)

PlaceholderAPI Support
Use the following placeholders (requires PlaceholderAPI):

Placeholder Description
%mekacrates_total_keys% Total virtual keys the player owns
%mekacrates_<crate>_keys_amount% Number of virtual keys for a specific crate
Integrations & Conversion

• PlaceholderAPI: Use placeholders in menus, chat, or scoreboards.
  
  
• Crate Converter: Easily import crates from other plugins (e.g., AdvancedCrates) without losing item data or drop chances.

Requirements

• Spigot or Paper 1.20.1+
  
  
• Java 17+
  
  
• PlaceholderAPI (optional)