核心 - 自定义库存

核心 - 自定义库存

此模组是TrueBackpack的核心依赖项。欢迎将其作为创建其他模组的基础。

实用

为 Hytale 重新设计的可扩展玩家物品栏,附带一个额外的 Gear 面板用于饰品装备,并提供一套 API,让其他模组可以添加页面、按钮、装备和视觉效果而互不冲突。

功能

重新设计的物品栏

  • 用单一的统一界面替换冒险模式物品栏(通过常规物品栏按键打开)
  • 玩家面板,包含角色预览、生命值、耐力、法力和防御
  • 护甲槽位,每件护甲上都有一个 眼睛开关,用于在角色身上显示或隐藏该护甲,同时保留其属性
  • 快捷栏,带有快速选择轮盘
  • 内置页面:
    • 随身合成
    • 收集的回忆
    • 背包
  • 物品栏操作:整理物品、丢弃堆叠、丢弃某一类型的所有堆叠、全部取出、全部存入和快速堆叠
  • 完整的鼠标和手柄支持,自动显示键盘或控制器按键提示

你也可以随时通过以下命令打开物品栏:

/custominventory

Gear 面板

角色旁边的一个可折叠面板,包含四个额外的装备槽位:

  • 帽子
  • 背包
  • 项圈
  • 腰带

Gear 物品会随你的角色一起保存,并在死亡时遵循世界正常的物品掉落规则。

装备可见性

每个 Gear 槽位都有自己的 眼睛开关:

  • 点击已装备物品旁的眼睛,可在角色身上显示或隐藏该物品
  • 每个槽位相互独立:隐藏背包不会隐藏帽子
  • 隐藏物品只改变外观。物品仍保持装备状态并继续生效
  • 你的选择会被保存,并在重新连接后保留
  • 某些功能性物品(例如 Helipack)始终可见,其眼睛显示为锁定状态

共享角色渲染

Custom Inventory 会绘制模组附加到角色上的所有内容:已装备的 Gear 物品、箭袋等等。多个装备模组可以同时安装,而不会互相隐藏对方的模型。你的皮肤、护甲可见性设置以及头饰下的发型都会保持完好。

面向模组开发者

Custom Inventory 的设计初衷就是可供扩展。通过 CustomInventoryPlugin.get() 和 api 包,你可以:

  • 注册物品栏 页面、按钮、UI 扩展 和 物品提示(InventoryRegistry)
  • 在共享物品栏中打开你自己的界面,玩家面板和物品栏面板已由模组处理(openView)
  • 为 Gear 槽位注册物品,并响应装备或卸下事件(ExtraEquipment、EquipmentManager)
  • 在玩家模型上显示你的装备,并自动遵循每个槽位的眼睛开关(EquipmentManager.Listener#attachment)
  • 安全地向玩家模型添加其他附加物、动画和重建回调(PlayerModel)

重要: 切勿自行替换玩家的 ModelComponent。请使用 EquipmentManager 或 PlayerModel,以确保所有模组的视觉效果都得以保留。

兼容性

  • 适用于 冒险 模式;其他游戏模式保留原版物品栏
  • 兼容所有护甲套装
  • 为 True Backpack 的必需依赖,该模组为 Gear 面板添加背包、HeadLight 帽子、箭袋和 Helipack

安装

  1. 将 Custom Inventory 的 JAR 文件放入服务器的 mods 文件夹
  2. 安装任何依赖它的模组,例如 True Backpack
  3. 启动服务器

源代码

有兴趣贡献或基于该项目进行开发?

GitHub:SupremoSama/Hytale-CustomInventory