Hysk-LongHotbar
LongHotbar The dual-column side-by-side quick bar enables you to quickly access more items in your backpack and offers a flexible item exchange mechanism.
Автор: YkinLing45,1 тыс.32обновлён 15 окт. 2026 г.
ХранениеУтилиты
Описание
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
| 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 + number quick mode switching (requires 2.0.0+). | true |
| Shortcut Modifier Key | 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
- After loading the mod, you’ll see side‑by‑side hotbars at the bottom.
- In DUAL mode: the right bar shows the bottom inventory row (slots 27-35) by default. Long‑press
=to switch to a different row. - 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.
- Press
R(tap or hold, depending on your config) to quickly swap the entire row with the right bar. - 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 tapRto 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. TappingRwill 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 SpacingandOffhand Offsetoptions. - When
Completely Disable Modis 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
Галерея
Последние версии
Все версии →beta
Hysk-LongHotbar 2.2.0Q+26.3
2.2.0Q+26.315 окт. 2026 г.487Minecraft: 26.3fabric
Что нового
> Fixed
- Fixed the default key bindings incorrectly showing as Arrow Up, F4, and Numpad 8.
- Cause: Minecraft 26.3 migrated from GLFW to SDL3, and the KeyMapping constructor expects an SDL scancode, not a keycode.
- Now correctly displays: R (Swap Items), = (Toggle Vanilla Style), ` (Scroll Multiplier Modifier).
beta
Hysk-LongHotbar 2.2.0I+1.20.1forge
2.2.0I+1.20.1forge10 окт. 2026 г.1,2 тыс.Minecraft: 1.20.1forge
Что нового
- The fix only involves the build configuration and the Mixin mapping.
- Improve compatibility issues in the relevant part
beta
Hysk-LongHotbar 2.2.0+26.3
2.2.0+26.33 окт. 2026 г.358Minecraft: 26.3fabric
beta
Hysk-LongHotbar 2.2.0K+26.2
2.2.0K+26.26 сент. 2026 г.890Minecraft: 26.2fabric
Что нового
[LongHotbar] Fix: Fabric scroll wheel accidentally triggers swap in GUI
- Symptom: Scrolling at hotbar edge while inventory/chest is open caused a full row swap.
- Cause: handleScroll lacked a check for client.gui.screen(), allowing edge-swap logic in GUI contexts.
- Fix: Added if (client.gui.screen() != null) return false; to disable mod scroll behavior in GUI.
- Verification: No swap occurs in GUI; vanilla scrolling works; HUD functionality remains intact.
beta
Hysk-LongHotbar 2.2.0J+1.21.1+neoforge
2.2.0J+1.21.1+neoforge30 авг. 2026 г.4 тыс.Minecraft: 1.21.1neoforge
Что нового
- Fixed: In DUAL mode, when “Enable middle-click pick block (row swap)” is enabled, middle-clicking a block only searched the configured swapRow row, preventing row swaps from other inventory rows. Now it traverses all non-main rows (9, 18, 27) to find matching items, aligning the row-swap behavior with TRIPLE/QUAD modes.
beta
Hysk-LongHotbar 2.2.0+forge
2.2.0+forge29 авг. 2026 г.2,6 тыс.Minecraft: 1.20.1forge
Что нового
- Added new config option Enable middle-click pick block (row swap) (default: false) to control middle-click block picking behavior.
1. When false (vanilla behavior): middle-click only searches the 9 hotbar slots.
2. When true: if the target block is not in the hotbar, the mod searches the configured inventory rows (DUAL mode: the row defined by swapRow; TRIPLE/QUAD: backpack rows 9, 18, 27), swaps the entire matching row into the hotbar, and automatically moves the selection highlight to the column of the swapped item, ensuring the held item matches the highlighted slot.
- New key "Scroll Multiplier Modifier" default binding (curly brackets).
- Added new Scroll Multiplier (default: 3 blocks)
1. Fixed the highlight not following the main hotbar row when using scroll multiplier in DUAL mode; now correctly synchronized.
beta
Hysk-LongHotbar 2.2.0H+26.2
2.2.0H+26.229 авг. 2026 г.227Minecraft: 26.2fabric
Что нового
[LongHotbar] Fabric: Short press of = key behavior:
- DUAL mode (disableMod=false): Only cycles the right-side hotbar row (swapRow 1→2→3), left/right positions unchanged.
- Vanilla Style mode (disableMod=true): Swaps the current extended row with the main row, toggles swappedPosition, then updates swapRow.
- This aligns with NeoForge behavior, fixing the previous issue of "always swapping the right side".
beta
Hysk-LongHotbar 2.2.0+26.2
2.2.0+26.229 авг. 2026 г.16Minecraft: 26.2fabric
Что нового
- Added new config option Enable middle-click pick block (row swap) (default: false) to control middle-click block picking behavior.
1. When false (vanilla behavior): middle-click only searches the 9 hotbar slots.
2. When true: if the target block is not in the hotbar, the mod searches the configured inventory rows (DUAL mode: the row defined by swapRow; TRIPLE/QUAD: backpack rows 9, 18, 27), swaps the entire matching row into the hotbar, and automatically moves the selection highlight to the column of the swapped item, ensuring the held item matches the highlighted slot.
- New key "Scroll Multiplier Modifier" default binding (curly brackets).
- Added new Scroll Multiplier (default: 3 blocks)
1. Fixed the highlight not following the main hotbar row when using scroll multiplier in DUAL mode; now correctly synchronized.
beta
Hysk-LongHotbar 2.2.0+1.21.1+neoforge
2.2.0+1.21.1+neoforge28 авг. 2026 г.201Minecraft: 1.21.1neoforge
Что нового
- Added new config option Enable middle-click pick block (row swap) (default: false) to control middle-click block picking behavior.
1. When false (vanilla behavior): middle-click only searches the 9 hotbar slots.
2. When true: if the target block is not in the hotbar, the mod searches the configured inventory rows (DUAL mode: the row defined by swapRow; TRIPLE/QUAD: backpack rows 9, 18, 27), swaps the entire matching row into the hotbar, and automatically moves the selection highlight to the column of the swapped item, ensuring the held item matches the highlighted slot.
- New key "Scroll Multiplier Modifier" default binding (curly brackets).
- Added new Scroll Multiplier (default: 3 blocks)
1. Fixed the highlight not following the main hotbar row when using scroll multiplier in DUAL mode; now correctly synchronized.
alpha
Hysk-LongHotbar 2.1.0Y+1.21.1+neoforge
2.1.0Y+1.21.1+neoforge9 авг. 2026 г.2,4 тыс.Minecraft: 1.21.1neoforge
Что нового
- LongHotbar fixes an issue where, when swapping at the edge of the scroll wheel, the type of the currently opened container was not checked, resulting in an index out-of-bounds error when attempting to swap items on the PhysicsBogeyMenu GUI of Simurail-Mod (without item slots), causing a crash.