Hysk-LongHotbar

LongHotbar

LongHotbar 是一个 Fabric 客户端模组，适用于 Minecraft 1.21.11，它添加了一个并排多物品栏系统，让你能够通过灵活的交换机制快速访问更多物品栏行。

注意：TRIPLE 和 QUAD 模式需要模组版本 2.0.0+。

• 作者：YkinLing
• AI 助手：Deepseek
• QQ 群：783492491（用于获取源代码）

（QUAD 模式需要 2.0.0+）

---

✨ 功能特性

• 多栏物品栏
  支持 DUAL、TRIPLE 和 QUAD 并排物品栏，每个物品栏有 9 个槽位。

  • DUAL 模式：左栏 = 主物品栏（0-8 槽位），右栏 = 可配置的物品栏行（第 1/2/3 行）。
  • TRIPLE/QUAD 模式：所有栏位显示不同的物品栏行；你可以使用 R 键或鼠标滚轮来交换栏位并重新排序。

• 智能物品交换
  使用 R 键（可配置）在主物品栏和扩展物品栏行（DUAL 模式）或各个栏位（TRIPLE/QUAD 模式）之间交换物品。
  支持轻按和长按操作，带有独立的行为（整行交换、单个物品、排除主手物品等）。

• 副手槽图标
  自动在左侧物品栏旁边显示你的副手物品（偏移量可调整）。

• 原版样式模式
  按下 = 键立即恢复为原版单栏外观（交换功能仍然有效）；再次按下恢复多栏显示。

• 滚轮自动交换
  当左滚越过最左侧槽位（0）时，或右滚越过最右侧槽位（8）时，模组会自动交换整行并切换左右位置（DUAL 模式）或切换焦点栏位（TRIPLE/QUAD 模式）。

• 双击数字键
  快速双击数字键（1-9），将对应槽位中的物品与扩展行/栏中相同列位置的物品进行交换。

• Ctrl+数字快捷键（2.0.0+）
  按住配置的修饰键（默认为左 Ctrl）并按下 1-4 可以快速切换模式：

  • Ctrl+1：切换原版样式模式
  • Ctrl+2：切换到 DUAL 模式
  • Ctrl+3：切换到 TRIPLE 模式
  • Ctrl+4：切换到 QUAD 模式

• 完全可配置
  所有功能都可以通过 Mod Menu 或配置文件进行精细调整。

---

🎮 默认按键绑定

按键	操作
R	轻按： 根据配置进行交换；长按： 整行交换（并可选择切换左右位置）
=	轻按： 切换原版样式模式；长按： 循环切换交换行（DUAL 模式）或旋转背包行（TRIPLE/QUAD）
1~9	双击： 与扩展栏中相同列的物品进行交换
Ctrl+1~4	快速模式切换（需要 2.0.0+，默认修饰键为左 Ctrl）

💡 长按延迟默认为 200 毫秒（可配置）。

---

⚙️ 配置选项

通过 Mod Menu（推荐）或手动编辑 config/longhotbar.json5 进行配置。

选项	描述	默认值
完全禁用模组	完全禁用模组：无多栏、无交换，= 键将不起作用。必须通过配置文件或 Mod Menu 重新启用。	false
原版样式模式	恢复原版单栏外观（交换功能仍然有效）。	false
物品栏模式	选择 DUAL、TRIPLE 或 QUAD。TRIPLE/QUAD 需要 2.0.0+。	DUAL
物品栏间距	栏位之间的像素间距（可为负数）。	-1
副手偏移	副手图标距左侧物品栏左边缘的水平偏移量（像素）。	-30
单物品交换模式（仅轻按）	开启时：轻按 R 仅交换主手物品。关闭时：轻按 R 交换整个行。	false
反转交换行为（仅轻按）	开启时：轻按 R = 仅整行交换（无位置切换），长按 R = 整行交换 + 切换位置。关闭时：相反。	false
轻按交换其他 8 个物品	开启时：轻按 R 会交换物品栏中除当前选中槽位之外的其他 8 个物品（主手物品保持不变）。覆盖上述两个选项。	false
交换行	在 DUAL 模式下与主物品栏交换的物品栏行：1 = 顶行（9-17），2 = 中间行（18-26），3 = 底行（27-35）。	3
反转交换行循环顺序	开启时，长按 = 键从下到上循环交换行（3→2→1→3），而不是从上到下。	false
长按延迟（毫秒）	触发长按操作所需按住按键的毫秒数（范围 180–1000）。	200
播放交换音效	通过按键交换时播放拾取音效（R、=、双击）。滚动轮自动交换时不播放。	true
启用 Ctrl+数字快捷键	是否允许修饰键 + 数字快速模式切换（需要 2.0.0+）。	true
快捷键修饰键	与数字 1-4 配合使用的修饰键（左 Ctrl、右 Ctrl、左 Alt、右 Alt、左 Shift、右 Shift）。	LEFT_CONTROL
交换 = 键短/长按功能	开启时：短按 = 循环交换行，长按 = 切换原版样式模式。关闭时：相反。	true

---

🛠️ 使用示例

基本游戏玩法

1. 加载模组后，你会在底部看到并排的物品栏。
2. 在 DUAL 模式下：右栏默认显示底部物品栏行（27-35 槽位）。长按 = 切换到其他行。
3. 按下数字键选择左栏上的槽位；双击该键可将该物品与右栏上相同槽位中的物品交换。
4. 按下 R（轻按或长按，取决于你的配置）快速将整行与右栏交换。
5. 当选中最左侧槽位（0）时向左滚动，或选中最右侧槽位（8）时向右滚动，模组会自动交换整行并切换左右位置（DUAL 模式）或切换焦点栏位（TRIPLE/QUAD 模式）。

进阶技巧

• 单个物品快速交换：启用“单物品交换模式”，然后轻按 R 将你主手物品与右栏对应的槽位交换。
• 保持主手物品：启用“轻按交换其他 8 个物品”。轻按 R 将交换所有其他物品栏槽位，同时保持当前选中的槽位不变——非常适合快速整理物品栏。
• 在 TRIPLE/QUAD 模式下重新排序栏位：使用 R 键（短按 = 下一栏，长按 = 上一栏）或滚轮（在边缘处）来更改每个栏位中显示哪个物品栏行。模组会相应地实际移动行之间的物品。

---

🔧 兼容性

• Minecraft 版本：1.21.11
• 模组加载器：Fabric
• 依赖项：Fabric API、Cloth Config API
• 可选：Mod Menu（提供 GUI 配置界面）

---

📝 注意事项

• 此模组仅客户端工作；无需在服务器上安装。
• 如果遇到渲染重叠或偏移问题，请调整“物品栏间距”和“副手偏移”选项。
• 启用“完全禁用模组”后，= 键将不起作用。你必须通过配置文件或 Mod Menu 重新启用模组。
• TRIPLE 和 QUAD 模式需要模组版本 2.0.0+。早期版本仅支持 DUAL 模式。

---

📄 许可证

BSD 2-Clause License