PlayerKits - 全配置式礼包插件

本插件已停止更新，请使用其全新优化改进的版本 PlayerKits 2（免费）。开发者已完全重写插件，使其更易于维护和更新。PlayerKits 2 提供了数据迁移系统，可从本插件导入礼包数据。此后，本插件将不再获得支持。

💡功能概述

PlayerKits 允许你创建多种礼包，并将其展示在 GUI 界面中。玩家通过 /kit 命令或界面点击，在拥有对应权限且礼包未处于冷却时即可领取。其特色在于创建礼包极其简单：只需手持物品执行命令即可。几乎所有物品属性都能被正确保存并发放。

核心特性

• GUI 领取界面：支持多页面系统，可完全自定义。
• 灵活的领取方式：支持 GUI 点击与命令领取。
• 高度可配置的展示物品：
• 可设置不同的名称、描述。
• 可配置无权限、未购买、冷却中时的不同显示物品与描述。
• 丰富的礼包控制选项：
• 支持冷却时间。
• 支持权限节点。
• 支持设置购买价格（需 Vault）。
• 支持一次性购买。
• 支持领取时执行控制台命令。
• 支持自定义礼包预览。
• 强大的物品保存能力：保存包括名称、描述（支持 %player% 变量及 PlaceholderAPI 静态变量）、附魔、药水效果、皮革盔甲颜色、成书、烟花、旗帜、盾牌、头颅纹理、物品标签、不可破坏标签、属性修饰符、NBT 标签等几乎所有属性。
• 其他便利功能：
• 首次加入礼包。
• 一次性使用礼包。
• 支持 1.16+ 的 HEX 颜色代码。
• 自动装备盔甲与副手物品。
• 支持 MySQL 存储玩家数据。
• 支持 1.8+ 全版本。
• 支持多语言信息翻译。

🎮快速开始

创建礼包

• 将你想要放入礼包的物品拿在手中或放在背包里。
• 执行命令 /kit create <礼包名称>。

领取礼包

玩家可通过以下两种方式之一领取礼包

• 执行 /kit 打开 GUI 界面，点击对应的礼包物品。
• 执行 /kit claim <礼包名称>。（如果配置中 claim_kit_short_command 设为 true，也可直接使用 /kit <礼包名称>）

编辑礼包

所有礼包属性均在 plugins/PlayerKits/kits.yml 文件中配置。你也可以在游戏中直接使用 /kit edit <礼包名称> 命令进行编辑，无需手动修改配置文件。

🔧配置文件详解

kits.yml 结构

以下是一个配置示例，展示了主要选项

Kits:
  iron:
    Items: # 礼包包含的物品列表
      '1':
        id: IRON_AXE
        amount: 1
      '2':
        id: IRON_PICKAXE
        amount: 1
    slot: 10 # 在 GUI 中的格子位置 (0-53)
    display_item: IRON_AXE # GUI 中显示的物品类型
    display_name: '&6&lIron &aKit' # 显示名称
    display_lore: # 显示描述
      - '&eThis kit includes:'
      - '&8- &7x1 Iron Axe'
    cooldown: 10800 # 冷却时间（秒）
    price: 5000 # 价格（需 Vault）
    permission: playerkits.kit.diamond # 所需权限
    one_time: true # 是否为一次性礼包（领取后永久无法再领）
    first_join: true # 是否作为首次加入礼包
    Commands: # 领取时执行的命令（可使用 %player% 变量）
      - "bc &6%player% &ejust claimed a &aDIAMOND KIT&e!"
    noPermissionsItem: # 当玩家无权限时显示的替代物品
      display_item: BARRIER
      display_name: "&cNo Permission"
    noBuyItem: # 当玩家未购买（one_time_buy为true时）时显示的替代物品
      display_item: BARRIER
      display_name: "&eClick to Buy"

config.yml 主要设置

• GUI 与界面：
• inventorySize：GUI 大小。
• inventory_pages_names：各页面标题。
• kit_preview：是否启用礼包预览。
• 功能开关：
• claim_kit_short_command：启用后可使用 /kit <名称> 直接领取。
• close_inventory_on_claim：领取后是否关闭界面。
• drop_items_if_full_inventory：背包满时是否掉落物品。
• 音效：可配置错误、领取、翻页等音效，格式为 Sound;Volume;Pitch。
• MySQL：启用后可集中存储玩家礼包数据。
• 消息：可自定义所有提示信息。

✨命令与权限

命令列表

• /kit – 打开礼包 GUI 界面。
• /kit open <玩家> <页面> – 为指定玩家打开礼包界面。
• /kit create <礼包名> – 创建新礼包。
• /kit delete <礼包名> – 删除礼包。
• /kit list – 列出所有礼包。
• /kit claim <礼包名> – 领取礼包。
• /kit preview <礼包名> – 预览礼包内容。
• /kit edit <礼包名> – 编辑礼包。
• /kit give <礼包名> <玩家> – 给予玩家礼包。
• /kit reset <礼包名> <玩家> – 重置玩家对该礼包的数据（如冷却）。
• /kit reload – 重载配置文件（别名 /kits）。

权限节点

• playerkits.admin – 使用所有管理命令的权限。
• playerkits.bypasscooldown – 绕过所有礼包冷却时间。
• playerkits.list – 使用 /kit list 命令的权限。
• playerkits.kit.<礼包名> – 领取特定礼包所需的权限。

❓常见问题与提示

• PlaceholderAPI 支持：可使用 %playerkits_cooldown_<kit>% 变量在别处显示礼包冷却时间。
• 自定义头颅：在 display_item 设为 PLAYER_HEAD 后，使用 display_item_skulldata: "id;texture" 来设置纹理。
• 版本兼容：物品材料名称因版本而异，高版本服务器请参考 Spigot Javadoc。
• 问题反馈：如遇问题或漏洞，请在插件讨论区留言，请勿直接给予差评。
• 迁移至 PlayerKits 2：新版本支持从本插件一键迁移数据，建议升级以获得持续更新和支持。

⭐附加信息

• 翻译支持：插件支持多国语言，已有西班牙语、俄语、越南语、简体中文、繁体中文、罗马尼亚语、波兰语等翻译文件。
• 视频教程：英文与西班牙语教程可在原发布页查找。
• 依赖：如需经济功能（价格），需要安装 Vault 和经济插件。

---

请注意：此插件（PlayerKits）已停止维护，开发重心已完全转移至 PlayerKits 2。