Kits Config v6.1+
Description
kits.yml (created on first start)
Extended example:
mykitname: items: examplesword: id: 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' - 'Recipient''s name is (player)' name: '&1(player)''s Swordname' slot: inventory orangewool: id: 35 data: 1 amount: 10 slot: inventory magentawool: id: 35 data: 2 amount: 10 slot: inventory myhelmet: id: 298 amount: 1 slot: helmet color: 51 255 204 commands: - say That triggered a say command - tell (player) Hi, I am the console. - pex user (player) add test.node 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: coloredwool: id: 35 data: 3 amount: 10 slot: inventory helmetlether: id: 298 amount: 1 slot: helmet cooldown: 10 message: '&1Enjoy it ;)'
How to make kits
Kits are defined in this format:
[kitname]: items: [identifier - any string] id: [any integer] data: [data value - for wool/potions/etc] amount: [any integer] color: [any rgb color] 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: [-2, -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, you don't have to specify all attributes. It will just use it's default if it's not set.
If you want to use an apostrophe ( ' ) in messages/names/whatever then you have to escape it. How to do that? Simply use two instead of only one ( '' ). This is not a double quote but 2 single apostrophes!
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 |
identifier | This is a string you have to put right above every item section. That allows you to use the same item ID multiple times. | any string | none |
id | Put in the item ID without data values here (data value belongs to data - for wool/potions/etc). | any item id | 0 |
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 |
color | Only works for leather armor. Requires a RGB color String. Scroll down for detailed explanation. | any rgb color | none |
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.Note: This are console commands! Players don't need the permissions for the commands. | 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 a player can request this kit. -2 = once per life; -1 = starterkit; 0 = infinite; 1 = only once; 2 or higher = limited to the given number | -2, -1, 0, 1 or higher | 0 |
cooldown | Here you can set a cooldown (in seconds) 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 |
Armor Colors
Get your RGB colors here: http://www.colorschemer.com/online.html