Potion Mechanics
Vanilla brewing has always felt a little boxed in. You can push Strength to level two, stretch a potion to eight minutes, and that is where the ceiling sits. Potion Mechanics tears that ceiling down without adding a single new item, block, or GUI. It is a fully data-driven overhaul that lets server owners push effect levels, durations, and even custom attribute potions far beyond what Mojang ever intended.
What Makes This Add-On Different
Most potion mods dump a pile of new bottles and ingredients into your inventory. This one does not. Everything runs through vanilla potions, effects, and data components, which means your world stays clean and your item list stays familiar. The mod is entirely server-side, so friends joining your world do not need to install anything at all. They connect with a stock client and see every upgraded potion render correctly, because levels, durations, and hidden particles travel through standard effect packets.
Supported Versions and Loaders
If you are running a modern server, chances are you are covered. The add-on supports Fabric 1.19.2 through 1.21.11, Forge 1.19.2 through 1.21.11, and NeoForge 1.21.1. That is a wide net, and it means you can keep your existing modpack intact while dropping this in.
Upgrading Potions You Already Brewed
Here is the clever part. Vanilla brewing is untouched, so you still make a normal potion the normal way. Once it hits its vanilla maximum, you keep going in the same brewing stand using three special ingredients:
- Echo Shard raises the potion's level by one step.
- Amethyst Shard extends the duration by one step, sixty seconds by default.
- Prismarine Shard or Crystals hide the effect particles while keeping the HUD icon visible.
Each upgrade applies one step per brew, and upgrades combine freely in any order. Raise the level, stretch the time, hide the particles. Once you hit the configured limit, the stand simply refuses the ingredient instead of consuming it, so you never waste rare materials on a potion that cannot improve further.
Custom Attribute Potions
This is where things get genuinely interesting. JSON files in config/potionmechanics/attribute_potions/ let you define potions built from attribute modifiers. Each definition picks a vanilla carrier effect purely for the HUD icon and countdown, plus an optional brewing recipe. Two examples ship on first launch: a Potion of Reach brewed from an Awkward Potion and an Eye of Ender, and a Haste potion made with a Gold Block. The real gameplay comes from temporary attribute modifiers applied server-side and removed automatically, even after a relog or death.
Comparator Signals and Configuration
Redstone engineers will appreciate the comparator overhaul. By default, a brewing stand now pulses a short signal when the current potion finishes rather than reporting fullness. Duration and strength are configurable, and switching the mode back to vanilla restores the original behaviour. The main config file, config/potionmechanics.json, is created automatically and never overwritten. It holds global and per-effect limits like maxLevelAll and maxDuration, ingredient toggles, and the comparator block. Values outside their valid range are clamped, and broken files degrade to defaults with a log warning instead of disabling the mod entirely.
Commands That Apply Instantly
Everything is adjustable in-game through the /potion command tree, complete with Brigadier autocompletion:
- /potion reload reloads configuration on the fly.
- /potion gamerule tweaks parameters and writes them straight to disk.
- /potion attribute list, give, and apply manage custom potions.
No restarts, no server downtime. Invalid values and unknown effects are rejected with a clear message, so you always know what went wrong.
How to Install
Installation is straightforward. Drop the correct build for your loader into the server's mods folder, start it once to generate the config, then tune the JSON to taste. Remember this is server-side only, so clients need nothing. If you want a smoother path, the foxygame.net launcher handles Potion Mechanics through its built-in add-on catalog, matching the right loader build to your server version automatically and keeping it updated between sessions. That saves the usual hunt for the correct jar.
When you are ready to download Potion Mechanics, grab the build that matches your loader and Minecraft version. Whether you run a small survival server or a large public realm, Potion Mechanics for Minecraft rewards the players who love brewing with a system that finally grows with them. Higher levels, longer durations, hidden particles, and custom attribute potions, all without asking anyone to install a thing.