PlayerKit

我可以用 PlayerKit 做什么？

该插件允许您创建各种套件并将它们放在 GUI 清单上。如果玩家拥有正确的权限，则使用 /kit 玩家将能够领取这些套件。套件也可以有冷却时间，因此用户不能每次都领取它们。

PlayerKits 的特别之处在于它创建套件的简单方法，只需将物品放在您的库存中并执行命令即可。您可以使用 /kit edit 命令编辑套件属性。此外，几乎所有物品属性都将存储在套件中，因此它们被正确给出。

功能介绍

• ✓ 用于领取套件的 GUI 库存。
• ✓ 领取套件的命令。
• ✓ GUI中可配置的显示项目：
  物品、名称、传说。
  当玩家没有权限时，不同的项目。
  当玩家没有购买套件时，不同的物品。
  当套件处于冷却状态时，不同的传说。
• ✓ 套件的冷却时间。
• ✓ 套件权限。
• ✓ 套件价格。
• ✓ 一次性购买套件
• ✓ 提供套件时执行命令。
• ✓ 可定制的套件预览。
• ✓ 页面系统。
• ✓ 从游戏中编辑套件。
• ✓ 首先加入套件。
• ✓ 一次性使用套件。
• ✓ 1.16 十六进制颜色支持套件物品。
• ✓ 自动护甲装备
• ✓ 自动副手物品装备
• ✓ 可配置的 GUI。
• ✓ MySQL 支持玩家数据。
• ✓ 套件将保存物品属性。
  名字，传说。
  %player% 变量。
  PlaceholderAPI 名称和传说中的静态变量。
  附 魔。
  药水效果。
  皮革盔甲颜色。
  书籍结界。
  书面书籍。
  Fireworks 属性。
  横幅，盾牌属性。
  骷髅头纹理。
  项目标志。
  牢不可破的标签。
  属性修饰符。
  NBT标签。
• ✓ 适用于 1.8+。
• ✓ 消息翻译。

如何使用？

要创建新套件，您只需要在库存中放置一些物品，然后执行命令 /kit create <name>。要领取套件，您有两种选择：
1） 使用 /kit 命令，然后单击 GUI 中的套件项。
2） 使用 /kit 声明 <name> 命令。（或者，如果将选项设置为 true，请使用 /kit <name>claim_kit_short_command）

现在，您可以编辑 kits.yml 文件中的所有套件属性。

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

您还可以使用 /kit edit <kit> 命令直接从 Minecraft 编辑套件，而无需触摸配置。

config.yml

消息：
prefix： “&8[&4PlayerKits&8] ”
noPermissions： “&cYou don't have permissions for that.”
commandCreateError： “&c您需要使用： &7/kit create <name>”
commandDeleteError： “&c您需要使用： &7/kit delete <name>”
commandClaimError： “&c您需要使用： &7/kit 声明 <kit>”
commandGiveError： “&c您需要使用： &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： “&c套件 &7%name% &c不存在。”
inventoryEmpty：“&c您的库存中至少需要 1 件物品才能创建套件。
kitCreated： “&aKit &7%name% &acreated 正确。”
kitRemoved： “&aKit &7%name% &aremoved correctly.”
kitReceived： “&aKit &7%name% &areceived.”
configReload：“&aConfig 已重新加载。
秒：“s”
分钟：“m”
小时：“h”
天：“d”
cooldownPlaceholderReady：“&a&lReady！”
cooldownError：“&c您需要等待 &7%time% &cto 再次领取此套件。
kitNoPermissions：“&c您无权声明此工具包。
kitInCooldownLore：
- “&c您需要等待 &7%time%”
- “&cto 再次领取此套件。”
commandList： “&6&lKit 列表”
commandListKit： “&6%number% &8» &a%kit%”
commandListKitNoPermissions： “&6%number% &8» &c%kit% &7（无权限）”
commandListKitInCooldown： “&6%number% &8» &c%kit% &7（冷却时间： &8%time%&7）”
commandListKitOneTime： “&6%number% &8» &c%kit% &7（已声明&7）”
noSpaceError： “&c您的库存中没有足够的空间。
materialNameError：“&c您的配置出错。材料：&7&l%material% &cis 不适用于您的 Minecraft 版本。
oneTimeError：“&c您无法再次申领此套件。
kitOneTimeLore：
- “&c你不能再领取这个套件了。”
previewInventoryName： “&9Kit Preview”
backItemName： “&7Back”
playerNotOnline： “&cPlayer &7%player% &cis not online.”
kitGive： “&aKit &7%kit% &agiven to &e%player%&a！”
noMoneyError： “&c你没有足够的钱来领取这个套件。&8（&a$&c%current_money%&7/&a$&c%required_money%&8）“
moneyInventoryName： ”&9购买套件确认“
moneyInventoryYes： ”&a&lYES“
moneyInventoryNo： ”&c&lNO“
moneyInventoryConfirmationName： ”&6你确定吗？”
moneyInventoryConfirmationLore：
- “&7这将花费你： &a$%price%”
kitInventoryOpen： “&a打开 &e%player%&a 的套件库存。”
errorPage：“写一个有效的页面（&c）。
通讯andResetError： “&c您需要使用： &7/kit reset <kit> <player>”
kitResetCorrect： “&aKit &7%kit% &areset for &7%player%&a！”
kitResetFail： “&c无法重置套件 &7%kit% &cfor &7%player%&c！”
noPreviewError：“&c此工具包没有任何可预览的内容。
cantPreviewError：“&c您无法预览此工具包。
配置：
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：假
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：真
player_data_save_time：300
inventory_pages_names：
1：“&9Kits”
2：“&bVIP Kits”
mysql_database：
已启用：false
主机：localhost
端口：3306
用户名：root
密码：root
数据库：数据库

#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"

Messages:
  prefix: '&8[&4PlayerKits&8] '
  noPermissions: '&c你对此没有权限.'
  commandCreateError: '&c请使用这个指令: &7/kit create <name>'
  commandDeleteError: '&c请使用这个指令: &7/kit delete <name>'
  commandClaimError: '&c请使用这个指令: &7/kit claim <kit>'
  commandGiveError: '&c请使用这个指令: &7/kit give <kit> <player>'
  commandEditError: '&c请使用这个指令: &7/kit edit <kit>'
  commandPreviewError: '&c请使用这个指令: &7/kit preview <kit>'
  commandOpenError: '&c请使用这个指令: &7/kit open <player> <page>'
  kitAlreadyExists: '&c礼包 &7%name% &c已经在配置中存在了.'
  kitDoesNotExists: '&c礼包 &7%name% &c不存在.'
  inventoryEmpty: '&c你的背包至少要有一个物品才能创建这个礼包.'
  kitCreated: '&a礼包 &7%name% &a已创建'
  kitRemoved: '&a礼包 &7%name% &a已移除.'
  inventoryName: '&9礼包'
  kitReceived: '&a礼包 &7%name% &a已领取.'
  configReload: '&a配置已重载.'
  seconds: '秒'
  minutes: '分钟'
  hours: '小时'
  days: '天'
  cooldownPlaceholderReady: '&a&l准备!'
  cooldownError: '&c你需要等待 &7%time% &c去再次领取这个礼包.'
  kitNoPermissions: '&c你没有权限去领取这个礼包.'
  kitInCooldownLore:
  - '&c你需要等待 &7%time%'
  - '&c去再次领取这个礼包.'
  commandList: '&6&l礼包列表'
  commandListKit: '&6%number% &8» &a%kit%'
  commandListKitNoPermissions: '&6%number% &8» &c%kit% &7(没有权限)'
  commandListKitInCooldown: '&6%number% &8» &c%kit% &7(冷却: &8%time%&7)'
  commandListKitOneTime: '&6%number% &8» &c%kit% &7(已经领取&7)'
  noSpaceError: '&c你背包没有足够的空间来领取礼包.'
  materialNameError: '&c这里有一个错误在配置里. 材料: &7&l%material%
    &c不在这个版本生效.'
  oneTimeError: '&c你不能再次领取这个礼包.'
  kitOneTimeLore:
  - '&c你不能再次领取这个礼包.'
  previewInventoryName: '&9礼包预览'
  backItemName: '&7返回'
  playerNotOnline: '&c玩家 &7%player% &c现在不在线.'
  kitGive: '&a礼包 &7%kit% &a已给予给 &e%player%&a!'
  noMoneyError: '&c你没有足够的钱去领取礼包. &8(&a$&c%current_money%&7/&a$&c%required_money%&8)'
  moneyInventoryName: '&9确认购买礼包'
  moneyInventoryYes: '&a&l确定'
  moneyInventoryNo: '&c&l取消'
  moneyInventoryConfirmationName: '&6确定要购买礼包吗?'
  moneyInventoryConfirmationLore:
  - '&7这将花费您: &a$%price%'
  kitInventoryOpen: '&给玩家 &e%player%&a 打开了礼包界面.'
  errorPage: '&c请写出一个有效的页面.'
  commandResetError: '&c请使用这个指令: &7/kit reset <player> <kit>'
  kitResetCorrect: '&a礼包 &7%kit% &a已为玩家 &7%player%&a重置!'
  kitResetFail: '&c无法重置礼包 &7%kit% &c给玩家 &7%player%&c!'
#直接替换语言部分即可,Config部分不需要删除

该插件具有 %playerkitscooldown<kit>% PlaceholderAPI 变量，该变量允许向玩家显示套件的当前冷却时间。

指令

• /kit 打开套件 GUI。
• /kit open <player> <page> 向玩家打开套件 GUI。
• /kit create <kit> 创建一个新工具包。
• /kit delete <kit> 删除已创建的套件。
• /kit list 显示所有套件。
• /kit claim <kit> 认领套件。（如果启用了claim_kit_short_command选项，则为 /kit <kit>）
• /kit preview <kit>预览套件。
• /kit edit <kit> 编辑工具包。
• /kit give <kit> <player> 给玩家一个套件。
• /kit reset <kit> <player> 重置播放器中的套件数据。
• /kit reload 重新加载配置。
  （别名：/kits）

  权限

• playerkits.admin 访问所有命令。
• playerkits.bypasscooldown 允许忽略套件冷却时间。
• playerkits.list 访问 /kit list 命令。