Custom Potions

⭐ — (21 endorsements) 📥 2,061 downloads 📌 v2.1.2+1.21.1 📅 5/25/2024
🟠 Updated over a year ago

By AshyBoxy · fabric

⬇ Download Mod Source: Modrinth ↗ 📅 Updated: 2/25/2025 📅 Created: 5/25/2024
⚠️ Install Order · 2 steps
1🛠️ Forge — Minecraft Forge (mod loader) Download ↗
2🛠️ Fabric — Fabric Loader Download ↗

Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.

🔍 Analysis

  • 👍 1.0% endorsement rate — high engagement, a strong quality signal
  • 🏆 #69 of 874 fabric mods in this game by downloads

📋 About This Mod

# Custom Potions Provides a server side only way to add custom potions using datapacks. When installed on the client, it provides integration with REI and EMI. (Only up to 1.21.1. If you experience issues with it, you can disable it starting with 2.1.2+1.21.1 in config/custompotions.json) ## Adding a potion In a datapack, make a data/id/custom_potions/id.json file for your potion. The available parameters are "fallback" for the fallback name of the potion, if translations are unvailable (Potion of {fallback}, Arrow of {fallback}, Splash {fallback}, Lingering {fallback}), an array of effects following the vanilla format, and an optional color using the (https://minecraft.wiki/w/Calculators/Decimal_representation_of_color). For example: ```json { "fallback": "Bad Luck", "effects": , "color": 5841183 } ``` ## Adding a potion recipe In your datapack, make a data/id/potion_recipes/id.json file for your recipe. The available parameters are "reagent", which takes in an item id, and is the ingredient used in the top of the brewing stand to make the potion. There are also "base" and "result", which both use the same format, and define the input and output potions used in the recipe. They have the parameters "type", which takes in either "custompotions:vanilla" for vanilla (or modded) potions, and "custompotions:custom" for potions added by datapack using this mod. For example: ```json { "reagent": "minecraft:poisonous_potato", "base": { "type": "custompotions:vanilla", "potion": "minecraft:awkward" }, "result": { "type": "custompotions:custom", "potion": "potionstuffs:bad_luck" } } ``` ```json { "reagent": "minecraft:nautilus_shell", "base": { "type": "custompotions:vanilla", "potion": "minecraft:awkward" }, "result": { "type": "custompotions:vanilla", "potion": "minecraft:luck" } } ``` ## Translating The translation key follows the format of `custompotion.namespace.id.type`. For example, `custompotion.mypotions.bad_luck.normal`, `custompotion.mypotions.bad_luck.splash`, `custompotion.mypotions.bad_luck.lingering`, and `custompotion.mypotions.bad_luck.arrow`. You can use these in a language json file like so: ```json { "custompotion.mypotions.bad_luck.normal": "Unlucky Potion", "custompotion.mypotions.bad_luck.splash": "Throwable Unlucky Potion", "custompotion.mypotions.bad_luck.lingering": "Lingering Unlucky Potion", "custompotion.mypotions.bad_luck.arrow": "Unlucky Arrow" } ```

# Custom Potions Provides a server side only way to add custom potions using datapacks.

When installed on the client, it provides integration with REI and EMI. (Only up to 1. 21. 1. If you experience issues with it, you can disable it starting with 2. 1. 2+1. 21. 1 in config/custompotions.json)

## Adding a potion In a datapack, make a data/id/custom_potions/id.json file for your potion.

The available parameters are "fallback" for the fallback name of the potion, if translations are unvailable (Potion of {fallback}, Arrow of {fallback}, Splash {fallback}, Lingering {fallback}), an array of effects following the vanilla format, and an optional color using the (https://minecraft.wiki/w/Calculators/Decimal_representation_of_color).

For example: ```json { "fallback": "Bad Luck", "effects": [ { "id": "minecraft:unluck", "duration": 6000, "amplifier": 1 } ], "color": 5841183 } ```

## Adding a potion recipe In your datapack, make a data/id/potion_recipes/id.json file for your recipe. The available parameters are "reagent", which takes in an item id, and is the ingredient used in the top of the brewing stand to make the potion. There are also "base" and "result", which both use the same format, and define the input and output potions used in the recipe. They have the parameters "type", which takes in either "custompotions:vanilla" for vanilla (or modded) potions, and "custompotions:custom" for potions added by datapack using this mod.

For example: ```json { "reagent": "minecraft:poisonous_potato", "base": { "type": "custompotions:vanilla", "potion": "minecraft:awkward" }, "result": { "type": "custompotions:custom", "potion": "potionstuffs:bad_luck" } } ``` ```json { "reagent": "minecraft:nautilus_shell", "base": { "type": "custompotions:vanilla", "potion": "minecraft:awkward" }, "result": { "type": "custompotions:vanilla", "potion": "minecraft:luck" } } ``` ## Translating The translation key follows the format of `custompotion.namespace.id.type`. For example, `custompotion.mypotions.bad_luck.normal`, `custompotion.mypotions.bad_luck.splash`, `custompotion.mypotions.bad_luck.lingering`, and `custompotion.mypotions.bad_luck.arrow`.

You can use these in a language json file like so: ```json { "custompotion.mypotions.bad_luck.normal": "Unlucky Potion", "custompotion.mypotions.bad_luck.splash": "Throwable Unlucky Potion", "custompotion.mypotions.bad_luck.lingering": "Lingering Unlucky Potion", "custompotion.mypotions.bad_luck.arrow": "Unlucky Arrow" } ```

🤖 AI-enhanced — based on mod data

📊 Mod Details

Game
Minecraft Mods
Author
AshyBoxy
Version
2.1.2+1.21.1
Downloads
2,061
Endorsements
21
Category
fabric
Created
5/25/2024
Updated
2/25/2025
Game Versions
1.21, 1.21.1
Tags
magic, utility

🔧 How to Install Minecraft Mods Mods

Download from Modrinth. Use Prism Launcher or drop into your mods folder.

📖 Full step-by-step install guide for Minecraft Mods →

Visit the official mod page for specific installation instructions for this mod.

🎮 Need cheat codes or console commands? Check ur gaming wiki for Minecraft Mods commands, item IDs, and more.

❓ Frequently Asked Questions

Which Minecraft Mods versions does Custom Potions support?

The author lists 1.21, 1.21.1. Other versions may work but are untested by the author.

What is the latest version of Custom Potions?

Version 2.1.2+1.21.1, published 2025-02-25 with 2,061 downloads recorded at the source.

Keep browsing — more Minecraft Mods mods await

📋 All Minecraft Mods Mods 🏆 Top 25 📂 More fabric 👤 More by AshyBoxy 🔎 Similar Mods 🌐 Best fabric (All Games) 🔀 Check Compatibility ⚖️ Compare Mods 🆕 New Mods