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.0.7
Approved
Direct Download How to install?
Switch version
695 Downloads / 6194 Total
17 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.

Prerequisites

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

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:
        enchantments:
         - 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.

    Example:

    crates:
      # Crate type named "Example"
      Example:
        floating-text: "Example Crate"
        amount: 1
        # Will run the command "/say" when opened
        commands:
          - "say {PLAYER} has opened the example crate!"
        drops:
          # 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"
            enchantments:
              - name: "Sharpness"
                level: 5
            commands:
              - "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"
            enchantments:
              - name: "Sharpness"
                level: 5
            commands:
              - "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
            commands:
              - "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!

Commands

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

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.

License

   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

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

What's new §
  • 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

TungstenVn
using v2.0.7
17 May 20
reply me i'll give it 5*
CtrlAltTr0ll
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
DaPigGuy
08 May 20
This already exists. You can set type to command for no items to be given.
G2Wolverine3751
using v2.0.6
03 May 20
Nice plugin though please add a way to just execute a command without giving the object
DaPigGuy
08 May 20
This already exists. You can set type to command for no items to be given.
JGYTVevo
using v2.0.6
02 May 20
Best crates plugin out there, very easy to setup. Would recommend
SexyLush
using v2.0.6
28 Apr 20
wow love the chance and floating name feature
TheRealSnipeZ
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
DaPigGuy
28 Apr 20
Already exists. Please read Installation & Setup in the README or on Poggit
hinexmine
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
Worst-Admin
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?
SexyLush
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
DaPigGuy
21 Apr 20
Read Installation & Setup in the README or on Poggit
creeperplayer20
using v2.0.4
30 Mar 20
Again, thanks for the preview. :D
AndroidMinDa
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/
DaPigGuy
13 Apr 20
This issue has been fixed.
pistolswang013
using v2.0.2
05 Dec 19
JGYTVevo
using v1.5.0
12 May 19
Permissions? Also can someone tell me how to get permissions of other plugins?
HotUrsula
using v1.4.0
17 Jan 19
Nice! Thank you :)
JackMD
using v1.4.0
25 Nov 18
Simple and easy setup. Nice
Yolohu1
using v1.2.0
16 May 20
Do you assign block that you put under a chest to open crates?
Aericio
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.
joshuasing
using v1.2.0
02 Jul 18
Great Plugin!

Reply to review by :

Supported API versions
3.2.0
->
3.13.0
Dependencies
PiggyCustomEnchants 2.0.1
Optional
View Plugin
Producers §
  • Collaborators:
    • @Aericio
  • Contributors:
    • @Heisenburger69
    • @JackMD
    • @SalmonDE
License §
Categories:
General
Miscellaneous
Permissions
Manage tiles
Permissions
Commands

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

Loading...