Better Bundle v1.8.2

更新内容

• 修复箱子、漏斗等普通容器界面搜索框无法输入字符的问题
  • 字符输入注入点从 GuiEventListener 修正为 ContainerEventHandler
  • 界面关闭时自动失焦，不再影响聊天等其他界面
• 容器点击实现保持原有逻辑不变

环境

• Minecraft 26.2
• Fabric Loader >= 0.19.3
• Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）
• ModMenu 20.0.2（可选，配置入口）
• Java >= 25

产物

• 26.2：better-bundle-mc26.2-v1.8.2-1.jar
• 1.21.2 / 1.21.3 / 1.21.4 / 1.21.5 / 1.21.6 / 1.21.7 / 1.21.8：better-bundle-mc<版本>-v1.8.2-1.jar
• 1.21.9 / 1.21.10 / 1.21.11：better-bundle-mc<版本>-v1.8.2-1.jar
• 26.1.2：better-bundle-mc26.1.2-v1.8.2-1.jar
• 26.3：better-bundle-mc26.3-v1.8.2-1.jar
• 各版本均提供 -sources.jar 源码包

各游戏版本的 Fabric API / Cloth Config / ModMenu / Java 要求见 README 的版本表。

Better Bundle v1.8.1

Better Bundle v1.8.1

产物命名：better-bundle-mc<游戏版本>-v<mod版本>-<该游戏版本下的发布序号>。
本 Release 同时提供 1.21.x / 26.1.x / 26.2 / 26.3 各版本构建，请按你的游戏版本下载对应文件。

下载对应

• Minecraft 1.21.2 → better-bundle-mc1.21.2-v1.8.1-1.jar
• Minecraft 1.21.3 → better-bundle-mc1.21.3-v1.8.1-1.jar
• Minecraft 1.21.4 → better-bundle-mc1.21.4-v1.8.1-1.jar
• Minecraft 1.21.5 → better-bundle-mc1.21.5-v1.8.1-1.jar
• Minecraft 1.21.6 → better-bundle-mc1.21.6-v1.8.1-1.jar
• Minecraft 1.21.7 → better-bundle-mc1.21.7-v1.8.1-1.jar
• Minecraft 1.21.8 → better-bundle-mc1.21.8-v1.8.1-1.jar
• Minecraft 1.21.9 → better-bundle-mc1.21.9-v1.8.1-1.jar（独立分支，基于 main 适配）
• Minecraft 1.21.10 → better-bundle-mc1.21.10-v1.8.1-1.jar
• Minecraft 1.21.11 → better-bundle-mc1.21.11-v1.8.1-1.jar
• Minecraft 26.1 / 26.1.1 / 26.1.2 → better-bundle-mc26.1.2-v1.8.1-1.jar
• Minecraft 26.2 → better-bundle-mc26.2-v1.8.1-1.jar
• Minecraft 26.3 → better-bundle-mc26.3-v1.8.1-1.jar

更新内容

• 面板搜索框由自绘改为原版 EditBox：获得原版的光标、选区、退格/删除、Enter/Esc 行为，并为原生输入法（IME）铺路。
• 修复 JEI 抢焦点：装有 JEI 时搜索框仍可正常聚焦并接收输入，不再出现输入被 JEI 搜索框抢占（中文输入被截胡）的问题。
• 新增 1.21.2–1.21.11 兼容构建：1.21.2–1.21.8 由 1.21.x 分支构建；1.21.9–1.21.11 由独立分支构建，基于 main 适配并跟随新输入 API。

已知问题

• 普通容器（箱子等）的搜索框无法输入字符。这是 main 核心代码的历史问题，影响所有版本（含 1.21.x、1.21.9 分支），不是兼容分支特有；需先在 main 修复，再由各兼容分支同步。

说明

• 26.1.x / 26.2 在 Linux 上使用输入法仍需 linux-ime 兼容 mod；26.3 起游戏原生支持输入法，无需该桥。
• 26.1.2 低于主分支版本，属经维护者同意的向下适配特例。
• 1.21.2 / 1.21.3 为向下兼容分支，不合并回 main；1.21.x 不使用 26.x 的输入法桥。

环境

Minecraft 1.21.2

• Fabric Loader >= 0.16.7 / Fabric API 0.106.1+1.21.2
• Cloth Config >= 16.0.143（必需）/ ModMenu 12.0.1（可选，配置入口）

Minecraft 1.21.3

• Fabric Loader >= 0.16.7 / Fabric API 0.114.1+1.21.3
• Cloth Config >= 16.0.143（必需）/ ModMenu 12.0.1（可选，配置入口）

Minecraft 1.21.4

• Fabric Loader >= 0.16.7 / Fabric API 0.119.4+1.21.4
• Cloth Config >= 17.0.144（必需）/ ModMenu 13.0.4（可选，配置入口）

Minecraft 1.21.5

• Fabric Loader >= 0.16.7 / Fabric API 0.128.2+1.21.5
• Cloth Config >= 18.0.145（必需）/ ModMenu 14.0.2（可选，配置入口）

Minecraft 1.21.6

• Fabric Loader >= 0.16.7 / Fabric API 0.128.2+1.21.6
• Cloth Config >= 19.0.147（必需）/ ModMenu 15.0.2（可选，配置入口）

Minecraft 1.21.7

• Fabric Loader >= 0.16.7 / Fabric API 0.129.0+1.21.7
• Cloth Config >= 19.0.147（必需）/ ModMenu 15.0.2（可选，配置入口）

Minecraft 1.21.8

• Fabric Loader >= 0.16.7 / Fabric API 0.136.1+1.21.8
• Cloth Config >= 19.0.147（必需）/ ModMenu 15.0.2（可选，配置入口）

Minecraft 1.21.9

• Fabric Loader >= 0.16.7 / Fabric API 0.134.1+1.21.9
• Cloth Config >= 20.0.149（必需）/ ModMenu 16.0.1（可选，配置入口）

Minecraft 1.21.10

• Fabric Loader >= 0.16.7 / Fabric API 0.138.4+1.21.10
• Cloth Config >= 20.0.149（必需）/ ModMenu 16.0.1（可选，配置入口）

Minecraft 1.21.11

• Fabric Loader >= 0.16.7 / Fabric API 0.141.6+1.21.11
• Cloth Config >= 21.11.160（必需）/ ModMenu 17.0.1（可选，配置入口）

Minecraft 26.1 / 26.1.1 / 26.1.2

• Fabric Loader >= 0.19.5 / Fabric API 0.155.3+26.1.2
• Cloth Config >= 26.1.154（必需）/ ModMenu 18.0.2（可选，配置入口）

Minecraft 26.2

• Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）/ ModMenu（可选，配置入口）

Minecraft 26.3

• Fabric Loader >= 0.19.5 / Fabric API 0.162.0+26.3
• Cloth Config >= 26.3.159（必需）/ ModMenu 21.0.0（可选，配置入口）

Java：1.21.x 需要 >= 21，26.x 需要 >= 25

产物

• better-bundle-mc26.1.2-v1.8.1-1.jar — 26.1 / 26.1.1 / 26.1.2 安装用
• better-bundle-mc26.1.2-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.2-v1.8.1-1.jar — 1.21.2 安装用
• better-bundle-mc1.21.2-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.3-v1.8.1-1.jar — 1.21.3 安装用
• better-bundle-mc1.21.3-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.4-v1.8.1-1.jar — 1.21.4 安装用
• better-bundle-mc1.21.4-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.5-v1.8.1-1.jar — 1.21.5 安装用
• better-bundle-mc1.21.5-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.6-v1.8.1-1.jar — 1.21.6 安装用
• better-bundle-mc1.21.6-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.7-v1.8.1-1.jar — 1.21.7 安装用
• better-bundle-mc1.21.7-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.8-v1.8.1-1.jar — 1.21.8 安装用
• better-bundle-mc1.21.8-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.9-v1.8.1-1.jar — 1.21.9 安装用
• better-bundle-mc1.21.9-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.10-v1.8.1-1.jar — 1.21.10 安装用
• better-bundle-mc1.21.10-v1.8.1-1-sources.jar — 源码
• better-bundle-mc1.21.11-v1.8.1-1.jar — 1.21.11 安装用
• better-bundle-mc1.21.11-v1.8.1-1-sources.jar — 源码
• better-bundle-mc26.2-v1.8.1-1.jar — 26.2 安装用
• better-bundle-mc26.2-v1.8.1-1-sources.jar — 源码
• better-bundle-mc26.3-v1.8.1-1.jar — 26.3 安装用
• better-bundle-mc26.3-v1.8.1-1-sources.jar — 源码

Better Bundle v1.8.0

Better Bundle v1.8.0

产物命名：better-bundle-mc<游戏版本>-v<mod版本>-<该游戏版本下的发布序号>。
本 Release 同时提供 26.1.x / 26.2 / 26.3 三个构建，请按你的游戏版本下载对应文件。

下载对应

• Minecraft 26.1 / 26.1.1 / 26.1.2 → better-bundle-mc26.1.2-v1.8.0-1.jar
• Minecraft 26.2 → better-bundle-mc26.2-v1.8.0-1.jar
• Minecraft 26.3 → better-bundle-mc26.3-v1.8.0-1.jar

新特性

• 物品分类改为运行时规则推导：不再维护 1279 条硬编码物品清单，改为按物品类型 / 数据组件 / 原版 tag / 方块形状自动归类。
• MC 升级新增的物品会被规则自动归类，无需人工补表（兼容分支几乎零维护）。

分类逻辑

• 食物：FOOD 数据组件（+ cake）
• 植物：树苗/树叶/种子标签、植物类方块（VegetationBlock 等）、花朵/作物/藤蔓 tag
• 矿物：*_ORES / COALS / COPPER 标签 + 少量补充（锭 / 宝石 / 原矿）
• 工具和装备：TOOL / EQUIPPABLE 组件 + 剑斧镐锄铲 / 护甲 / 箭 / 长矛 / 收纳袋标签 + 桶 / 船 / 矿车
• 方块 / 不完整方块：功能方块（带 BlockEntity）与形状不满的归「不完整方块」，其余实心方块归「方块」
• 杂物：兜底，确保不再有物品「只出现在全部」

环境

Minecraft 26.1 / 26.1.1 / 26.1.2

• Fabric Loader >= 0.19.5 / Fabric API 0.155.3+26.1.2
• Cloth Config >= 26.1.154（必需）/ ModMenu 18.0.2（可选，配置入口）

Minecraft 26.2

• Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）/ ModMenu（可选，配置入口）

Minecraft 26.3

• Fabric Loader >= 0.19.5 / Fabric API 0.162.0+26.3
• Cloth Config >= 26.3.159（必需）/ ModMenu 21.0.0（可选，配置入口）

Java >= 25

产物

• better-bundle-mc26.1.2-v1.8.0-1.jar — 26.1 / 26.1.1 / 26.1.2 安装用
• better-bundle-mc26.1.2-v1.8.0-1-sources.jar — 源码
• better-bundle-mc26.2-v1.8.0-1.jar — 26.2 安装用
• better-bundle-mc26.2-v1.8.0-1-sources.jar — 源码
• better-bundle-mc26.3-v1.8.0-1.jar — 26.3 安装用
• better-bundle-mc26.3-v1.8.0-1-sources.jar — 源码

Better Bundle v1.7.1

Better Bundle v1.7.1

同一版本号提供两个 Minecraft 分支的构建，请按你的游戏版本下载对应文件。

下载对应

• Minecraft 26.2 → better-bundle-1.7.1.jar
• Minecraft 26.3 → better-bundle-1.7.1-mc26.3.jar

修复（26.2 / 26.3 共通）

• 配置界面里默认分类名显示为原始翻译键（text.autoconfig.better-bundle.category.default）的问题；现在正常显示为「常规 / General」。

新增：Minecraft 26.3 支持（同版本 1.7.1）

• 适配 Minecraft 26.3：Fabric Loader >= 0.19.5 / Fabric API 0.162.0+26.3 / Cloth Config >= 26.3.159 / ModMenu 21.0.0 / Java >= 25。
• 适配 26.3 输入系统改动（GLFW → SDL）造成的编号错位：
  • 修复「按住空格 + 拖动鼠标左键批量存入」失效；
  • 修复 Shift 修饰键判定（Shift + 点击面板物品取出放入容器/背包）；
  • 修复搜索框的 退格 / 回车 / Esc 按键。
• 适配 Bundle 内容 API：BundleContents.itemCopyStream() → itemCopies()。
• 构建工具链：Gradle 9.8.1 / Fabric Loom 1.18.4。

环境

Minecraft 26.2

• Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）/ ModMenu（可选，配置入口）

Minecraft 26.3

• Fabric Loader >= 0.19.5 / Fabric API 0.162.0+26.3
• Cloth Config >= 26.3.159（必需）/ ModMenu 21.0.0（可选，配置入口）

Java >= 25

产物

• better-bundle-1.7.1.jar — 26.2 安装用
• better-bundle-1.7.1-sources.jar — 26.2 源码
• better-bundle-1.7.1-mc26.3.jar — 26.3 安装用
• better-bundle-1.7.1-mc26.3-sources.jar — 26.3 源码

Better Bundle v1.7.0

Better Bundle v1.7.0

新增

• 配置界面（Cloth Config / AutoConfig，ModMenu 入口）：
  • 显示分类栏（开 / 关）
  • 面板显隐：一直开 / 一直关 / 跟随上次（记住上次状态）
  • 高级选项卡：一键整理的动作最小/最大间隔、服务端确认超时、单次整理动作上限
• 列表支持拖动滚动条（并支持点击轨道跳转）。
• 隐藏分类栏时面板不再变矮（最小高度仍按分类栏高度）。

修复

• 点击面板内的空网格/空白处会把光标物品丢出：原版在 mouseReleased 阶段按“点击 GUI 窗口之外(-999)”丢出物品，而面板整体位于容器 GUI 之外。现在松开也在整个面板内吞掉点击，与按下一致，不再丢出。

依赖

• Cloth Config >= 26.2.155（必需）；ModMenu 可选（提供配置入口）。

环境

• Minecraft 26.2 / Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155 / Java >= 25

产物

• better-bundle-1.7.0.jar — 安装用
• better-bundle-1.7.0-sources.jar — 源码

Better Bundle v1.7.0-beta.2 (预发布测试2)

Better Bundle v1.7.0-beta.2（预发布测试2）

修复「光标持物点击面板空白处会把物品丢出」的问题。

原因

面板绘制在容器 GUI 之外。之前光标持物点击面板时，若塞不下 / 袋子已满，该次点击未被取消 → 落到原版逻辑 → 原版把“点击 GUI 窗口之外”当成丢出光标物品。

修复

• 光标持物、点击面板所在的横向列（左右范围之内，上下不限，含面板下方空白）时，无条件吞掉该点击：
  • 放得下 → 正常放入袋子；
  • 放不下 / 已满 → 什么都不发生，绝不丢出。

环境

• Minecraft 26.2 / Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）/ ModMenu（可选，配置入口）
• Java >= 25

产物

• better-bundle-1.7.0-beta.2.jar
• better-bundle-1.7.0-beta.2-sources.jar

Better Bundle v1.7.0-beta.1 (预发布测试1)

Better Bundle v1.7.0-beta.1（预发布测试1）

测试版，可能有 bug，欢迎反馈。

需要安装 Cloth Config API（>= 26.2.155）；建议搭配 ModMenu 20.x，在模组列表点「配置」打开设置界面。

新增

• 配置界面（Cloth Config / AutoConfig，ModMenu 入口）：
  • 显示分类栏（开 / 关）
  • 面板显隐：一直开 / 一直关 / 跟随上次（记住上次状态）
  • 高级选项卡：一键整理的动作最小/最大间隔、服务端确认超时、单次整理动作上限
• 列表滚动条支持拖动（并支持点击轨道跳转）。
• 隐藏分类栏时面板不再变矮（最小高度仍按分类栏高度）。

环境

• Minecraft 26.2 / Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2
• Cloth Config >= 26.2.155（必需）/ ModMenu（可选，用于配置入口）
• Java >= 25

产物

• better-bundle-1.7.0-beta.1.jar — 安装用
• better-bundle-1.7.0-beta.1-sources.jar — 源码

Better Bundle v1.6.0

Better Bundle v1.6.0

变更

• 重写面板布局：新增唯一布局真源 PanelLayout，渲染、交互命中、排序按钮、bounds 判定共用同一份，从根上避免「看得到的」与「点得到的」不一致。
• 面板自适应大小与位置：贴屏幕边缘、不再越界（左侧空间不足时贴左缘并压缩列数）；真实描边，尺寸=实际内容，去掉旧的固定高度与魔数。
• 动态每行格子：列数随左侧可用宽度变化（2~10），行数随可用高度变化；高度自适应，超出可用高度才滚动。
• 分类按钮移入面板内部；搜索 / 滚动 / 容量 / 悬停全部按同一布局计算。
• 面板条目按物品 id 稳定排序（延续 1.5.0）。

说明

• 纯客户端（仅 client），不修改服务端。
• 物理整理策略保持既有发行版行为（同种优先 → 最空袋）。

环境

• Minecraft 26.2 / Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2 / Java >= 25

产物

• better-bundle-1.6.0.jar — 安装用
• better-bundle-1.6.0-sources.jar — 源码

Better Bundle v1.5.0

Better Bundle v1.5.0

变更

• 面板条目改为按物品 id 稳定排序（仅显示层）：
  • 显示顺序与物理存放位置无关；同 id 的跨袋条目相邻，方便记忆位置、快速取用。
  • 不合并条目：碎片仍然各自显示，交给「一键整理」在物理层合并。
  • 不影响写入与「一键整理」等物理层逻辑，也不改变取出/悬停/滚动等交互。
  • 搜索的「命中置顶」保留，命中组内部保持 id 序。

说明

• 纯客户端（仅 client），不修改服务端。
• 物理整理策略保持既有发行版行为（同种优先 → 最空袋）。

环境

• Minecraft 26.2 / Fabric Loader >= 0.19.3 / Fabric API 0.153.0+26.2 / Java >= 25

产物

• better-bundle-1.5.0.jar — 安装用
• better-bundle-1.5.0-sources.jar — 源码

Better Bundle v1.4.3

Better Bundle 1.4.3

修复

• 按住空格快速滑动收纳时，滑快会漏掉中间几格 → 改为按鼠标划过的轨迹补格，划过的都会收
• 批量收进的顺序和手滑顺序不一致 → 改为按划过先后依次放入
• 单格卡住或光标被占用时，会连带丢掉后面一整批待处理格 → 改为只跳过当前格、保留其余

适用

• Minecraft 26.2
• Fabric Loader >= 0.19.3 / Java >= 25