PlayerKits | Fully Configurable KITS! [1.8-1.20]

PlayerKits | Fully Configurable KITS! [1.8-1.20] -----

A simple but powerful solution to create kits and claim them on a GUI.

THIS PLUGIN WILL NOT BE UPDATED ANYMORE, BUT YOU CAN CHECK PLAYER KITS 2, WHICH IS THE NEW OPTIMIZED AND IMPROVED VERSION OF THE PLUGIN (IT'S FREE)

I wanted to recode the plugin from scratch and make it more maintainable so I can update it more frequently. PlayerKits 2 offers a migration system to import kits data from PlayerKits. Finally, PlayerKits will not receive support anymore, only PlayerKits 2 will.

What can I do with PlayerKits?
This plugin allows you to create a variety of kits and put them on a GUI Inventory. Using /kit players will be able to claim these kits if they have the correct permission. Kits can also have a cooldown, so users can't claim them everytime.

What makes PlayerKits special is its easy way to create kits, just having the items on your inventory and executing a command. You can edit kits properties by using /kit edit command. Also, almost all item attributes will be stored in the kit, so they are given correctly.

If you want to help me maintain this project alive, I would be grateful if you donate and support my work

@serhatkotan

- ✓ GUI Inventory to claim Kits.
- ✓ Command to claim Kits.
- ✓ Configurable display item in GUI:

Item, name, lore.
Different item when player doesn't have permission.
Different item when player hasn't buyed the kit.
Different lore when kit is in cooldown.

- ✓ Cooldown for kits.
- ✓ Permissions for kits.
- ✓ Price for kits.
- ✓ One Time Buy kits
- ✓ Execute commands when giving a kit.
- ✓ Customizable Kit Preview.
- ✓ Pages System.
- ✓ Edit Kits from Game.
- ✓ First join kit.
- ✓ One time use kit.
- ✓ 1.16 HEX Color support for kit items.
- ✓ Auto Armor Equip.
- ✓ Auto Offhand item Equip.
- ✓ Configurable GUI.
- ✓ MySQL support for player data.

- ✓ Kits will save Item Attributes.

Name, Lore.
%player% variable in name and lore.
PlaceholderAPI static variables in name and lore.
Enchantments.
Potion Effects.
Leather Armor Color.
Book Enchantments.
Written Books.
Fireworks Attributes.
Banner, Shields Attributes.
Skull Textures.
Item Flags.
Unbreakable Tag.
Attributes Modifiers.
NBT Tags.

- ✓ Works in 1.8+.
- ✓ Messages translation.

To create a new kit you just need to have some items on your inventory and then execute the command /kit create <name>. To claim the kit you have two options:
1) Use the /kit command and click on the kit item inside the GUI.
2) Use the /kit claim <name> command. (Or use /kit <name> if you have claim_kit_short_command option set to true)

Now you can edit all the kit properties in the kits.yml file.

Code (YAML):

Kits:
iron:
Items:
'1':
id : IRON_AXE
amount : '1'
'2':
id : IRON_PICKAXE
amount : '1'
'3':
id : IRON_SWORD
amount : '1'
slot : 10
display_item : IRON_AXE
display_name : '&6&lIron &aKit'
display_lore :
- '&eThis kit includes:'
- '&8- &7x1 Iron Axe'
- '&8- &7x1 Iron Pickaxe'
- '&8- &7x1 Iron Sword'
- ''
- '&7Cooldown : &c3 hours'
- ''
- '&aLeft Click to claim!'
- '&bRight Click to preview!'
cooldown : 10800
diamond:
Items:
'1':
id : DIAMOND_AXE
amount : '1'
'2':
id : DIAMOND_PICKAXE
amount : '1'
'3':
id : DIAMOND_SWORD
name : "&4Super Sword"
lore :
- "&7Best sword on the server."
- ""
- "&7Owner : &a%player%"
enchants :
- DAMAGE_ALL;5
amount : '1'
Commands :
- "bc &6%player% &ejust claimed a &aDIAMOND KIT&e!"
slot : 11
display_item : DIAMOND_SWORD
display_name : '&6&lDiamond &aKit'
display_lore :
- '&eThis kit includes:'
- '&8- &7x1 Diamond Axe'
- '&8- &7x1 Diamond Pickaxe'
- '&8- &7x1 Diamond Sword'
- ''
- '&7Cooldown : &c12 hours'
- '&7Price : &a$5000'
- ''
- '&aClick to buy!'
- '&bRight Click to preview!'
cooldown : 43200
price : 5000
permission : playerkits.kit.diamond
noPermissionsItem:
display_item : BARRIER
display_name : "&6&lDiamond &aKit"
display_lore :
- "&cYou don't have permissions to claim"
- "&cthis kit."
- ""
- "&7You need : &bVIP&6+ &7rank. "
onetime:
Items:
'1':
id: LEVER
amount: '5'
name: "&6Mystery Key : &aBasic"
lore :
- "&7Use it on the spawn."
slot : 12
display_item : LEVER
display_name : '&6&lBasic Mystery Key &aKit'
display_lore :
- '&eThis kit includes:'
- '&8- &7x5 Basic Mystery Key'
- ''
- '&7You can claim this kit just one time!'
- ''
- '&aClick to claim!'
- '&bRight Click to preview!'
one_time : true

#The position of the kit in the GUI Inventory. If you don't want to show the kit you can remove this option.
slot: 10

#The page of the inventory where the kit will show. If you want to show the item in the first page, you don't need to add this option.
page: 2

#Attributes of the item in the inventory. For the display_name you need to use a valid item name. For latest Minecraft version use this link as reference: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
#If you want to set a textured skull the display_item must be "PLAYER HEAD" or "SKULL_ITEM:3" for 1.8-1.12 and add :
#display_item_skulldata: "id;texture"
display_item: IRON_AXE
display_name: '&6&lIron &aKit'
display_lore:
- '&eThis kit includes:'
- '&8- &7x1 Iron Axe'
- '&8- &7x1 Iron Pickaxe'
- '&8- &7x1 Iron Sword'
- ''
- '&7Cooldown: &c3 hours'
- ''
- '&aClick to claim!'

#If is set to true, the display item will be enchanted.
display_item_glowing: true

#Cooldown of the kit in seconds. How much time the player will have to wait to claim this kit again.
cooldown: 10800

#You can add a price for the kit. For this option to work you need Vault: https://dev.bukkit.org/projects/vault
price: 5000

#If is set to true, players will need to buy the kit just one time before claiming it.
one_time_buy: true

#Besides giving items in kits, you can execute commands from the console, remember to use %player% variable.
Commands:
- "bc &6%player% &ejust claimed a &aDIAMOND KIT&e!"

#You can add a permission for the kit.
permission: playerkits.kit.diamond

#If the player doesn't have the correct permission, this item will show in the inventory instead of the original one.
noPermissionsItem:
display_item: BARRIER
display_name: "&6&lDiamond &aKit"
display_lore:
- "&cYou don't have permissions to claim"
- "&cthis kit."
- ""
- "&7You need: &bVIP&6+ &7rank."

#If the player hasn't buyed a kit with one_time_buy option, this item will show in the inventory instead of the original one.
noBuyItem:
display_item: BARRIER
display_name: "&6&lIron &aKit"
display_lore:
- '&eThis kit includes:'
- '&8- &7x1 Iron Axe'
- '&8- &7x1 Iron Pickaxe'
- '&8- &7x1 Iron Sword'
- ''
- '&7Price: &$5000'
- ''
- '&aClick to buy!'

#If this option is set to true, players will receive this kit when joining for the first time.
first_join: true

#If this option is set to true, players can claim this kit just one time.
one_time: true

You can also edit the kit directly from Minecraft without touching the config, using the /kit edit <kit> command.
[IMG]

Code (Text):

Messages:
prefix: "&8[&4PlayerKits&8] "
noPermissions: "&cYou don't have permissions for that."
commandCreateError: "&cYou need to use: &7/kit create <name>"
commandDeleteError: "&cYou need to use: &7/kit delete <name>"
commandClaimError: "&cYou need to use: &7/kit claim <kit>"
commandGiveError: "&cYou need to use: &7/kit give <kit> <player>"
commandEditError: "&cYou need to use: &7/kit edit <kit>"
commandPreviewError: "&cYou need to use: &7/kit preview <kit>"
commandOpenError: "&cYou need to use: &7/kit open <player> <page>"
kitAlreadyExists: "&cThe kit &7%name% &calready exists on the config."
kitDoesNotExists: "&cThe kit &7%name% &cdoesn't exists."
inventoryEmpty: "&cYou need at least 1 item on your inventory to create a kit."
kitCreated: "&aKit &7%name% &acreated correctly."
kitRemoved: "&aKit &7%name% &aremoved correctly."
kitReceived: "&aKit &7%name% &areceived."
configReload: "&aConfig Reloaded."
seconds: 's'
minutes: 'm'
hours: 'h'
days: 'd'
cooldownPlaceholderReady: "&a&lReady!"
cooldownError: "&cYou need to wait &7%time% &cto claim this kit again."
kitNoPermissions: "&cYou don't have permissions to claim this kit."
kitInCooldownLore:
- "&cYou need to wait &7%time%"
- "&cto claim this kit again."
commandList: "&6&lKit List"
commandListKit: "&6%number% &8» &a%kit%"
commandListKitNoPermissions: "&6%number% &8» &c%kit% &7(No Permissions)"
commandListKitInCooldown: "&6%number% &8» &c%kit% &7(Cooldown: &8%time%&7)"
commandListKitOneTime: "&6%number% &8» &c%kit% &7(Already claimed&7)"
noSpaceError: "&cYou don't have enough space in your inventory."
materialNameError: "&cThere is an error on your config. Material: &7&l%material% &cis not valid for your Minecraft version."
oneTimeError: "&cYou can't claim this kit again."
kitOneTimeLore:
- "&cYou can't claim this kit again."
previewInventoryName: "&9Kit Preview"
backItemName: "&7Back"
playerNotOnline: "&cPlayer &7%player% &cis not online."
kitGive: "&aKit &7%kit% &agiven to &e%player%&a!"
noMoneyError: "&cYou don't have enough money to claim this kit. &8(&a$&c%current_money%&7/&a$&c%required_money%&8)"
moneyInventoryName: "&9Buy Kit Confirmation"
moneyInventoryYes: "&a&lYES"
moneyInventoryNo: "&c&lNO"
moneyInventoryConfirmationName: "&6Are you sure?"
moneyInventoryConfirmationLore:
- "&7This will cost you: &a$%price%"
kitInventoryOpen: "&aOpening Kits inventory for &e%player%&a."
errorPage: "&cWrite a valid page."
commandResetError: "&cYou need to use: &7/kit reset <kit> <player>"
kitResetCorrect: "&aKit &7%kit% &areset for &7%player%&a!"
kitResetFail: "&cNot possible to reset kit &7%kit% &cfor &7%player%&c!"
noPreviewError: "&cThere is nothing to preview for this kit."
cantPreviewError: "&cYou can't preview this kit."
Config:
inventorySize: 45
previewInventorySize: 54
preview_inventory_back_item_slot: 45
kit_preview: true
kit_preview_back_item: true
hide_kits_with_permissions: false
close_inventory_on_claim: false
drop_items_if_full_inventory: false
commands_before_items: false
preview_inventory_requires_permission: false
claim_kit_short_command: false
kit_error_sound: BLOCK_NOTE_BLOCK_PLING;10;0.1
kit_claim_sound: ENTITY_PLAYER_LEVELUP;10;1.5
kit_page_sound: BLOCK_LAVA_POP;10;1
update_notify: true
player_data_save_time: 300
inventory_pages_names:
1: "&9Kits"
2: "&bVIP Kits"
mysql_database:
enabled: false
host: localhost
port: 3306
username: root
password: root
database: database

#Here you can define the sound name for specific events. Use these sounds for 1.8: https://github.com/Attano/Spigot-1.8/blob/master/org/bukkit/Sound.java
And these sounds for newer versions: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
#Format: Sound;Volume;Pitch
#You can set the options to 'none' for not setting any sound.
kit_error_sound: BLOCK_NOTE_BLOCK_PLING;10;0.1
kit_claim_sound: ENTITY_PLAYER_LEVELUP;10;1.5

#This will define the time in seconds in which player kit data is saved automatically.
player_data_save_time: 300

#If this option is enabled, players without permissions to claim certain kit will not be able to preview it.
preview_inventory_requires_permission: false

#If this option is enabled, players will be able to use /kit <name> command instead of /kit claim <name>
claim_kit_short_command: false

#Here you need to define the title of the kits inventory per page.
inventory_pages_names:
1: "&9Kits"
2: "&bVIP Kits"

#Enabling this will fix some nbt issues especially with AdvancedEnchantments plugin. If you modify this option you must save your kits again.
nbt_alternative_data_save: false

#You can modify the GUI Inventory as you like by adding items here. The section name (in this case 0) is the slot. You can also add a command to the item if you want. You can also use skulldata. You can use PlaceholderAPI variables on the name and lore.
#You can use the custom_model_data option if you need to
0:
id: BLACK_STAINED_GLASS_PANE
name: "&6Go Back"
lore:
- "line1"
- "line2"
command: chestcommands open %player% mainmenu
custom_model_data: 5

#Here you can modify the slot and properties of the next page and previous page items. Just remember to leave the "type" intact.
18:
id: PLAYER_HEAD
skulldata: "2391d533-ab09-434d-9980-adafde4057a3;eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmQ2OWUwNmU1ZGFkZmQ4NGU1ZjNkMWMyMTA2M2YyNTUzYjJmYTk0NWVlMWQ0ZDcxNTJmZGM1NDI1YmMxMmE5In19fQ=="
type: previous_page
name: "&6Previous Page"
26:
id: PLAYER_HEAD
skulldata: "d513d666-0992-42c7-9aa6-e518a83e0b38;eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTliZjMyOTJlMTI2YTEwNWI1NGViYTcxM2FhMWIxNTJkNTQxYTFkODkzODgyOWM1NjM2NGQxNzhlZDIyYmYifX19"
type: next_page
name: "&6Next Page"

Spanish by MeikersYT [Click here]
Spanish by @igabrielf04 [Click here]
Russian by @snr93 [Click here]
Vietnamese by @ImCursedKiwi [Click here]
Simplified Chinese by @Lijinhong [Click here]
Traditional Chinese by @Lijinhong [Click here]
Rumanian by @Iepurooy [Click here]
Polish by @Tomcio0203x [Click here]

English by @XDRGAMING_S4

Spanish by me

The plugin has the %playerkits_cooldown_<kit>% PlaceholderAPI variable which allows to show current cooldown of kit to the player.

[IMG]

- /kit Open the Kits GUI.
- /kit open <player> <page> Opens the Kits GUI to a player.
- /kit create <kit> Creates a new kit.
- /kit delete <kit> Removes a created kit.
- /kit list Shows all kits.
- /kit claim <kit> Claims a kit. (Or /kit <kit> if claim_kit_short_command option is enabled)
- /kit preview <kit> Previews a kit.
- /kit edit <kit> Edits a kit.
- /kit give <kit> <player> Gives a kit to the player.
- /kit reset <kit> <player> Resets a kit data from the player.
- /kit reload Reloads the config.
(alias: /kits)
[IMG]

- playerkits.admin Access to all commands.
- playerkits.bypasscooldown Allows to ignore kit cooldowns.
- playerkits.list Access to /kit list command.

[IMG]

Please avoid posting bad ratings before asking. If you have problems or bugs with the plugin contact with me or post on the plugin discussion and I will take a look at it. Enjoy the plugin

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 417,251

First Release: Feb 14, 2020

Last Update: Jun 9, 2023

Category: ---------------

All-Time Rating:

422 ratings

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings