物品栏按钮栏

物品栏按钮栏

库存界面上的一个共享条带,各模组可在此添加按钮而不会互相重叠。

这个模组在物品栏界面添加了一个共享条带,其他模组可以将它们的按钮放置于此。它存在的意义在于,模组作者无需自行决定玩家从哪里进入其模组菜单,也避免了两个模组做出相同决定而冲突的情况。注册一个按钮只需一次 API 调用。

单独使用时它不执行任何操作。 它本身不添加任何按钮。如果没有模组使用它,你的物品栏界面将和安装前完全一样。

AI 使用声明: 本模组在开发过程中使用了 AI 代理辅助,采用了此代理工作流。项目所有者在开发期间对工作进行了审查。


功能说明

  • 按钮对齐:沿物品栏面板的一条边缘均匀排列,并随面板移动而移动。
  • 边缘可选:你可以选择顶部或右侧,分别适用于生存模式和创造模式界面,也可在任一界面上完全关闭。
  • 自动换行:当一行排满时会换到下一行,并在屏幕空间不足时干净地停止,而不会绘制到屏幕边缘之外。
  • 顺序可控:你可以自定义按钮顺序,并隐藏任何不需要的按钮。
  • 容错机制:单个异常模组不会破坏你的物品栏。如果某个按钮行为异常,条带会记录日志并继续运行。

配置

所有配置均位于 config/inventorybuttonbar.cfg 文件中。没有设置界面,因此请编辑文件后重启游戏。

重要选项:

  • survivalPlacement 和 creativePlacement - 可选值为 TOP(顶部)、RIGHT(右侧)或 HIDDEN(隐藏)。生存模式默认在顶部,创造模式默认在右侧。
  • order - 按你列出的顺序指定优先显示的按钮 ID。
  • hidden - 指定你想要排除的按钮 ID。

order 和 hidden 都需要按钮 ID。在游戏内执行 /ibb ids 命令即可打印出列表。

为什么需要两个设置而不是一个: 两种界面尺寸不同,且已绘制的内容也不同,因此在一个界面上空余的边缘在另一个界面上往往已被占用。

如果你使用 JEI 请注意

物品列表位于面板右侧的条带中。在创造模式界面,条带默认从右侧开始,因此两者会重叠。

如果这让你困扰,可以将 creativePlacement 设置为 TOP。这样条带会改为显示在创造模式标签页上方,并且需要足够高的窗口才能容纳。在矮窗口中,创造模式条带将完全不显示,这是一种取舍,也是右侧作为默认值的原因。

生存模式界面默认在顶部,没有此问题。

安装

客户端和服务端都需要安装。

面向模组作者

注册一个按钮需要两种类型和一次调用。请参阅集成指南。

在集成之前务必阅读它。最常见的错误其症状是崩溃而非按钮缺失,而该指南正是围绕避免这一情况编写的。

源码

github.com/mahghuuuls/inventory-button-bar。采用 MIT 许可证。