Potions 26.1.2

Learn how to add a custom potion for various mob effects.

Potions are consumables that grants an entity an effect. A player can brew potions using a Brewing Stand or obtain them as items through various other game mechanics.

Custom Potions

Just like items and blocks, potions need to be registered.

Creating the Potion

Let's start by declaring a field to hold your Potion instance. We will be directly using a ModInitializer-implementing class to hold this. Note the use of Registry.registerForHolder, as, like mob effects, most vanilla methods that use potions prefer them as holders.

// :::1
public class ExampleModPotions implements ModInitializer {
	public static final Holder<Potion> TATER_POTION =
			Registry.registerForHolder(
					BuiltInRegistries.POTION,
					Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "tater"),
					new Potion("tater",
							new MobEffectInstance(
									ExampleModEffects.TATER,
									3600,

We pass an instance of MobEffectInstance, which takes 3 parameters:

• Holder<MobEffect> type - An effect, represented as a holder. We use our custom effect here. Alternatively you can access vanilla effects through vanilla's MobEffects class.
• int duration - Duration of the effect in game ticks.
• int amplifier - An amplifier for the effect. For example, Haste II would have an amplifier of 1.

INFO

To create your own potion effect, please see the Effects guide.

Registering the Potion

In our initializer, we will use the FabricBrewingRecipeRegistryBuilder.BUILD event to register our potion using the BrewingRecipeRegistry.registerPotionRecipe method.

@Override
public void onInitialize() {
	FabricPotionBrewingBuilder.BUILD.register(builder -> {
		builder.addMix(
				// Input potion.
				Potions.WATER,
				// Ingredient
				Items.POTATO,
				// Output potion.
				TATER_POTION
		);

registerPotionRecipe takes 3 parameters:

• Holder<Potion> input - The starting potion, represented by a holder. Usually this can be a Water Bottle or an Awkward Potion.
• Item item - The item which is the main ingredient of the potion.
• Holder<Potion> output - The resultant potion, represented by a holder.

Once registered, you can brew a Tater potion using a potato.