大多数装备包插件会给所有玩家提供相同的配置。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。
| 玩家命令 | 玩家可以运行的所有命令 |
| 管理员命令 | Kit 房间、公共 Kit、清理、导出、迁移 |
| 权限 | 所有权限节点,以及 LuckPerms 配方 |
| config.yml 参考 | 所有设置及其功能说明 |
| 存储与数据库 | SQLite、MySQL、PostgreSQL、Redis |
| 升级指南 | 更新前需要检查的事项 |
| 故障排除 | 解决用户最常遇到的问题 |
| 常见问题解答 | 常见问题的简短回答 |
| Java API | 供插件开发者使用 |
支持
在 Discord 中提问。请在 问题追踪器 上报告 Bug。
每个提交的开发构建版本都托管在 Jenkins 上。这些版本已编译但未进行测试。在正式服务器上运行前,请务必备份你的 Kit 数据。
开源
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 autosetupfills 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
/rgto 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/copykitfor 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 autosetupand skip straight to playing. - Give out permissions.
perplayerkit.usefor players,perplayerkit.stafffor moderators,perplayerkit.adminfor you.
About five minutes. Requires Paper or Spigot 1.19+ and Java 17+.
Documentation
Everything is at perplayerkit.com.
| Player commands | Every command a player can run |
| Admin commands | Kit room, public kits, purge, export, migrate |
| Permissions | Every node, plus LuckPerms recipes |
| config.yml reference | Every setting and what it does |
| Storage and databases | SQLite, MySQL, PostgreSQL, Redis |
| Upgrading | What to check before updating |
| Troubleshooting | Fixes for the problems people hit most |
| FAQ | Short answers to common questions |
| Java API | For plugin developers |
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.
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PerPlayerKit
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
1.8.0
升级指南:
破坏性更新(Breaking)
- 配置 v3。现有的 v1 和 v2 配置文件会自动备份并迁移。除非另有说明,以下所有更改均已为您转换。
- 面向玩家的消息已从
config.yml移至lang/<code>.yml。自定义消息会保留下来。 - 消息占位符
%player%和%kitname%重命名为{player}和{kitname}。现有消息已被重写。 max-kits重命名为kits.max-slots。disabled-command-worlds和 rekit-on-kill 的世界列表已替换为locations规则。- 模组房间材质和导入过滤器已替换为
item-filter。 - 世界名称和存储类型值现在不区分大小写。请检查之前依赖精确大小写的条目。
perplayerkit.admin现包含模组房间编辑和员工检查功能。- 记住的模组选择存储在数据库中。升级后加载一次模组以保存您的选择。
新增(Added)
- PostgreSQL 存储后端。
- 14 种内置语言。
- WorldGuard 支持(可选)。
- 可配置的模组数量限制(1 到 99),带有分页的
/kit菜单以及/k10../k99、/ec10../ec99。 - 最多 99 页模组房间页面,带有分组页面导航。
locations规则:允许或拒绝每个世界或 WorldGuard 区域的任何功能。- 针对 rekit-on-kill 和 rekit-on-respawn 的按世界和按区域公共模组。
rekit-on-respawn延迟(以刻为单位)。item-filter规则:不可破坏物品、自定义属性、物品标志、附魔等级上限、互斥附魔、药水等级和持续时间上限、按材质覆盖。适用于潜影盒、容器、 bundles 和附魔书内部。- 记住的模组选择在重新连接、重启和服务器切换之间持久化。可选
restore-enderchest。 - 内置起始模组房间页面和公共模组。
/perplayerkit autosetup用于填充空的模组房间和公共模组。提供add-kits和reset confirm变体。/perplayerkit location [feature]用于检查适用的世界和区域规则。/sharekit <slot> <player>和/shareec <slot> <player>,配合/shareaccept和/sharedecline。/transferkits <player>用于将所有模组和末影箱复制到另一个玩家。/deleteec <slot>。/purgeitem用于从所有存储的模组中移除一种物品类型。/kitdata export和/kitdata import用于.ppk文件。- 模组加载广播中的
{kitname}占位符。 - 权限
perplayerkit.staff、perplayerkit.editkitroom、perplayerkit.kitnotify、perplayerkit.deleteenderchest。 - 文档网站位于
更改(Changed)
- 更新检查异步运行,缓存一小时,失败后一分钟重试。
- SQLite 备份使用
VACUUM INTO进行一致快照,而不是复制活动文件。 - 报告存储故障以便队列保存可以重试。
- 拥有未加载或失败模组数据的玩家会收到消息,而不是空模组。
- 物品过滤现在适用于接受的分享和传输。
- 清除个人模组编辑器并关闭它时会删除该模组。
- 图标材质未知的公共模组会被跳过,而不是阻止插件启用。
- 失败的 WorldGuard 查找会阻止操作,而不是回退到全服模组。
- 聊天通过 Paper 的 Adventure API 发送(如果可用)。
- Redis 错误作为带有堆栈跟踪的错误记录。
- 依赖项更新:Adventure 4.26, Jedis 6.2, HikariCP 6.3.3, PostgreSQL 驱动 42.7.13, SQLite 3.53, bStats 3.2, okhttp2 替换为 okhttp3。
修复(Fixed)
- 受限物品可以在潜影盒内绕过 regear 过滤器。
- 加载模组或 regear 后出现的鬼手副手物品。
- 对离线玩家使用
/inspectkit和/inspectec时的卡顿和失败。 /inspectec打开的是检查者的末影箱而不是目标的末影箱。- 菜单重绘期间丢失的模组编辑器更改。
- 菜单中的物品名称格式化。
/deletekit和/swapkit接受了超出范围的槽位。- KitsX 导入在报告缺失文件后继续。
- 启动时 SQLite 的 HikariCP
idleTimeout警告。 - 插件重新启用时在主线加载模组。
- 玩家退出时的重复保存。
- 断开连接或第二次重生时未取消待处理的重生恢复。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧