Kits Config v6.0
Description
kits.yml (created on first start)
Extended example:
mykitname: items: '276': data: 0 amount: 1 enchantments: - 33,2 - 32,1 - 0,1 lore: - '&0This makes a colored text' - '&1This is colored too' - 'This is uncolored' name: '&1Colored Swordname' slot: inventory '35': data: 3 amount: 10 slot: inventory '298': amount: 1 slot: helmet commands: - say That triggered a say command - tell (player) Hi, I am the console. removeeffects: true effects: - 1,10,2 - 2,10,3 givemoney: 20 givexp: 50 usages: 0 clearinv: true cleararmor: true cooldown: 10 price: 0 message: '&1Enjoy it ;)'
Simple example:
simpletkitname: items: '35': data: 3 amount: 10 slot: inventory '298': amount: 1 slot: helmet cooldown: 10 message: '&1Enjoy it ;)'
How to make kits
Kits are defined in this format:
[kitname]: items: '[ID]': data: [data value] amount: [any integer] enchantments: - [ID,Level] lore: - '[any string]' name: - '[any string]' slot: [helmet, chestplate, leggings, boots, inventory] commands: - [your commands string here - no "/" required] removeeffects: [true or false] effects: - [ID, Duration(seconds), strength] givemoney: [any floating-point number] givexp: [any integer] usages: [-1, 0, 1 or more] clearinv: [true or false] clearamor: [true or false] cooldown: [cooldown in seconds] price: [price as floating-point number] message: '[any string]'
IMPORTANT: The kits config is using Bukkit's yaml parser. That means you can't use TAB indentation and you have to use spaces (see example).
Also if you don't set an attribute, it will use its default value.
Available config attributes
attribute | description | possible | default |
---|---|---|---|
items | This is where you put all your items IDs in (surrounded by ' '). See example above. | item ids | none |
data | This can be used for data values (e.g. wool, potions, etc) | any data id | 0 |
amount | The amount of the item | any integer | 0 |
enchantments | Define the enchantments for the item here. Format: ID,Level | any enchant id | none |
lore | Here you can set an item desciption (colors supported - see below). Has to be surrounded with ' ' | any string | none |
name | Define an item name here if you want. | any string | none |
slot | Here you can define the slot for the item (helmet,chestplate,leggings,boots,inventory) | see description | inventory |
commands | Here you can list commands which are being executed after requesting a kit. (player) represents the name of the player who is getting the kit. See example above. | strings | none |
removeeffects | If true, this removes all effects on the player when requesting the kit | true or false | false |
effects | Potion effects that are directly applied to the player. Format: ID,Duration,Strength | any effect id | none |
givemoney | Give money to the user who is requesting the kit (requires Vault + Economy plugin). | any floating-point number | 0.0 |
givexp | Give experience points to the kit requester. | any integer | 0 |
usages | Defines how often this kit can be used. -2 = deathkit; -1 = starterkit; 0 = infinite; 1 or more = limited to that number | -2,-1,0,1 and higher | 0 |
cooldown | If onetime and starter is false, you can set a cooldown (in seconds) here if you want. | any integer | 0 |
clearinv | Set this to true if you want the player's inventory to be cleared out before sending the kit. | true or false | false |
cleararmor | Set this to true if you want the player's armor to be cleared out before sending the kit. | true or false | false |
price | If you got Vault + Economy plugin installed, you can set a price here. | any floating-point number | 0.0 |
message | Here you can specify a custom message for this kit. The default message from config.yml will be used if you leave that empty or remove the "message:" field. Colors are possible: See color codes. Has to be surrounded with ' ' | any string | nothing |
Enchantmemt IDs
ID | Enchant |
---|---|
0 | Protection |
1 | Fire Protection |
2 | Feather Falling |
3 | Blast Protection |
4 | Projectile Protection |
5 | Respiration |
6 | Aqua Affinity |
7 | Thorns |
16 | Sharpness |
17 | Smite |
18 | Bane Of Arthropods |
19 | Knockback |
20 | Fire Aspect |
21 | Looting |
32 | Efficiency |
33 | Silk Touch |
34 | Unbreaking |
35 | Fortune |
48 | Power |
49 | Punch |
50 | Flame |
51 | Infinity |
Color IDs
ID | Color |
---|---|
&0 | Black |
&1 | Dark Blue |
&2 | Dark Green |
&3 | Dark Aqua |
&4 | Dark Red |
&5 | Dark Purple |
&6 | Gold |
&7 | Gray |
&8 | Dark Gray |
&9 | Blue |
&a | Green |
&b | Aqua |
&c | Red |
&d | Light Purple |
&e | Yellow |
&f | White |
&k | Magic/Obfuscated |
&l | Bold |
&m | Strikethrough |
&n | Underline |
&o | Italic |
&r | Reset Color |