![[Banner]](https://i.imgur.com/tl2TQuw.png)
PureKitPvP (1.3.1)
PureKitPvP 让你能够快速创建一个 Kit PvP 环境,并使用自定义的 Kit。以下是所有功能的快速概览:
- 死亡回顾 (Death Recaps)
- 虚空/环境伤害击杀时显示击杀者信息
- 助攻积分
- 追踪连杀、击杀数、死亡数以及大量其他统计数据
- 基于击杀、死亡和助攻的经验等级系统
- 可在游戏内创建 Kit,布局可根据每个玩家自定义
- Kit 可以设置“击杀掉落物”,即击杀后获得的物品
- 每次 Minecraft 生命周期只能选择一个 Kit(死亡后重置)
- 每个 Kit 拥有独立的权限控制
- 简洁的 Kit GUI(支持多页浏览)
- 金色头颅 (Golden Heads)(可设置为 Kit 物品或/以及击杀掉落物)
- 随机战利品箱子,可设置为 Kit 物品或击杀掉落物
- 在游戏内创建这些随机战利品箱子,并在配置文件中更改概率
- 查看 Kit 使用统计数据以进行平衡性调整
- 生物可作为 Kit 的一部分,当玩家死亡时它们会消失
- 可以使用装备和武器创建自定义生物
- 生物 AI 仅针对敌对玩家
- 落入虚空时会迅速死亡
- 14 种增益效果 (Perks),通过 GUI 进行选择
- 外观特效:弹道轨迹、击杀特效、击杀/死亡消息
- 全局 PvP 相关事件
- 可自定义的语言文件:大多数玩家可见的消息均可修改
命令
所有命令均可在游戏内通过 /purekitpvp help 查看。
管理员命令
所有管理员命令均以 /purekitpvp 开头。
-
/purekitpvp kit <create/delete/edit/setkillitem>
- create <kitName> <displayColor> <kitIcon> <kitPermission> <killItem>
- 根据你背包中的内容创建一个 Kit
- <kitIcon> / <killItem> - 自动补全菜单中的所有材质名称
- delete <kitName>
- edit <kitName>
- setkillitem <kitName>
-
/purekitpvp resetkit
-
/purekitpvp createloottable <name> <lore> <displayName>
- 为你正看向的箱子创建一个战利品表
- <lore> - 用于右键点击以获取随机物品的箱子上显示的文本描述 (Lore)
- <displayName> - 用于右键点击以获取随机物品的箱子上显示的名称 (Display Name)
- 建议在这些值的配置文件中进行编辑,因为那里支持多行文本
- 请确保遵循 loottables 配置文件中的格式,因为 YAML 格式可能相当挑剔
-
/purekitpvp getcustomitem <golden_head/random_chest/custom_mob_egg>
- 获取可用于 Kit 的自定义物品
- <random_chest> 需要一个战利品表名称
- <custom_mob> 需要一个自定义生物名称
-
/purekitpvp custommob <create/set/delete>
- create <name> <type>
- 创建具有特定类型的自定义生物,可以是任何实体(官方支持的生物均可)
- set <name> <mainhand/offhand/boots/leggings/chestplate/helmet/child>
- 将手中物品设置为生物的某个属性,或者对于 child 属性;必须指定 true 或 false
- delete <name>
-
/purekitpvp event <start/stop/pause>
- start <eventName>
- 你一次只能启动一个事件。计时器可以跳过直到事件计时结束。
- stop <eventName>
- pause
- 暂停全局事件循环计时器。已经激活的事件保持激活状态。如果你想停止全局事件循环,你可以在配置文件中禁用它,或者在没有活动事件时暂停以防止任何事件触发。
-
/purekitpvp getkitstats
- 输出 Kit 使用统计数据,以查看哪个 Kit 最受欢迎(用于平衡性调整)
-
/purekitpvp <help/info/reload>
- Reload 不会完全重新加载配置文件;与事件循环相关的设置不会更新,因为事件循环是持续运行的。
玩家命令
-
/kit
- 显示 Kit GUI
Kit 可以根据每个玩家进行自定义;请参阅视频:
Per Player Preferences feature showcase -
-
/perks
- 显示增益效果 (Perk) GUI,点击某个槽位以更改该槽位的增益效果(参见图片)
![[IMG]](https://i.imgur.com/DB81qVL.png)
-
/cosmetics
- 打开外观菜单
- 在此菜单中,可以更改击杀特效、死亡/击杀消息和弹道轨迹
-
/getkit <kitName>
-
/stats <player>
-
/suicide
- 自杀(如果已启用)
- 启用此功能可提高死亡消息的准确性
文件说明
有几个文件,其中大部分用于内部跟踪统计数据等。config.yml 包含一些功能开关,并在那里进行了说明。
除非你知道如何检查你的 YAML 是否有效,否则我建议不要编辑 kits.yml,因为如果解析了错误的 YAML,文件可能会重置(别问我为什么)。
对于 loottables.yml,请遵循文件中提供的示例格式。编写 lore 时不加引号,而 displayName 使用单引号(例如:'&6Lootchest')。
lang.yml 文件包含大量的语言键,每个键对应游戏中的一处或多处文本。大多数对默认玩家(即非管理员)可见的文本都是可自定义的。GUI 中的物品提示框文本、记分板文本、所有增益效果的解释等等。请务必遵循每个键的单独格式,因为有些是为单行文本设计的(如物品的显示名称),而另一些则是为多行文本描述的(如增益效果的解释)。重置值就像从文件中删除它并重新加载一样简单:缺失的值总是会用其默认值添加回来。目前不可自定义与击杀消息相关的文本;该系统并非为此设计,我也怀疑这两个系统能否并存。
如果您有任何问题,请通过 Discord 联系(见 #Support)。
如何创建 Kit
另请参阅下面涵盖此主题的视频。
将你想要放入套装的所有物品放在你的背包中,然后输入命令 /purekitpvp kit create \<name>。系统将自动创建一个包含这些参数的套装,并将其添加到套装菜单(/kit)中。你可以在基础命令中提供一个击杀奖励物品;如果你希望击杀奖励是一个特殊物品(例如金色头颅或随机战利品箱子),请使用 /purekitpvp getcustomitem 命令获取该物品,并在手持该物品的情况下运行命令 /purekitpvp kit setkillitem \<kitName>。
在选择套装时,套装内容会以一个简洁的悬浮提示框显示,其中会将你快捷栏的前三个物品分类为武器,背包剩余部分归类为物品,护甲归类为护甲,副手栏归类为副手。如果套装没有配备护甲,也会相应提示。你可以在 kits.yml 中设置一段描述文本(lore)。
虽然背包中能找到的基础药水也会被翻译识别,但由于 Spigot 内部机制的原因,它们不会显示药水的强度与持续时间。然而,通过命令创建的自定义药水则能完美工作并正确显示强度与持续时间,因此建议在使用药水时通过命令自行创建。
特性 (Perks)
可以使用 /perks 或通过 /kit 命令打开特性菜单。这些特性仅在玩家尚未选择套装时方可更改。你可以同时激活最多 5 个特性。特性的激活取决于其功能类型,有些在击杀时触发,有些则在战斗过程中触发等。配置文件中提供了一些默认配置,但由于大多数特性具有独特性,它们的可定制程度不如套装和战利品表那样高。
目前大约有 13 种特性可供选择。欢迎提出建议(见下方联系方式)。
如何创建战利品表
另请参阅下方涵盖此主题的视频。
放置一个箱子,并将所有你想放入战利品表的物品放入箱中。每个物品的掉落概率默认为 0.1。你可以在 loottables.yml 文件中修改此值;或者,如果你希望概率为 0.2,只需在箱子中放入两个相同的物品即可。完成后,看向箱子并运行命令 /purekitpvp createloottable \<name> \<lore> \<displayName>。描述文本(lore)和显示名称(displayname)对于绑定此战利品表的物品至关重要。现在你可以在 loottables.yml 文件中调整每个物品的概率值。你也可以修改描述文本和显示名称以实现多行文本效果。如果将 guaranteed 设置为 true,插件会循环遍历战利品箱中的所有物品,直到确切给出指定数量的物品为止。在重载插件之前(或备份文件之前),请检查你的 YAML 文件格式是否有效,否则文件可能会重置(!)。要获取带有战利品表的物品,请运行命令 /purekitpvp getcustomitem random_chest \<loottable>(支持自动补全)。将该物品放入背包后,你就可以将其用于套装中,或设置为击杀奖励物品。
如何创建自定义生物
另请参阅下方涵盖此主题的视频。
使用 /purekitpvp custommob create \<name> \<type> 来创建你的生物。所有实体类型均可使用,但官方仅正式支持怪物类型以确保持久稳定运行。创建好生物后,你可以使用 /purekitpvp custommob set \<property> 来设置属性。你可以使用与护甲部件关联的属性为生物装备物品——例如 chestplace(胸甲)或 leggings(护腿)。如果该生物允许幼体形态,你还可以使用 child 属性,后接 true 或 false 将其设为幼体。生成生物或在套装中使用它非常简单:使用 /purekitpvp getcustomitem custom_mob_egg /<name> 获取生成自定义生物的刷怪蛋。这将给你一个刷怪蛋,可用于套装、战利品表等场景。
视频教程
已知问题与支持
问题反馈请参见 此处。
我确信肯定会出现一些问题,但发现所有问题需要大量的测试时间。请务必提交任何遇到的问题!
如果遇到任何问题,请在 Spigot 上留言,在 GitHub 上添加 issue,这里,或在 Twitter 上私信我。如需直接支持,你也可以加入支持 Discord 服务器。
![[Banner]](https://i.imgur.com/tl2TQuw.png)
PureKitPvP (1.3.1)
PureKitPvP lets you create a kit pvp environment quickly, with your own custom kits. A quick overview of all features:
- Death Recaps
- Kill Credit on void/environmental damage
- Assist credit
- Tracks Killstreaks, Kills, Deaths and a lot more stats
- Level system based on kills, deaths and assists
- Kits can be made in-game, layout customizable per player
- Kits can have a kill item, an item that will be aquired on kill
- Pick only one kit per minecraft life (reset after death)
- Per kit permissions
- Clean Kit GUI (multiple pages support)
- Golden Heads (can be set as kit items or/and as kill items)
- Random Loot Chests that can be set as kit item or as kill item
- Create these random loot chests ingame, change percentages in config
- See Kit usage stats for balancing
- Mobs can be used in kits, they despawn when the player has died
- Custom mobs can be created with gear and weapons
- Mob AI only targets enemy players
- Quickly die when falling in the void
- 14 Perks, with GUI selection
- Cosmetics: Projectile Trails, Kill Effect, Kill/Death Message
- Global PvP-related Events
- Customizable language file: most player-visible messages can be changed
Commands
All commands can be seen in-game via /purekitpvp help.
Admin commands
All admin commands are preceded with /purekitpvp.
-
/purekitpvp kit <create/delete/edit/setkillitem>
- create <kitName> <displayColor> <kitIcon> <kitPermission> <killItem>
- Create a kit with the contents of your inventory
- <kitIcon> / <killItem> - All material names within the autocomplete menu
- Use air if you don't want a kill item
- delete <kitName>
- edit <kitName>
- Edit a kit's contents in a GUI
- setkillitem <kitName>
- Set the killitem to the item in your hand
-
/purekitpvp resetkit
- Resets kit, if the executor has the sufficient permission.
-
/purekitpvp createloottable <name> <lore> <displayName>
- Create a loottable of the chest you are looking at
- <lore> - The lore on the item chest that will be right clicked for the random items
- <displayName> -The displayname on the item chest that will be right clicked for the random items
- I suggest editing the above values in the loottables config, because multi-line is possible there
- Make sure to follow the format in the loottables config, as YAML can be quite finicky
-
/purekitpvp getcustomitem <golden_head/random_chest/custom_mob_egg>
- Get the custom item to use in a kit
- <random_chest> requires a loottable name
- <custom_mob> requires a custom mob name
-
/purekitpvp custommob <create/set/delete>
- create <name> <type>
- Creates custom mob with a certain type, can be any entity (mobs are officially supported)
- set <name> <mainhand/offhand/boots/leggings/chestplate/helmet/child>
- Sets a property of a mob to the item in hand, or with the child property; true or false must be specified
- delete <name>
-
/purekitpvp event <start/stop/pause>
- start <eventName>
- You may only start one event at a time. Timer can be skipped to the end of the event timer.
- stop <eventName>
- pause
- Pauses the global event loop timer. Events already active stay active. If you want the global event loop to stop, you may disable it in the config, or pause when no event is active to keep any events from triggering.
-
/purekitpvp getkitstats
- Outputs kit usage stats to see what kit is most popular (for balancing)
-
/purekitpvp <help/info/reload>
- Reload does not fully reload the config file; any settings pertaining to the event loop are not updated, because the event loop is continuous.
Player commands
-
/kit
- Show Kit GUI
Kits can be customized per player; see video:
Per Player Preferences feature showcase -
-
/perks
- Show Perk GUI, click on a slot to change the perk in that slot (see image)
![[IMG]](https://i.imgur.com/DB81qVL.png)
-
/cosmetics
- Brings up cosmetics menu
- In this menu, the kill effect, death/kill message and projectile trail can be changed
-
/getkit <kitName>
-
/stats <player>
-
/suicide
- Commit suicide (if enabled)
- Enabling this improves accuracy of death messages
Files
There are several files, most are used internally to track stats and such. The config.yml has some feature toggles that are explained there.
I would recommend not editing the kits.yml unless you know how to check if your YAML is valid, because the file may reset when wrong YAML is parsed (don't ask me why).
For the loottables.yml, follow the format that is provided in the example in the file. Write lore bare, and the displayname with single apostrophes (like so: '&6Lootchest').
The lang.yml file has a plethora of language keys, each of which corresponds with a single or more instances of text in-game. Most text that is visible to a default player - that is a non-admin - is customizable. Item tooltips in GUI's, scoreboard text, all perk explanations et cetera. Be sure to follow the format of each key individually, since some are made for single-line text (such as a display name of an item), and others for multiple lines of lore (think perk explanations). Resetting a value is as easy as deleting it from the file and reloading: missing values are always added back in with their default values. Text that pertains to the kill messages is currently not customizable; the system is not made for this and I question whether the two systems can live side-by-side.
If you have any questions please reach out via Discord (see #Support).
How to create a kit
Also see the video that covers this topic below.
Have all the items you want to be in your kit in your inventory, and type the command /purekitpvp kit create <name> . A kit will be created with the arguments and automatically added to the kit menu (/kit). You either provide a kill item in the base command, or, if you want the kill item to be a special item (i.e. a golden head or a random loot chest), use the /purekitpvp getcustomitem command to get that item, and run the command /purekitpvp kit setkillitem <kitName> while holding that item.
The contents of the kit will be shown in a clean hoverbox when choosing the kit, which will categorize the first 3 items in your hotbar as weapons, the rest of the inventory as items, the armor as armor and the offhand as offhand. If the kit has no armor, it will tell you aswell. A piece of lore can be set in the kits.yml.
Basic potions that can be found in the inventory are translated as well, although they do not show their potency and lenght, due to how these items work in spigot. Custom potions created with commands however do work perfectly and show potency and lenght, so I recommend to create your own potions with commands when working with them.
Perks
The perks menu can be brought up using /perks, or via the /kit command. These perks can only be changed when the player has not yet chosen a kit. You can have a total of 5 perks actively selected. Perks are activated based on what they do, some active on kill, some during combat etc. Some configuration is provided in the config, but these perks are not as customizable as the kits and loot tables, due to most perks being quite unique.
There are currently around 13 perks to choose from. Suggestions can be made (see contact info below).
How to create a loot table
Also see the video that covers this topic below.
Place a chest and put all items you want to be in your loottable in the chest. The chance of each item will be 0.1 by default. You can change this in the loottables.yml file, but if you want you can just put 2 identical items in the chest if you want the chance to be 0.2. When finished, look at the chest and run the command /purekitpvp createloottable <name> <lore> <displayName>. The lore and displayname are important for the item this loot table with be attached to. Now you may change the chance values of each item in the loottables.yml file. You may also change the lore and displayname to get multi-line text. If guaranteed is set to a true, the plugin will keep cycling through all item of the lootchest until exactly that amount is given. Check if your YAML is valid before reloading the plugin (or back it up), otherwise the file may reset (!). To get the item with the loot table, run the command /purekitpvp getcustomitem random_chest <loottable> (will auto-complete). With this item in your inventory you can use it in a kit, or set it as kill item.
How to create a custom mob
Also see the video that covers this topic below.
Use /purekitpvp custommob create <name> <type> to create your mob . All entitytypes are possible, but only monsters are officially supported to work well. After you have created your mob, you can set properties using /purekitpvp custommob set <property>. You can put equipment on the mob using the property associated with the armor piece - so chestplace or leggings for example. The mob can also be made a baby (if possible for that mob), using the property child, followed by either true or false. Spawning the mob or using it in a kit is simple. Get the spawn egg that spawns the custom mob with /purekitpvp getcustomitem custom_mob_egg /<name>. This will give you a spawn egg, that can be used in kits, loottables and more.
Videos
-
Create Kits and Loot tables. Some commands may be slightly different than in the video.
-
Custom Mobs and how to use them
-
Per Player Kit Preferences feature showcase
Known issues & Support
Issues can be found here.
I am sure there will be issues, but finding all of them takes a lot of testing time. Please submit any problems!
If there are any problems, create a message on Spigot, add them on GitHub, here, or DM me on Twitter. For direct support you may also join the support Discord server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧