# Potion's Belt [![Minecraft](https://img.shields.io/badge/Minecraft-1.21.11-62B47A)](https://www.minecraft.net/) [![Fabric](https://img.shields.io/badge/Fabric-0.18.4%2B-C8A87A)](https://fabricmc.net/) [![Java](https://img.shields.io/badge/Java-21%2B-ED8B00?logo=openjdk&logoColor=white)](https://adoptium.net/) [![License](https://img.shields.io/badge/License-GPL--3.0%2B-blue)](https://github.com/scr0ols/Potions-Belt/blob/main/LICENSE) *A dedicated 3x9 potion container with fast, column-based drinking — no more digging through the hotbar.*

--- ## What it does Potion's Belt adds a single item: a 27-slot belt that accepts drinkable potions and empty bottles, plus a fast way to drink from it without opening any GUI mid-fight. | Feature | Description | |---|---| | **Drink on right click** | The vanilla 1.6s drink animation and timing — no balance changes, just faster access. | | **Column-based loadout** | 3 rows x 9 columns. Dedicate each column to one potion type; drinking only ever replaces the exact slot drunk, so a column's contents never drift. | | **Sticky column selection** | Hold the remappable "Column Select" modifier + a hotbar key (1-9) or scroll to pick a column. Your pick is remembered as the default for every future drink, not just the current one. | | **Row and belt-wide fallback** | If the selected column's top potion is gone, the belt falls back to row 2, then row 3, of that column; if the whole column is empty, it falls back further to the first potion anywhere in the belt, only failing outright if the belt has none left at all. | | **HUD preview** | An icon + name next to the hotbar always shows exactly which potion is about to be drunk. | | **Bottles return to the belt** | Drinking turns only that slot into an empty bottle, in place — nothing else shifts. | | **Two ways to open the GUI** | A dedicated keybind (either hand), or E while the belt is specifically your **main-hand** item. | | **Custom sounds** | Distinct sounds for opening the belt and for each drink starting/ending. |

TIP

All of Potion's Belt's keybinds are **unbound by default** and fully remappable under **Options > Controls > Potions Belt** — see the [Column Loadouts & Keybinds wiki page](https://github.com/scr0ols/Potions-Belt/wiki/Column-Loadouts) before your first drink.

--- ## Requirements | | | |---|---| | Minecraft | 1.21.11 | | Fabric Loader | 0.18.4+ | | Fabric API | 0.141.3+1.21.11 | | Java | 21+ |

NOTE

The belt's consumption logic runs server-side, so multiplayer requires the mod on both the server and every client — see the wiki's [Installation](https://github.com/scr0ols/Potions-Belt/wiki/Installation) page.

--- ## Installation 1. Install [Fabric Loader](https://fabricmc.net/use/) for Minecraft 1.21.11. 2. Download [Fabric API](https://modrinth.com/mod/fabric-api) for the same version and drop it in your `mods/` folder. 3. Download Potion's Belt and drop it in `mods/` too. See the [wiki](https://github.com/scr0ols/Potions-Belt/wiki) for a full usage guide, keybind setup, and column-loadout tips. --- ## Languages | Language | Locale | File | |---|---|---| | 🇬🇧 English (US) | `en_us` | [`en_us.json`](https://github.com/scr0ols/Potions-Belt/blob/main/potions-belt-fabric-1.21.11/src/main/resources/assets/potions-belt/lang/en_us.json) | | 🇵🇹 Portuguese (Portugal) | `pt_pt` | [`pt_pt.json`](https://github.com/scr0ols/Potions-Belt/blob/main/potions-belt-fabric-1.21.11/src/main/resources/assets/potions-belt/lang/pt_pt.json) |

NOTE

Want to add or fix a translation? See the wiki's [Translations](https://github.com/scr0ols/Potions-Belt/wiki/Translations) page.

--- ## License

[GPL-3.0+](https://github.com/scr0ols/Potions-Belt/blob/main/LICENSE)

Scr0ols