Potions 1.21.1

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

WARNING

This page is written for version 1.21.1. Documentation for older versions may be incomplete.

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 store your Potion instance. We will be directly using a ModInitializer-implementing class to hold this.

				BuiltInRegistries.POTION,
				ResourceLocation.fromNamespaceAndPath("example-mod", "tater"),
				new Potion(
						new MobEffectInstance(
								ExampleModEffects.TATER,
								3600,
								0)));

@Override
public void onInitialize() {

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

• Holder<MobEffect> type - An effect. 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 FabricPotionBrewingBuilder.BUILD event to register our potion using the PotionBrewing.addMix method.

			builder.addMix(
					// Input potion.
					Potions.WATER,
					// Ingredient
					Items.POTATO,
					// Output potion.
					BuiltInRegistries.POTION.wrapAsHolder(TATER_POTION)
			);
		});
	}
}
// :::1

addMix takes 3 parameters:

• Holder<Potion> input - The starting potion's registry entry. 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's registry entry.

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