PiggyCrates's documentation page includes the configuration documentation.
PiggyCrates is a simple and customizable crates plugin with roulettes, supporting both custom and
vanilla enchantments.
As of October 19, 2019, PiggyCrates has been completely rewritten
from scratch. Click the box below
to learn more.
Version 2.0.0 is a complete rewrite of the plugin and introduces tons of bug fixes, optimizations, and quality of life changes.
Key | Index | Explanation |
---|---|---|
keys | id | Specifies the item that should be used to act as a "key" for the
crate. Accepted values: item id
|
meta | Specifies the meta value for the key item. Accepted values: item meta
|
|
name | Specifies the name of the key item. Accepted values: item name
|
|
lore | Specifies the lore (the text under the name) of the key item. You can add multiple lines in lore by adding \n .Example: lore: "Line #1\nLine #2\nLine #3" Accepted values: item lore
|
|
crates | mode | Whether to instantly give items or open the roulette menu. If roulette is selected, you can define duration and
speed of roulette in the following section.Accepted values: instant, roulette
|
roulette.duration | Determines the length of the roulette in ticks (20 ticks = 1
second). Accepted values: roulette duration
|
|
roulette.speed | Determines the speed at which the roulette items should shift
left. Accepted values: roulette speed
|
Key | Index | Data | Explanation |
---|---|---|---|
crates.crate_type | drops | id | Specifies the id of the drop item. Accepted values: item id |
meta | Specifies the meta of the drop item. Accepted values: item meta |
||
amount | Specifies the amount of items that should be given. Accepted values: number of items |
||
chance | Specifies the chance of recieving the drop item. The accumulative chance values of all drops should equal to 100. Accepted values: drop chance |
||
name | (optional) Specifies the name of the drop item. Accepted values: item name |
||
lore | (optional) Specifies the lore (the text under the name) of the drop
item. Accepted values: item lore |
||
nbt | (optional) Specifies NBT tags on the drop item. Any JSON-ified strings will work for NBT tags. Refer here for possible vanilla NBT tags. Accepted values: json |
||
enchants | (optional) Specifies vanilla or custom enchants to apply onto the
drop item. PiggyCustomEnchants support is added by default. Accepted values: enchants => name, level |
||
amount | Specifies the amount of times that the crate should roll with only
one key. Accepted values: number of rolls |
||
commands | (optional) Specifies what command should be ran upon opening the
crate. Possible Tags: {PLAYER} Accepted values: array of text |
||
drops | Specifies the content of the floating text above the
crate. Accepted values: text |