By continuing to use this site, you agree to the Terms of Service of this website, including usage of cookies.

OK, Don't show this again

Add crates to your server
version 2.2.0
Direct Download How to install?
Switch version
167 Downloads / 4177 Total
4 Reviews
Plugin Description §


Add customizable crates to your server.

  • Add as many crate types as you want
  • Item and command rewards
  • Open crates with a nice animation
  • In-game preview menu with the crate contents including the rarity of each item
  • Customies support


How to use


Command aliases: /magiccrates, /mc

Command Description Permission-
/magiccrates create Create a crate magiccrates.cmd.create
/magiccrates remove Remove a crate magiccrates.cmd.remove
/magiccrates makekey <crate_type> [amount] [player] Make a crate key magiccrates.cmd.makekey


Permission Description Default
magiccrates.cmd Access to the /magiccrates command OP
magiccrates.cmd.create Access to the /magiccrates create command OP
magiccrates.cmd.remove Access to the /magiccrates remove command OP
magiccrates.cmd.key Access to the /magiccrates key command OP
magiccrates.break.remove Permission to remove a crate by breaking it OP

Create a new crate

  1. Use the command /mc create
  2. Click on the chest where you want your crate. (double chests do not work)
  3. Select the crate type in the dropdown menu and click Submit.
  4. Click save crate

Remove an existing crate

You can remove crates with a command:

  1. Use the command /mc remove
  2. Click on the crate you want to delete
  3. Click Delete crate

You can also remove crates by breaking the crate:

  1. Destroy a crate
  2. Click Delete crate

Create a crate key

You can only open crates by using a crate key. Each crate type has its own key.
You can create keys using the command /mc key <crate_type> [amount] [player]
When you have a crate key, you can open the matching crate by clicking on the crate.


Here you can see all options inside the config.yml

  • delay: int Amount of ticks it will take until the opening animation starts after a player opens a crate.
  • prefix: string Prefix used for messages send by the plugin
  • key-name: string name of the crate keys (The available options are crate and crate_type)
  • types: type[] A list of all available crate types in your server. You can add as many types as you want.

Adding crate types

Each crate type you want to add has its own unique identifier. You can choose this identifier yourself, but make sure that it is a valid array key.

  name: string
  rewards: reward[]
  commands: string[] # Optional
  • name: string The name shown above a crate
  • rewards: reward[] A list of all rewards inside the crate
  • commands: string[] A list of commands that will always be executed when opening this type of crate

Adding rewards

A crate type can have many rewards, and you can set the rarity of each reward individually.

 - name: string
     id: item_id
     name: string          # Optional
     amount: int           # Optional
     lore: string|string[] # Optional
     enchantments: # Optional
       - name: string
         level: int
   commands: string[]
   amount: int
   icon: string           # Optional
  • name: string The name of the reward.
  • item: The item that will be given to the player as reward.
    • id: string The minecraft ID of the item (e.g. "diamond" or "ender_pearl")
    • name: string The custom name of the item.
    • amount: int The amount of the item.
    • lore: string|string[] The item lore.
      • You can add a single line by providing a string e.g. "My lore" or multiple lines by providing an array e.g. ["First", "Second"].
    • enchantments: A list of all enchantments on the item.
      • name: string The name of the enchantment.
      • level: int The level of the enchantment
  • commands: string[] A list of commands when the player gets this reward.
  • amount: int How many times this reward is inside the crate. This makes you able to set rarities to rewards.
    • e.g. if you have a reward with amount 1 and a reward with amount 2, there are a total of 3 items in the crate. The probability that you win the first item is 1/3 and for the second item it is 2/3.
  • icon: string The path/url to a texture or image. The texture/image will be displayed on the preview menu.
    • For minecraft textures you can use textures/items/<name> for items or textures/blocks/<name> for blocks.
    • It is also possible to use other images instead of the minecraft textures. This have to be urls that start withhttp:// or https:// to work.
    • When no icon is provided, the icon of the item will be used. When there are only commands in the reward, a command block icon is shown.
    • Notice that for some blocks, e.g. logs, concrete and wool (Most of the blocks added to later versions of mc don't have this problem), there will no icon be found, if you want red wool for example, you have to use textures/blocks/wool_colored_red.
    • You can find all vanilla resource pack textures under the textures/ path. You can see all the textures in the bedrock-samples resource pack.

Command options

The commands that you can place in the command lists in the type or reward are the same commands as you can execute in the console.
It is also possible to add some parameters to the commands to make them more usable. The options are:

  • {player} The name of the player
  • {crate_type} The id of the crate type
  • {crate} The name of the crate type
  • {reward} The name of the reward

Example Config

delay: 1

    name: "┬žeCommon ┬ž6Crate"
      - name: "Diamond"
          id: "minecraft:diamond"
          name: "Diamond"
          amount: 1
          lore: "Diamond from a crate"
            - name: "efficiency"
              level: 1
          - "msg {player} be carefull with this diamond!"

        amount: 1
      - name: "Dirt"
          id: "dirt"
          amount: 2
        commands: [ ]
        amount: 2
      - "say {player} won {reward} from a {crate_type} crate"


What's new §
  • Fix key duplication bug
  • Add configurable prefix and key name in the config
  • Fix crash when player is offline during crate opening
  • Replace Paroxity/Commando with ACM-PocketMine-MP/Commando to fix a bug that crashes the server on startup
  • Add Customies support
  • Add crate reward preview
  • Rewrite most of the code
  • Update to pmmp 5.0.0
  • Added PiggyCustomEnchants support
  • removed support for versions before 1.16.x
  • Added v1.16.200 support

using v2.1.1
24 Aug 23
Nice plugin!
using v1.1.0
23 Mar 21
It would be great if the console can use the key command :)
using v1.0.8
17 Dec 20
Best plugin ever #bestdev
using v1.0.8
13 Dec 20
Great! Love the difference from this plugin. Like the different crate opening!

Reply to review by :

/ 5
Supported API versions
Customies 1.3.2
View Plugin
Producers §
  • Collaborators:
    • @Hebbinkpro
License §
Manage entities
Other files

You can leave one review per plugin release, and delete or update your review at any time

/ 5