LongHotbar

LongHotbar is a Fabric client-side mod for Minecraft 1.21.11 that adds a side-by-side double hotbar, allowing you to quickly access more items from your inventory with flexible item swapping mechanics.

• Producer: YkinLing
• Auxiliary AI: Deepseek
• QQ Group: 783492491 (For obtaining the source code)

✨ Features

• Double Hotbar
  Displays two hotbars (9 slots each) side by side at the bottom of the screen – 18 slots in total.
  The left bar shows your main hotbar (slots 0-8), while the right bar shows a configurable inventory row (default: bottom row, slots 27-35).

• Smart Item Swapping
  Swap the main hotbar with a selected inventory row (full row or single item) using the R key (configurable).
  Supports tap and hold actions, each with separately configurable behavior.

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

• Quick Style Toggle
  Press = (equals) to instantly switch to the vanilla single‑bar look (swapping still works); press again to restore the double bar.

• Scroll Wheel Auto‑Swap
  When you scroll past the leftmost or rightmost slot, the mod automatically swaps the entire row and toggles the left/right bar positions.

• Double‑Tap Number Keys
  Quickly press a number key (1-9) twice to swap the item in that slot with the same position on the right bar.

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

🎮 Default Key Bindings

Key Action R Tap: swap according to configuration; Hold: swap full row (and optionally toggle left/right position) = Tap: toggle vanilla style mode (on/off); Hold: cycle through the inventory row to swap with (1→2→3→1) 1 ~ 9 Double‑tap: swap the item with the same slot on the right bar

💡 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 double hotbar, 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 Spacing Pixel gap between the left and right hotbars (can be negative). -1 Offhand Offset Horizontal offset of the offhand icon from the left edge of the left hotbar (pixels). -30 Invert Swap Behavior (Tap only) When ON: Tap R = swap full row only (no position toggle), Hold R = swap full row + toggle position. When OFF: opposite. false 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 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). This overrides the two options above. false Swap Row Which inventory row to swap with the main hotbar: 1 = top row (slots 9-17), 2 = middle row (18-26), 3 = bottom row (27-35). 3 Long press delay (ms) Milliseconds you must hold a key to trigger a long press action (range 180–1000). 200 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 Play Swap Sound Effect Plays a pickup sound when swapping items or toggling hotbar position via keys (R, =, double‑tap numbers). Does not play for scroll wheel auto‑swap. true

🛠️ Usage Examples

Basic Gameplay

1. After loading the mod, you’ll see two side‑by‑side hotbars at the bottom of the screen.
2. 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 (slot 0) selected and scroll left, or the rightmost slot (slot 8) selected and scroll right, the mod automatically swaps the full row and toggles the left/right bar positions.

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.
• Cycle inventory rows: Long‑press = to cycle through the three inventory rows without opening your inventory screen.

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

📄 License

BSD 2