Hysk-LongHotbar

LongHotbar

side-by-side multi hotbar is a Fabric client-side mod for Minecraft 1.21.11 that adds a side-by-side multi hotbar system, allowing you to quickly access more inventory rows with flexible swapping mechanics.

> 2.0.0+: TRIPLE and QUAD modes require mod version 2.0.0+.

- QQ Group: YkinLing - QQ Group: Deepseek - QQ Group: 783492491 (for source code)

*(QUAD mode requires 2.0.0+)*

---

✨ Features

- QUAD Supports QUAD, QUAD, and QUAD side‑by‑side hotbars, each with 9 slots. - DUAL mode: left bar = main hotbar (slots 0-8), right bar = a configurable inventory row (row 1/2/3). - TRIPLE/QUAD mode: all bars display different inventory rows; you can swap bars and reorder them using R key or mouse scroll.

- hold Use hold (configurable) to swap items between the main hotbar and an extended inventory row (DUAL mode) or between bars (TRIPLE/QUAD mode). Supports hold and hold actions with separate behaviors (full row, single item, exclude main hand, etc.).

- Offhand Slot Icon Automatically shows your offhand item next to the left hotbar (offset adjustable).

- = Press = to instantly revert to the vanilla single‑bar look (swapping still works); press again to restore the multi‑bar display.

- Scroll Wheel Auto‑Swap When you scroll past the leftmost slot (0) while scrolling left, or past the rightmost slot (8) while scrolling right, the mod automatically swaps full rows and toggles left/right positions (DUAL mode) or changes the focused bar (TRIPLE/QUAD mode).

- Double‑Tap Number Keys Quickly double‑tap a number key (1-9) to swap the item in that slot with the same column position in the extended row/bar.

- Ctrl+Number Shortcuts (2.0.0+) Hold the configured modifier key (default Left Ctrl) and press 1-4 to quickly switch modes: - Ctrl+1: toggle Vanilla Style Mode - Ctrl+2: switch to DUAL mode - Ctrl+3: switch to TRIPLE mode - Ctrl+4: switch to QUAD mode

- Mod Menu All features can be fine‑tuned via Mod Menu or the config file.

---

🎮 Default Key Bindings

| Key | Action | |-------------|------------------------------------------------------------------------| | `R` | Double‑tap: swap according to configuration; Double‑tap: full row swap (and optionally toggle left/right positions) | | `=` | Double‑tap: toggle Vanilla Style Mode; Double‑tap: cycle the swap row (DUAL mode) or rotate backpack rows (TRIPLE/QUAD) | | `1`~`9` | Double‑tap: swap the item with the same column in the extended bar | | `Ctrl+1~4` | Quick mode switching (requires 2.0.0+, default modifier Left Ctrl) |

> 💡 Long‑press delay is 200 ms by default (configurable).

---

⚙️ Configuration Options

Configure via Mod Menu (recommended) or manually edit `config/longhotbar.json5`.

| Option | Description | Default | |--------|-------------|---------| | Swap = Key Short/Long Press Functions | Completely disables the mod: no multi‑bar, no swapping, `=` key won’t work. Must be re‑enabled via config file or Mod Menu. | `false` | | Swap = Key Short/Long Press Functions | Reverts to the vanilla single‑bar appearance (swapping still works). | `false` | | Swap = Key Short/Long Press Functions | Choose DUAL, TRIPLE, or QUAD. TRIPLE/QUAD require 2.0.0+. | `DUAL` | | Swap = Key Short/Long Press Functions | Pixel gap between bars (can be negative). | `-1` | | Swap = Key Short/Long Press Functions | Horizontal offset of the offhand icon from the left edge of the left hotbar (pixels). | `-30` | | Swap = Key Short/Long Press Functions | When ON: Tap R swaps only the main hand item. When OFF: Tap R swaps the entire row. | `false` | | Swap = Key Short/Long Press Functions | When ON: Tap R = full row swap only (no position toggle), Hold R = full row swap + toggle position. When OFF: opposite. | `false` | | Swap = Key Short/Long Press Functions | When ON: tapping R swaps the 8 items in the hotbar other than the currently selected slot (main hand item stays). Overrides the two options above. | `false` | | Swap = Key Short/Long Press Functions | Which inventory row to swap with the main hotbar in DUAL mode: 1 = top row (9-17), 2 = middle row (18-26), 3 = bottom row (27-35). | `3` | | Swap = Key Short/Long Press Functions | When ON, long‑pressing `=` cycles the swap row from bottom to top (3→2→1→3) instead of top to bottom. | `false` | | Swap = Key Short/Long Press Functions | Milliseconds you must hold a key to trigger a long press action (range 180–1000). | `200` | | Swap = Key Short/Long Press Functions | Plays a pickup sound when swapping via keys (R, =, double‑tap). Does not play for scroll wheel auto‑swap. | `true` | | Swap = Key Short/Long Press Functions | Whether to allow modifier key + number quick mode switching (requires 2.0.0+). | `true` | | Swap = Key Short/Long Press Functions | Modifier key used with numbers 1-4 (Left Ctrl, Right Ctrl, Left Alt, Right Alt, Left Shift, Right Shift). | `LEFT_CONTROL` | | Swap = Key Short/Long Press Functions | When ON: short press = cycle swap row, long press = toggle Vanilla Style Mode. When OFF: opposite. | `true` |

---

🛠️ Usage Examples

Basic Gameplay

1. After loading the mod, you’ll see side‑by‑side hotbars at the bottom. 2. In DUAL mode: the right bar shows the bottom inventory row (slots 27-35) by default. Long‑press `=` to switch to a different row. 3. Press a number key to select a slot on the left bar; double‑tap it to swap that item with the same slot on the right bar. 4. Press `R` (tap or hold, depending on your config) to quickly swap the entire row with the right bar. 5. When you have the leftmost slot (0) selected and scroll left, or the rightmost slot (8) selected and scroll right, the mod automatically swaps the full row and toggles left/right positions (DUAL mode) or changes the focused bar (TRIPLE/QUAD mode).

Advanced Tips

- Reorder bars in TRIPLE/QUAD mode: Enable `Single Item Swap Mode`, then tap `R` to swap your main hand item with the corresponding slot on the right bar. - Reorder bars in TRIPLE/QUAD mode: Enable `Tap swaps the other 8 items`. Tapping `R` will swap all other hotbar slots while leaving the currently selected slot untouched – great for quick inventory organisation. - Reorder bars in TRIPLE/QUAD mode: Use R key (short press = next bar, long press = previous bar) or scroll wheel (at edges) to change which inventory row appears in which bar. The mod physically moves items between rows accordingly.

---

🔧 Compatibility

- Optional: 1.21.11 - Optional: Fabric - Optional: Fabric API, Cloth Config API - Optional: Mod Menu (provides a GUI configuration screen)

---

📝 Notes

- This mod works TRIPLE and QUAD modes require mod version 2.0.0+; it does not need to be installed on a server. - If you experience rendering overlaps or offsets, adjust the `Hotbar Spacing` and `Offhand Offset` options. - When `Completely Disable Mod` is enabled, the `=` key will not work. You must re‑enable the mod via the config file or Mod Menu. - TRIPLE and QUAD modes require mod version 2.0.0+. Earlier versions only support DUAL mode.

---

📄 License

BSD 2-Clause License