Minecraft Potion /give Command Guide
This generator creates Java Edition /give commands for drinkable potions, Splash Potions, Lingering Potions, and Tipped Arrows. It uses the minecraft:potion_contents item component introduced in Java 1.20.5, replacing the older Potion, CustomPotionColor, and CustomPotionEffects item tags.
Choose a vanilla potion when you want its normal in-game effect and duration. Extended and stronger variants have their own registry IDs, such as minecraft:long_night_vision and minecraft:strong_strength. The selected item type controls whether the result is drunk, thrown, left as a lingering cloud, or fired as a tipped arrow.
Custom effects are stored as effect instances. Duration is entered in seconds here and converted to game ticks at 20 ticks per second. Effect level is easier to read in the form, while the generated amplifier remains zero-based: level I is amplifier 0 and level II is amplifier 1.
Choose the Right Potion Item
Use Potion for a drinkable item, Splash Potion for a thrown impact, Lingering Potion for an area-effect cloud, or Tipped Arrow for an effect delivered by a bow or crossbow. The same potion_contents component supplies the potion data for all four item types.
Use Vanilla Potion IDs First
A vanilla potion ID is the safest way to reproduce normal Minecraft behavior because the game supplies its built-in effects, color, and duration. Use custom effects only when the desired combination is not represented by a normal potion registry entry.
Understand Custom Effect Timing
Custom effect duration is stored in ticks. The generator multiplies seconds by 20 before writing the command. Lingering clouds and tipped arrows can scale applied duration during gameplay, so their delivered duration may be shorter than the number stored on the item.
Keep Commands Safe to Test
Start with a count of one, target yourself with @s, and test powerful or negative custom effects in a private world. High Speed, Levitation, Instant Damage, or amplifier values near 255 can make a world difficult to control.
Color Is Visual, Effects Are Functional
The custom_color field stores an RGB integer and changes the potion appearance. It does not create an effect. Select a base potion or add custom effects separately so the item does what its color suggests.
Command Tokens Stay Untranslated
Minecraft command keywords, selectors, item IDs, potion IDs, booleans, and component field names must remain in English. The surrounding interface is localized, but changing tokens such as minecraft:potion_contents or show_particles would make the command invalid.
Potion Command Generator Questions
Does this generator work in Bedrock Edition?
No. This page generates the Java Edition item-component syntax used from Java 1.20.5 onward. Bedrock uses different item and command systems. Use the Potion Chart when you need brewing recipes and duration comparisons for both editions.
What is the difference between a potion and the /effect command?
A potion command gives an item that can be stored, thrown, or fired. The /effect command applies or clears a status effect directly on an entity. Use the potion generator for inventory items and the /effect generator for immediate status changes.
Why is effect level II written as amplifier 1?
Minecraft stores custom effect amplifiers from zero. Amplifier 0 displays as level I, amplifier 1 as level II, and amplifier 255 as level 256. The form accepts the visible level and converts it automatically.
Can I combine a vanilla potion with custom effects?
Yes. The potion field supplies the selected vanilla effects and custom_effects adds more effect instances. This is useful for map rewards and custom items, but test the combination because positive and negative effects can interact in unexpected ways.
Can I make a potion with only custom effects?
The generated command always keeps a valid base potion ID and can add any number of custom effects. Choose a visually suitable base, override its color if needed, and add the custom effects that define the item behavior.
Why does the command fail on an older Java version?
The square-bracket item component syntax was introduced in Java 1.20.5. Older versions use legacy item NBT and cannot run this command unchanged. Make sure the server version is Java 1.20.5 or newer.