You can create kits using the kits.yml file. Kit items are formatted in strings.
Effective Kit Storage:
Kits are stored in chests so when you claim a kit it doesn't fill up your inventory as much. To get the kit's items, simply place the chest on the ground and it will be automatically filled.
If your inventory is full when you claim or receive a kit, it will be send to your ender chest. If your ender chest is full, only then will the kit drop on the ground.
Kit GUI:
When you type /kit, you open a GUI that allows you to select kits. You can customize the GUI item for each kit using the config. Also, you can customize the GUI title.
Permissions and Cooldowns:
Each kit has its own permission ("kit.<kitname>") and you can edit the cooldown of each kit. Kit cooldowns are optimized to cause less lag to the server.
Compatibility:
You can send players kits from the console so you can use vKits with other plugins as well.
/kit
Opens the Kit GUI.
/kit <kit>
Gives you a kit.
/kit <kit> <player>
Gives a player a kit.
kit.<kitname>
Gives the player permission to use a kit.
vKits.admin
Gives the player permission to use all kits and bypass all cooldowns.
Spoiler: config.yml
# Note: To avoid errors, follow the syntax provided in the config.
# To learn how to use the config, read the documentation on the
# resource page.
messages :
send-update-message-to-ops : true
use-error-prefix : true
kit-claimed : '&7Successfully claimed kit &b { kit } &7!'
kit-does-not-exist : '&cThe kit { kit } does not exist!'
no-items-defined-ops : '&cThere are no items defined for the { kit } kit in the config!'
no-items-defined-player : '&cThis kit is currently not available. Ask a staff member for support!'
player-not-found : '&cPlayer &4 { player } &cnot found!'
player-given-kit-from-op : '&7You have been given kit &b { kit } &7!'
no-kits-in-gui : '&cThere are no kits in the GUI!'
invalid-item-config-format-ops : '&cInvalid item config format. Refer to the plugin documentation for details!'
invalid-item-config-format-players : '&cThis kit is currently not available. Ask a staff member for support!'
insufficient-permission : '&cYou do not have permission to do this!'
insufficient-permission-ops-only : '&cOnly OPs can do this!'
op-given-kit-to-player : '&7Given kit { kit } to &a { player } &7!'
console-given-kit-to-player : 'Given kit { kit } to { player } !'
kit-cooldown-active : '&cYou cannot use this kit for another { time } !'
unknown-error-ops : '&cUnknown error. Contact the plugin developer for support!'
unknown-error-player : '&cUnknown error. Ask a staff member for help!'
kit-sent-to-enderchest : '&bYour inventory is full so the kit was sent to your ender chest!'
invalid-material : '&cCould not add item "{item}" to the kit! Reason : INVALID_MATERIAL'
# Note: The config section "kits" is only here for reference.
# To add kits, use the format provided with the following config section in the file kits.yml.
kits :
test : # -> Name of the kit.
items :
# <material> <amount> <durability> <name> <enchants[enchant:level]>
# This item is a diamond sword with the name &aTest_&7Sword and it has Sharpness 5 and Unbreaking 3
# Names can use "&" color code symbols
# To add spaces in the name of the item, use "_"
- diamond_sword 1 0 &aTest_&7Sword sharpness:5,unbreaking:3
- cooked_beef 1 0
# Some items have custom formats
# Potions:
# <material> <potion type> <extended> <upgraded>
# Leather Armor:
# For Solid Color:
# <material> <amount> <durability> <color> <name> <enchants[enchant:level]>
# For RGB Color:
# <material> <amount> <durability> <red:green:blue> <name> <enchants[enchant:level]>
# Note: red, green and blue must be replaced with numbers.
# Note: If extended and upgraded are both set to true, the potion will only be extended since
# potions cannot be both extended and upgraded. Also, the only acceptable material types for potions
# are "potion", "splash_potion", and "lingering_potion". Otherwise, the potion will be a regular awkward potion.
- potion instant_healing false true
delay : 43200 # -> This is the cooldown for the kit in seconds. The cooldown of this kit is 12 hours.
gui :
displayname : '&aTest &7Kit' # -> Use this to set the display name for the kit's GUI display item.
# Note: You don't need to use "_" to create spaces in the name.
material : chest # -> Use this to set the material for the kit's GUI display item.
lore : # -> Use this to set the lore for the kit's GUI display item.
- '&bClick me to claim'
- '&ba &aTest &bKit!'
# Here is another example.
starter :
items :
- stone_pickaxe 1 0 &cStarter_&7Pickaxe
- stone_sword 1 0 &cStarter_&7Sword
- stone_axe 1 0 &cStone_&7Axe
- cooked_beef 16 0
- torch 32 0
- cobblestone 32 0
- oak_log 16 0
- potion instant_healing true false
delay : 7200
gui :
displayname : '&cStarter &7Kit'
material : chest
lore :
- '&7Useful tools for'
- '&7new players!'
gui :
displayname : '&0Select a Kit!' # -> Use this to change the title of the GUI.
Code (YAML):
# Note: To avoid errors, follow the syntax provided in the config.
# To learn how to use the config, read the documentation on the
# resource page.
messages :
send-update-message-to-ops : true
use-error-prefix : true
kit-claimed : '&7Successfully claimed kit &b { kit } &7!'
kit-does-not-exist : '&cThe kit { kit } does not exist!'
no-items-defined-ops : '&cThere are no items defined for the { kit } kit in the config!'
no-items-defined-player : '&cThis kit is currently not available. Ask a staff member for support!'
player-not-found : '&cPlayer &4 { player } &cnot found!'
player-given-kit-from-op : '&7You have been given kit &b { kit } &7!'
no-kits-in-gui : '&cThere are no kits in the GUI!'
invalid-item-config-format-ops : '&cInvalid item config format. Refer to the plugin documentation for details!'
invalid-item-config-format-players : '&cThis kit is currently not available. Ask a staff member for support!'
insufficient-permission : '&cYou do not have permission to do this!'
insufficient-permission-ops-only : '&cOnly OPs can do this!'
op-given-kit-to-player : '&7Given kit { kit } to &a { player } &7!'
console-given-kit-to-player : 'Given kit { kit } to { player } !'
kit-cooldown-active : '&cYou cannot use this kit for another { time } !'
unknown-error-ops : '&cUnknown error. Contact the plugin developer for support!'
unknown-error-player : '&cUnknown error. Ask a staff member for help!'
kit-sent-to-enderchest : '&bYour inventory is full so the kit was sent to your ender chest!'
invalid-material : '&cCould not add item "{item}" to the kit! Reason : INVALID_MATERIAL'
# Note: The config section "kits" is only here for reference.
# To add kits, use the format provided with the following config section in the file kits.yml.
kits :
test : # -> Name of the kit.
items :
# <material> <amount> <durability> <name> <enchants[enchant:level]>
# This item is a diamond sword with the name &aTest_&7Sword and it has Sharpness 5 and Unbreaking 3
# Names can use "&" color code symbols
# To add spaces in the name of the item, use "_"
- diamond_sword 1 0 &aTest_&7Sword sharpness:5,unbreaking:3
- cooked_beef 1 0
# Some items have custom formats
# Potions:
# <material> <potion type> <extended> <upgraded>
# Leather Armor:
# For Solid Color:
# <material> <amount> <durability> <color> <name> <enchants[enchant:level]>
# For RGB Color:
# <material> <amount> <durability> <red:green:blue> <name> <enchants[enchant:level]>
# Note: red, green and blue must be replaced with numbers.
# Note: If extended and upgraded are both set to true, the potion will only be extended since
# potions cannot be both extended and upgraded. Also, the only acceptable material types for potions
# are "potion", "splash_potion", and "lingering_potion". Otherwise, the potion will be a regular awkward potion.
- potion instant_healing false true
delay : 43200 # -> This is the cooldown for the kit in seconds. The cooldown of this kit is 12 hours.
gui :
displayname : '&aTest &7Kit' # -> Use this to set the display name for the kit's GUI display item.
# Note: You don't need to use "_" to create spaces in the name.
material : chest # -> Use this to set the material for the kit's GUI display item.
lore : # -> Use this to set the lore for the kit's GUI display item.
- '&bClick me to claim'
- '&ba &aTest &bKit!'
# Here is another example.
starter :
items :
- stone_pickaxe 1 0 &cStarter_&7Pickaxe
- stone_sword 1 0 &cStarter_&7Sword
- stone_axe 1 0 &cStone_&7Axe
- cooked_beef 16 0
- torch 32 0
- cobblestone 32 0
- oak_log 16 0
- potion instant_healing true false
delay : 7200
gui :
displayname : '&cStarter &7Kit'
material : chest
lore :
- '&7Useful tools for'
- '&7new players!'
gui :
displayname : '&0Select a Kit!' # -> Use this to change the title of the GUI.
To add kits to the server, you have to add them to the kits.yml file, not the config.yml. The kits in the config.yml are only there as an example.
Here is an example of the kits.yml:
Spoiler: kits.yml
Code (YAML):
kits :
tutorial :
items :
- leather_helmet 1 0 140:26:93 &cTutorial_&fHelmet &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_chestplate 1 0 140:26:93 &cTutorial_&fChestplate &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_leggings 1 0 140:26:93 &cTutorial_&fLeggings &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_boots 1 0 140:26:93 &cTutorial_&fBoots &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- stone_pickaxe 1 0 { default } { default } efficiency:3,unbreaking:1
- stone_sword 1 0 &cTutorial_&fSword &cThe_tutorial_gear|&fis_awesome sharpness:3,unbreaking:1
- golden_apple 1 0
- splash_potion luck true false &aLuck_&fPotion &fGives_you|&agood_luck!
delay : 43200
gui :
displayname : '&cTutorial &fKit'
lore :
- '&fA test Kit'
- '&dClick to claim'
tutorial :
items :
- leather_helmet 1 0 140:26:93 &cTutorial_&fHelmet &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_chestplate 1 0 140:26:93 &cTutorial_&fChestplate &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_leggings 1 0 140:26:93 &cTutorial_&fLeggings &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- leather_boots 1 0 140:26:93 &cTutorial_&fBoots &cThe_tutorial_gear|&fis_awesome
protection:5,mending:1
- stone_pickaxe 1 0 { default } { default } efficiency:3,unbreaking:1
- stone_sword 1 0 &cTutorial_&fSword &cThe_tutorial_gear|&fis_awesome sharpness:3,unbreaking:1
- golden_apple 1 0
- splash_potion luck true false &aLuck_&fPotion &fGives_you|&agood_luck!
delay : 43200
gui :
displayname : '&cTutorial &fKit'
lore :
- '&fA test Kit'
- '&dClick to claim'
Item Formats
When adding items to kits using the kits.yml file, there are 3 formats to use.
Regular Items:
Potions:
When adding items to kits using the kits.yml file, there are 3 formats to use.
Regular Items:
Spoiler: Regular Items
kits :
tutorial :
items :
# Format: <material> <amount> <durability> <displayname> <lore> <enchants>
# Note: You can use {default} to use the default name and lore for the item.
# To add multiple enchants, you can use a comma between enchants in the string. Here is an example of a regular item.
- diamond_sword 1 0 &dExample_&fSword &fGuess_what?|&aIt_works! sharpness:5
Here is the item from the example above:
Leather Armor:
Code (YAML):
kits :
tutorial :
items :
# Format: <material> <amount> <durability> <displayname> <lore> <enchants>
# Note: You can use {default} to use the default name and lore for the item.
# To add multiple enchants, you can use a comma between enchants in the string. Here is an example of a regular item.
- diamond_sword 1 0 &dExample_&fSword &fGuess_what?|&aIt_works! sharpness:5
Spoiler: Leather Armor
kits :
tutorial :
items :
# Format: <material> <amount> <durability> <color> <displayname> <lore> <enchants>
# Note: You can use minecraft's default colors here or you can create an RGB color. To create an RGB color, replace <color> with red:green:blue and replace each color with a number between 0 and 255.
# Note: You can use {default} to use the default color, name and lore for the item.
# To add multiple enchants, you can use a comma between enchants in the string. Here is an example of a regular item.
- leather_chestplate 1 0 143:186:192 &dExample_&fChestplate &fGuess_what?|&aIt_works! protection:6,mending:1
Here is the item from the example above:
Code (YAML):
kits :
tutorial :
items :
# Format: <material> <amount> <durability> <color> <displayname> <lore> <enchants>
# Note: You can use minecraft's default colors here or you can create an RGB color. To create an RGB color, replace <color> with red:green:blue and replace each color with a number between 0 and 255.
# Note: You can use {default} to use the default color, name and lore for the item.
# To add multiple enchants, you can use a comma between enchants in the string. Here is an example of a regular item.
- leather_chestplate 1 0 143:186:192 &dExample_&fChestplate &fGuess_what?|&aIt_works! protection:6,mending:1
Potions:
Spoiler: Potions
kits :
tutorial :
items :
# Format: <material> <type> <extended> <upgraded> <name> <lore>
# Note: The only materials that work for potions are "potion", "splash_potion" and "lingering_potion".
# If the material is anything different, it will return an awkward potion.
# Note: <extended> and <upgraded> are booleans. They can only be set to "true" or "false".
# Note: You can use {default} to use the default name and lore for the item.
# Here is an example of a potion.
- splash_potion luck true false &aLuck_&fPotion &fGives_you|&agood_luck!
Here is the item from the example above:
Code (YAML):
kits :
tutorial :
items :
# Format: <material> <type> <extended> <upgraded> <name> <lore>
# Note: The only materials that work for potions are "potion", "splash_potion" and "lingering_potion".
# If the material is anything different, it will return an awkward potion.
# Note: <extended> and <upgraded> are booleans. They can only be set to "true" or "false".
# Note: You can use {default} to use the default name and lore for the item.
# Here is an example of a potion.
- splash_potion luck true false &aLuck_&fPotion &fGives_you|&agood_luck!
Errors and Support
Errors may occur if you do not properly use the files config.yml and kits.yml. If errors occur, please check the support section below. If errors occur when using this plugin, please do not leave a negative review. Instead, please send a message in this resource's discussion describing your error and I will be happy to help you. Please don't hesitate to contact me if you have any questions, issues or concerns!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.15
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
vKits | An Optimized and Fully Configurable Kit Plugin! is a free Minecraft Java mod. Compatible with Minecraft 1.15. Downloaded 430 times (via Spigot). Download it and open it directly in the game.