====== .potion ======

<WRAP 516px>
^  .potion  ^^
|{{ potion.webp?500 |A custom invisibility potion, created with the .potion command.}}||
^Type|[[:Command]]|
^Category|[[:No Category|none]]|
^In-game description|"Changes the effects of the held potion.\\ \\ Syntax: .potion add (<effect> <amplifier> <duration>)...\\ .potion set (<effect> <amplifier> <duration>)...\\ .potion remove <effect>"|
^[[:keybinds#default_keybinds|Default keybind]]|none|
</WRAP>

.potion is a [[:command|chat command]] that allows the user to edit the effects of potions.

One can add effects by using ''.potion add (<effect> <amplifier> <duration>)...'', remove effects using ''.potion remove <effect>'' or completely override the effects of a potion using ''.potion set (<effect> <amplifier> <duration>)...''.

Creative Mode is required to run this command, but it is still very useful for getting around restrictions like banned [[mc>Invisibility]] potions, as one can simply take a potion that is not banned (or even a [[mc>water bottle]]) and add the desired effects to it.

===== Syntax =====
Main article: [[Command Syntax]]
  * ''.potion add (<effect> <amplifier> <duration>)...'' adds the specified effect(s) to the potion held in the main hand slot.\\ \\ 
  * ''.potion set (<effect> <amplifier> <duration>)...'' removes all effects from the potion held in the main hand slot, then adds the specified effect(s).\\ \\ 
  * ''.potion remove <effect>'' removes the specified effect from the potion held in the main hand slot.

Examples:
  * ''.potion set invisibility 1 600'' adds [[mc>Invisibility]] for 10 minutes to the held potion. Also removes all other effects, if any.\\ \\ 
  * ''.potion set invisibility 1 600 jump_boost 2 30'' adds [[mc>Invisibility]] for 10 minutes and [[mc>Jump Boost]] II for 30 seconds to the held potion. Also removes all other effects, if any.\\ \\ 
  * ''.potion add jump_boost 2 30'' adds [[mc>Jump Boost]] II for 30 seconds to the held potion, without removing other effects.\\ \\ 
  * ''.potion remove jump_boost'' removes the [[mc>Jump Boost]] effect from the held potion. If the held potion never had the [[mc>Jump Boot]] effect, nothing happens.\\ \\ 

===== Changes =====

^Version^Changes^
|[[update:Wurst 2.2]]|Added ''.potion''.|
|[[update:Wurst 3.0pre1]]|Broke ''.potion''.|
|[[update:Wurst 3.0pre4]]|Fixed ''.potion''.|
|[[update:Wurst 7.0pre1]]|Temporarily removed ''.potion''.|
|[[update:Wurst 7.0pre26]]|Re-added ''.potion''.|
|:::|Improved some of ''.potion'''s error messages.|
|[[update:Wurst 7.15.1]]|Fixed a crash when running the .potion command with an invalid potion effect.|

{{tag>creative_mode_only NBT_data}}