Cib Lib

Cib Lib

一个Fabric库,允许模组将创造模式标签页分为多个部分,每部分都有独立的横幅。

创造性物品栏横幅(Creative Inventory Banner) 是一个供模组开发者使用的库。它将一个创造模式标签页划分为多个分区,每个分区顶部由你选择的横幅图片作为标题。

不再是一整片平坦的物品墙,你的标签页会呈现为带标签的分组:材料、工具、食物、装饰,以及任何你决定的分类。

工作原理

一个分区会在创造模式网格中占据一整行作为其标题栏,然后将物品排列在下方。渲染分为两层:库始终会在空槽位行上绘制一个占位框架,你的横幅则叠加在其上方。如果不声明横幅,则会使用内置的默认样式。

面向开发者

声明你的分区并将布局交给标签页:

```java

InventoryBanners.register(MY_TAB, layout -> layout
        .section(section -> section
                .banner(MOD_ID, "materials")
                .add(RUBY, SAPPHIRE))
        .section(section -> section
                .banner(MOD_ID, "gear")
                .add(RUBY_SWORD, RUBY_PICKAXE))
        .section(section -> section
                .add(MYSTERY_ITEM)));

CreativeModeTab.builder(...)
        .displayItems(InventoryBanners.displayItems(MY_TAB))
        .build();

```

横幅纹理位于 assets/<你的模组ID>/textures/gui/banner/<名称>.png,并且必须恰好为 160x16 像素。

默认情况下会有一个灰色横幅。

这就是常见用途的全部 API 接口。物品堆栈是惰性构建的,因此你可以在注册物品的同时声明分区,而不会因未初始化的物品组件而引发问题。

完整文档、构建器参考和更多示例位于 Discord 中的 README 文件里。

需求

  • Minecraft 26.2
  • Fabric Loader 0.19.3 或更新版本
  • Fabric API
  • Java 25