PotionCombine Documentation
This page covers installation, player controls, recipes, config, commands, permissions, and the 1.2 chaining system.
Installation

1. Use Paper 1.20.4 - 1.21.x with Java 17.
2. Put the jar into your server's
   Code (Text):

   plugins/
   folder.
3. Restart the server.
4. Edit files in
   Code (Text):

   plugins/PotionCombine/
   .
5. Run
   Code (Text):

   /potioncombine reload
   after config or recipe changes.

Spigot and CraftBukkit are not supported.
Player Controls

• Shift + left-click a water cauldron to insert the held ingredient.
• Shift + right-click to retrieve the last inserted ingredient, if enabled.
• Right-click a finished floating potion to collect it.
• Use a brush on polluted cauldrons if pollution is enabled.

Recipes
Recipes live in . They are shapeless: order does not matter.
Example:
Recipe ingredients can be vanilla items, potion variants, or another PotionCombine recipe:
The bundled recipes are examples. Replace them with your own server recipes.
Important Config Options
How long the cauldron waits after the last inserted item before checking the recipe.
Fallback brew time if a recipe does not define its own.
How long a finished potion can hover before spoiling. Set to 0 to disable.
Lets a hopper directly under the cauldron collect finished potions automatically.
Turns on the grime mechanic. Disabled by default.
Makes configured blocks speed up brewing or reduce pollution risk.
Turns on 1.2 multi-cauldron brewing chains. Disabled by default.
Brewing Chains
When , a finished brew can pour into a neighbouring cauldron instead of hovering.
Rules:

• Only the four horizontal neighbours are checked.
• The target cauldron must need exactly that finished potion to complete a recipe.
• The result is never poured into a random partial recipe.
• A hopper under the source cauldron takes priority.

controls how long a cauldron that is one ingredient short can wait for a
neighbouring brew.
Area Heat
By default, heat checks the block directly under the cauldron.
Enable if nearby heat sources should count too. The strongest source in range wins;
sources do not stack.
Commands
- command list
- version, recipe count, active brews, hooks
- reload config, recipes, and locale
- give a finished custom potion
Aliases: , Permissions
- basic player access, default true
- reload and give commands, default op
- skips brew cooldown, default op
PlaceholderAPI
If PlaceholderAPI is installed, PotionCombine registers automatically.
Known Notes

• Live brewing timers do not survive a hard server crash yet.
• Pollution persists across restarts.
• Normal shutdown safely drops active ingredients and ready results.
• Hopper extraction bypasses the spoil timer.
• Reloading does not interrupt active brews.