inventary Tabs API

Quick Stash

Quick Stash 会将你的储物容器以标签页的形式放在物品栏旁边。 点击标签页即可打开潜影盒、末影箱或背包，无需将物品从物品栏中取出或拿在手上。

Quick Stash 会在物品栏、盔甲栏、副手或 Curios 槽位中查找物品。

使用方法

1. 打开物品栏（或任意容器界面）。
2. 点击屏幕一侧的标签页。
3. 储物容器就会打开。切换标签页时，光标上的物品仍会留在手中。

功能一览

• 潜影盒 可作为标签页打开。
• 末影箱 可作为标签页打开。
• Sophisticated Backpacks 会在专属界面中打开，并支持升级。
• Ender Pouch（Ender Logistics Network）可作为标签页打开。
• 支持Curios 槽位。
• 附近的容器。附近可触及的箱子、工作台和熔炉也会显示为标签页。默认最多显示 8 个，距离最近的优先。
• 上次使用的容器标签页（默认关闭）。只要上次打开的容器仍在可触及范围内，就可以重新打开它。
• 安全可靠：打开物品所在的槽位会被锁定，服务器也会检查每次打开操作。

操作

• F9（在容器界面中）：打开标签页布局编辑器。使用鼠标或方向键将标签页行移动到屏幕任意边缘（按住 Shift 可每次移动 5 像素）。可以只为当前界面保存布局，也可以应用到所有界面。
• Enter保存，Esc取消，R重置偏移量。

配置

config/quickstash-client.toml或游戏内的模组设置：

整合包作者须知

标签页通过数据包配置，无需编写代码。在 data/<namespace>/quickstash/stash_tab/ 中放入 JSON 文件，例如放在 kubejs/data：

{
  "kind": "item",
  "match": { "items": "#c:shulker_boxes" },
  "handler": { "type": "quickstash:container_component", "rows": 3 },
  "category": "quickstash:portable",
  "priority": 10
}

• kind：item（玩家携带的物品），singleton（单个标签页，例如末影箱）。
• match：匹配哪些物品（按 ID、标签或组件）。
• handler：储物容器的打开方式。可用的处理器：container_component（任何带有 minecraft:container 组件的物品，rows 取值为 1 到 6）、ender_chest、sophisticated_backpack、ender_pouch。
• category：favorites、portable、equipment、personal、world 或自定义处理器。
• title、icon：名称和图标（默认使用物品自身的名称和图标）。
• priority：有多个规则匹配时，决定优先采用哪条。
• requirements：控制标签页何时显示，例如 quickstash:has_item。可与 not、any_of、all_of 组合使用。
• enabled：false 可关闭其他数据包中的规则。

添加一个带有 neoforge:conditions 和 neoforge:mod_loaded 的条目，即可将规则设为可选。你的数据包中若存在 ID 相同的规则，则会覆盖内置规则。

修改数据包后，请重启世界。 /reload 不会重新加载标签页。

公开 Java API 位于 ua.meekeyn.quickstash.api。

兼容性

• Minecraft 1.21.1，NeoForge 21.1.x
• 可选：Curios、Sophisticated Backpacks、Ender Logistics Network

许可证

GPL-3.0-only

Quick Stash

Quick Stash 会将你的储物容器以标签页的形式放在物品栏旁边。点击标签页即可打开潜影盒、末影箱或背包，无需将物品从物品栏中取出或拿在手上。

模组会在物品栏、盔甲栏、副手或 Curios 槽位中查找物品。

使用方法

1. 打开物品栏（或任意容器界面）。
2. 点击屏幕一侧的标签页。
3. 储物容器就会打开。切换标签页时，光标上的物品仍会留在手中。

功能一览

• 潜影盒可作为标签页打开。
• 末影箱可作为标签页打开。
• Sophisticated Backpacks会在专属界面中打开，并支持升级。
• Ender Pouch（Ender Logistics Network）可作为标签页打开。
• 支持Curios 槽位。
• 附近的容器。附近可触及的箱子、工作台和熔炉也会显示为标签页。默认最多显示 8 个，距离最近的优先。
• 上次使用的容器标签页（默认关闭）。只要上次打开的容器仍在可触及范围内，就可以重新打开它。
• 安全可靠：打开物品所在的槽位会被锁定，服务器也会检查每次打开操作。

操作

• F9（在容器界面中）：打开标签页布局编辑器。使用鼠标或方向键将标签页行移动到屏幕任意边缘（按住 Shift 可每次移动 5 像素）。可以只为当前界面保存布局，也可以应用到所有界面。
• Enter保存，Esc取消，R重置偏移量。

设置

配置文件 config/quickstash-client.toml 或游戏内的模组设置：

整合包作者须知

标签页通过数据包配置，无需编写代码。在 data/<namespace>/quickstash/stash_tab/ 中放入 JSON 文件，例如放在 kubejs/data：

{
  "kind": "item",
  "match": { "items": "#c:shulker_boxes" },
  "handler": { "type": "quickstash:container_component", "rows": 3 },
  "category": "quickstash:portable",
  "priority": 10
}

• kind: item（玩家携带的物品）或 singleton（单个标签页，例如末影箱）。
• match：匹配哪些物品（按 ID、标签或组件）。
• handler：储物容器的打开方式。可用的处理器：container_component（任何带有 minecraft:container 组件的物品，rows 取值为 1 到 6）、ender_chest、sophisticated_backpack、ender_pouch。
• category：favorites、portable、equipment、personal、world 或自定义处理器。
• title、icon：名称和图标（默认使用物品自身的名称和图标）。
• priority：有多个规则匹配时，决定优先采用哪条。
• requirements：控制标签页何时显示，例如 quickstash:has_item。可与 not、any_of、all_of 组合使用。
• enabled：false 可关闭其他数据包中的规则。

添加带有 neoforge:conditions 和 neoforge:mod_loaded 的条目，即可将规则设为可选。你的数据包中若存在 ID 相同的规则，则会覆盖内置规则。

修改数据包后，请重启世界。 /reload 不会重新加载标签页。

公开 Java API 位于包 ua.meekeyn.quickstash.api 中。

兼容性

• Minecraft 1.21.1，NeoForge 21.1.x
• 可选：Curios、Sophisticated Backpacks、Ender Logistics Network

许可证

GPL-3.0-only