Hysk-LongHotbar

LongHotbar

LongHotbar 是一款适用于 Minecraft 1.21.11 的 Fabric 客户端模组，新增了并排多快捷栏系统，让你可以通过灵活的交换机制快速使用更多行物品栏。

注意：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+，默认修饰键为 Left Ctrl） |

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

⚙️ 配置选项

建议通过 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 |
| 长按延迟（ms） | 触发长按操作所需的按键按住时长（范围 180–1000 毫秒）。 | 200 |
| 播放交换音效 | 使用按键（R、=、双击）交换时播放拾取音效。滚轮自动交换时不会播放。 | true |
| 启用 Ctrl+数字快捷键 | 是否允许使用修饰键 + 数字键快速切换模式（需要 2.0.0+）。 | true |
| 快捷键修饰键 | 与数字键 1-4 搭配使用的修饰键（Left Ctrl、Right Ctrl、Left Alt、Right Alt、Left Shift、Right Shift）。 | LEFT_CONTROL |
| 交换 = 键的短按/长按功能 | 开启时：短按 = 循环切换交换行，长按 = 切换原版风格模式。关闭时则相反。 | true |

🛠️ 使用示例

基础玩法

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

高级技巧

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

🔧 兼容性

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

📝 注意事项

• 此模组仅客户端生效；无需安装在服务器上。
• 如果你遇到渲染重叠或偏移，请调整 Hotbar Spacing 和 Offhand Offset 选项。
• 当启用 Completely Disable Mod 时，= 键将不起作用。你必须通过配置文件或 Mod Menu 重新启用模组。
• TRIPLE 和 QUAD 模式需要模组版本 2.0.0+。更早的版本仅支持 DUAL 模式。

📄 许可证

BSD 2-Clause License