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 unlimited number of MysteryCrates with full customization.
version 9.2.0
Direct Download How to install?
Switch version
9263 Downloads / 23399 Total
39 Reviews
Plugin Description §


MysteryCrate Banner

A MysteryCrate plugin for PocketMine-MP


  • This plugin adds custom crates to your server.
  • Crates can be opened with a custom key.
  • Easy to use crates.yml for adding custom items to the crate.
  • Upon opening the crate particles are generated telling player someone opened the crate.
  • Ability to give enchanted item to players.
  • Ability to give custom enchanted items to players. Requires PiggyCustomEnchants by @DaPigGuy
  • Fool proof. Players cannot grief it.
  • You can set multiple crates using the pattern set in crates.yml.
  • The entire plugin is suited for PocketMine-MP latest API.

How to setup?

  • For adding enchants that are not registered by PocketMine-MP you may use VanillaEnchantments by @TheAz928 or TeaSpoon by @CortexPE for adding enchants on the items.
  • Additionally you can also add CustomEnchants to the items. For this you require PiggyCustomEnchants by @DaPigGuy.
  • Get the .phar and drop the into your plugins folder.
  • Next navigate to the crates.yml file and edit/set the block you want the crate to be recognized with under block: "ID:META" key.
  • Make sure that name of the world where crate is located is same as the world folder name.
  • Now mention the name of theworld where the crate is located in crateWorld.
  • Reload the server.
  • Place the block down you initially set in crates.yml under block: "ID:META" key.
  • Place either a chest, ender chest or trapped chest on top of that block.
  • To open the crate you require a crateKey.
  • To get the key use /key [type] [player] [amount] in-game and then tap the crate with it. You can set/see the crate type in crates.yml file.


Q: How to setup the crates?
A: Please read this.

Q: How to add particles?
A: Its very simple. When you place a chest on top of the block you set in crates.yml the plugin will automatically add its coordinates to the blocks.yml file. You will just need to restart the server for the particles to show.

Q: How to remove the particles?
A: Just destroy the chest whose particles you want to remove. Restart the server and the particles will be removed.

Q: Will the crates have floating text above them?
A: Yes, they will have Floating Text.

Q: Can I edit the floating text that appears above the crate?
A: Yes you can. Navigate to blocks.yml and edit the crate text you see. For example, you want to edit the floating text of legendary crate then there would be a key\heading of legendary: in the blocks.yml file. Edit the text after the : to edit\change the floating text.

Q: I found a issue in the plugin what do I do?
A: Please open an issue here and give as much detail as possible.

Q: I would like a new feature to be added. How do I report?
A: Please open an issue here and give as much detail as possible.

Q: What to do with the blocks.yml file?
A: You need not to do anything with it unless you want to edit the floatiing text. The plugin automatically generates stuff within the file to make the setup for the user easier.

Commands and Permissions

Description Command Permission Default
Crate Key /key [type] [player] [amount] mc.command.key op
Crate Key All /keyall [type] [amount] mc.command.keyall op
Use a crate ~ mc.crates.use true
Destroy a crate ~ mc.crates.destroy op
Create a crate ~ mc.crates.create op


  • Make sure to subscribe to be updated for when i release more stuff on my YT channel.
  • Support is appreciated.
  • Please don't hesitate to ask questions or report bug report in issues section.



YouTube YouTube

What's new §
  • Merge pull request #141 from DaPigGuy/master
    • PiggyCE V2.0.0 Support
  • PiggyCE V2.0.0 Support
  • Update plugin.yml
  • shut up phpstan
  • version bump to support latest changes made to InvMenu
  • we only can support 3.9.0 now since protocol updates
  • Add info regarding key all command in readme
  • Added KeyAll Command.
    • (need to test)
  • Added support for ConfigUpdater
  • Forgot to remove this bit in previos update
  • Improve message and everything seems to be working 😎
  • Merge pull request #115 from GiantQuartz/patch
    • Simplify KeyCommand
  • Registered KeyAll command
  • Simplify KeyCommand
  • Update else structure formatting
  • update to support ConfigUpdater
  • The BIGGEST and FATTEST update of all time. Now you can use multiple crates!!
  • Added InvMenuHandler and update file paths
  • Added scrollSpeed and config version is now 2
  • Added support for InvMenu
  • Added support for any chest type, some functions deleted and close #101
  • InvMenu support and now multiple players can open any crate at any time unlike before. Further close #83 and close #98
  • Version 9.0.0
  • Missed a colon
  • Version bump
  • Add support for broadcasts on opeing crate and close #92
  • Added config versions check
  • Checks to ensure user has entered valid data in crates.yml
  • Close #100
  • Crate world will now be loaded. Close #97
  • Fix and close #99
  • FloatingTexts will now not appear on other worlds. Close #94
  • Remove useless return statement
  • Version 8.0.0 and fix description
  • You can now disable custom name. Close #96
  • Added ParticleType.php
  • Added return types and fix formatting + phpdocs
  • Added support for update notifier
  • Alright so.. everything still works even after blasting apart everything
  • Declare some properties as private and fix #90,
  • Version bump
  • add support for UpdateNotifier virion
  • declare strict types on everything
  • declared strict types and made the properties private
  • fix typehints
  • lost count of what i am doing
  • phpdocs updates
    • its astonishing how many bugs im finding by declaring strict types
  • some reformatting of code
  • typehints/phpdocs
  • update readme
  • close #85
  • version bump
  • Update according to Poggit standards and version bump
  • Added Translations #84
  • Changes for translations
  • New Lang.php for handling translations etc
  • Upload lang.yml
  • initialized Lang.php
  • version bump
  • fix #80
  • added a check to stop plugin from crashing if blocks.yml is empty
  • version bump
  • Removed small portion of code that I added during debug
  • version bump
  • Fixed permissions not working properly
  • Fixed players being able to remove floating text,
  • Optimiztions for FloatingText
  • Version bump
  • Fixed a typo in command
  • fix #67 , #73 and #78
  • version bump
  • Multiple Particles
  • Support for multiple commands for reward
  • Floating Text is back
  • Typo in README fixed
  • v6.0.0
    • Changing key in config will work now.
    • Added particles above crates.
    • Added Floating Text above the crate.
    • Improved vanilla and custom enchants compatibility.
    • Add support for adding lores to reward.
    • Added support for executing commands as a reward.
    • Removbed useless conditions.
    • Added image.

using v9.2.0
28 Apr 21
using v9.2.0
19 Dec 20
It works but I tried to add a crate I place it down and stuff it works but I can't get a key for it idk how to /key {name} doesn't work for it
using v9.2.0
05 Sep 20
how to create one key and crate ?
using v9.2.0
04 Sep 20
its an amazing plugin but sadly you are not ablo to edit the chances becuse i dont want a beacon and a dirt block to have the same chance! i will give 5/5 when added
using v9.2.0
26 Jul 20
using v9.2.0
07 Jul 20
Amazing... You can't take items when spinning as long as u restart server after you make crate and place it in the world
using v9.2.0
19 May 20
Error!, when i use Sharpness Enchant.
using v9.2.0
08 May 20
I love the plugin unfortunately players are able to pull any item out of the crate while it is being opened i will update my review once this is fixed.
using v9.2.0
23 Apr 20
how to rename key?
using v9.1.1
03 Apr 21
using v9.1.1
17 Mar 20
Awesome build dud
using v9.1.1
02 Mar 20
Works well but slow the tick rate for (60 or more) the particles. The CloudRain works best! Make no more then 5 crates.
using v9.1.1
18 Dec 19
Hey Help me! This plug-in is really really good! I give it a 5 star but! Whenever you key someone the key stays in your inventory and when you try to use it doesn’t work. I try to throw out the key but it keeps coming back into my inventory. Pls fix
using v9.1.1
24 Sep 19
It's very good but the particles are only over 2 crates
using v9.1.1
13 Aug 19
i understand now it was simple move ty
using v9.1.1
10 Aug 19
How can I give a player one of the keys on vote?
using v9.1.1
05 Aug 19
Awesome plugin! Ignore the kids in the comments section who can't follow basic instructions...
using v9.1.0
04 Jul 19
Sir you plugin is a little bit broken because I can take items in the crate when its used it is not vanishing and I can use those items.
13 Jul 19
You need to mention the crateWorld in config.yml to stop that from happening.
using v9.1.0
20 Apr 19
21 Apr 19
Thanks 😀
using v9.1.0
26 Mar 19
You can take items from it even when it is not dont opening like the hole chest fix this fast Plzzzz
28 Mar 19
What are you talking about? Open issue on github don't give a bad rating here!
using v9.1.0
24 Mar 19
[21:21:39] [Server thread/CRITICAL]: ErrorException: "Array to string conversion" (EXCEPTION) in "plugins/MysteryCrate.phar/src/JackMD/MysteryCrate/EventListener" at line 167 Please help!
25 Mar 19
Uh pretty sure somethings wrong at your hand but either way open an issue on github
using v9.1.0
14 Mar 19
Have found new fault 😕 Even without autoinv one can exchange the items from the crate with items in the inventory. (also dirt) too dangerous for our server sorry 😔
14 Mar 19
Don't use it then. Simple. And I have mentioned it many times before. Its NOT MysterCrates fault. Blame Mojang or PocketMine for not handling the transactions.
using v9.0.0
16 Feb 19
Best crates plugin out there!
18 Feb 19
using v9.0.0
12 Feb 19
Speechless, this plugin easy to use and give a great job to my server
13 Feb 19
using v9.0.0
11 Feb 19
Love the plugin, because you can have custom crates, there are cool particels, and much more... But can you add a config to change the keys name, cause I woud do §r befor, so that is isn't italic!
13 Feb 19
using v8.0.0
31 Jan 19
The BEST of the BEST!:)
01 Feb 19
Thanks and thanks!! 😍
using v7.0.0
27 Jan 19
Does this plugin support PiggyCE ?
30 Jan 19
Yes it does!
using v7.0.0
13 Jan 19
It's not working. It always says "Please select the crate world" but i did.
30 Jan 19
Please use latest release i.e. 8.0.0. This issue is now fixed.
using v7.0.0
25 Dec 18
when i break the chest it kicks me off and gives a bunch of errors
27 Dec 18
This is not a place to report bugs/errors. Use github to report the bugs. And I cannot reproduce the error. So don't misguide others.
using v6.5.0
12 Dec 18
13 Dec 18
Thanks a ton for the review :heart:
using v6.5.0
08 Dec 18
10/10 but does supports Ender Chests?
09 Dec 18
It doesn't support that at the very moment but I have plans to redo parts the plugin. Will also add that into the todo list. Thanks for 5 stars!!
using v6.4.3
24 Nov 18
Super plugins, but I manage to put the chests (crates) and my friend managed to have
25 Nov 18
Sorry but I don't understand what you are trying to say. Anyway if you want a tutorial on how to setup MysteryCrate then my friends over at have done an in-depth tutorial on how to set it up. You should consider watching this
using v6.4.2
17 Aug 18
19 Aug 18
Thank you
using v6.4.1
08 Aug 18
Your plugin is wonderful. Congratulations!
09 Aug 18
Thank you
using v6.3.0
07 Aug 18
Best plugin i ever seen!
07 Aug 18
using v6.0.0
21 Jun 18
Works well. Easy to follow instructions and a very solid plugin.
22 Jun 18
Thanks a ton
using v6.0.0
08 Jun 18
Do I change the word "CrateWorld" ?
09 Jun 18
If your world is not the world set in crateWorld then yes you have to change it.
using v6.0.0
01 Jun 18
Very good Plugin! And it works :D
01 Jun 18
Thank you
using v6.0.0
28 May 18
29 May 18
Thanks !
using v5.1.0
29 May 18
30 May 18
Thanks alot!

Reply to review by :

Supported API versions
Producers §
  • Collaborators:
    • @DaPigGuy
License §
Manage tiles

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