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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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

Try it in the Studio All potion effect fields explained →