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

attributedescriptionpossibledefault
itemsThis is where you put all your items IDs in (surrounded by ' '). See example above.item idsnone
dataThis can be used for data values (e.g. wool, potions, etc)any data id0
amountThe amount of the itemany integer0
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.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 this kit can be used. -2 = deathkit; -1 = starterkit; 0 = infinite; 1 or more = limited to that number-2,-1,0,1 and higher0
cooldownIf onetime and starter is false, you can set a cooldown (in seconds) here 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