Hysk-LongHotbar

# 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)

!(https://cdn.modrinth.com/data/cached_images/e15bff85d4244ceccdf69ff98298df4a80a5a73d_0.webp) !(https://cdn.modrinth.com/data/cached_images/54f59db69a52a3df2741a5d01583cdd690525f63.png) (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

| Key | Action | |-------------|------------------------------------------------------------------------| | `R` | Tap: swap according to configuration; Hold: full row swap (and optionally toggle left/right positions) | | `=` | Tap: toggle Vanilla Style Mode; Hold: 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 | |--------|-------------|---------| | Completely Disable Mod | Completely disables the mod: no multi‑bar, no swapping, `=` key won’t work. Must be re‑enabled via config file or Mod Menu. | `false` | | Vanilla Style Mode | Reverts to the vanilla single‑bar appearance (swapping still works). | `false` | | Hotbar Mode | Choose DUAL, TRIPLE, or QUAD. TRIPLE/QUAD require 2. 0. 0+. | `DUAL` | | Hotbar Spacing | Pixel gap between bars (can be negative). | `-1` | | Offhand Offset | Horizontal offset of the offhand icon from the left edge of the left hotbar (pixels). | `-30` | | Single Item Swap Mode (Tap only) | When ON: Tap R swaps only the main hand item. When OFF: Tap R swaps the entire row. | `false` | | Invert Swap Behavior (Tap only) | When ON: Tap R = full row swap only (no position toggle), Hold R = full row swap + toggle position. When OFF: opposite. | `false` | | Tap swaps the other 8 items | 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 Row | 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` | | Reverse swap row cycle order | When ON, long‑pressing `=` cycles the swap row from bottom to top (3→2→1→3) instead of top to bottom. | `false` | | Long press delay (ms) | Milliseconds you must hold a key to trigger a long press action (range 180–1000). | `200` | | Play Swap Sound Effect | Plays a pickup sound when swapping via keys (R, =, double‑tap). Does not play for scroll wheel auto‑swap. | `true` | | Enable Ctrl+Number Shortcuts | Whether to allow modifier key + num