UltimateHotbars

# UltimateHotbars **UltimateHotbars** is a Minecraft Forge mod (1.20.1 / Forge) that gives you virtually unlimited custom hotbars and pages. Easily switch between them in-game or in any inventory screen, save and restore layouts, and keep your tools, gear and resources organized! **NO longer necessary because V2 now creates a new hotbars.dat file in the world folder and is no longer global.** ~~This is the new Version 2 of the mod. Version 1 will no longer be worked on or updated so please switch to the V2 branch/version. In the config menu hit the Purge Data Files button if your comming from V1.x.x as the hot bar data files are not compatable and it will be all messed up. (Sorry you will have to start fresh with your Hot bars.)~~ V2.1.x Adds new overlay of hot bars to inventory/container screens. has drag and drop support from the creative inventory or JEI. --- ## 🌟 Features - **Virtual Hotbars & Pages** Create up to 100 hotbars per page (configurable), and as many pages as you like. - **Peek hotbars popup** Hold ALT (by default can be changed) to popup a list of hotbars from the current page. You can click a slot to change to it, page list to switch pages and drag and drop support. - **Hot bars overlay** Inventory, chest, anvil ect... you will be able to interact with you hot bars in that screen. - **Seamless Switching** Switch hotbars or pages via keybinds inside the GUI and containers. - **Persistent Storage** Your layouts are automatically saved and loaded between sessions. - **Quick Clear** Instantly clear the current hotbar with a single key. - **Configurable Sounds & HUD** Optional click sounds, on-screen page labels, debug overlay, and color themes. --- ## 🎮 Default Keybindings | Action | Key(s) | |----------------------------------|---------------------| | Open/Close Hotbar GUI | `h` | | Next Hotbar | `=` | | Previous Hotbar | `-` | | Next Page (Ctrl + `=`) | `Ctrl + =` | | Previous Page (Ctrl + `-`) | `Ctrl + -` | | Clear Current Hotbar | `Delete` | | Popup for hotbars | `Alt` | > **Tip:** You can rebind all of these in the Controls menu. --- ## ⚙️ Configuration Options Accessible via the in-game **Config** button in the Hotbar GUI, or by editing `config/ultimatehotbar-client.toml`. | Option | Default | Description | |---------------------------------|-----------|-------------------------------------------------------------------------------------------| | **enableSounds** | `true` | Play a click/drum sound when switching hotbars or pages. | | **maxHotbarsPerPage** | `20` | How many hotbars each page can hold (1–100). | | **showDebugOverlay** | `false` | Draws extra debug info (for troubleshooting). | | **showHudLabel** | `true` | Display “Pg 1/3” style labels on your HUD. | | **showHudLabelBackground** | `true` | Enable a background behind the HUD label text. | | **highlightColor** | `` | RGBA color for the selected hotbar highlight in the GUI. | | **hudLabelBackgroundColor** | `` | RGBA color for the HUD label background. | | **hudLabelTextColor** | `` | RGBA color for the HUD label text. | | **hoverBorderColor** | `` | RGBA color for the slot-hover border in the GUI. | | **scrollThrottleMs** | `50` | delay (10–150 ms) between scroll/key-hold repeats to avoid duplicates. | - **Scroll Throttle** Adjustable delay to prevent duplicate/overwrite when scrolling quickly. you can lower the delay if you really want to but it might mess up your hotbars. If you are getting hot bars copying over eachother then raise this number but default should be ok for most systems this was put in just incase your scrolling faster then your systems I/O. --- ## 💡 Usage 1. **Open the Hotbar GUI** with your configured key (default `h`). 2. **Add / Remove Pages** or **Hotbars** via the buttons on the left. 3. **Drag & Drop** items in the GUI to rearrange. 4. **Mouse Scroll** or use (default -,=) or **⬆️/⬇️ keys** to switch hotbars. 5. **Mouse Scroll** over page list or **Ctrl + -/=** to flip pages. 6. **Delete** key clears the current hotbar instantly. 7. **Close GUI** with `