保持背包控制器

📦 背包控制器

终极“保留背包”大改造

---

🌟 为什么选择背包控制器？

厌倦了死亡时要么失去一切，要么保留一切的二元选择？背包控制器通过让你对死亡惩罚拥有完全细致的控制权，填补了这一空白。你无需再将整个背包丢进岩浆，而是可以设定规则：损失物品一定比例的耐久度、损失部分堆叠物品的数量，或者安全地将你的掉落经验装瓶保存。

通过直观且功能齐全的游戏内图形界面，你可以自定义哪些物品随身保留、哪些掉落，以及掉落时物品会损失多少耐久。它彻底革新了生存体验，让死亡变得既有惩罚性又公平合理！

📖 快速入门教程

1. 打开菜单：按下 I 键（默认）或使用添加到标题/暂停界面的按钮。
2. 调整你的惩罚尺度：导航到“背包控制器”选项卡。在这里，你可以为工具、武器、盔甲、食物等配置最小和最大惩罚百分比。
3. 设置黑名单和白名单：想始终保留你信赖的镐子？将其加入物品黑名单即可！你可以按物品ID、标签甚至自定义名称标签将物品加入黑名单。
4. 生存与死亡：当你死亡时，你的物品将根据你的规则处理。保留的物品会损失一定耐久度或堆叠数量（如果配置了），而掉落的物品将安全地存放在一个应急死亡箱中！（注意：你需要下载 Pageable Chests）

✨ 核心功能

⚖️ 细致惩罚系统

• 动态耐久度与堆叠损失： 保留的物品可以配置为随机损失一定百分比的耐久度（适用于工具/盔甲）或数量（适用于可堆叠物品）。
• 分类别设定： 为工具、武器、盔甲、食物和“其他”物品独立设置独特的惩罚范围（最小/最大）。
• 容器支持： 模组会深入检查带有背包的物品（如背包或潜影盒），并对其内部的物品应用独特的“容器背包”规则！

🛡️ 智能过滤与保护

• 白名单与黑名单： 按精确的物品ID、Forge标签甚至自定义物品名称进行过滤（非常适合保护带有特殊名称传说物品）。
• 稀有度保护： 自动保护稀有物品！你可以设置阈值（例如史诗或稀有物品），使其完全跳过掉落或惩罚。
• 零耐久度检查： 可以配置因死亡惩罚而碎裂的物品完全掉落，或安全地以5点耐久度保留在背包中。

☠️ 情境感知死亡惩罚

• 即死倍数： 被苦力怕从95%血量一击必杀？模组会识别这种情况，并对你的惩罚应用一个可配置的倍数。
• 快速死亡倍数： 在几秒钟内迅速死亡？模组会对你的物品损失应用一个“快速死亡”修正值！

🧪 经验保存

• 取代原版的经验球，你会掉落一个物理的“存储死亡经验”瓶。
• 可配置你总经验的百分比（最小/最大）放入此瓶中。
• 你没有损失的经验将保存在玩家数据中，并在重生后自动恢复！

📦 安全死亡掉落

• 如果你掉落物品，模组会搜索一个安全位置（向上搜索以避免物品被石头或基岩窒息）。
• 必要时会在空中或液体上方创造一个黑曜石平台，以防止你的掉落物品掉入虚空或岩浆！

📸 背包快照与历史记录

• 模组会在你死亡前秘密保存一个快照，每当你使用恢复命令（历史记录）或手动操作时都会进行！
• 命令（需要 OP 等级 2）：
  /invsnapshot list <玩家>
/invsnapshot restore <玩家> <时间戳>
/invsnapshot manual_save save <玩家>
• 聊天菜单完全可点击！你可以在聊天中单击一次即可恢复丢失的背包。

🔗 模组兼容性

• Curios API： 完全支持 Curios 槽位！你的戒指、腰带和护身符都使用完全相同的惩罚逻辑进行处理和恢复。（可选）
• Pageable Chests： 需要 `pageable_chests_k` 模组来将大量死亡掉落物存储在一个箱子中，虽然你可能不喜欢这样，但目前只能这样，因为我不知道如何处理掉落的物品。

⚠️ 重要信息与要求

• 需要库文件： 你必须 安装 Kozhin Lib (kozhin_lib_k) 才能使此模组正常工作。否则游戏会崩溃！
• 每玩家配置： 配置通过客户端 GUI 为每位玩家处理，并在登录时同步到服务器。这意味着每个玩家都可以自定义自己的保留背包规则！
• 标签加载： 如果你在 GUI 中编辑标签白名单/黑名单，你必须加载到一个世界中，以便 Forge 获取当前激活的标签。
• 管理员命令： 通过 /invsnapshot 恢复快照需要 OP 等级 2。这是为了防止普通玩家利用快照系统复制物品。
• 更新与配置： 在版本更新之间，切勿手动删除你的 `Keep Inventory Controller` 配置文件夹。其中包含一个对数据迁移至关重要的 `configsVersion` 字节。在更新模组前务必备份！