PotionRecipes Lib
Modding Minecraft has always been about creativity, and few things capture that spirit better than brewing your own potions. Whether you are building a sprawling magic overhaul or a small quality-of-life tweak, PotionRecipes Lib offers a straightforward way to register brewing recipes without wrestling with complex systems. This lightweight library does one job and does it well, giving developers a clean entry point into potion crafting.
What Is PotionRecipes Lib?
PotionRecipes Lib is a simple API that provides a direct method for creating brewing recipes. As its original documentation notes, it is essentially a "fancy" invoker, nothing less and nothing more. That honesty is part of its charm. Instead of forcing you through layers of abstraction, it hands you a single registration call and lets you get back to building your mod.
The library is available under the CC0 license, which means you can learn from it, modify it, and incorporate it into your own projects freely. For developers who just need brewing recipes to work, this is exactly the kind of no-nonsense tool that saves hours of frustration.
Supported Minecraft Versions and Loaders
PotionRecipes Lib was designed with older Forge-based Minecraft versions in mind, targeting the era when potion brewing was a common focus for gameplay mods. It works as a dependency you include in your build.gradle file, making integration into existing Forge projects quick and painless. If you are maintaining a legacy mod or building something that relies on the classic brewing stand mechanics, this library fits neatly into that workflow.
It is worth noting that the project has been archived. That does not make it useless, but it does mean new development has stopped. For modern versions of the game, you may want to explore alternatives such as nbt-crafting APIs if your needs go beyond simple recipe registration.
How to Install PotionRecipes Lib
Getting started is refreshingly simple. Because PotionRecipes Lib is a development library rather than a standalone gameplay mod, installation happens at the project level rather than through a typical mod folder drop.
- Add the library as a dependency in your build.gradle file.
- Sync your project so your IDE recognizes the new classes.
- Reference the brewing registration method inside your mod code.
- Test your recipes in a development environment before release.
If you are a player rather than a developer, you generally will not need to install this directly. It arrives bundled inside mods that depend on it. When you download PotionRecipes Lib as part of a modpack, the launcher or mod loader handles the heavy lifting for you.
For those who prefer a smoother setup, the foxygame.net launcher makes adding PotionRecipes Lib to a modded instance a genuinely painless process, handling dependencies and version matching automatically so you can focus on playing rather than troubleshooting.
How to Use the API
The core of PotionRecipes Lib is a single method call. You register a potion recipe by specifying three things: the input potion, the ingredient item, and the output potion.
The Registration Method
The call follows this pattern: BrewingRecipeRegister.registerPotionRecipe(Potion input, Item item, Potion output). Each parameter plays a clear role in defining your recipe.
- Input: The potion you start from, usually Potions.AWKWARD or a custom potion from your own registry.
- Item: The ingredient required to trigger the brew, such as a piece of glowstone or a modded reagent.
- Output: The potion that results once brewing completes.
That is the entire workflow. There is no configuration file to wrestle with and no event bus to hook into. You call the method, and your recipe exists.
Practical Example
Suppose you want to turn an awkward potion into a custom healing brew using a rare herb from your mod. You would pass your custom potion as the input, the herb as the item, and your healing potion as the output. The library handles the rest, wiring your recipe into the brewing stand's internal logic.
For a full working reference, the original author's own mod serves as an excellent example of the API in action. Studying that implementation shows how cleanly the library integrates into a real project.
Should You Use It?
PotionRecipes Lib is a niche tool, and it knows it. If your mod needs brewing recipes and nothing more, this library delivers exactly that with minimal overhead. Its CC0 license removes any legal friction, and its tiny footprint keeps your project lean.
If your ambitions extend further, such as custom NBT handling or more elaborate crafting systems, you will likely outgrow it quickly. In that case, broader APIs are the smarter investment. But for the specific job of registering potion recipes in a Forge environment, PotionRecipes Lib remains a tidy, dependable solution worth keeping in your toolkit.