Cauldron API
by Yunitrish
Cauldron API is a Fabric library for server owners and mod developers who want to define custom cauldron recipes, covering several recipe types and new block sets.
What it does
Developers use the API to create several recipe types based on the cauldron, so a mod can register its own behaviour for the block instead of relying on vanilla water and lava rules. Recipes can react to items dropping inside a cauldron and to living entities that stand in it, which opens the block to new crafting and processing logic.
Because the API is aimed at mod creators, its main audience is other mod authors who need a shared foundation for cauldron features. Server owners install it when a pack they run depends on a mod built with it. The server needs the library, while players may leave it out unless their own client-side mods call into it.
Installation requires Fabric. Cauldron API is published for Fabric only, in a single game version, 1.21, with the 0.1.2+1.21 file as the latest build. The code is open source under the MIT License.
Key features
Multiple cauldron recipe types
The API lets developers register more than one recipe type on the base cauldron block, each with its own inputs and outputs.
Items dropping into cauldrons
Recipes can be triggered when an item falls into a cauldron, so dropped items can be consumed or transformed.
Living entity interaction
Recipes can also respond to living entities inside a cauldron, extending the block beyond item handling.
Custom block sets
Specific block sets can be tied to cauldron recipes, letting a mod limit which blocks take part in a recipe.
Developer recipe hooks
Mod developers add cauldron recipes through the API instead of writing their own cauldron logic from scratch.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Mod developers building cauldron recipes, and server owners running mods that depend on the API. Players on the client side do not need it unless their own installed mods require it.
How it compares
Better Cauldrons is a Fabric mod for 1.21.11 that runs on client and server, under the MIT License, and is open source. Fill My Cauldron is a Fabric server-side only mod for 1.21 – 26.2, released under the CC0 1.0 Universal license. Cauldron API stays limited to the 1.21 game version, with the server required and the client optional.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Cauldron API | Fabric | 1.21 | Server required, client optional | 2024-07-07 |
| Better Cauldrons | Fabric | 1.21.11 | Client and server | 2025-12-21 |
| Fill My Cauldron | Fabric | 1.21 – 26.2 | Server-side only | 2026-06-17 |
Questions
Does Cauldron API need Fabric API?
Does a player need Cauldron API on the client?
Which game versions does Cauldron API support?
In the catalog
Cauldron API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 15,770 mods support Minecraft 1.21.
More from Yunitrish
Similar mods
What the author says
this mod provides a api allows mod developers to make cauldron recipes with the feature of - living entities - items dropping inside cauldron - specific block sets if all of the rule is all matched then right-click the cauldron to make things out!
Official listing
- Modrinth page
- modrinth.com/mod/cauldron-api
- Owner
- Yunitrish
- Published
- 2024-07-07
- Updated on Modrinth
- 2024-07-07
- Facts verified
- 2026-10-15