# LongHotbar<\/p>\n
**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.<\/p>\n
> **Note**: TRIPLE and QUAD modes require mod version **2.0.0+**.<\/p>\n
– **Author**: YkinLing
\n– **AI Assistant**: Deepseek
\n– **QQ Group**: 783492491 (for source code) <\/p>\n
\n
\n*(QUAD mode requires 2.0.0+)*<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Multi\u2011Bar Hotbar**
\n Supports **DUAL**, **TRIPLE**, and **QUAD** side\u2011by\u2011side hotbars, each with 9 slots.
\n – DUAL mode: left bar = main hotbar (slots 0-8), right bar = a configurable inventory row (row 1\/2\/3).
\n – TRIPLE\/QUAD mode: all bars display different inventory rows; you can swap bars and reorder them using R key or mouse scroll.<\/p>\n
– **Smart Item Swapping**
\n Use **R key** (configurable) to swap items between the main hotbar and an extended inventory row (DUAL mode) or between bars (TRIPLE\/QUAD mode).
\n Supports **tap** and **hold** actions with separate behaviors (full row, single item, exclude main hand, etc.).<\/p>\n
– **Offhand Slot Icon**
\n Automatically shows your offhand item next to the left hotbar (offset adjustable).<\/p>\n
– **Vanilla Style Mode**
\n Press **=** to instantly revert to the vanilla single\u2011bar look (swapping still works); press again to restore the multi\u2011bar display.<\/p>\n
– **Scroll Wheel Auto\u2011Swap**
\n 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).<\/p>\n
– **Double\u2011Tap Number Keys**
\n Quickly double\u2011tap a number key (1-9) to swap the item in that slot with the same column position in the extended row\/bar.<\/p>\n
– **Ctrl+Number Shortcuts** (2.0.0+)
\n Hold the configured modifier key (default Left Ctrl) and press 1-4 to quickly switch modes:
\n – Ctrl+1: toggle Vanilla Style Mode
\n – Ctrl+2: switch to DUAL mode
\n – Ctrl+3: switch to TRIPLE mode
\n – Ctrl+4: switch to QUAD mode <\/p>\n
– **Fully Configurable**
\n All features can be fine\u2011tuned via **Mod Menu** or the config file.<\/p>\n
—<\/p>\n
## \ud83c\udfae Default Key Bindings<\/p>\n
| Key | Action |
\n|————-|————————————————————————|
\n| `R` | **Tap:** swap according to configuration; **Hold:** full row swap (and optionally toggle left\/right positions) |
\n| `=` | **Tap:** toggle Vanilla Style Mode; **Hold:** cycle the swap row (DUAL mode) or rotate backpack rows (TRIPLE\/QUAD) |
\n| `1`~`9` | **Double\u2011tap:** swap the item with the same column in the extended bar |
\n| `Ctrl+1~4` | Quick mode switching (requires 2.0.0+, default modifier Left Ctrl) |<\/p>\n
> \ud83d\udca1 Long\u2011press delay is 200 ms by default (configurable).<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration Options<\/p>\n
Configure via **Mod Menu** (recommended) or manually edit `config\/longhotbar.json5`.<\/p>\n
| Option | Description | Default |
\n|——–|————-|———|
\n| **Completely Disable Mod** | Completely disables the mod: no multi\u2011bar, no swapping, `=` key won\u2019t work. Must be re\u2011enabled via config file or Mod Menu. | `false` |
\n| **Vanilla Style Mode** | Reverts to the vanilla single\u2011bar appearance (swapping still works). | `false` |
\n| **Hotbar Mode** | Choose DUAL, TRIPLE, or QUAD. TRIPLE\/QUAD require 2.0.0+. | `DUAL` |
\n| **Hotbar Spacing** | Pixel gap between bars (can be negative). | `-1` |
\n| **Offhand Offset** | Horizontal offset of the offhand icon from the left edge of the left hotbar (pixels). | `-30` |
\n| **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` |
\n| **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` |
\n| **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` |
\n| **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` |
\n| **Reverse swap row cycle order** | When ON, long\u2011pressing `=` cycles the swap row from bottom to top (3\u21922\u21921\u21923) instead of top to bottom. | `false` |
\n| **Long press delay (ms)** | Milliseconds you must hold a key to trigger a long press action (range 180\u20131000). | `200` |
\n| **Play Swap Sound Effect** | Plays a pickup sound when swapping via keys (R, =, double\u2011tap). Does not play for scroll wheel auto\u2011swap. | `true` |
\n| **Enable Ctrl+Number Shortcuts** | Whether to allow modifier key + number quick mode switching (requires 2.0.0+). | `true` |
\n| **Shortcut Modifier Key** | Modifier key used with numbers 1-4 (Left Ctrl, Right Ctrl, Left Alt, Right Alt, Left Shift, Right Shift). | `LEFT_CONTROL` |
\n| **Swap = Key Short\/Long Press Functions** | When ON: short press = cycle swap row, long press = toggle Vanilla Style Mode. When OFF: opposite. | `true` |<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Usage Examples<\/p>\n
### Basic Gameplay
\n1. After loading the mod, you\u2019ll see side\u2011by\u2011side hotbars at the bottom.
\n2. In DUAL mode: the right bar shows the bottom inventory row (slots 27-35) by default. Long\u2011press `=` to switch to a different row.
\n3. Press a number key to select a slot on the left bar; double\u2011tap it to swap that item with the same slot on the right bar.
\n4. Press `R` (tap or hold, depending on your config) to quickly swap the entire row with the right bar.
\n5. 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).<\/p>\n
### Advanced Tips
\n– **Single\u2011item quick swap**: Enable `Single Item Swap Mode`, then tap `R` to swap your main hand item with the corresponding slot on the right bar.
\n– **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 \u2013 great for quick inventory organisation.
\n– **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.<\/p>\n
—<\/p>\n
## \ud83d\udd27 Compatibility<\/p>\n
– **Minecraft version**: 1.21.11
\n– **Mod loader**: Fabric
\n– **Dependencies**: Fabric API, Cloth Config API
\n– **Optional**: Mod Menu (provides a GUI configuration screen)<\/p>\n
—<\/p>\n
## \ud83d\udcdd Notes<\/p>\n
– This mod works **client\u2011side only**; it does not need to be installed on a server.
\n– If you experience rendering overlaps or offsets, adjust the `Hotbar Spacing` and `Offhand Offset` options.
\n– When `Completely Disable Mod` is enabled, the `=` key will not work. You must re\u2011enable the mod via the config file or Mod Menu.
\n– **TRIPLE and QUAD modes require mod version 2.0.0+**. Earlier versions only support DUAL mode.<\/p>\n
—<\/p>\n
## \ud83d\udcc4 License<\/p>\n
BSD 2-Clause License<\/p>\n","protected":false},"excerpt":{"rendered":"
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.<\/p>\n","protected":false},"featured_media":83144,"template":"","meta":{"_minecraft_slug":"hysk-longhotbar","_minecraft_project_id":"JtgORGSF","_minecraft_author":"YkinLing","_minecraft_license":"BSD-2-Clause","_minecraft_downloads":2445,"_minecraft_follows":11,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"hysk-longhotbar.zip","_minecraft_size_bytes":1101437,"_minecraft_version_count":39,"_minecraft_updated_at":"2026-05-15T19:59:02.395713Z","_minecraft_date_created":"2026-04-22T05:22:37.880375Z","_minecraft_date_modified":"2026-05-15T04:36:44.225925Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hysk-longhotbar","_minecraft_icon_attachment_id":83144,"_minecraft_imported_at":"2026-06-04T18:19:45+00:00","_minecraft_import_hash":"f0ab2a94b2edebb46119a4afbeb4eb77","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,158,91,92],"mod_loader":[99,106,160],"minecraft_version":[36,37,40,41,38,81,82,83,167,163],"class_list":["post-83143","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-storage","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n