![[Banner]](https://i.imgur.com/tl2TQuw.png)
# PureKitPvP (1.3.1)
PureKitPvP 允许您快速创建带有自定义套件的套件 PvP 环境。 所有功能的快速概览：
- 复盘死亡
- 在虚空/环境伤害中获得击杀积分
- 协助积分
- 跟踪连杀、击杀、死亡以及更多统计数据
- 基于击杀、死亡和协助的等级系统
- 套件可以在游戏中创建，布局可根据每个玩家自定义
- 套件可以具有击杀物品，获得击杀时获得的物品
- 每次 Minecraft 生命周期只能选择一个套件（死亡后重置）
- 每个套件的权限
- 清洁套件 GUI（支持多个页面）
- 金色头颅（可以设置为套件物品和/或击杀物品）
- 随机战利品箱，可以设置为套件物品或击杀物品
- 可以在游戏中创建这些随机战利品箱，在 config 中更改百分比
- 查看套件使用统计数据以进行平衡
- 可以在套件中使用生物，当玩家死亡时生物会消失
- 可以创建带有装备和武器的自定义生物
- 生物 AI 仅攻击敌方玩家
- 掉入虚空时快速死亡
- 14 个特质，带有 GUI 选择
- 化妆品：投射物轨迹、击杀效果、击杀/死亡消息
- 全局 PvP 相关事件
- 可自定义的语言文件：大多数玩家可见的消息都可以更改
## 命令
所有命令可以在游戏中通过 _/purekitpvp help_ 查看。
### 管理员命令
所有管理员命令都以 /purekitpvp 开头。
* **/purekitpvp kit **
* **create** \<套件名称> \<显示颜色> \<套件图标> \<套件权限> \<击杀物品>
* 创建带有您物品栏内容的套件
* \<套件图标> / \<击杀物品> - _自动完成菜单中的所有材质名称_
* 如果您不想使用击杀物品，请使用 _air_
* **delete** \<套件名称>
* 移除一个套件
* **edit** \<套件名称>
* 在 GUI 中编辑套件的内容
* **setkillitem** \<套件名称>
* 将击杀物品设置为您手中的物品
* **/purekitpvp resetkit**
* 如果执行者具有足够的权限，则重置套件。
* **/purekitpvp createloottable** **\<名称> \ \<显示名称>**
* 创建您正在查看的胸口的战利品表
* \ - _将鼠标悬停在按右键获取随机物品的胸口上的 lore_
* \ - _将鼠标悬停在按右键获取随机物品的胸口的显示名称_
* 我建议在战利品表配置中编辑上述值，因为可以实现多行文本
* 确保遵循战利品表配置中的格式，因为 YAML 可能很挑剔
* **/purekitpvp getcustomitem \**
* 获取用于套件的自定义物品
* \ 需要战利品表名称
* \ 需要自定义生物名称
* **/purekitpvp custommob \**
* **create** \<名称> \<类型>
* 使用特定的类型创建自定义生物，可以是任何实体（怪物是官方支持的）
* **set** \<名称> \
* 将生物的属性设置为您手中的物品，或使用“child”属性；必须指定 true 或 false
* **delete** \<名称>
* 删除自定义生物
* **/purekitpvp event \**
* **start** \<事件名称>
* 您一次只能启动一个事件。 可以跳过计时器以到达事件计时器的结束。
* **stop** \<事件名称>
* 停止当前事件。
* **pause**
* 暂停全局事件循环计时器。 现有的活动事件仍然活动。 如果要停止全局事件循环，您可以禁用它在配置中的设置，或在没有任何活动事件时暂停，以防止任何事件触发。
* **/purekitpvp getkitstats**
* 将套件使用统计数据输出到控制台，以查看哪个套件最受欢迎（用于平衡）
* **/purekitpvp \**
* 重载不完全重载配置文件；与事件循环相关的任何设置都不会更新，因为事件循环是持续的。
### 玩家命令
* **/kit**
* 显示套件 GUI
![[IMG]](https://i.imgur.com/JLFvel3.png)
套件可以根据每个玩家自定义；请看视频：
Per Player Preferences 功能演示 - https://youtu.be/wVQJzBPUlQU
* **/perks**
* 显示特质 GUI，单击该槽中的一个槽以更改该槽中的特质（请参见图片）
![[IMG]](https://i.imgur.com/Yau99d1.png)
![[IMG]](https://i.imgur.com/DB81qVL.png)
* **/cosmetics**
* 弹出化妆品菜单
* 在此菜单中，可以更改击杀效果、死亡/击杀消息和投射物轨迹
* **/getkit \<套件名称>**
* 直接获取套件
* **/stats \<玩家>**
* 显示任何玩家的统计数据
* **/suicide**
* 自杀（如果启用）
* 启用此功能可以提高死亡消息的准确性
## 文件
有几个文件，大多数用于跟踪统计数据等。 **config.yml** 包含一些在此处解释的一些功能开关。
我建议不要编辑 **kits.yml**，除非您知道如何检查您的 YAML 是否有效，因为如果解析错误 YAML，文件可能会重置（不要问我为什么）。
对于 **loottables.yml**，请遵循文件中提供的格式。 裸写 lore，并且使用单引号 (例如: '&6Lootchest') 编写显示名称。
**lang.yml** 文件包含许多语言密钥，每个密钥对应于游戏中单个或多个文本实例。 默认玩家 - 即非管理员 - 可以自定义大多数玩家可见的文本。 GUI 中的物品工具提示，计分板文本，所有特质说明等。 确保遵循每个密钥的格式，因为有些是用于单行文本（例如物品的显示名称），而另一些是用于多行 lore（例如特质说明）。 重置值的方法是简单地从文件中删除它并重新加载：缺失的值将使用其默认值添加回来。 相关的击杀消息文本目前不可自定义；系统尚未为此而设计，并且我怀疑这两者能够并存。
如果您有任何问题，请通过 Discord（参见 #Support）联系我们。
## 如何创建套件
*也请参见下面的视频主题*
将您想要包含在套件中的所有物品都放入您的物品栏中，然后输入命令 /purekitpvp kit create \<名称>。 将创建带有参数的套件并自动添加到套件菜单 (/kit)。 您要么在基本命令中提供击杀物品，要么，如果您希望击杀物品是特殊物品（例如金色头颅或随机战利品箱），则使用 /purekitpvp getcustomitem 命令获取该物品，然后运行命令 /purekitpvp kit setkillitem \<套件名称> 同时拿着该物品。
套件的内容将在选择套件时显示在干净的悬停框中，它会将您物品栏中的前 3 个物品分类为武器，物品栏中的其余物品为物品，盔甲为盔甲，以及空手为空手。 如果套件没有盔甲，它会告诉您。 可以在 kits.yml 中设置 lore。
可以在物品栏中找到的基本药水也被翻译了，尽管它们不显示效力和长度，这是由于这些物品在 spigot 中的工作方式。 但是，使用命令创建的自定义药水可以完美地显示效力和长度，因此如果您处理药水时，我建议您使用命令创建自己的药水。
## 特质
可以使用 /perks 弹出特质菜单，也可以通过 /kit 命令弹出。 这些特质只能在玩家尚未选择套件时更改。 您可以主动选择总共 5 个特质。 特质的激活基于它们的作用，有些在击杀时激活，有些在战斗中激活等。 在配置中提供了一些配置，但由于大多数特质都相当独特，因此这些特质不像套件和战利品表那样可定制。
当前有大约 13 个特质可供选择。 建议可以提交（参见联系方式）。
## 如何创建战利品表
*也请参见下面的视频主题*
将您想要包含在战利品表中的所有物品都放入胸口中。 每个物品的概率将默认为 0.1。 您可以在 loottables.yml 文件中更改此设置，但如果您希望概率为 0.2，则只需在胸口中放入两个相同的物品。 完成后，查看胸口并运行命令 /purekitpvp createloottable \<名称> \ \<显示名称>。 lore 和显示名称很重要，因为这个战利品表将附加到物品上。 现在，您可以在 loottables.yml 文件中更改每个物品的概率值。 您还可以更改 lore 和显示名称以获得多行文本。 如果将 guaranteed 设置为 true，则插件将循环遍历战利品箱中的所有物品，直到提供确切的那个数量。 在重新加载插件之前（或备份它），请检查您的 YAML 是否有效，否则文件可能会重置（！）。 要获取带有战利品表的物品，请运行命令 /purekitpvp getcustomitem random_chest \<战利品表名称>（将自动完成）。 使用此物品在您的物品栏中，您可以使用它在套件中，或者将其设置为击杀物品。
## 如何创建自定义生物
*也请参见下面的视频主题*
使用 /purekitpvp custommob create \<名称> \<类型> 创建您的生物。 所有实体类型都是可能的，但仅支持怪物以更好地工作。 创建生物后，您可以使用 /purekitpvp custommob set 设置属性。 您可以使用与盔甲件相关的属性（例如胸甲或护腿）在生物上装备装备。 生物还可以使用属性 child（如果对此生物可能）设置为 baby（真或假）。 简而言之，可以使用 /purekitpvp getcustomitem custom_mob_egg /<名称> 获取生成自定义生物的 spawn egg。 这将为您提供一个 spawn egg，可用于套件、战利品表等。
## 视频
- 创建套件和战利品表。 视频中的某些命令可能与游戏中略有不同。
- 自定义生物以及如何使用它们
- 每个玩家的套件首选项功能演示
## 已知问题与支持
问题可以在 [https://github.com/LifelessNerd/PureKitPvP/issues](https://github.com/LifelessNerd/PureKitPvP/issues) 中找到。
我很确定会出现问题，但是查找所有问题需要大量的测试时间。 请提交任何问题！
如果您有任何问题，请在 [https://bit.ly/PureKitPvPSpigotMC](https://bit.ly/PureKitPvPSpigotMC) 中创建一个消息，在 GitHub 上添加它们 [https://github.com/LifelessNerd/PureKitPvP](https://github.com/LifelessNerd/PureKitPvP)，或通过 [https://twitter.com/lukadevrij](https://twitter.com/lukadevrij) 的 Twitter 私信联系我。 为了获得直接支持，您还可以加入支持 [Discord 服务器](https://discord.com/invite/8n65jSEkVf)。