This file is located at plugins/SkyWars/kits.yml
.
Note: This document is on how to manually type in new kits into the config. To much more quickly create kits just from items in your inventory, check out Creating a new kit.
The following is a version of the default kits.yml config, annotated with comments. For a complete reference of all possible values, see the kits.yml reference.
# ####### kits.yml #######
#
# Kit configuration
#
# For documentation, please visit
# http://daboross.net/projects/skywars/configuring-kits
# #########
# This is the version of the configuration.
# If this line is changed or removed, SkyWars may overwrite some of the newer settings when
# the server is next restarted.
configuration-version: 1
# Note that to enable most of these kits, you must enable economy support in main-config.yml.
bowman:
# This kit has a cost of $100. The cost is charged every game in which it is used.
cost: 100
# This kit is represented by a bow when shown in the kit inventory-GUI.
totem: BOW
# This is shown in the lore of the totem.
description: "&4Just a bow."
items:
# You can list any number of items here.
# Each item has a type section. It also may optionally have an enchantments
# section and amount value.
# The type is a material name. You can get a list of these here:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
- {type: ARROW, amount: 16}
# When amount is not given, it defaults to 1.
- {type: BOW}
whacker:
cost: 20
totem: STICK
description: "&4Knockback 3."
items:
- {type: STICK, enchantments: {KNOCKBACK: 3},
name: "Whacking Stick", lore: ["&2Whacking", "&4and hacking"]}
potions:
# This kit demonstrates how to enter potions into kits.
cost: 100
totem: POTION
# A multiline description
description: |
&cInvisibility&4, &cspeed&4,
&cposion&4 and &chealing&4.
&4What more could you need?
items:
# Potions:
# There are two ways to add potions to an item:
#
# Using `potion: {TYPE, extended: true/false, upgraded: true/false splash: true/false, lingering: true/false}`
# will turn the item into one of the set potions in minecraft, and update the
# item name and lore accordingly. TYPE in this case is a PotionType, see links below.
#
# You can also add "custom" potion effects, using:
# `extra-effects: [{type: TYPE, duration: SECONDS, amplifier: AMPLIFIER}, {type: TYPE2, ...}]`
# For extra-effects, TYPE is a PotionEffectType, see the links below. SECONDS is how long it
# will last, AMPLIFIER is similar to a potion level, but can go up to 128. amplifier: 0
# represents the default effects, and is the default value.
#
# When adding custom potion effects, it is recommended to still have one "regular" potion set.
# Even if you override it with a custom effect, it will allow the item's name and lore to
# update for the potion it holds.
# this is a drinkable invisibility potion
- {type: POTION, amount: 2, potion: {type: INVISIBILITY}}
# this potion is a double edged sword - it gives speed, and poison.
# however, the speed lasts a bit longer than the poison does.
- {type: POTION, amount: 2, potion: {type: SPEED, splash: true},
extra-effects: [
# this will overwrite the main speed effect, while allowing the text to remain.
# I honestly have no idea what this duration is counted in.
{type: SPEED, duration: 2000},
{type: POISON, duration: 1000}
]}
# Full heal - the higher the amplifier, the more effect it has.
- {type: POTION, amount: 3, potion: {type: HEAL, splash: true}}
- {type: POTION, amount: 4, potion: {type: HEAL, splash: true},
extra-effects: [{type: HEAL, amplifier: 5}]}
diamond-swordsman:
# You can define a permission, a cost, or both for a kit.
# When you define a permission, the kit is only shown to people with that
# permission. This allows you to make kits only available to donors.
permission: server.donor
totem: DIAMOND_SWORD
description: "&4Server donors only."
items:
- {type: DIAMOND_SWORD, amount: 1}
chestplate:
type: LEATHER_CHESTPLATE
armor-color: CC7700
full-donor-armor:
# This kit is only available to donors, but it also costs $500 each game!
permission: server.donor
totem: DIAMOND_HELMET
description: "&4Rich server donors only."
cost: 500
# You can define a helmet, chestplate, leggings and boots.
# These will automatically be placed in the armor slots of the player.
helmet: {type: DIAMOND_HELMET}
chestplate: {type: DIAMOND_CHESTPLATE, enchantments: {PROTECTION_PROJECTILE: 2}}
leggings: {type: DIAMOND_LEGGINGS}
# See link above for exact enchantment names
boots: {type: DIAMOND_BOOTS, enchantments: {PROTECTION_FALL: 2}}
Complete list of possible names: - Materials: - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html. - Enchantments: - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html. - Potions (potion: {type: ...}): - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionType.html - Potions (extra-effects: [{type: ...}]): - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
The links above have more information than needed, but they are continually the most up to date lists of full names. All you need to use a material, enchantment or potion is the UPPERCASE name.