注意:新更新通常包含有助于改善体验的重要补丁
CombatKeepInventory 是一款轻量级的战斗标记与背包保护插件,适用于基于 Bukkit 的 Minecraft 服务器。
它改变了 keepInventory 在 PvP 死亡时的行为:当玩家因普通 PvE 或环境因素死亡时,可以保留其背包物品;而当被其他玩家击杀时,则会掉落背包物品。
CombatKeepInventory 专为生存服、SMP、PvP 以及网络服设计,旨在提供对死亡和背包行为的更精细控制,同时不替换 Minecraft 原有的死亡系统。

功能特性
- PvP 战斗标记
- 可配置的战斗持续时间
- 玩家击杀时的背包掉落
- PvE/环境伤害下的背包保护
- 可与原版 keepInventory 游戏规则配合使用
- 可选的 WorldGuard 集成
- 战斗状态下的登出处理
- 权限绕过支持
- 禁用世界支持
- 可自定义消息
- 重载与信息命令
- 供集成的核心 API
- 平台检测与能力信息
工作原理
当玩家进入战斗状态时,CombatKeepInventory 会创建战斗会话并追踪相关的战斗状态。
如果玩家被其他玩家击杀,即使启用了 keepInventory,插件也可以强制掉落背包物品。
由怪物、环境或其他非玩家因素导致的死亡,将继续遵循配置的背包策略。
兼容性
- Bukkit
- Spigot
- Paper
- Purpur
- 使用 Bukkit API 的 Java Edition 服务器
该插件旨在避免不必要的 NMS 依赖,并在可能的情况下使用 Bukkit/Paper API。
要求
- Java 17+
- 兼容 Bukkit 的服务器
- 推荐使用 Paper
可选集成
- WorldGuard
命令
/cki reload /cki info /cki pvp /cki debug *1.2.5
权限
combatkeepinventory.bypass combatkeepinventory.admin
配置
CombatKeepInventory 提供了以下配置选项:
- 战斗持续时间
- PvP 行为
- 禁用世界
- WorldGuard 集成
- 消息内容
- 平台检测
- 战斗状态处理
该插件无需代理即可运行。
如需实现跨代理/全网络的战斗状态同步,请使用独立的 CombatKeepInventory Velocity 项目。
如果遇到任何错误,请立即在 报告。
Note: New updates often contain important patches that help improve the experience
CombatKeepInventory is a lightweight combat tagging and inventory protection plugin for Bukkit-based Minecraft servers
It changes the behavior of keepInventory during PvP deaths: players can keep their inventory when they die from normal PvE or environmental causes while still dropping their inventory when killed by another player.
CombatKeepInventory is designed for survival, SMP, PvP and network servers that want more precise control over death and inventory behavior without replacing Minecraft's normal death system.

Features
- PvP combat tagging
- Configurable combat duration
- Player-kill inventory drop
- PvE/environmental inventory protection
- Works alongside the vanilla keepInventory gamerule
- Optional WorldGuard integration
- Combat logout handling
- Bypass permissions
- Disabled-world support
- Configurable messages
- Reload and information commands
- Core API for integrations
- Platform detection and capability information
How it works
When a player enters combat, CombatKeepInventory creates a combat session and tracks the relevant combat state.
If the player is killed by another player, the plugin can force the inventory to drop even when keepInventory is enabled.
Deaths caused by mobs, the environment or other non-player causes can continue to follow the configured inventory policy.
Compatibility
- Bukkit
- Spigot
- Paper
- Purpur
- Java Edition servers using the Bukkit API
The plugin is designed to avoid unnecessary NMS dependencies and uses the Bukkit/Paper API where possible.
Requirements
- Java 17+
- Bukkit-compatible server
- Paper is recommended
Optional integrations
- WorldGuard
Commands
/cki reload /cki info /cki pvp /cki debug *1.2.5
Permissions
combatkeepinventory.bypass combatkeepinventory.admin
Configuration
CombatKeepInventory provides configuration options for:
- Combat duration
- PvP behavior
- Disabled worlds
- WorldGuard integration
- Messages
- Platform detection
- Combat state handling
The plugin does not require a proxy to operate.
For proxy/network-wide combat state synchronization, use the separate CombatKeepInventory Velocity project.
If you encounter any errors, please report them immediately at
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CombatKeepInventory
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
1.2.6-release(续:高负载下的稳定性)
已修复
- 战斗会话在内存泄漏且自然过期时未通知。 预定的清理快照记录了
getActiveSessions()(“之前”的状态),并仅清理该快照中仍然存在的会话——但一个已过期的会话在清理运行之前就不再被视为活跃状态,因此快照始终为空,循环从未处理任何内容,导致一个过期的标签永远停留在会话映射中,除非有人再次查找该特定玩家。在同时拥有大量标签的服务器上,这会导致无限制的内存增长,而不仅仅是遗漏了combat.combat-ended消息。现已替换为CombatSessionManager#sweepExpired(long),它在一个遍历中以原子方式转换并移除过期会话。通过模拟 5,000 个同时会话的复现测试验证:所有 5,000 个会话均被清理,且无任何残留。 - WorldGuard 反射在每次命中时被重新解析。 每个 PvP 检查都会重新执行约 12 次
Class.forName/getMethod/getField查找。现在所有这些操作仅在检测到 WorldGuard 时解析一次,并在后续检查中重复使用——行为相同,但在持续进行 PvP 的服务器上大幅减少了每次命中的工作量。
已更改
- 事件处理器现在首先检查
worlds.enabled/disabled-worlds,然后再解析攻击者、查询 WorldGuard 或扫描最近的爆炸——最廉价的过滤器在任何实际工作之前运行,而不是之后。 onEntityExplode(TNT 归属追踪)现在也尊重禁用的世界;此前它无视此设置,追踪所有的 TNT 爆炸。worlds.enabled现在在config.yml中有清晰文档说明(false禁用的是排除列表,而非 CKI 本身——容易误读),并且配置验证器会在enabled: false与非空的disabled-worlds列表组合使用时发出警告。- 将禁用世界的决策提取为一个普通的
WorldFilter.isDisabled(boolean, List<String>, String)方法,不包含任何 Bukkit 类型,从而使其拥有直接的单元测试,而不仅仅只能通过活体World访问。
1.2.6-release
加固版本:包含错误修复、自动化测试、调试功能和库存保护。需要 Minecraft 1.18+(Paper/Spigot)和 Java 17+。Velocity 模块:支持 Velocity 3.x。
已修复
- 具有更高优先级的 player-kill 规则现在真正生效。 由玩家造成的死亡,如果最终原因是 PvE(例如被击入虚空),会使用 pve-death 策略,但在报告 player-kill 规则时却应用了该策略,导致
player-kill: KEEP可能输出为 DROP。现在 player-kill 规则始终使用 player-kill 策略(或特定的 PLAYER_* 覆盖)。 - WorldGuard 尊重真实的
pvp标志。 之前的钩子仅将区域名称与 CKI 自己的列表进行比较,从未读取 WorldGuard 的pvp标志,因此/rg flag <region> pvp deny无效。现在它查询RegionQuery#testState以获取 PVP 标志,这也通过 WorldGuard 自身的优先级规则解决了重叠/嵌套区域的问题。excluded-regions和restrict-to-enabled-regions仍然作为额外的层在上面工作。 - 经验值处理保持一致。
keep-experience根据策略动作是 KEEP 还是 DROP/PARTIAL 意味着两种相反的含义。现在三者达成一致:true= 不生成经验球。 - Velocity:减少误判惩罚。 在代理关闭期间、后端踢出/重定向后、断开连接不是正常退出(重复登录、取消连接)、标签剩余时间少于 1.5 秒(后端/代理时钟差异)或同一场战斗在 10 秒内第二次发生时,不进行惩罚。拥有 bypass 权限的玩家在退出时受到惩罚,因为查找发生在他们离开代理之后;现在权限检查直接在断开连接事件中进行。惩罚现在也始终要求存在活跃的标签。
库存保护
PARTIAL首先由纯规划器(PartialInventoryPlanner)计算,然后一次性应用。在写入任何内容之前验证物品数量;如果任何步骤失败,则恢复原始库存并保留所有内容。物品不会丢失、重复或移动到另一个槽位。
调试
/cki debug <player>显示上次死亡信息:原因、选择的策略、其优先级和操作,以及配置的优先级。实时的/cki debug流为每次死亡打印相同的行。- 新增
debug.worldguard标志,解释每个允许/拒绝的决定。
配置
- 新增
ConfigValidator:在启动和重载时报告错误的类型、未知的操作/优先级、超出范围的持续时间以及可疑的组合(错误 vs 警告)。 /cki reload安全:新文件首先被解析和验证;如果有错误,先前的配置保持活动状态。它还会指出哪些设置需要重启(listener-priority)。config.yml现在记录了worldguard部分。
测试
- JUnit 5 测试涵盖规则/优先级引擎、部分库存规划器、Velocity 惩罚守卫和配置验证器。
- CI 在 Java 17 和 21 上运行
mvn verify。
已知限制
- 作者未在实时服务器上测试:游戏中的 PARTIAL、重叠的 WorldGuard 区域以及 Velocity 切换/退出流程。
- 后端和代理时钟应进行 NTP 同步(代理比较后端的绝对过期时间)。
官方版本 1.2.5 包含以下内容:
-
全新、现代化的配置系统,以及多种其他更改。
-
message.yml文件的更新。 -
修复了 WorldGuard 集成问题。
-
由玩家触发的爆炸伤害现在计入战斗标记。
-
支持 1.18 及更高版本。
-
添加了 /cki debug 命令,允许管理员直接在服务器内查看信息。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
评论 0
登录后参与评分
还没有评论,来抢沙发吧