CustomBrewRecipes
by Emafire003
CustomBrewRecipes lets mod developers register non-potion brewing recipes whose inputs and outputs can carry NBT data.
What it does
Brewing recipes in the base game only handle potions. CustomBrewRecipes gives developers an API for adding brewing recipes that work with other items and keep their NBT data, so a recipe can check or produce items with custom components. The mod is for developers working on other mods, and it has no in-game features on its own.
The API documentation is written as javadoc on the classes and methods. Developers supply the items a recipe accepts, then either pass ItemStacks that already carry the custom components or use the NBT method. Checks can test whether a component type or NBT field is present, and whether a field holds a specific value. The output item keeps its full ComponentMap or NBT, since the recipe result is the item that gets created.
The mod runs on the server side only, so players join without installing it. It is published for Fabric, NeoForge and Quilt, with game versions 1.18 – 1.21.4, and is released under CC0 1.0 Universal, which makes the source code open source.
Key features
Custom brewing recipes
Developers register brewing recipes for items other than potions through the mod's API.
NBT-aware inputs
A recipe can match an input by its custom components or NBT fields, not only by item type.
NBT-preserving outputs
The recipe output keeps the full component map or NBT data of the item it creates.
Javadoc documentation
The API is described in javadoc comments on its classes and methods, covering how to supply items and call the NBT method.
Compatibility
Latest build for each game version and loader.
1.21.x5 of 5 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Required by 2 mods
Use cases
Who it’s for: Mod developers who want brewing recipes that go beyond potions. Players and server owners only need it when a dependent mod requires it, such as LightWithin - Player-specific unique powers! or Vietnam's Delight Reborn.
How it compares
NBT Recipes is open source under the Apache License 2.0, and works on Fabric and Quilt for 1.20 – 1.20.1. NBT Copy is open source under the GNU Lesser General Public License v3.0 only, runs on Fabric, Forge and NeoForge for 1.16 – 26.3, and either side can run it, and neither needs it. CustomBrewRecipes covers Fabric, NeoForge and Quilt for 1.18 – 1.21.4 and is server-side only.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| CustomBrewRecipes | Fabric, NeoForge and Quilt | 1.18 – 1.21.4 | Server-side only | 2025-03-22 |
| NBT Recipes | Fabric and Quilt | 1.20 – 1.20.1 | Server-side only | 2023-11-14 |
| NBT Copy | Fabric, Forge and NeoForge | 1.16 – 26.3 | Client or server, optional | 2026-03-28 |
Questions
Which loader should a developer target with CustomBrewRecipes?
Does CustomBrewRecipes have to be installed on the client?
Which mods require CustomBrewRecipes?
More from Emafire003
What the author says
Detailed instructions can be found in the javadoc, but all you have to do is calling and either use itemstacks that already have custom components or supply the nbt to the method.
Official listing
- Modrinth page
- modrinth.com/mod/custombrewrecipes
- Owner
- Emafire003
- Published
- 2024-03-22
- Updated on Modrinth
- 2025-03-22
- Facts verified
- 2026-10-15
