菜单工具包:容器

菜单工具包:容器

MenuKit 的插槽扩展 — 自定义容器菜单、逐插槽状态、插槽组区域。需要 MenuKit。

基础库

MenuKit: Containers

MenuKit: Containers 是 MenuKit 的槽位扩展。它允许模组添加可持久化的槽位,无论是放置在自定义容器菜单中,还是放置在原本没有槽位的原版位置。

功能特性:

  • 将槽位创建为 UI 组件,像其他组件一样放置:口袋、额外装备槽、背包——每个都真实存在且与服务器同步。
  • 添加与 MenuKit 面板集成的自定义容器菜单。
  • 为任意槽位附加按槽位状态:服务器授权、自动同步,可设置为每个玩家私有或所有查看者共享。
  • 创建与原版一致的槽位:在创造模式和生存模式下表现相同;死亡时处理正确(掉落、keepInventory 保留、或消失诅咒销毁)并兼容墓碑模组;可选绑定诅咒和经验修补。
  • 在所有容器屏幕(创造模式、生存模式和第三方菜单)上显示已注册槽位,无需逐个屏幕设置。
  • 支持放置容器:双箱子解析、无需打开菜单即可在服务端读取、以及客户端能力检查。
  • 将每个槽位的状态存储在其自然所有者(玩家、方块、实体或物品)上,可通过 /data get 读取。
  • 将创建的每个槽位暴露给任何 MenuKit 消费者,使其他模组能查看和访问你的槽位,你也能访问他们的。来自不同模组的槽位和菜单能干净注册并共存,保持模组间的兼容性。

MenuKit: Containers 是通用模组(同时在客户端和服务端运行),依赖 MenuKit(会自动引入)。需要 Fabric。

安装

repositories {
    maven { url 'https://api.modrinth.com/maven' }
}
dependencies {
    modImplementation 'maven.modrinth:menukit-containers:2.0.0'
    // MenuKit 会被间接引入,无需单独声明
}

在 fabric.mod.json 中声明两者:

"depends": { "menukit": "*", "menukit-containers": "*" }

工作示例

validator-mkc 模组是可靠的参考实现,包含实际、可编译的创建槽位、按槽位状态、死亡/绑定/修补等功能的用法。完整 API 在 javadoc 中有文档说明。

许可证

MIT。详见 LICENSE。

问题反馈

github.com/trevorschoeny/menukit-containers/issues