Minecraft Custom Potion Generator

Build a /give command for normal, splash, and lingering potions: base potion data, custom effects, bottle color, lore, CustomModelData, and support for both 1.20.5+ components and legacy NBT.

Potion Setup

Leave empty for a fully custom bottle or use IDs like long_swiftness and strong_healing.

Model ID from your resource pack. It changes the look, not the potion effect.

Read the article

Custom Effects

Preview and Command

preview

Unnamed potion

Syntax: Components

Open article

How to Use It

  • The base potion field sets the vanilla foundation, such as healing, long_swiftness, or strong_strength.
  • Custom effects let you add or replace the default effect package in the same command.
  • In legacy mode, the builder converts supported effects into old numeric IDs and warns you if something must be removed.
  • For a story item, add lore, a custom color, and CustomModelData, then paste the command into console or a command block.

When this potion builder is most useful

Potion commands stop being simple the moment the bottle is supposed to carry more than one job. A vanilla potion is easy. A quest reward with custom lore, a story color, and a clean payload for a modern server version is where people start losing time. This builder is for that second case: when the bottle has to feel intentional, not generic.

Reward items

If a potion should feel like a crafted object instead of a random drop, the combination of custom name, lore, color, and effect stack matters more than raw strength. The builder lets you shape that whole package at once instead of bolting details on afterward.

RP consumables

This page is especially handy for drinks, alchemical tonics, poisons, or ritual brews that need readable text and a memorable look. Even if the mechanical effect is small, the item can still feel distinct because the visual and textual layer is already part of the command.

Version-sensitive commands

One of the most annoying parts of potion commands is not the potion itself, but the syntax drift between legacy NBT and the modern component system. The builder is useful precisely because it keeps that translation in one place.

A simple workflow that stays readable later

Start with the bottle type

Choose normal, splash, or lingering first. That decision affects how the potion behaves in play and prevents you from mentally designing one kind of item while the command is actually building another.

Pick the vanilla base only if it helps

Sometimes a real base potion is useful because it gives you familiar defaults. Sometimes it is cleaner to leave the base empty and define everything through custom effects. The builder supports both paths, and that is important when you are trying to keep the design legible.

Write lore like a player will read it

Lore works best when each line answers one question: what is this, what does it do, and why should I care. When the text starts sounding like raw admin notes, the potion may still function, but it stops feeling like an item people actually want to use.

Only then refine effects and color

The effect stack and bottle color should reinforce the idea you already have, not replace it. Bright purple can suggest danger, pale blue can suggest clarity, and deep green can signal poison or medicine, but only if the rest of the item supports that read.

Mistakes that usually break potion commands

Overbuilding the bottle

It is easy to pile on too many effects and turn a flavorful item into a hard-to-read spreadsheet in a glass bottle. In practice, one primary purpose and one secondary twist usually reads better than a huge stack of tiny bonuses.

Forgetting that lore and mechanics tell the same story

If the lore says the potion is subtle but the command gives instant fireworks, the item feels fake. If the lore promises danger and the effect is barely noticeable, the item feels weak. The command and the text need to point in the same direction.

Using the wrong syntax for the server version

This is the most practical failure mode. A potion can look perfect in the form and still fail if the environment expects modern components and you pasted an old NBT pattern, or the other way around. That is why the version switch matters before you copy the final command.

Quick FAQ

Should I use a base potion or only custom effects?

Use a base potion when you want to inherit a familiar vanilla identity. Skip it when the bottle is supposed to be fully custom and the default behavior would only get in the way.

Is this page only for combat potions?

No. It is just as useful for social drinks, quest medicine, ritual ingredients, joke items, or collectible bottles that mainly exist to support story and atmosphere.

When should I add CustomModelData?

Add it when the bottle should also hook into a resource pack and look different from normal potions. If the item only needs mechanical changes, you can leave that field empty.

What should I do after the command is copied?

Test it in the real environment where it will live: the server, command block, or admin console you actually use. Potions are small items, but they often reveal syntax and formatting mistakes immediately.