InventoryKeeper - 死亡物品保留

你是否觉得原版的死亡掉落过于困难，而开启 keepInventory 又过于简单、失去平衡？那么这款插件非常适合你。它提供特定的物品（虚拟或实体物品）或权限，让玩家在死亡时恢复背包和经验。当玩家死亡时，插件会消耗其拥有的、优先级最高的匹配物品来恢复背包。请注意：此插件仅在游戏规则 keepInventory 设置为 false 时生效。

💡核心特性

• 可设置禁用世界。
• 可设置经验损失比例。
• 支持随机系统。
• 可清除带有诅咒附魔的物品。
• 可在死亡和重生时执行命令。
• 命令支持 TAB 自动补全。
• 支持自定义头颅材质。
• 支持自定义模型数据（Custom Model Data）。
• 支持自定义死亡类型。
• 支持虚拟/实体物品及权限。
• 支持 PlaceholderAPI。
• 支持多种物品。
• 支持十六进制颜色代码。
• 可自定义饥饿值与饱和度。
• 可自由过滤实体类型和自定义名称。
• 高度可定制，简单易用。
• 支持扩展插件。
• 支持 Minecraft 1.7 至 1.17 版本。

🎮命令与权限

管理员命令

需要权限：inventorykeeper.admin（OP 默认拥有）

• /invkeep - 主命令。
• /invkeep get <v/p> <item-name> [amount] - 获取指定物品。（v 代表虚拟物品，p 代表实体物品）
• /invkeep give <v/p> <item-name> <player> [amount] - 给予指定玩家物品。
• /invkeep take <player> <item-name> [amount] - 从玩家处取走虚拟物品。
• /invkeep set <player> <item-name> [amount] - 设置玩家的虚拟物品数量。
• /invkeep check [player] - 检查虚拟物品数量。
• /invkeep reload - 重载配置文件。

玩家命令与权限

• /invkeep check [player] - 允许玩家检查虚拟物品数量。
• inventorykeeper.check - 允许使用 /invkeep check 命令（默认拥有）。
• inventorykeeper.check.others - 允许检查其他玩家的物品数量。
• inventorykeeper.unlimited.<Item Name> - 拥有此权限的玩家在恢复背包时，对应的物品（虚拟/实体）将不会被消耗，即拥有无限数量（默认 OP 拥有）。

注意： 权限 inventorykeeper.keep 已被弃用，请使用新的 inventorykeeper.unlimited.<Item Name>。

🔧安装与使用

• 将插件 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 编辑配置文件。
• 开始使用。

✨配置详解

config.yml 主要设置

• debug: 设置为 true 时显示调试信息。若插件工作不正常，请开启此项并向作者报告。
• show-death-cause-on-death: 在控制台显示玩家死亡原因（调试选项）。
• galacticraft-mod-support: 若服务器安装了 Galacticraft 模组，请开启此项以保留其专属物品栏。
• clear-vanishing-curse-items: 玩家死亡时清除带有“消失诅咒”的物品。
• drop-binding-curse-items: 玩家死亡时掉落带有“绑定诅咒”的物品。
• default-hunger-level: 自定义玩家死亡掉落时，重生后的默认饥饿值。可选 keep（保持）、reset（重置为满，原版行为）或 set,数值 / set,最小值,最大值（自定义）。
• default-saturation-level: 自定义玩家死亡掉落时，重生后的默认饱和度。格式同上。
• compatibility-mode: 兼容性模式。若插件工作不正常可尝试开启。

- `inventory`: 若物品被消耗但背包仍掉落，可尝试设为 `true`。

- `exp`: 若经验值在重生时无法正确设置，可尝试设为 `true`。

• run-commands-on-death-if-drops: 玩家死亡掉落时执行的命令列表。
• run-random-commands-on-death-if-drops: 玩家死亡掉落时，随机选择一组命令执行。
• run-commands-on-respawn-if-drops: 玩家死亡掉落并在重生时执行的命令列表。
• run-random-commands-on-respawn-if-drops: 玩家重生时，随机选择一组命令执行。

命令格式说明：

• 使用 %player% 代表玩家名，%random% 代表随机数。
• 如需在命令中使用随机数，格式为：最小值|最大值|命令。
• 以 OP 权限执行命令，请在命令前添加 [OP]。
• 可直接使用 PlaceholderAPI 的占位符。
• 如需执行多个命令，请用 ; 分隔，; 后不要加空格。

items.yml 物品配置

此文件用于设置用于保留玩家背包的自定义物品。可以设置多个物品，玩家死亡时，将优先消耗优先级（priority）最高的物品。

每个物品的主要配置项包括

• item-id: 物品 ID（支持旧版数字 ID 和 Sub-id，如 '397:3'）。
• name: 在插件命令中显示的物品名称（非游戏内实际名称）。
• custom-texture: （可选）自定义头颅材质 Base64 字符串。
• custom-model-data: （可选）自定义模型数据值。
• item-name: （可选）物品在游戏内的显示名称。
• item-lore: （可选）物品描述。
• item-enchantments: （可选）物品附魔，格式为 附魔名-等级。
• save-exp: 死亡时是否保留经验。
• exp-lose-percentage: 经验损失百分比。可为固定值（如 50）或随机范围（如 10-30）。若 save-exp 为 true 则此项无效。
• hunger-level / saturation-level: 使用此物品重生后的饥饿值与饱和度设置。
• disabled-worlds: （可选）此物品无效的世界列表。
• run-commands-on-death / run-commands-on-respawn: （可选）消耗此物品时，在死亡/重生时执行的命令。
• run-random-commands-on-death / run-random-commands-on-respawn: （可选）消耗此物品时，在死亡/重生时随机选择执行的命令组。
• filter-entities-list: 根据实体类型过滤是否生效。
• filter-entities-name: 根据实体自定义名称过滤是否生效。
• items-with-lore-to-be-removed-on-death: 死亡时移除带有指定描述文字的物品（适用于与 SoulBind 等插件配合）。
• death-message: 消耗此物品时发送给玩家的自定义消息。
• priority: 优先级，数值高的物品优先被消耗。
• enabled-death-type: 设置此物品对哪些死亡类型生效。详细类型请参考 Spigot API 文档。

❓教程与提示

使用自定义头颅

在物品配置中添加 custom-texture 项，并填入对应的 Base64 材质字符串。

使用自定义模型数据

在物品配置中添加 custom-model-data 项，并填入整数值。

设置死亡/重生时执行的命令

在 config.yml 或单个物品配置中，使用 run-commands-on-death 或 run-commands-on-respawn 列表。如需随机执行，则使用 run-random-commands-on-death 或 run-random-commands-on-respawn。

示例：

run-commands-on-death:
  - 'eco take %player% 100'
  - '[OP] fly off'
  - '100|200|eco take %player% %random%'

run-random-commands-on-death:
  - 'tell %player% Oops! You died!;eco take %player% 100'
  - '[OP] fly off'
  - '100|200|eco take %player% %random%;tell %player% Oops! You have lost %random% coins!'

PlaceholderAPI 支持

插件提供以下占位符

• %inventorykeeper_amount_<物品名>% - 返回玩家拥有的指定虚拟物品数量。
• %inventorykeeper_amount_<物品名>,<玩家名>% - 返回其他在线玩家的指定虚拟物品数量。

在死亡/重生命令中，也可以直接使用 PlaceholderAPI 的其他占位符。

⭐扩展插件

• RandomDrop - 在玩家死亡时随机掉落或清除物品。

💡问题与反馈

如遇到问题或有建议，请在插件发布页留言或在 GitHub 上提交 Issue。