🧪 POTION BELT

A vanilla-friendly potion belt system for Minecraft 1.21.1

Carry your potions. Organize your loadout. Drink them instantly with configurable hotkeys.

Brew your potions. Fill your belt. Continue the adventure.

⚗️ A BETTER WAY TO CARRY POTIONS

Potion Belt expands Minecraft's alchemy system with wearable potion belts designed for exploration, combat, and long adventures.

Instead of constantly opening your inventory and moving potions to the hotbar, equip a belt, prepare your potion loadout, and access each slot through dedicated hotkeys.

No automatic effects. No infinite potions. No shortcuts around brewing.

You still gather ingredients, brew every potion, and manage your resources.

Potion Belt simply makes preparation more useful.

🎒 THREE BELTS. ONE ALCHEMIST'S JOURNEY.

Start simple. Improve your equipment. Become a Grandmaster Alchemist.

🟤 ALCHEMIST'S BELT

3 Potion Slots • 4 Potions per Slot

Your first Potion Belt. Designed for early exploration and players beginning their journey into alchemy.

⚙️ MASTER ALCHEMIST'S BELT

4 Potion Slots • 8 Potions per Slot

An improved belt for experienced adventurers. Requires the previous Alchemist's Belt to craft.

👑 GRANDMASTER ALCHEMIST'S BELT

5 Potion Slots • 16 Potions per Slot

The ultimate Potion Belt. Built for dangerous structures, long expeditions, and prepared late-game players.

Alchemist → Master → Grandmaster

🏗️ PREPARE YOUR POTION LOADOUT

Meet the Advanced Alchemy Bench.

The Advanced Alchemy Bench is a dedicated workstation for managing your Potion Belt.

Place your belt inside the bench and fill the available slots with compatible potions.

Each belt slot stores multiple potions of the same type. The maximum capacity is determined by your belt tier.

Prepare before the adventure. Drink when it matters.

⚡ YOUR POTIONS. ONE KEY AWAY.

Once your Potion Belt is equipped in the Curios Belt Slot, your prepared potions become available through dedicated hotkeys.

Z — SLOT 1
X — SLOT 2
C — SLOT 3
V — SLOT 4
B — SLOT 5

Press the corresponding key and your character begins drinking the potion stored in that slot.

No inventory management in the middle of combat.

No moving potions back and forth from your hotbar.

Choose. Drink. Continue fighting.

All Potion Belt keybinds can be customized through Options → Controls.

🎨 A VANILLA-FRIENDLY POTION HUD

Your equipped Potion Belt is displayed through a lightweight HUD near the hotbar.

At a glance, you can see:

Stored potions
Potion quantities
Assigned hotkeys
Available belt slots
Empty slots
Potion usage status

The HUD dynamically reflects the tier of your equipped belt.

Its visibility, position, scale, empty slots, and particle settings can be customized through the client configuration.

✨ MAGIC GULP

A new treasure enchantment created for Potion Belt.

Magic Gulp reduces the drinking time of potions consumed through your equipped Potion Belt.

Apply Magic Gulp to chest armor using an Anvil.

MAGIC GULP I

20% Faster Potion Drinking

MAGIC GULP II

40% Faster Potion Drinking

MAGIC GULP III

60% Faster Potion Drinking

The enchantment only affects potions consumed through Potion Belt.

Higher levels become increasingly valuable during dangerous exploration and combat where drinking time matters.

🗺️ FIND MAGIC GULP IN THE WORLD

Magic Gulp is a treasure enchantment.

You cannot normally obtain it from the Enchanting Table.

To find Magic Gulp, explore Minecraft structures and search their loot chests.

🏘️ VILLAGE CLERIC HOUSES

An early opportunity to discover Magic Gulp.

Magic Gulp I can appear in Cleric-related village chests.

Magic Gulp II is also possible, but extremely rare.

Magic Gulp III cannot be found in villages.

📚 STRONGHOLD LIBRARIES

Search Stronghold Library chests for Magic Gulp enchanted books.

A valuable destination for alchemists already progressing toward the End.

⚔️ TRIAL CHAMBERS

Magic Gulp enchanted books can appear in Trial Chamber reward loot.

Regular rewards may contain lower or intermediate enchantment levels.

☠️ OMINOUS TRIAL REWARDS

Take on Ominous Trials for better opportunities to discover stronger Magic Gulp books.

Greater danger brings greater alchemical rewards.

🏚️ WOODLAND MANSIONS

Rare Magic Gulp books can be discovered while searching Woodland Mansion loot.

🌌 ANCIENT CITIES

Deep beneath the world, Ancient City loot can contain powerful Magic Gulp enchanted books.

One of the most dangerous destinations for players searching for advanced alchemical equipment.

⭐ THE SEARCH FOR MAGIC GULP III

Magic Gulp III is intentionally rare.

The strongest level cannot be discovered in Village Cleric loot.

Players searching for Magic Gulp III must venture into more dangerous structures and advanced content.

🏘️ Villages introduce the enchantment.

📚 Strongholds and Trial Chambers continue the progression.

☠️ Ominous Trials, Woodland Mansions, and Ancient Cities reward the most dedicated explorers.

📖 HOW IT WORKS

1️⃣ CRAFT YOUR FIRST BELT

Create an Alchemist's Belt and begin with three potion slots.

2️⃣ EQUIP IT

Equip the belt in the Curios Belt Slot.

3️⃣ PREPARE YOUR POTIONS

Place the belt inside the Advanced Alchemy Bench and configure your potion loadout.

4️⃣ EXPLORE

Your equipped Potion Belt HUD displays every prepared potion and its assigned hotkey.

5️⃣ DRINK

Press the corresponding hotkey to consume a potion directly from the belt.

6️⃣ UPGRADE

Progress from Alchemist to Master and finally Grandmaster.

7️⃣ MASTER MAGIC GULP

Explore the world, discover Magic Gulp books, and improve your potion drinking speed.

🔨 CRAFTING & PROGRESSION

ALCHEMIST'S BELT

3 Slots • 4 Potions per Slot

Leather • String • Glass Bottle

Your entry into Potion Belt progression.

MASTER ALCHEMIST'S BELT

4 Slots • 8 Potions per Slot

Iron • Blaze Powder • Copper • Glass Bottle

Requires an Alchemist's Belt.

GRANDMASTER ALCHEMIST'S BELT

5 Slots • 16 Potions per Slot

Gold • Netherite Scrap • Blaze Rods • Glass Bottle

Requires a Master Alchemist's Belt.

ADVANCED ALCHEMY BENCH

Copper • Brewing Stand • Stone • Crafting Table

Your dedicated workstation for Potion Belt management.

🧩 MOD COMPATIBILITY

Potion Belt supports compatible modded drinkable potions through:

potionbelt:belt_potions

Modpack developers can use this item tag to add compatible potion items from other mods.

By default, the belt does not accept Splash Potions, Lingering Potions, Milk, Honey, Food, or Empty Glass Bottles.

🔌 REQUIREMENTS

Minecraft Java Edition 1.21.1
NeoForge 21.1
Java 21
Curios API 9.5.1+1.21.1 or newer

⚠️ Only Minecraft 1.21.1 is currently supported.

🌿 DESIGNED TO FEEL VANILLA

Potion Belt does not replace Minecraft's potion system.

It expands it.

You still gather ingredients.

You still explore the Nether.

You still brew every potion.

You still manage your resources.

You still search dangerous structures for rare treasure.

Potion Belt simply makes prepared players better prepared.

🧪 BREW. PREPARE. EXPLORE.

Fill your belt and continue the adventure.

Potion Belt currently supports Minecraft 1.21.1 with NeoForge only.