How to Make a Potion Effect in Minecraft (Mod Maker guide)
Learn how to create a custom potion effect for entities using 9Minecraft Mod Maker right in your web browser. No installation is needed to start creating.
Open the Studio and Workspace
Open 9Minecraft Mod Maker in your web browser. Since it runs online, you do not need to download or install anything.
Create a new workspace or open an existing one. Make sure your project uses a supported version: NeoForge 26.1.2 or NeoForge 1.21.1.
Add a Potion Effect Element
Click the green plus button in your workspace to create a new mod element.
Look in the Data-driven content group and select Potion effect. A potion effect is an effect that can be given to entities.
Set the Name, Icon, and Color
Enter the Effect display name. This controls the name of the effect displayed inside the player's inventory.
Choose an Effect icon to show in the player's inventory when the potion is active. Note that if the texture name differs from the element's registry name, a copy of the texture will be made.
Pick a Potion effect color to set the color of the bottles and the arrow. You do not need this option if you do not want the items.
Choose Category and Basic Rules
Select a Potion effect category. Choose NEUTRAL if it is neither bad nor good like Glowing, HARMFUL if it is bad like Poison, or BENEFICIAL if it is good like Regeneration.
Check Is this potion effect instantly applied if your effect should apply one time like Instant health.
If you want the effect to be removed after drinking a honey bottle, select Is potion effect cured by honey.
Configure Visuals and Sounds
Check Render in hud to make the effect visible in the game, and enable Render in inventory to display it in the player's inventory when active.
Set Potion effect particles to control which particles spawn around entities with this effect. If no particle is specified, the default spiral particle is used.
You can also choose a Sound to play when effect is added, which plays whenever an entity receives this effect.
Add Attribute Modifiers
Find the Attribute modifiers field.
Add any attribute modifiers you want. These are applied to the entity while the effect is active.
Set Up Triggers and Procedures
Attach procedures to control what the effect does. Use When potion applied for when the effect starts, When active tick for each tick an entity has the effect, and When potion expires for when the entity loses the effect.
You can set an Active tick condition to determine if the effect should activate its tick procedure based on the level and duration left. This is useful for effects that behave like regeneration or poison.
You can also add procedures to On mob hurt, which runs every time a mob with this effect is hurt, and On mob death, which runs when a mob with this effect dies.
Test and Export Your Mod
Save your Potion effect element once all fields are filled out.
Click Build & run to test your new potion effect directly, then export your finished mod when you are happy with how it works.
Tips
- Match your Effect icon texture name to the element's registry name if you want to avoid having an automatic copy of the texture made.
- Use the procedure template available in Active tick condition to easily build effects that work like poison or regeneration.
- Leave Potion effect particles blank if you simply want to use the default spiral particle around entities.
- Uncheck Render in hud and Render in inventory if you want to make a hidden potion effect that players cannot see on screen.