PlayerKits 2 - 可配置礼包插件

简介

PlayerKits2 是一款功能强大的 Minecraft 插件，它允许你创建多种生存礼包，并将其展示在一个可配置的 GUI 界面中。玩家可以通过命令领取这些礼包，但可能需要满足特定权限或条件。礼包可以设置冷却时间，防止玩家重复领取。其特色在于创建和编辑礼包非常简便，你可以直接使用背包中的物品来创建，并通过命令或配置文件轻松调整所有属性。

💡为什么从 PlayerKits 升级到 PlayerKits2？

• 性能更优：代码经过优化，运行更高效。
• 完全可配置的界面：你可以创建自定义的 GUI 界面，例如分页或分类菜单。
• 自定义礼包条件：可以为礼包设置领取要求（支持使用 PlaceholderAPI 变量）。
• 更新更频繁：插件将持续获得功能更新和问题修复。
• 详尽的 Wiki：提供完整的在线文档以供参考。

🎮完整 Wiki 与支持

Wiki 文档

完整的插件使用文档、配置指南和 API 说明请访问：

https://ajneb97.gitbook.io/playerkits-2

支持渠道

如果你需要帮助或联系作者，可以通过以下方式

• 作者支持：
• 在 SpigotMC 的插件讨论区发布你的问题。
• 在 SpigotMC 上向作者发送私信。
• 在 GitHub 仓库提交 Issue。
• 社区 Discord 支持：
• 这是一个主要由西班牙语用户组成的社区 Discord 服务器，但也设有英语支持分类。
• 前往 "Plugins Ajneb97" 分类，在 "general-plugins-ajneb97" 频道中提问。
• 请注意，此频道的帮助来自其他用户/客户，作者不保证会在此直接提供支持。如需作者亲自帮助，请使用上述讨论区或私信功能。
• Discord 链接： [DISCORD LINK]

🔧插件功能详解

核心功能

• 创建多种生存礼包，并通过 GUI 界面展示。
• 玩家使用命令可领取礼包，并可设置权限和条件限制。
• 礼包可设置冷却时间、一次性领取等属性。
• PlayerKits2 的亮点在于创建礼包极其简单：只需将物品放入背包，执行一个命令即可。

礼包属性

每个礼包可以配置以下属性

• 冷却时间：领取间隔。
• 所需权限：领取礼包必须拥有的权限。
• 一次性：每个玩家只能领取一次。
• 自动穿戴：自动装备盔甲类物品。
• 自动副手：自动将物品放入副手槽。
• 可执行动作：
• 领取时执行。
• 领取出错时执行。
• 领取要求：
• 价格（经济）。
• PlaceholderAPI 变量条件。
• 一次性要求。
• GUI 显示物品：可为不同状态设置不同的展示物品，例如：
• 默认状态。
• 无权限状态。
• 冷却中状态。
• 已领取（一次性）状态。
• 要求未满足状态。

其他实用功能

• 礼包编辑 GUI 界面。
• 完全可自定义的 GUI 库存布局。
• 背包已满时，礼包物品会掉落在地。
• 礼包预览功能。
• 首次加入服务器赠送的礼包。
• 为新礼包设置默认值。
• 礼包物品的名称和描述支持 PlaceholderAPI 变量。
• 支持 MySQL 数据库。
• 兼容 Minecraft 1.8 及以上版本。

⭐命令列表

• /kit - 打开礼包 GUI 界面。
• /kit claim - 不通过 GUI，直接领取指定礼包。
• /kit - 仅当配置文件中 claim_kit_short_command 选项启用时，此命令可直接领取礼包。
• /kit create - 使用你当前背包中的物品创建一个新礼包。
• /kit edit - 在 GUI 中编辑一个已存在的礼包。
• /kit give - 将礼包给予指定玩家，此操作无视冷却时间、权限、一次性限制和所有要求。
• /kit delete - 删除一个礼包。
• /kit reset - 重置指定玩家对于某个礼包的数据（如冷却时间、领取记录）。
• /kit reload - 重载插件配置文件。

介绍

PlayerKits 2 是一个功能强大的 Minecraft 插件，允许服务器管理员创建和管理多种类型的礼包。玩家可以通过命令、权限、定时器或 GUI 菜单来领取这些礼包，为你的服务器增添丰富的奖励和互动系统。

💡功能

• 创建多种礼包：支持普通礼包、一次性礼包、每月礼包、每周礼包和每日礼包。
• 灵活的领取方式：可通过命令、定时器、权限或 GUI 菜单领取。
• 自定义 GUI 菜单：为礼包创建美观的图形用户界面。
• 强大的变量支持：使用 PlaceholderAPI 变量自定义消息和 GUI 文本。
• 礼包预览：允许玩家在领取前查看礼包内容。
• 冷却时间系统：为礼包设置独立的领取冷却时间。
• 礼包赠送：玩家可以将自己的礼包赠送给其他玩家。
• 礼包购买：通过 Vault 经济插件，设置礼包价格供玩家购买。
• 多世界支持：可限制礼包在特定世界使用。
• MySQL 支持：使用 MySQL 数据库存储玩家数据。
• 礼包升级系统：允许礼包根据条件（如权限）升级为其他礼包。
• 礼包组合：将多个礼包组合成一个礼包组。
• BungeeCord 支持：跨服同步玩家礼包数据。

🎮命令与权限

玩家命令

• /kits - 打开礼包菜单（如果已配置）。
• /kit - 领取指定的礼包。
• /kit preview - 预览指定礼包的内容。
• /kit send - 将你的一个礼包赠送给其他玩家。
• /kit buy - 购买一个礼包（如果已设置价格）。

管理员命令

• /kitadmin - 打开管理员菜单。
• /kitadmin create - 创建一个新礼包。
• /kitadmin delete - 删除一个礼包。
• /kitadmin edit - 编辑一个礼包。
• /kitadmin give - 给予玩家一个礼包。
• /kitadmin reload - 重载插件配置。
• /kitadmin reset - 重置玩家对某个礼包的冷却时间或领取状态。
• /kitadmin list - 列出所有礼包。

主要权限

• playerkits.kit. - 领取特定礼包的权限。
• playerkits.kit.preview. - 预览特定礼包的权限。
• playerkits.kit.buy. - 购买特定礼包的权限。
• playerkits.admin - 使用所有管理员命令的权限。
• playerkits.bypass.cooldown. - 绕过特定礼包冷却时间的权限。
• playerkits.bypass.onetime. - 绕过特定一次性礼包限制的权限。

🔧安装与设置

要求

• Minecraft 服务器： Spigot、Paper 或衍生服务端（1.8.x 至最新版本）。
• Java： 版本 8 或更高。
• 可选依赖：
• Vault： 用于礼包购买的经济系统。
• PlaceholderAPI： 用于在消息和 GUI 中使用变量。
• ProtocolLib： 用于某些高级 GUI 功能。

安装步骤

• 将下载的 PlayerKits2.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 首次运行后，插件会在 plugins/PlayerKits2 目录下生成配置文件。
• 编辑 config.yml 和 kits.yml 文件来配置插件和创建礼包。

创建你的第一个礼包

• 使用命令 /kitadmin create myfirstkit。
• 使用命令 /kitadmin edit myfirstkit 进入编辑模式。
• 手持物品，输入 /kitadmin additem 将物品添加到礼包。
• 输入 /kitadmin save 保存并退出编辑模式。
• 现在玩家可以使用 /kit myfirstkit 领取这个礼包了。

✨配置与自定义

配置文件

主要配置文件位于 plugins/PlayerKits2/config.yml。你可以在这里调整：

• 语言和消息。
• GUI 菜单的全局设置。
• 数据库设置（MySQL/SQLite）。
• 礼包升级和组合的设定。
• 冷却时间格式。

礼包文件

所有礼包都定义在 plugins/PlayerKits2/kits.yml 文件中。每个礼包可以配置：

• 物品： 礼包包含的物品列表。
• 类型： normal, onetime, daily, weekly, monthly。
• 冷却时间： 领取后需要等待的时间。
• 领取条件： 所需权限、世界、金钱价格等。
• 消息： 领取成功、失败等提示...