# Custom Potions
\nProvides a server side only way to add custom potions using datapacks.<\/p>\n
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)<\/p>\n
## Adding a potion
\nIn a datapack, make a data\/id\/custom_potions\/id.json file for your potion.<\/p>\n
The available parameters are “fallback” for the fallback name of the potion, if translations are unvailable
\n(Potion of {fallback}, Arrow of {fallback}, Splash {fallback}, Lingering {fallback}),
\nan array of effects following the vanilla format, and an optional color using the same format as vanilla.<\/p>\n
For example:
\n“`json
\n{
\n “fallback”: “Bad Luck”,
\n “effects”: [
\n {
\n “id”: “minecraft:unluck”,
\n “duration”: 6000,
\n “amplifier”: 1
\n }
\n ],
\n “color”: 5841183
\n}
\n“`<\/p>\n
## Adding a potion recipe
\nIn your datapack, make a data\/id\/potion_recipes\/id.json file for your recipe. The available parameters are “reagent”,
\nwhich takes in an item id, and is the ingredient used in the top of the brewing stand to make the potion. There are
\nalso “base” and “result”, which both use the same format, and define the input and output potions used in the recipe.
\nThey have the parameters “type”, which takes in either “custompotions:vanilla” for vanilla (or modded) potions, and
\n“custompotions:custom” for potions added by datapack using this mod.<\/p>\n
For example:
\n“`json
\n{
\n “reagent”: “minecraft:poisonous_potato”,
\n “base”: {
\n “type”: “custompotions:vanilla”,
\n “potion”: “minecraft:awkward”
\n },
\n “result”: {
\n “type”: “custompotions:custom”,
\n “potion”: “potionstuffs:bad_luck”
\n }
\n}
\n“`
\n“`json
\n{
\n “reagent”: “minecraft:nautilus_shell”,
\n “base”: {
\n “type”: “custompotions:vanilla”,
\n “potion”: “minecraft:awkward”
\n },
\n “result”: {
\n “type”: “custompotions:vanilla”,
\n “potion”: “minecraft:luck”
\n }
\n}
\n“`
\n## Translating
\nThe 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`,
\nand `custompotion.mypotions.bad_luck.arrow`.<\/p>\n
You can use these in a language json file like so:
\n“`json
\n{
\n “custompotion.mypotions.bad_luck.normal”: “Unlucky Potion”,
\n “custompotion.mypotions.bad_luck.splash”: “Throwable Unlucky Potion”,
\n “custompotion.mypotions.bad_luck.lingering”: “Lingering Unlucky Potion”,
\n “custompotion.mypotions.bad_luck.arrow”: “Unlucky Arrow”
\n}
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
Allows adding custom potions and potion recipes through datapacks<\/p>\n","protected":false},"featured_media":53209,"template":"","meta":{"_minecraft_slug":"custompotions","_minecraft_project_id":"QoUTazud","_minecraft_author":"AshyBoxy","_minecraft_license":"MIT","_minecraft_downloads":1809,"_minecraft_follows":20,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"custompotions.zip","_minecraft_size_bytes":570957,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-17T00:27:45.700008Z","_minecraft_date_created":"2024-05-25T21:36:25.414224Z","_minecraft_date_modified":"2025-02-25T21:07:16.138298Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/custompotions","_minecraft_icon_attachment_id":53209,"_minecraft_imported_at":"2026-06-02T23:02:48+00:00","_minecraft_import_hash":"725700e1bb8cf3f5cdf460b22a9439ca","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,97,122,98,92],"mod_loader":[99,100],"minecraft_version":[102,62,37,73,748,749,750,74,38],"class_list":["post-53208","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-fabric","mod_category-magic","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-2-pre5","minecraft_version-1-21-2-rc1","minecraft_version-1-21-2-rc2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n