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

attributedescriptionpossibledefault
itemsThis is where you put all your items IDs in (surrounded by ' '). See example above.item idsnone
identifierThis is a string you have to put right above every item section. That allows you to use the same item ID multiple times.any stringnone
idPut in the item ID without data values here (data value belongs to data - for wool/potions/etc).any item id0
dataThis can be used for data values (e.g. wool, potions, etc)any data id0
amountThe amount of the itemany integer0
colorOnly works for leather armor. Requires a RGB color String. Scroll down for detailed explanation.any rgb colornone
enchantmentsDefine the enchantments for the item here. Format: ID,Levelany enchant idnone
loreHere you can set an item desciption (colors supported - see below). Has to be surrounded with ' 'any stringnone
nameDefine an item name here if you want.any stringnone
slotHere you can define the slot for the item (helmet,chestplate,leggings,boots,inventory)see descriptioninventory
commandsHere 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.stringsnone
removeeffectsIf true, this removes all effects on the player when requesting the kittrue or falsefalse
effectsPotion effects that are directly applied to the player. Format: ID,Duration,Strengthany effect idnone
givemoneyGive money to the user who is requesting the kit (requires Vault + Economy plugin).any floating-point number0.0
givexpGive experience points to the kit requester.any integer0
usagesDefines 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 higher0
cooldownHere you can set a cooldown (in seconds) if you want.any integer0
clearinvSet this to true if you want the player's inventory to be cleared out before sending the kit.true or falsefalse
cleararmorSet this to true if you want the player's armor to be cleared out before sending the kit.true or falsefalse
priceIf you got Vault + Economy plugin installed, you can set a price here.any floating-point number0.0
messageHere 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 stringnothing


Enchantmemt IDs

IDEnchant
0Protection
1Fire Protection
2Feather Falling
3Blast Protection
4Projectile Protection
5Respiration
6Aqua Affinity
7Thorns
16Sharpness
17Smite
18Bane Of Arthropods
19Knockback
20Fire Aspect
21Looting
32Efficiency
33Silk Touch
34Unbreaking
35Fortune
48Power
49Punch
50Flame
51Infinity


Color IDs

IDColor
&0Black
&1Dark Blue
&2Dark Green
&3Dark Aqua
&4Dark Red
&5Dark Purple
&6Gold
&7Gray
&8Dark Gray
&9Blue
&aGreen
&bAqua
&cRed
&dLight Purple
&eYellow
&fWhite
&kMagic/Obfuscated
&lBold
&mStrikethrough
&nUnderline
&oItalic
&rReset Color


Armor Colors

Get your RGB colors here: http://www.colorschemer.com/online.html