Videos - There are no updated videos of this plugin.
Screenshots
Want to buy me? Click here!
- configurable particle effects
- GUI preview of crate prizes
- ability to add enchantments to items within the GUI
- ability to add custom lore lines to items within the GUI
- configurable messages
- configurable prefixes
- configurable knockback effect
- configurable crate keys
- configurable message prefix
- configurable crate prizes
- add per-crate particles
/cratekey give [player] [crate-name] [amount]
/cratekey add [crate-name]
/cratekey reload
cratekey.give
cratekey.add
cratekey.reload
I'll be going over every customization you can make in this plugin. You ready? Let's go
Wrong Key Message
Code:
wrong-key-message: '&bYou may only use the %key% key on this crate!'[Screenshot]
Fireworks
Code:
firework:
colors:
- BLUE
- YELLOW
shape: BALL
fade:
- PURPLE
- WHITE
trail: true
flicker: false
power: 2The available colors are: AQUA, BLACK, BLUE, FUCHSIA, GRAY, GREEN, LIME, MAROON, NAVY, OLIVE, ORANGE, PURPLE, RED, SILVER, TEAL, WHITE, and YELLOW.
For the shape, there are 5 shapes your firework can have: BALL, BALL_LARGE, STAR, BURST, and CREEPER.
The fade part is the colors that your firework will fade with. The available colors for the fade colors are the same ones listed above.
The trail variable controls whether your firework will leave a trail.
The flicker variable controls whether you firework will flicker.
Lastly, the power variable controls how fast/far your firework goes. You can only put the numbers 1-4.
Broadcast Prefix
Code:
broadcast-prefix: '&bCrates &a> 'Crate Effects
Code:
particle-effect: 'SPELL_WITCH'
knockback-power: 1.0The particle-effect variable controls what type of particles spawn around the crate/chest. The list of available particles can be found here:
Code:
EXPLOSION_NORMAL("explode", 0, 17),
EXPLOSION_LARGE("largeexplode", 1, 1),
EXPLOSION_HUGE("hugeexplosion", 2, 0),
FIREWORKS_SPARK("fireworksSpark", 3, 2),
WATER_BUBBLE("bubble", 4, 3),
WATER_SPLASH("splash", 5, 21),
WATER_WAKE("wake", 6, -1),
SUSPENDED("suspended", 7, 4),
SUSPENDED_DEPTH("depthsuspend", 8, 5),
CRIT("crit", 9, 7),
CRIT_MAGIC("magicCrit", 10, 8),
SMOKE_NORMAL("smoke", 11, -1),
SMOKE_LARGE("largesmoke", 12, 22),
SPELL("spell", 13, 11),
SPELL_INSTANT("instantSpell", 14, 12),
SPELL_MOB("mobSpell", 15, 9),
SPELL_MOB_AMBIENT("mobSpellAmbient", 16, 10),
SPELL_WITCH("witchMagic", 17, 13),
DRIP_WATER("dripWater", 18, 27),
DRIP_LAVA("dripLava", 19, 28),
VILLAGER_ANGRY("angryVillager", 20, 31),
VILLAGER_HAPPY("happyVillager", 21, 32),
TOWN_AURA("townaura", 22, 6),
NOTE("note", 23, 24),
PORTAL("portal", 24, 15),
ENCHANTMENT_TABLE("enchantmenttable", 25, 16),
FLAME("flame", 26, 18),
LAVA("lava", 27, 19),
FOOTSTEP("footstep", 28, 20),
CLOUD("cloud", 29, 23),
REDSTONE("reddust", 30, 24),
SNOWBALL("snowballpoof", 31, 25),
SNOW_SHOVEL("snowshovel", 32, 28),
SLIME("slime", 33, 29),
HEART("heart", 34, 30),
BARRIER("barrier", 35, -1),
ITEM_CRACK("iconcrack_", 36, 33),
BLOCK_CRACK("tilecrack_", 37, 34),
BLOCK_DUST("blockdust_", 38, -1),
WATER_DROP("droplet", 39, -1),
ITEM_TAKE("take", 40, -1),
MOB_APPEARANCE("mobappearance", 41, -1);The knockback-power variable controls how far back the player is pushed when they don't use the correct key on a crate. This variable is very sensitive and I don't recommend going above 2.0. You can use decimals to fine tune how far you want them to be knocked back.
Crate Key
Code:
keyName: '&e&lVote &lKey'
keyLore:
- '&bThis key is for Vote crates'
keyMaterial: TRIPWIRE_HOOKThe keyName variable controls what shows up when you hover your mouse over the key. It supports color codes. [Screenshot]
The keyLore variable controls what shows up as the key lore. You can add several lines of lore which support color codes. [Screenshot]
The keyMaterial variable controls what material your key is. The list of materials that you can set your key as can be found here.
Prizes
Code:
prizePackages:
'1':
percent: 10
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received &1&l2 &lUncommon &lCrate &lKeys!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
&6&l2 &lUncommon &lCrate &lKeys!'
commands:
- cratekey give %player% uncommon 2
item-material: 'EMERALD'
item-name: '&62 Uncommon Crate Keys'
item-enchants:
- 0:4
item-lore:
- '&cThis is the the 2 Uncommon Crate Keys prize.'The percent variable controls what the players' chances are of getting that specific prize.
The playerMessage controls what will be sent to the player when they receive that prize.
The broadcastMessage is the message that will broadcast when a player wins that prize.
The commands variable controls what command will be run when the player wins that specific prize. There's no need to put a slash in front of the comand unless the command is run as "//something". Also, you can use the %player% variable to replace the players name.
The item-material variable controls what material the prize will show up as in the prize preview GUI. [Screenshot] As you can see, the prize shows up as an EMERALD. The list of materials that you can set your prize as can be found here.
The item-name variable controls what shows up when you hover your mouse over the prize in the prize preview GUI. It supports color codes. [Screenshot]
The item-enchants variable controls what enchantments are on the prize item. You must use enchantment ids for this to work. The list of enchantment ids can be found here. The number after the colon is the level of enchantment. [Screenshot]
The item-lore variable controls the lore of the prize item. It also supports color codes. [Screenshot]
Default Configuration
Great, now you know how to customize your own crate, down to its very core. In case you want to just edit the default config, here it is:
Code:
wrong-key-message: '&bYou may only use the %key% key on this crate!'
crates:
vote:
firework:
colors:
- 'BLUE'
- 'YELLOW'
shape: 'BALL'
fade:
- 'PURPLE'
- 'WHITE'
trail: true
flicker: false
power: 2
particle-effect: 'SPELL_WITCH'
knockback-power: 1.0
broadcastPrefix: '&bCrates &a&l> '
keyName: '&e&lVote &lKey'
keyLore:
- '&bThis key is for Vote crates'
keyMaterial: TRIPWIRE_HOOK
crateLocations: []
prizePackages:
'1':
percent: 10
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received &1&l2 &lUncommon &lCrate &lKeys!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
&6&l2 &lUncommon &lCrate &lKeys!'
commands:
- cratekey give %player% uncommon 2
item-material: 'EMERALD'
item-name: '&62 Uncommon Crate Keys'
'2':
percent: 30
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&lVote &lKit!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&lVote &lKit!'
commands:
- kit vote %player%
item-material: 'DIAMOND'
item-name: '&bVote Kit'
'3':
percent: 20
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received &1&l15 %lMillion &lDollars!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
&6&l15 &lMillion &lDollars!'
commands:
- eco give %player% 1000000
item-material: 'COAL'
item-name: '&a1 Million Dollars'
'4':
percent: 10
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&lMVP &lKit!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&lMVP &lKit!'
commands:
- kit mvp %player%
item-material: 'REDSTONE'
item-name: '&cMVP Kit'
'5':
percent: 5
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&lDiamond &lHelmet!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&lDiamond &lHelmet!'
commands:
- give %player% diamondhelm 1 protection:5 unbreaking:3
item-material: 'DIAMOND_HELMET'
item-name: '&9Diamond Helmet'
'6':
percent: 5
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&lDiamond &lChestplate!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&lDiamond &lChestplate!'
commands:
- give %player% diamondchestplate 1 protection:5 unbreaking:3
item-material: 'DIAMOND_CHESTPLATE'
item-name: '&9Diamond Chestplate'
'7':
percent: 5
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&lDiamond &Legging!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&lDiamond &lLegging!'
commands:
- give %player% diamondleggings 1 protection:5 unbreaking:3
item-material: 'DIAMOND_LEGGINGS'
item-name: '&9Diamond Leggings'
'8':
percent: 5
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received &1&lDiamond &lBoots!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
&6&lDiamond &lBoots!'
commands:
- give %player% diamondboots 1 protection:5 unbreaking:3
item-material: 'DIAMOND_BOOTS'
item-name: '&9Diamond Boots'
'9':
percent: 3
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&l$5 &lBuycraft &lVoucher!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&l$5 &lBuycraft &lVoucher!'
commands:
- tell %player% Take a screenshot of this message and show it to an Owner. If you lie, you'll be perm banned.
item-material: 'DIAMOND'
item-name: '&4$5 Buycraft Voucher'
'10':
percent: 7
playerMessage: '&bCrates &a&l> &4You have opened a &3&lVote &lCrate
&4and received a &1&l/Nick &lCommand!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lVote &lCrate &5and received
a &6&l/Nick &lCommand!'
commands:
- manuaddp %player% essentials.nick
- manuaddp %player% essentials.nick.color
item-material: 'STONE'
item-name: '&7/Nick Command'
uncommon:
firework:
colors:
- 'GREEN'
- 'BLACK'
shape: 'STAR'
fade:
- 'AQUA'
- 'PURPLE'
trail: true
flicker: true
power: 3
particle-effect: 'FIREWORKS_SPARK'
knockback-power: 1.0
broadcastPrefix: '&bCrates &a&l> '
keyName: '&b&lUncommon &lCrate &lKey'
keyLore:
- '&bThis key is for Uncommon crates'
keyMaterial: TRIPWIRE_HOOK
crateLocations: []
prizePackages:
'1':
percent: 48
playerMessage: '&bCrates &a&l> &4You have opened a &3&lUncommon &lCrate
&4and received a &1&lHero &lKit!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lUncommon &lCrate &5and
received a &6&lHero &lKit!'
commands:
- kit hero %player%
item-material: 'DIAMOND_SWORD'
item-name: '&9Hero Kit'
'2':
percent: 13
playerMessage: '&bCrates &a&l> &4You have opened a &3&lUncommon &lCrate
&4and received &1&lSpeed &lIII &lForever!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lUncommon &lCrate &5and
received &6&lSpeed &lIII &lForever!'
commands:
- effect %player% 100000000
item-material: 'FEATHER'
item-name: '&ePermanent Speed III'
'3':
percent: 24
playerMessage: '&bCrates &a&l> &4You have opened a &3&lUncommon &lCrate
&4and received &1&l40 &lMillion &lDollars!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lUncommon &lCrate &5and
received &6&l40 &lMillion &lDollars!'
commands:
- eco give %player% 40000000
item-material: 'GOLD_INGOT'
item-name: '&a140 Million Dollars'
'4':
percent: 15
playerMessage: '&bCrates &a&l> &4You have opened a &3&lUncommon &lCrate
&4and received &1&l70 &lMillion &lDollars!'
broadcastMessage: '&3&l%player% &5&lhas opened a &2&lUncommon &lCrate &5and
received &6&l70 &lMillion &lDollars!'
commands:
- eco give %player% 70000000
item-material: 'DIAMOND'
item-name: '&b170Million Dollars'