PerPlayerKit
每位玩家都能打造属于自己的 PvP 装备包
文档 · Discord · 源码
大多数装备包插件会给所有玩家提供相同的配置。PerPlayerKit 为每位玩家提供九个装备包槽位和九个末影箱槽位,这些槽位的内容源自你通过 装备包房间(kit room)放入的、经你批准的物品。玩家只需一次性整理好装备包,然后在热身阶段使用 /k1 加载即可立即投入战斗。
它是许多水晶、药水、UHC 和剑术练习服务器所使用的装备包系统,支持 Paper 或 Spigot 1.19+。
服务器为何选择它
- 玩家拥有自己的装备包。 默认情况下,每位玩家拥有九个装备包和九个末影箱装备包,上限可扩展至 99 个。数据保存至数据库,因此重启后不会丢失,且可在你的服务器网络中跟随玩家跨服同步。
- 你掌控全局。 装备包房间是获取物品的唯一来源。可选的物品过滤功能可限制附魔等级、药水等级与持续时间,并阻止不可破坏物品、自定义属性及非法 NBT 数据的使用。
- 一条命令即可上手。
/perplayerkit autosetup 会自动填充装备包房间以及九个公共装备包,内置现成的水晶、战锤、下界合金、药水、UHC、剑、斧、自由混战(FFA)和矿车配置。
- 专为战斗设计。 重生时自动重新装备,每次击杀敌人后自动重新装备,并通过
/rg 从已加载的装备包中补充珍珠、水晶和药水,无需打开菜单。
- 无绑定风险。 基于 AGPL-3.0 协议免费开源,支持从 KitsX 导入,并提供跨服务器的装备包数据导出与导入功能。
功能特性
装备包与末影箱装备包
玩家可通过 /kit 打开界面,从装备包房间选取物品,整理包含盔甲和副手在内的完整背包,关闭编辑器即可保存。使用 /k1 至 /k9 可即时加载对应的装备包;/ec1 至 /ec9 则用于加载末影箱装备包。支持切换槽位、删除槽位,并且可在每次加载时选择性地恢复生命值、饱食度、饱和度或清除状态效果。
公共装备包
服务器范围内预设的公共装备包,任何玩家均可通过 /publickit 加载。在配置文件中声明它们,手持你想要的物品内容,然后运行 /savepublickit <id> 即可保存。
自动重新装备
在重生时将最后加载的套装归还,支持配置延迟时间。开启“击杀后重新套装”功能可在每次击杀后立即为击杀者重新装备。两种触发方式均可改为按世界或 WorldGuard 区域选择公共套装,例如下界竞技场发放水晶套装,而剑术竞技场则发放剑类套装。
重新装备
/rg 和 /regear 会从玩家已加载的装备包中补充白名单物品。可以将其作为即时指令运行,或发放一个装填好物品的界伏盒。伤害计时器、冷却时间和鞘翅检查机制可防止其在连击过程中被滥用。
共享与转移
/sharekit <槽位> <玩家> 发送一个预设套装。玩家在聊天栏中点击 [接受] 即可领取。
/sharekit <槽位> 会生成一个分享代码,任何人在 15 分钟内都可以通过 /copykit 使用该代码来兑换。
/transferkits <玩家> 将所有预设套装复制到另一个账号。
物品过滤与反作弊
默认关闭,在配置文件中启用一个块。限制套装仅限套装房间物品,按附魔限制附魔等级,拒绝超高等级或不兼容的附魔,限制药水效果等级和持续时间,并阻止不可破坏的物品和自定义属性修改器。规则在加载、保存、导入和重新装备时适用,且每个材料覆盖允许胸甲通过保护 V 级,而其他所有项目保持在原版限制内。潜影盒和包裹递归检查。
工具类命令
/inspectkit <玩家> 和 /inspectec <玩家> 可以查看任意玩家的装备箱。当有物品漏网时,/purgeitem 会删除所有存储装备箱(共 99 个槽位)中该物品的所有副本。
存储
内置 SQLite 支持。对于需要在服务器间共享套件的服务器网络,可选择 MySQL、MariaDB、PostgreSQL 或 Redis。之后可通过 /perplayerkit migrate <from> <to> 命令切换数据库。支持将套件房间、公共套件或玩家数据导出为可移植的 .ppk 文件,并支持从这些文件中导入。
其他所有内容
- 菜单强调色和填充玻璃均可自定义,标题支持 MiniMessage。
- 每条消息均位于语言文件中。内置十四种语言:英语、中文、西班牙语、葡萄牙语、法语、乌克兰语、丹麦语、意大利语、波兰语、罗马尼亚语、荷兰语、德语、瑞典语和芬兰语。
- 为每项功能提供按世界和按区域的规则,并可选支持 WorldGuard。
- 消息中支持 PlaceholderAPI 占位符。
- 支持音效、加入消息和定时广播。
- 提供一个小型 Java API,用于列出公共工具箱并将其中一个应用至玩家。
快速上手
- 安装它。将 jar 文件放入
plugins/ 目录,重启服务器,如果不想使用 SQLite,请选择其他数据库。
- 配置 Kit 房间。或者运行
/perplayerkit autosetup 并直接开始游戏。
- 分配权限。
perplayerkit.use 用于玩家,perplayerkit.staff 用于管理员,perplayerkit.admin 用于你。
大约需要五分钟。需要 Paper 或 Spigot 1.19+ 和 Java 17+。
文档
所有内容均在 perplayerkit.com。
支持
在 Discord 中提问。请在 问题追踪器 上报告 Bug。
每个提交的开发构建版本都托管在 Jenkins 上。这些版本已编译但未进行测试。在正式服务器上运行前,请务必备份你的 Kit 数据。
开源
PerPlayerKit 采用 AGPL-3.0 许可证授权。源代码位于 GitHub。
Most kit plugins hand everyone the same loadout. PerPlayerKit gives every player nine kit slots and nine enderchest slots of their own, built from a kit room you stock with the items you approve. Players arrange their kit once, then load it with /k1 mid-warmup and get straight back to fighting.
It is the kit system behind many crystal, pot, UHC, and sword practice servers, and it runs on Paper or Spigot 1.19+.
Why servers pick it
- Players own their kits. Nine kits and nine enderchest kits per player by default, up to 99. Saved to a database, so they survive restarts and follow the player across your network.
- You keep control. The kit room is the only source of items. Optional item filtering caps enchantment levels, potion levels and durations, and blocks unbreakable items, custom attributes, and illegal NBT.
- Playable in one command.
/perplayerkit autosetup fills the kit room and nine public kits with a ready-made crystal, mace, netherite, pot, UHC, sword, axe, FFA, and cart setup.
- Built for fights. Rekit on respawn, rekit the killer after every kill, and
/rg to restock pearls, crystals, and potions from the loaded kit without opening a menu.
- No lock-in. Free, open source under AGPL-3.0, with an importer for KitsX and export/import of all kit data between servers.
Features
Kits and enderchest kits
Players open /kit, take items from the kit room, arrange a full inventory including armor and off-hand, and close the editor to save. /k1 through /k9 load kits instantly. /ec1 through /ec9 do the same for enderchest kits. Swap slots, delete slots, and optionally heal, feed, saturate, or clear effects on every load.
Public kits
Server-wide preset kits anyone can load from /publickit. Declare them in config, hold the inventory you want, and run /savepublickit <id>.
Automatic rekit
Give the last loaded kit back on respawn, with a configurable delay. Turn on rekit-on-kill to regear the killer instantly after every kill. Either trigger can instead pick a public kit by world, or by WorldGuard region, so the Nether arena hands out crystal kits and the sword arena hands out sword kits.
Regear
/rg and /regear restock whitelisted items from the player's loaded kit. Run them as instant commands or hand out a regear shulker box. Damage timers, cooldowns, and an elytra check stop it being abused mid-combo.
Sharing and transfers
/sharekit <slot> <player> sends a kit. They click [ACCEPT] in chat.
/sharekit <slot> prints a share code anyone can redeem with /copykit for 15 minutes.
/transferkits <player> copies every kit to a new account.
Item filtering and anti-exploit
Off by default, on in one block of config. Limit kits to kit room items only, cap enchantment levels per enchantment, reject over-levelled or incompatible enchantments, cap potion effect level and duration, and block unbreakable items and custom attribute modifiers. Rules apply on load, on save, on import, and on regear, and per-material overrides let Protection V through on chestplates while everything else stays at vanilla limits. Shulkers and bundles are checked recursively.
Staff tools
/inspectkit <player> and /inspectec <player> open any player's kits. /purgeitem deletes every copy of an item from every stored kit, across all 99 slots, when something slips through.
Storage
SQLite out of the box. MySQL, MariaDB, PostgreSQL, or Redis for networks that share kits between servers. Switch later with /perplayerkit migrate <from> <to>. Export and import kit rooms, public kits, or player data as portable .ppk files.
Everything else
- Menu accent color and filler glass are configurable, and titles accept MiniMessage.
- Every message lives in a language file. Fourteen languages ship bundled: English, Chinese, Spanish, Portuguese, French, Ukrainian, Danish, Italian, Polish, Romanian, Dutch, German, Swedish, and Finnish.
- Per-world and per-region rules for every feature, with optional WorldGuard support.
- PlaceholderAPI placeholders in messages.
- Sounds, join messages, and scheduled broadcasts.
- A small Java API for listing public kits and applying one to a player.
Get started
- Install it. Drop the jar in
plugins/, restart, pick a database if you are not happy with SQLite.
- Stock the kit room. Or run
/perplayerkit autosetup and skip straight to playing.
- Give out permissions.
perplayerkit.use for players, perplayerkit.staff for moderators, perplayerkit.admin for you.
About five minutes. Requires Paper or Spigot 1.19+ and Java 17+.
Documentation
Everything is at perplayerkit.com.
Support
Ask in the Discord. Report bugs on the issue tracker.
Dev builds of every commit are on Jenkins. They are compiled, not tested. Back up your kit data before running one on a live server.
Open source
PerPlayerKit is licensed under the AGPL-3.0. The code is on GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧