A dedicated 3x9 potion container with fast, column-based drinking — no more digging through the hotbar.
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 before your first drink.
Two independent loader targets, same gameplay on both — pick whichever loader you already use.
Fabric
| Minecraft | 1.21.11 |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.141.3+1.21.11 |
| Java | 21+ |
NeoForge
| Minecraft | 26.2 |
| NeoForge | 26.2.0.21-beta+ |
| Java | 25+ |
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 page.
Fabric
- Install Fabric Loader for Minecraft 1.21.11.
- Download Fabric API for the same
version and drop it in your
mods/folder. - Download Potion's Belt and drop it in
mods/too.
NeoForge
- Install NeoForge for Minecraft 26.2.
- Download Potion's Belt and drop it in
mods/. No separate API mod needed — NeoForge is the mod loader itself.
See the wiki for a full usage guide, keybind setup, and column-loadout tips (loader-independent — the gameplay is identical).
| Language | Locale | File |
|---|---|---|
| 🇬🇧 English (US) | en_us |
en_us.json |
| 🇵🇹 Portuguese (Portugal) | pt_pt |
pt_pt.json |
Note
Want to add or fix a translation? See the wiki's Translations page.
wiki/ wiki pages, drafted locally for now
potions-belt-fabric-1.21.11/ the Fabric mod (Gradle project root)
potions-belt-neoforge-26.2/ the NeoForge mod (Gradle project root)
Same gameplay, two independent per-loader Gradle projects — not a shared-core multiloader setup. Build and run each from inside its own folder.
Fabric — requires Java 21 (JDK). From potions-belt-fabric-1.21.11/:
./gradlew build # produces the mod jar in build/libs/, runs unit tests
./gradlew runClient # launches a dev Minecraft client with the modNeoForge — requires Java 25 (JDK). From potions-belt-neoforge-26.2/:
./gradlew build # produces the mod jar in build/libs/
./gradlew runClient # launches a dev Minecraft client with the mod(Windows: use gradlew.bat instead of ./gradlew in either folder.)
Tip
The built jar ends up in each project's own build/libs/ — drop that jar
(not the -sources.jar, where present) into your mods/ folder to test
a local build.
Contributions, bug reports, and translations are welcome — see CONTRIBUTING.md for the workflow, and the Code of Conduct for community standards. Security issues: see SECURITY.md.
Warning
Target the dev branch, not main, when opening a pull request — see
Branches below.
Development happens on dev; main holds the stable state and is updated
by merging dev when a milestone is ready.
In active development. Core gameplay is complete and in-game verified on both loaders; polish, docs, and configurability are ongoing.
- Planning: loader decision, architecture, edge cases
- Repository setup
- Skeleton builds and runs
- GUI (3x9 menu, potion-only filter, persistence)
- Drinking via right click
- Column selection: sticky default, modifier-gated hotbar keys + scroll, HUD preview
- Polish: sounds, column-selection feedback, edge-case pass
- NeoForge port: full gameplay parity with Fabric, in-game verified
- Docs pass: community-health files, wiki (in progress)
- Configurable settings (scroll direction, no-pre-selector mode, combined inventory+belt tab)
- Localization: community translation process + initial languages
- Belt skin/texture applier (idea stage, not scoped)