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

A crate plugin for PocketMine-MP supporting unlimited crate types
version 2.1.0
Direct Download How to install?
Switch version
574 Downloads / 11561 Total
36 Reviews
Plugin Description §

PiggyCrates Poggit-CI Discord

PiggyCrates is a simple and customizable crates plugin, supporting an unlimited amount of crate types. It also supports vanilla and custom enchants, such as PiggyCustomEnchants.


  • Basic knowledge on how to install plugins from Poggit Releases and/or Poggit CI
  • PMMP 3.22.1+


You will need to download the InvCrashFix plugin and update your PiggyCrates version to 2.1.0 for menus to function properly.

Installation & Setup

  1. Install the plugin from Poggit.

  2. Start your server.

  3. (Optional) The config.yml file has a few options that allow you to customize your key items & crate modes (default is roulette).

  4. Open the crates.yml.

  5. PiggyCrates supports an unlimited number of crates. To define a crate, add a key crates.yourcratename.

  6. Configure your crate types. Crate types have several different properties:

    • (Optional) floating-text: Floating text that will appear above the crate type. Leave empty for no floating text.
    • (Optional) commands: Commands to be run by CONSOLE when crate type is opened. Use {PLAYER} as a placeholder for player name.
    • drops: Possible drops of a crate type. Items are defined with the properties:
      • id: Item ID
      • meta: Item Meta
      • amount: Item Amount
      • (Optional) type: Item Type
        • (Default) item: Runs all crate item commands & gives the item
        • command: Runs all crate item commands
      • (Optional) chance: Item Weight
      • (Optional) nbt: Item NBT as stringified JSON
      • (Optional) name: Item Name
      • (Optional) lore: Item Lore as string with line breaks represented as \n
      • (Optional) enchantments: Item enchantments defined like so:
         - name: "Protection"
           level: 1
         - name: "Thorns"
           level: 1
      • (Optional) commands: Commands to be run by CONSOLE if item is dropped by crate.
    • amount: Amount of drops a single crate type will give.


      # Crate type named "Example"
        floating-text: "Example Crate"
        amount: 1
        # Will run the command "/say" when opened
          - "say {PLAYER} has opened the example crate!"
          # 50% chance for 1x Diamond Sword named Sharpened Diamond Sword w/ Sharpness 5 enchantment
          # Will run the command "/tell" on drop
          - id: 276
            meta: 0
            amount: 1
            chance: 50
            name: "Sharpened Diamond Sword"
              - name: "Sharpness"
                level: 5
              - "tell {PLAYER} You got a Sharpened Diamond Sword! ;o"
          # Identical to the above drop but with a 25% chance and an Iron Sword
          - id: 267
            meta: 0
            amount: 1
            chance: 25
            name: "Sharpened Iron Sword"
              - name: "Sharpness"
                level: 5
              - "tell {PLAYER} You got a Sharpened Iron Sword! ;o"
          # 25% chance for player to get money
          - id: 266
            meta: 0
            amount: 1
            chance: 25
            name: "$2500"
            type: command
              - "givemoney {PLAYER} 2500"
  7. Restart your server.

  8. Connect to your server.

  9. Place a chest block where you intend on having a crate.

  10. Run the command /crate <crate name>

  11. Tap the target chest.

  12. Repeat with other crate types.

  13. You're done!


Command Description Permissions Aliases
/crate <crate> Changes a chest to a crate by tapping piggycrates.command.crate N/A
/key Gives a player a specific crate key piggycrates.command.key N/A
/keyall Gives all online players a specific crate key piggycrates.command.keyall N/A


Permissions Description Default
piggycrates Allows usage of all PiggyCrates features false
piggycrates.command Allow usage of all PiggyCrates commands op
piggycrates.command.crate Allow usage of all /crate commands op
piggycrates.command.key Allow usage of the /key command op
piggycrates.command.keyall Allow usage of the /keyall command op

Issue Reporting

  • If you experience an unexpected non-crash behavior with PiggyCrates, click here.
  • If you experience a crash in PiggyCrates, click here.
  • If you would like to suggest a feature to be added to PiggyCrates, click here.
  • If you require support, please join our discord server here.
  • Do not file any issues related to outdated API version; we will resolve such issues as soon as possible.
  • We do not support any spoons of PocketMine-MP. Anything to do with spoons (Issues or PRs) will be ignored.
    • This includes plugins that modify PocketMine-MP's behavior directly, such as TeaSpoon.

Additional Information

  • We do not support any spoons. Anything to do with spoons (Issues or PRs) will be ignored.
  • We are using the following virions: Commando and InvMenu.
    • Unless you know what you are doing, use the pre-compiled phar from Poggit-CI and not GitHub.
    • If you wish to run it via source, check out DEVirion.
  • Any custom enchantment plugin can be used, as long as the custom enchant has been registered to the server.
  • Detailed Installation Guide available at PiggyDocs.
  • Check out our Discord Server for additional plugin support.


   Copyright 2018-2020 DaPigGuy

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   See the License for the specific language governing permissions and
   limitations under the License.

What's new §
  • Update to InvMenu v4.1.1 (#95)
    • Resolves Ds\Queue not found error.
  • Add check on startup for InvCrashFix plugin.
  • Bump API version to 3.22.1
  • Bump version to 2.1.0
  • Improved Poggit update notifier
  • Added ability to configure messages
  • Commands now implement PluginIdentifiableCommand
  • Switched to ParoxityTeam/Commando
  • Bumped version to 2.0.8
  • Add InvMenu to virion check
  • Fixed previews for crates with over 27 items
  • Bump version to v2.0.7
  • Fixed NBT parsing
  • Added plugin icon
  • Bump version to v2.0.6
  • Implemented crate item types (#59)
  • Fixed Commando packet hooker not being registered
  • Update Commando to 0.6
  • Bump version to 2.0.5
  • Ability to Preview Crates
    • Ordered by percentage, maximum of 54 items can be shown in preview.
  • PHPDoc Nuke
  • Update LICENSE year
  • Version Bump v2.0.4
  • Added virion checks
  • Added message on invalid enchant config (#53)
  • Added name/lore/enchant examples (#52)
  • Fix potential crashes from missing crate types
  • PHPStan Level 8
  • Bump to v2.0.2
  • Added Poggit update checks
  • poggit: incorrect syntax, builds commando virion now.
  • Crate items now have a lore option
  • Crates & crate items now have a command option
  • Fixed an extreme permission issue
  • Now using Commando virion for command handling.
  • Crates are now saved as tiles.
  • Floating text particles have been added.
  • Crate roulettes have been added.
  • Crate items now support NBT
  • Crate item names are now optional
  • PiggyCustomEnchants 2.0.0 support
  • Bump to v1.5.0
  • Add /keyall command
  • Correct /key usage
  • Change messages for giving and added a receiving message.
  • Poggit: Comply with C1a, C2b, B3
  • Version: bumped to v1.4.0
  • Config: Delete obnoxious ASCII to reduce file size.
  • API: bumped to v3.2.0
  • Bump minor version, renamed config property
      • changed command to commands because it is more logical. please update crates.yml accordingly.
      • bump minor version.
  • Cleanup
  • Close #42, added support for multiple commands
    • Tested.
  • Fix #37
  • Fixed #38
  • Fixed permission problem with /key
  • Updated PHPDocs + Added PHPDocs for fields

using v2.1.0
20 Sep 21
using v2.1.0
17 Sep 21
Nbt reader
using v2.1.0
12 Aug 21
Make it where I can put items in the crates without ids so I can put some piggy ce books
using v2.1.0
11 Aug 21
Add nbt reader for custom items, a crates plugin its almost useless without it
using v2.0.9
03 May 21
using v2.0.9
25 Apr 21
On-crate effects, like fireworks, particles, and sounds. Freaking great plugin btw 💕👌
using v2.0.9
19 Feb 21
Add visual key pls
using v2.0.9
05 Feb 21
using v2.0.9
24 Jan 21
DaPigGuy please add particle for the crate please
using v2.0.9
09 Dec 20
update pls:/
using v2.0.9
13 Sep 20
For some reason piggycrates at line 106 $datacrate["amount"] is error lmao
using v2.0.9
02 Sep 20
add maxenchants possibility more enchants and i give 5 stars
using v2.0.9
31 Aug 20
Gives a internal error when key is used I might be doing something wrong.
using v2.0.9
20 Aug 20
Is it possible that you can make it so were you can add items in game not through config it would be so much easier!
using v2.0.9
26 Jul 20
using v2.0.9
13 Jul 20
using v2.0.7
13 Jun 20
help i get error when i make chance 0.001
using v2.0.7
17 May 20
reply me i'll give it 5*
using v2.0.6
08 May 20
love the plugin alot BUT can you please make it so that we can set the item amount value to 0, so the player doesnt get the item only runs the command for the player.. (money for example) fix = 5 stars
08 May 20
This already exists. You can set type to command for no items to be given.
using v2.0.6
03 May 20
Nice plugin though please add a way to just execute a command without giving the object
08 May 20
This already exists. You can set type to command for no items to be given.
using v2.0.6
02 May 20
Best crates plugin out there, very easy to setup. Would recommend
using v2.0.6
28 Apr 20
wow love the chance and floating name feature
using v2.0.6
25 Apr 20
I like the plugin but could be better if you added an option in config to edit names and lores
28 Apr 20
Already exists. Please read Installation & Setup in the README or on Poggit
using v2.0.6
24 Apr 20
can I make it so that I don't need hooks, but just virtually and can I make a case with a privilege
using v2.0.6
24 Apr 20
The plugin is good but is there a way to automatically give keys to players like mining or killing someone?
using v2.0.5
20 Apr 20
How do i add per item commands, when the item is won how do i add a command(s) tha execute
21 Apr 20
Read Installation & Setup in the README or on Poggit
using v2.0.4
19 Dec 20
Amazing, Easy setup, Open crates with keys has crashed since 1.16.100, Needs an Update for 1.16.200 Please!! (will change review once working correctly again)
using v2.0.4
30 Mar 20
Again, thanks for the preview. :D
using v2.0.3
24 Mar 20
Asynchronous Worker #2 thread/CRITICAL]: TypeError: "json_decode() expects parameter 1 to be string, bool given" (EXCEPTION) in "plugins/PiggyCrates.phar/src/DaPigGuy/PiggyCrates/tasks/CheckUpdatesTask" at line 38 [07:28:32] [Asynchronous Worker #2 thread/
13 Apr 20
This issue has been fixed.
using v2.0.2
05 Dec 19
using v1.5.0
12 May 19
Permissions? Also can someone tell me how to get permissions of other plugins?
using v1.4.0
17 Jan 19
Nice! Thank you :)
using v1.4.0
25 Nov 18
Simple and easy setup. Nice
using v1.2.0
01 Feb 21
Is it possible to enchant item with random level?
using v1.2.0
16 May 20
Do you assign block that you put under a chest to open crates?
17 May 20
Assuming you're actually using 1.2.0, then yes. In 2.0.0, you just do "/crate (name)" and tap the crate to make the crate.
using v1.2.0
02 Jul 18
Great Plugin!

Reply to review by :

Supported API versions
PiggyCustomEnchants 2.0.1
View Plugin
Producers §
  • Collaborators:
    • @Aericio
  • Contributors:
    • @Heisenburger69
    • @Ifera
    • @SalmonDE
License §
Manage tiles

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