LongHotbar

LongHotbar 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.

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

• Author: YkinLing
• AI Assistant: Deepseek
• QQ Group: 783492491 (for source code)

(QUAD mode requires 2.0.0+)

✨ Features

• Multi‑Bar Hotbar
  Supports DUAL, TRIPLE, 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.

  • Smart Item Swapping
    Use R key (configurable) to swap items between the main hotbar and an extended inventory row (DUAL mode) or between bars (TRIPLE/QUAD mode).
    Supports tap 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).

  • Vanilla Style Mode
    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

  • Fully Configurable
    All features can be fine‑tuned via Mod Menu or the config file.

🎮 Default Key Bindings

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

⚙️ Configuration Options

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

🛠️ 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

• Single‑item quick swap: Enable Single Item Swap Mode, then tap R to swap your main hand item with the corresponding slot on the right bar.
• Keep your main hand item: 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

• Minecraft version: 1.21.11
• Mod loader: Fabric
• Dependencies: Fabric API, Cloth Config API
• Optional: Mod Menu (provides a GUI configuration screen)

📝 Notes

• This mod works client‑side only; 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