Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 

Functions allow players to run lists of commands using text files with the extension .mcfunction. It is recommended to use UTF-8 encoding (without BOM) for function files to prevent any problems.

Usage

To utilize functions, the text files must first be placed into a top-level folder within [WORLD_NAME]/datapacks/[DATA_PACK_NAME]/data/[NAMESPACE]/functions. For single player, the world folders can be found in .minecraft/saves. For multiplayer, functions must be placed in every world folder that wants to utilize them (In 1.12 you MUST place the functions inside the main world folder (the one specified in the server.properties, level-name=(world-name here)), otherwise it will NOT work.). The name of the new top-level folder will be the namespace used when running the functions inside. Functions can also be placed into subfolders within the top-level folder.

For example, running the function custom:example/test will refer to the file located at data/custom/functions/example/test.mcfunction. If the namespace is left out when trying to call a function, it will default to the minecraft: namespace. Using a custom namespace is recommended in order to prevent unintended behavior in the case of future additions to the default namespace.[1]

Functions, being text files, are easily modifiable and less likely than command blocks to induce lag when used in large quantities. If a function is modified or added, using the /reload command will reload the function files from disk. This allows Minecraft to recognize any changes to the function files, without the need to quit and re-enter the world.

Upon successfully running a function, a message will display in the chat: Executed [amount] command(s) from function '[function file directory]'. The successful output of the commands inside a function cannot be measured with a comparator (although the same effect could be accomplished with the use of /stats and /scoreboard commands).

Function syntax

TestingFunctions

Testing the function system. Three /tellraw messages and one /give command were used in this simple function.

Within the .mcfunction file, one valid command is placed per line, without the usual forward slash (/). Players can add comments within the function text file by preceding them with a #.

Individual commands in functions can be longer than the 32,500 character limit in command blocks but the total number of commands run inside a function will still obey /gamerule maxCommandChainLength, which is 65,536 commands by default; any commands beyond this limit will be ignored.

Running a function

Functions will run all of their commands in a single tick and functions called from within other functions will also run their commands in the same tick as their parent. Functions will use the command environment of whatever called the function. This includes command sender, position, rotation, etc.

Changes to the command environment that happen within a function will not affect the command environment used by the other commands within that same function (or within its child functions) until the next iteration, regardless of the order of commands. The /execute command is an exception and will update the command environment.

For example:

1.12

execute @a ~ ~ ~ function foo:bar

foo:bar

teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute @s ~ ~ ~ setblock ~ ~-1 ~ diamond_block

1.13

execute as @a at @s run function foo:bar

foo:bar

teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute at @s run setblock ~ ~-1 ~ diamond_block

When called through a player this function will teleport that player 5 blocks up, place an emerald block one block below their original position before the teleport, and place a diamond block one block below their new position after the teleport. This behavior does not affect target selector arguments.

There are several methods of running a function file in-game:

Commands

/function
  • Allows players to run a function once.
  • The commands in the function are run through the entity or command block that ran the /function command.
  • The optional arguments if and unless will make the function only run when the selector was found or not found in the world respectively.
  • Usage: /function <name>

Advancements

Advancements can run a function once as a reward for completing them. The commands in the function are run through the player who completed the advancement.

Reward functions are called within advancement JSON files using the following format:

{
    "rewards": {
        "function": "namespace:path/to/function/file"
    }
}

Tags

Functions can be grouped together using tags in data packs. These tags can then be called to run all the functions inside that tag with /function #(namespace):tag.

Functions tagged in minecraft:tick will automatically run every tick at the beginning of the tick. Functions tagged in minecraft:load will run after (re)loading the datapack.

History

Java Edition
1.12
{{Extension DPL}}<ul><li>[[Horse Armor|Horse Armor]]<br/>{{Item
| image = <gallery>
Leather Horse Armor.png | Leather 
Iron Horse Armor.png | Iron
Golden Horse Armor.png | Golden
Diamond Horse Armor.png | Diamond
</gallery>
| image2 = <gallery>
Leather Horse Armor (item).png|Leather
Iron Horse Armor (item).png|Iron
Golden Horse Armor (item).png|Golden
Diamond Horse Armor (item).png|Diamond
</gallery>
| extratext = View [[#Gallery|all renders]]
| renewable = 
* '''Leather''': Yes
* '''All others''': No
| stackable = No
}}

'''Horse armor''' is a special type of [[armor]] that can be given to a [[horse]] to wear.

== Obtaining ==

===Chest loot===
{{LootChestItem|iron-horse-armor}}
{{LootChestItem|golden-horse-armor}}
{{LootChestItem|diamond-horse-armor}}

===Crafting===
{{crafting
|A1= Leather
|C1= Leather
|A2= Leather
|B2= Leather
|C2= Leather
|A3= Leather
|C3= Leather
|Output= Leather Horse Armor
|type=Miscellaneous
}}

Only leather horse armor can be crafted; other horse armor can be obtained only from chest loot from some generated structures.

===Trading===
Expert-level [[leatherworker]] villagers [[trading|sell]] leather horse armor for 6 [[emerald]]s as part of their trade.

==Usage==

Only normal adult horses can wear armor; foals, [[donkey]]s, [[mule]]s, and undead variants such as [[skeleton horse]]s and [[zombie horse]]s cannot be equipped with armor.

=== Types ===
Horse armor has leather, iron, gold, and diamond variants. However, horse armor does not have netherite or chainmail variants.

=== Armor Stands ===
Horse armor cannot be placed or displayed on [[armor stand]]s. 

===Protection===
Horse armor can be equipped to horses either by manually placing it in its respective slot by pressing E while riding the horse ({{SlotSprite|Horse Armor}}), or by right-clicking the horse with it.

There is a gradual increase in the defense given from a horse wearing the different types of armor. Note that golden horse armor provides more protection than iron horse armor, whereas the opposite is true for [[armor|player armor]].
{| class="wikitable" data-description="Armor defense"
|-
! Material !! [[Armor]]
|-
! [[Leather]]
| {{armor|3}} 
|-
! [[Iron]]
| {{armor|5}} 
|-
! [[Gold]]
| {{armor|7}} 
|-
! [[Diamond]]
| {{armor|11}} 
|}
When a horse dies while equipped with any horse armor, it drops its normal loot, saddle (if it had one), and the horse armor.

Leather horse armor protects horses from freezing in [[powder snow]], but it does not negate other powder snow effects (e.g., falling through, inability to jump).

===Durability===
Unlike [[armor|player armor]], horse armor does not have durability. This means a single horse armor can be used infinitely unless destroyed.
=== Enchanting ===
Unlike [[armor|player armor]], horse armor cannot be enchanted in survival mode. However, {{in|java}} Creative mode, horse armor can be used with an [[anvil]] to enchant with [[Depth Strider]], [[Thorns]], [[Respiration]], [[Feather Falling]], and [[Curse of vanishing]]. Other enchantments can be applied, but they have no effect.

=== Dyeing ===
Leather horse armor can be dyed 12,326,391 different colors (using lone dyes or dye combinations) and put onto a horse to display that color. These changes can be reverted by {{control|using}} a filled [[cauldron]] with dyed leather horse armor.

===Smelting usage===
{{Smelting|showname=1|Iron Horse Armor;Golden Horse Armor|Iron Nugget;Gold Nugget|0,1}}

===Piglins===
{{EntityLink|Piglin|Piglins}} are attracted to golden horse armor and run toward any golden horse armor on the ground, inspecting it for 6 to 8 seconds before putting it in their inventory.

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Horse armor.ogg
|subtitle=Horse armor equips
|source=neutral
|description=When armor is equipped to a horse
|id=entity.horse.armor
|translationkey=subtitles.entity.horse.armor
|volume=0.5
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Horse armor.ogg
|source=neutral
|description=When armor is equipped to a horse
|id=mob.horse.armor
|volume=0.6
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Leather Horse Armor
|spritetype=item
|nameid=leather_horse_armor
|form=item}}
{{ID table
|displayname=Iron Horse Armor
|spritetype=item
|nameid=iron_horse_armor
|form=item}}
{{ID table
|displayname=Diamond Horse Armor
|spritetype=item
|nameid=diamond_horse_armor
|form=item}}
{{ID table
|displayname=Golden Horse Armor
|spritetype=item
|nameid=golden_horse_armor
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather Horse Armor
|spritetype=item
|nameid=leather_horse_armor
|aliasid=horsearmorleather
|id=530
|form=item
|translationkey=item.horsearmorleather.name}}
{{ID table
|displayname=Iron Horse Armor
|spritetype=item
|nameid=iron_horse_armor
|aliasid=horsearmoriron
|id=531
|form=item
|translationkey=item.horsearmoriron.name}}
{{ID table
|displayname=Diamond Horse Armor
|spritetype=item
|nameid=diamond_horse_armor
|aliasid=horsearmordiamond
|id=533
|form=item
|translationkey=item.horsearmordiamond.name}}
{{ID table
|displayname=Golden Horse Armor
|spritetype=item
|nameid=golden_horse_armor
|aliasid=horsearmorgold
|id=532
|form=item
|translationkey=item.horsearmorgold.name
|foot=1}}

=== Item data ===
When leather horse armor is dyed, it has the following NBT:

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: Parent tag.
** {{nbt|compound|display}}: Display properties.
*** {{nbt|int|color}}: The color of the leather armor. The tooltip displays "Dyed" if advanced tooltips are disabled, otherwise it displays the hexadecimal color value. Color codes are calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''<ref>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref>
</div>

{{el|bedrock}}:
: See [[Bedrock Edition level format/Item format]].

== History ==
{{History|java}}
{{History||1.6.1|snap=13w16a|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.
|Horse armor can be [[crafting|crafted]] using the following recipe.
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |C1=Iron Ingot; Gold Ingot; Diamond
  |A2=Iron Ingot; Gold Ingot; Diamond 
  |B2=Any Wool
  |C2=Iron Ingot; Gold Ingot; Diamond
  |A3=Iron Ingot; Gold Ingot; Diamond
  |B3=Iron Ingot; Gold Ingot; Diamond
  |C3=Iron Ingot; Gold Ingot; Diamond
  |Output=Iron Horse Armor; Golden Horse Armor; Diamond Horse Armor
}}
{{!}}}
}}
{{History|||snap=13w18a|The crafting recipe for horse armor has been removed.
|Horse armor can now be found in [[chest]]s in [[jungle temple|jungle]] & [[desert temple]]s, [[dungeon]]s, [[nether fortress]]es, [[stronghold]] altar rooms and [[village]] blacksmith buildings.
|Iron horse armor can now additionally be found in [[mineshaft]] chests.}}
{{History|||snap=13w21a|Horse armor is no longer stackable, to be consistent with other types of [[armor]].}}
{{History||1.9|snap=15w31a|Horse armor has been added to [[end city]] [[chest]]s.}}
{{History|||snap=15w43a|The average yield of horse armor in [[nether fortress]] chests has slightly decreased.}}
{{History|||snap=15w44a|The average yield of horse armor in [[desert temple]] chests has increased.
|The average yield of iron horse armor from [[dungeon]] chests has slightly decreased.
|Iron horse armor has been removed from [[mineshaft]] [[chest]]s.}}
{{History||1.11.1|snap=16w50a|Golden and iron horse armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w45a|[[File:Iron Horse Armor JE2.png|32px]] [[File:Golden Horse Armor JE2.png|32px]] [[File:Diamond Horse Armor JE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}}
{{History|||snap=17w46a|[[File:Iron Horse Armor 17w46a.png|32px]] [[File:Golden Horse Armor 17w46a.png|32px]] [[File:Diamond Horse Armor 17w46a.png|32px]] The model of horse armor has been changed, but the textures of horse armor have remained unaltered.}}
{{History|||snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 417, 418 and 419.}}
{{History|||snap=18w03a|[[File:Iron Horse Armor JE3.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}}
{{History|||snap=18w22a|[[File:Iron Horse Armor JE4 BE2.png|32px]] The texture of iron horse armor when equipped has been changed.<ref>{{bug|MC-124357}}</ref>}}
{{History|||snap=pre2|A bug with the [[horse]] skin and horse armor textures not applying correctly has been fixed.<ref>{{bug|MC-124364}}</ref>}}
{{History||1.14|snap=18w50a|[[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of horse armor [[item]]s have been changed.}}
{{History|||snap=February 20, 2019|slink=https://twitter.com/_LadyAgnes/status/1098134917299531776?s=19|Leather horse armor announced for {{el|je}}.}}
{{History|||snap=19w08a|[[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of iron, gold and diamond horse armor have been changed.
|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Leather Horse Armor (item) JE1.png|32px]] Added leather horse armor, which can be [[dyeing|dyed]] 12,326,391 different colors, similar to leather [[armor]].}}
{{History|||snap=19w11a|Leatherworker [[villager]]s now [[trading|sell]] leather horse armor.}}
{{History||1.14.1|snap=Pre-Release 1|[[File:Leather Horse Armor (item) JE2.png|32px]] The texture of leather horse armor [[item]] has been changed to be more consistent with the other types of horse armor.
|[[File:Iron Horse Armor (item) JE4 BE3.png|32px]] The texture of iron horse armor item has been changed.}}
{{History||1.16|snap=20w15a|Horse armor placed in a dispenser can now be put on tamed horses.}}
{{History|||snap=20w16a|Golden horse armor now generates in [[ruined portal]] chests.}}
{{History||1.17|snap=21w13a|Leather horse armor now protects [[horse]]s from [[freezing]].}}
{{History||1.19|snap=22w13a|Diamond horse armor may now be found in [[ancient city]] [[chest]]s.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor and [[dyeing|dyeable]] leather horse armor as a version exclusive.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Horse armor can now be found inside [[end city]] [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden horse armor are now [[smelting|smeltable]].}}
{{History|bedrock}}
{{History||1.2.6|snap=beta 1.2.6.2|[[File:Leather Horse Armor BE2.png|32px]] [[File:Iron Horse Armor JE4 BE2.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has been changed.}}
{{History||1.10.0|snap=beta 1.10.0.3|Horse armor can now be found in [[plains]] [[village]] weaponsmith [[chest]]s.
|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE2.png|32px]] [[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of all horse armor have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Horse armor can now be found in [[savanna]], [[desert]], [[taiga]], [[snowy taiga]] and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Leather horse armor can now be [[trading|bought]] from leatherworker [[villager]]s.}}
{{History|||snap=beta 1.11.0.5|[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE4 BE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of all horse armor [[item]]s have been changed.}}
{{History||1.17.0|snap=beta 1.16.230.54|Leather horse armor now protects [[horse]]s from [[freezing]].}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden horse armor are now [[smelting|smeltable]].}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|[[File:Leather Horse Armor BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] Added leather horse armor.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of leather, iron, gold and diamond horse armor have been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Leather Horse Armor.png | Undyed Leather armor
White Leather Horse Armor.png | White Leather armor
Light Gray Leather Horse Armor.png | Light Gray Leather armor
Gray Leather Horse Armor.png | Gray Leather armor
Black Leather Horse Armor.png | Black Leather armor
Brown Leather Horse Armor.png | Brown Leather armor
Red Leather Horse Armor.png | Red Leather armor
Orange Leather Horse Armor.png | Orange Leather armor
Yellow Leather Horse Armor.png | Yellow Leather armor
Lime Leather Horse Armor.png | Lime Leather armor
Green Leather Horse Armor.png | Green Leather armor
Cyan Leather Horse Armor.png | Cyan Leather armor
Light Blue Leather Horse Armor.png | Light Blue Leather armor
Blue Leather Horse Armor.png | Blue Leather armor
Purple Leather Horse Armor.png | Purple Leather armor
Magenta Leather Horse Armor.png | Magenta Leather armor
Pink Leather Horse Armor.png | Pink Leather armor
</gallery>

=== Screenshots ===
<gallery>
Armored Horse.png|A [[horse]] equipped with iron horse armor and bound to a fence post by a [[lead]].
13w21a-new-HorseUI-inventory.png|The GUI for horses implemented in [[Java Edition 13w21a|13w21a]], which allows the removal and switching of armor.
GodSpawner.png|A golden horse armor found in a [[dungeon]] chest, which coincidentally contains an [[enchanted golden apple]].
Horses with armor.png|4 [[horse]]s equipped with [[leather]], [[iron]], [[gold]], and [[diamond]] armor.
Leather Horse Armor 1.jpg|First image of leather horse armor.
Leather Horse Armor 2.jpg|Second image of leather horse armor.
Leather Horse Armor 3.jpg|Third image of leather horse armor.
Leather Horse Armor 4.jpg|Fourth image of leather horse armor.
Leather Horse Armor 5.jpg|Fifth image of leather horse armor.
</gallery>

== Notes ==
{{Notelist}}

== References ==
{{Reflist}}

{{items}}

[[Category:Armor]]

[[de:Rossharnisch]]
[[es:Armadura para caballo]]
[[fr:Armure pour cheval]]
[[it:Bardatura]]
[[ja:馬鎧]]
[[ko:말 갑옷]]
[[nl:Paardenharnas]]
[[pl:Zbroja końska]]
[[pt:Armadura para cavalo]]
[[ru:Конская броня]]
[[uk:Кінські обладунки]]
[[zh:马铠]]</li><li>[[Splash Potion|Splash Potion]]<br/>{{about|the throwable potions|the drinkable potions|Potion|the throwable potions that leave a lingering area of effect|Lingering Potion}}
{{Item
| image = <gallery>
Splash Water Bottle.png | Water Bottle
Uncraftable Splash Potion.png | Uncraftable
</gallery>
| extratext = View [[#Gallery|all renders]]
| renewable = '''Uncraftable, Luck{{only|je|short=1}}, Decay{{only|be|short=1}}''': No<br>
'''All others''': Yes
| stackable = No
}}

'''Splash potions''' are a variant of [[potion]]s that can be thrown.

== Obtaining ==

=== Brewing ===
{{main|Brewing}}
{{brewing
  |Gunpowder
  |Any Splash Potion
  |base= Any Potion
}}

Splash potions are brewed by adding gunpowder to a normal potion, including uncraftable potions of luck{{only|java|short=1}} and decay{{only|be|short=1}}.

=== Natural generation ===
One splash potion of weakness can be found in a [[brewing stand]] inside an [[igloo]] basement.

=== Filling bottles ===
Using a glass bottle on a [[cauldron]] that contains splash potion turns it into a bottle of that splash potion, this also removes {{frac|1|3}} of the cauldron's content.{{only|bedrock}}

=== Bartering ===
[[Piglin]]s have a 1.74% chance of [[barter]]ing a splash potion of Fire Resistance when given a [[gold ingot]].

{{anchor|Area of effect}} <!-- compatibility anchor -->

== Usage ==

===Brewing===
{{Brewing
|Dragon's Breath
|Any Lingering Potion
|ingredients=[[Dragon's Breath|Dragon's breath]] + <br>any splash potion
}}

[[Lingering potions]] are brewed by adding dragon's breath to a splash potion.

===Using===

Splash potions are thrown by {{control|using}} them. On impact they explode, applying [[status effect]]s to nearby entities. When thrown by the player, they have a range of 8 blocks if thrown at the best angle. The bottle is lost, unlike drinkable [[potion]]s. Entities within an 8.25×8.25×4.25 cuboid centered on the thrown potion at impact and within 4 blocks euclidean distance of the thrown potion<ref group="n">Specifically its lower-north-west corner; the potion entity like most thrown entities is 0.25×0.25×0.25 blocks.</ref> at impact are affected.

{{IN|Bedrock}}, splash potions' effects have only three-fourths of the duration of the drinkable form. {{IN|Java}}, splash and drinkable forms have the same duration.

If the potion directly collides with an entity, the entity gets the full duration and potency of the effect. Otherwise, the farther away the entity is from the center of the impact, the lesser the imbued effect. For instant effects (i.e. Healing or Harming), the potency of the effect reduces linearly from 100% on a direct hit to 0% at 4 blocks' distance. For other effects, the potency is unchanged, but the duration decreases linearly on the same scale (rounded to the nearest {{frac|1|20}} second), with no effect being applied if the duration would be 1 second or less.

=== Splash water bottles ===

Splash water bottles have no effect on almost all entities, but they extinguish fire in the block hit and the four blocks horizontally surrounding it.

A splash water bottle deals {{hp|1}} damage to [[endermen]], [[strider]]s, [[snow golem]]s, and [[blaze]]s; however, endermen have a chance of teleporting away if hit with one.

Splash water bottles can extinguish a burning entity.

==== Mud ====

Splash water bottles can be {{control|used}} on [[dirt]], [[coarse dirt]], or [[rooted dirt]] to turn it into [[mud]].

=== Filling cauldrons ===

{{IN|bedrock}}, using a splash potion on a cauldron adds one level of that potion to the cauldron. Attempting to add a splash potion to a cauldron with water, dyed water or a non-matching potion empties the cauldron and creates an explosion sound (but no actual explosion).

=== Uncraftable splash potion ===

{{IN|java}}, the uncraftable potion is a splash potion with no effect that is unobtainable in regular gameplay. It is also available in potion and lingering potion forms, as well as for tipped arrows.

It can be obtained in two distinct (though functionally identical) variants, using the following commands: {{cmd|give @s minecraft:splash_potion{Potion:"minecraft:empty"} }} or {{cmd|give @s minecraft:splash_potion }}. It is also obtained any time a potion has invalid or missing potion effect tags, and thus serves as a placeholder.

{| class="wikitable" style="text-align: center;" data-description="Unused potions"
! Icon
! Name
|-
| {{Slot|Uncraftable Splash Potion|link=none}}
! Uncraftable Splash Potion
|}

== Custom effects ==

{{IN|java}}, splash potions can be obtained with any status effect using {{cmd|give}} and the tag <code>CustomPotionEffects</code>, which is an array of effects for the potion. See [[Item format#Potion Effects]] for more information, and [[status effect]] for a list of effects and IDs.

== Sounds ==
{{edition|java}}:<br>
Splash potions use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Glass dig1.ogg
|sound2=Glass dig2.ogg
|sound3=Glass dig3.ogg
|subtitle=Bottle smashes
|source=neutral
|description=When a splash potion impacts something
|id=entity.splash_potion.break
|translationkey=subtitles.entity.potion.splash
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Bottle thrown
|source=player
|description=When a splash potion is thrown by a player
|id=entity.splash_potion.throw
|translationkey=subtitles.entity.potion.throw
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16}}
{{Sound table
|sound=Witch throw1.ogg
|sound2=Witch throw2.ogg
|sound3=Witch throw3.ogg
|subtitle=Witch throws
|description=When a splash potion is thrown by a [[witch]]
|source=hostile
|id=entity.witch.throw
|translationkey=subtitles.entity.witch.throw
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Dispensed item
|source=block
|description=When a splash potion is dispensed from a [[dispenser]]
|id=block.dispenser.launch
|translationkey=subtitles.block.dispenser.dispense
|volume=1.0
|pitch=1.2
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Glass dig1.ogg
|sound2=Glass dig2.ogg
|sound3=Glass dig3.ogg
|source=block
|description=When a splash potion impacts something
|id=random.glass
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bow shoot.ogg
|source=player
|description=When a splash potion is thrown by a player
|id=random.bow
|volume=0.5
|pitch=0.33-0.5}}
{{Sound table
|sound=Witch throw1.ogg
|sound2=Witch throw2.ogg
|sound3=Witch throw3.ogg
|source=hostile
|description=When a splash potion is thrown by a witch
|id=mob.witch.throw
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bow shoot.ogg
|source=player
|description=When a splash potion is dispensed from a dispenser
|id=random.bow
|volume=1.0
|pitch=0.83-1.25
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Splash Potion
|spritetype=item
|nameid=splash_potion
|form=item
|translationkey=item.minecraft.splash_potion,item.minecraft.splash_potion.effect.empty,item.minecraft.splash_potion.effect.water,item.minecraft.splash_potion.effect.mundane,item.minecraft.splash_potion.effect.thick,item.minecraft.splash_potion.effect.awkward,item.minecraft.splash_potion.effect.night_vision,item.minecraft.splash_potion.effect.invisibility,item.minecraft.splash_potion.effect.leaping,item.minecraft.splash_potion.effect.fire_resistance,item.minecraft.splash_potion.effect.swiftness,item.minecraft.splash_potion.effect.slowness,item.minecraft.splash_potion.effect.water_breathing,item.minecraft.splash_potion.effect.healing,item.minecraft.splash_potion.effect.harming,item.minecraft.splash_potion.effect.poison,item.minecraft.splash_potion.effect.regeneration,item.minecraft.splash_potion.effect.strength,item.minecraft.splash_potion.effect.weakness,item.minecraft.splash_potion.effect.levitation,item.minecraft.splash_potion.effect.luck,item.minecraft.splash_potion.effect.turtle_master,item.minecraft.splash_potion.effect.slow_falling
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Splash Potion
|spritetype=item
|nameid=splash_potion
|id=561
|form=item
|translationkey=potion.emptyPotion.splash.name,potion.mundane.splash.name,potion.mundane.extended.splash.name,potion.thick.splash.name,potion.awkward.splash.name,potion.nightVision.splash.name,potion.invisibility.splash.name,potion.jump.splash.name,potion.fireResistance.splash.name,potion.moveSpeed.splash.name,potion.moveSlowdown.splash.name,potion.heal.splash.name,potion.harm.splash.name,potion.poison.splash.name,potion.regeneration.splash.name,potion.damageBoost.splash.name,potion.weakness.splash.name,potion.wither.splash.name,potion.turtleMaster.splash.name,potion.slowFalling.splash.name
|foot=1}}

=== Item data ===

<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Potion}}
</div>

=== Entity ===

{{Entity
| title = Thrown splash potion
| networkid = '''JE:''' 73
}}

==== ID ====
{{edition|java}}:
{{ID table
|generatetranslationkeys=java
|displayname=Splash Potion
|spritetype=entity
|nameid=potion
|foot=1}}

{{edition|bedrock}}:
{{ID table
|shownumericids=y
|generatetranslationkeys=bedrock
|displayname=Splash Potion
|spritetype=entity
|nameid=splash_potion
|id=86
|foot=1}}

==== Entity data ====
{{see also|Chunk format|Potions#Data values|title2=Potion data values}}
Splash potions when thrown have entity data that define various properties of the entity.

{{/ED}}

== Achievements ==
{{load achievements|Stayin' Frosty;Zombie Doctor;Taste of your own Medicine;Free Diver}}

== Advancements ==
{{load advancements|Zombie Doctor;A Furious Cocktail;How Did We Get Here}}

== Video ==

<div style="text-align:center">{{yt|cuN6VdcUfLE}}</div>

== History ==
{{Info needed section|Splash Potion of Weakness; }}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 4|[[File:Splash Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Splash Potion of Swiftness JE1 BE1.png|32px]] [[File:Splash Potion of Slowness JE1 BE1.png|32px]] [[File:Splash Potion of Healing JE1 BE1.png|32px]] [[File:Splash Potion of Harming JE1 BE1.png|32px]] [[File:Splash Potion of Poison JE1 BE1.png|32px]] [[File:Splash Potion of Regeneration JE1 BE1.png|32px]] [[File:Splash Potion of Strength JE1 BE1.png|32px]] [[File:Splash Potion of Weakness JE1 BE1.png|32px]] Added splash potions.}}
{{History||link=http://www.reddit.com/r/Minecraft/comments/lbrqq/water_balloons/c2rey4s?context=3|Oct 14, 2011|[[Jeb]] had commented that while splash water bottles should logically harm [[endermen]] and [[blaze]]s, its coding would be more difficult to implement than is worthwhile.}}
{{History||1.3.1|snap=12w17a|Splash potions are no longer depleted from the [[player]]'s [[inventory]] when used in [[creative]].}}
{{History|||snap=12w22a|Splash potions have been added to the new creative item selection from [[Java Edition 12w21b|12w21b]]. This includes extended-enhanced potions with both extended duration and enhanced effect for four potion effects.}}
{{History||1.4.2|snap=12w32a|[[File:Splash Potion of Night Vision JE1 BE1.png|32px]] Added splash potions of [[Night Vision]].
|Splash potions of Night Vision are currently not yet [[brewing|brewable]].}}
{{History|||snap=12w34a|[[File:Splash Potion of Invisibility JE1 BE1.png|32px]] Added splash potions of [[Invisibility]].
|Splash potions of Night Vision are now brewable.}}
{{History|||snap=12w38a|[[Witch]]es now use splash potions for attacking.}}
{{History|||snap=12w39b|Custom [[potion]]s can now be created with a world editor.<ref>http://www.youtube.com/watch?v=2D8OcQ1zyzY</ref>}}
{{History||1.5|snap=?|Extended-enhanced potions are no longer available in the Creative inventory for all four potion effects. {{info needed}}{{verify}}<!--only checked v1.4.7 and v1.5.2, but did not check any version in between, please check all-->}}
{{History||1.7.2|snap=13w36a|[[File:Splash Potion of Water Breathing JE1 BE1.png|32px]] Added splash potions of [[Water Breathing]].}}
{{History||1.8|snap=14w27a|[[File:Splash Potion of Leaping JE1 BE1.png|32px]] Added splash potions of [[Leaping]].}}
{{History||1.8.1|snap=pre1|Splash potions of Leaping can now be extended.}}
{{History||1.9|snap=15w31a|[[File:Splash Water Bottle JE1 BE1.png|32px]] [[File:Splash Water Bottle JE1 BE1.png|32px]] [[File:Splash Water Bottle JE1 BE1.png|32px]] [[File:Splash Water Bottle JE1 BE1.png|32px]] Added splash water bottles, mundane, thick, and awkward splash potions.
|Splash potions no longer only have 75% of the durations from their corresponding normal potions.}}
{{History|||snap=15w33a|Splash potions are now used to brew [[lingering potion]]s.}}
{{History|||snap=15w33c|Splash potions can now be placed in [[brewing stand]]s.}}
{{History|||snap=15w34a|Splash water bottles now just extinguish [[fire]], without placing flowing [[water]].}}
{{History|||snap=15w43a|A splash potion of weakness can now be found in the [[brewing stand]] in an [[igloo]] basement.}}
{{History|||snap=15w44b|[[File:Uncraftable Splash Potion JE1.png|32px]] [[File:Splash Potion of Luck JE1.png|32px]] Added uncraftable splash potions and splash potions of [[Luck]].}}
{{History|||snap=15w49a|Splash potions, like all throwable projectiles, now take the thrower's motion into account.}}
{{History||1.11|snap=16w32a|The [[entity]] ID has been changed from <code>ThrownPotion</code> to <code>potion</code>.}}
{{History|||snap=16w35a|Splash water bottles now deal {{hp|1}} [[damage]] to [[endermen]] and [[blaze]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 438.}}
{{History|||snap=18w07a|[[File:Splash Potion of the Turtle Master JE1 BE1.png|32px]] Added splash potions of the Turtle Master.}}
{{History|||snap=18w14a|[[File:Splash Potion of Slow Falling JE1 BE1.png|32px]] Added splash potions of [[Slow Falling]].}}
{{History||1.14|snap=18w43a|[[File:Uncraftable Splash Potion JE2.png|32px]] [[File:Splash Water Bottle JE2 BE2.png|32px]] [[File:Splash Potion of Night Vision JE2 BE2.png|32px]] [[File:Splash Potion of Invisibility JE2 BE2.png|32px]] [[File:Splash Potion of Leaping JE2 BE2.png|32px]] [[File:Splash Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Splash Potion of Swiftness JE2 BE2.png|32px]] [[File:Splash Potion of Slowness JE2 BE2.png|32px]] [[File:Splash Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Splash Potion of Water Breathing JE2 BE2.png|32px]] [[File:Splash Potion of Healing JE2 BE2.png|32px]] [[File:Splash Potion of Harming JE2 BE2.png|32px]] [[File:Splash Potion of Poison JE2 BE2.png|32px]] [[File:Splash Potion of Regeneration JE2 BE2.png|32px]] [[File:Splash Potion of Strength JE2 BE2.png|32px]] [[File:Splash Potion of Weakness JE2 BE2.png|32px]] [[File:Splash Potion of Luck JE2.png|32px]] [[File:Splash Potion of Slow Falling JE2 BE2.png|32px]] The textures of splash potions have been changed.}}
{{History||1.16|snap=20w09a|[[Fire resistance]] splash potions can now be obtained through [[bartering]].}}
{{History||1.19|snap=22w11a|Splash water bottles can now be {{control|used}} on [[dirt]], [[coarse dirt]], or [[rooted dirt]] to turn it into [[mud]].}}
{{History||1.19.3|snap=22w43a|Splash water bottles can now extinguish burning entities.<ref>{{bug|MC-189911|||Fixed}}</ref>}}
{{History||1.19.4|snap=Pre-release 1|Splash potions no longer have an enchantment glint.}}
{{History|||snap=Pre-release 3|[[File:Splash Potion of Night Vision JE3.png|32px]] [[File:Splash Potion of Invisibility JE3.png|32px]] [[File:Splash Potion of Leaping JE3.png|32px]] [[File:Splash Potion of Fire Resistance JE3.png|32px]] [[File:Splash Potion of Swiftness JE3.png|32px]] [[File:Splash Potion of Slowness JE3.png|32px]] [[File:Splash Potion of the Turtle Master JE3.png|32px]] [[File:Splash Potion of Water Breathing JE3.png|32px]] [[File:Splash Potion of Harming JE3.png|32px]] [[File:Splash Potion of Poison JE3.png|32px]] [[File:Splash Potion of Strength JE3.png|32px]] Changed colors of the following splash potions: Night Vision, Invisibility, Leaping, Fire Resistance, Swiftness, Slowness, Turtle Master, Water Breathing, Harming, Poison, Strength, Resistance.}}
{{History||1.20|snap=23w12a|Wither [[effect]] particle colors have been adjusted to make them more distinguishable.
|The splash potion of [[Slow Falling]] has had its color tweaked to make it more distinguishable from the splash potion of [[Invisibility]].}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Splash Water Bottle JE1 BE1.png|32px]] [[File:Splash Potion of Night Vision JE1 BE1.png|32px]] [[File:Splash Potion of Invisibility JE1 BE1.png|32px]] [[File:Splash Potion of Leaping JE1 BE1.png|32px]] [[File:Splash Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Splash Potion of Swiftness JE1 BE1.png|32px]] [[File:Splash Potion of Slowness JE1 BE1.png|32px]] [[File:Splash Potion of Water Breathing JE1 BE1.png|32px]] [[File:Splash Potion of Healing JE1 BE1.png|32px]] [[File:Splash Potion of Harming JE1 BE1.png|32px]] [[File:Splash Potion of Poison JE1 BE1.png|32px]] [[File:Splash Potion of Regeneration JE1 BE1.png|32px]] [[File:Splash Potion of Strength JE1 BE1.png|32px]] [[File:Splash Potion of Weakness JE1 BE1.png|32px]] Added splash potions.
|Splash water bottles, mundane, long mundane, thick, and awkward splash potions are all available in the Creative inventory.}}
{{History||v0.13.0|snap=build 1|Splash potions of [[Leaping]] are now obtainable in [[survival]].}}
{{History||v0.14.0|snap=build 1|Splash potions can now be used to fill [[cauldron]]s.
|A cauldron now can be filled by splash potions and can be emptied using a [[glass bottle]], which turn into the corresponding splash potion.
|[[Witch]]es now use splash potions for attacking.}}
{{History||?|Splash water bottles now deal {{hp|1}} [[damage]] to [[endermen]] and [[blaze]]s.
|Splash water bottles now just extinguish [[fire]], without placing flowing [[water]].}}
{{History||v0.16.0|snap=build 4|[[File:Splash Potion of Decay BE1.png|32px]] As a version exclusive, added splash potions of [[Decay]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Splash potions can now be used to brew [[lingering potion]]s.
|A splash potion of weakness can now be found in the [[brewing stand]] in an [[igloo]] basement.}}
{{History|bedrock}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Splash Potion of the Turtle Master JE1 BE1.png|32px]] Added splash potions of the Turtle Master.}}
{{History||1.6.0|snap=beta 1.6.0.5|[[File:Splash Potion of Slow Falling JE1 BE1.png|32px]] Added splash potions of [[Slow Falling]].}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Splash Water Bottle JE2 BE2.png|32px]] [[File:Splash Potion of Night Vision JE2 BE2.png|32px]] [[File:Splash Potion of Invisibility JE2 BE2.png|32px]] [[File:Splash Potion of Leaping JE2 BE2.png|32px]] [[File:Splash Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Splash Potion of Swiftness JE2 BE2.png|32px]] [[File:Splash Potion of Slowness JE2 BE2.png|32px]] [[File:Splash Potion of Water Breathing JE2 BE2.png|32px]] [[File:Splash Potion of Healing JE2 BE2.png|32px]] [[File:Splash Potion of Harming JE2 BE2.png|32px]] [[File:Splash Potion of Poison JE2 BE2.png|32px]] [[File:Splash Potion of Regeneration JE2 BE2.png|32px]] [[File:Splash Potion of Strength JE2 BE2.png|32px]] [[File:Splash Potion of Weakness JE2 BE2.png|32px]] [[File:Splash Potion of Decay BE2.png|32px]] [[File:Splash Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Splash Potion of Slow Falling JE2 BE2.png|32px]] The textures of splash potions have been changed.}}
{{History||1.16.0|snap=beta 1.16.0.57|[[Fire resistance]] splash potions can now be obtained through [[bartering]].}}
{{History||1.19.80|snap=beta 1.19.80.21|Changed potion colors for the following splash potions: Fire Resistance, Harming, Invisibility, Leaping, Night Vision, Poison, Slowness, Strength, Swiftness, Turtle Master, and Water Breathing.
|Removed enchantment glint from splash potions.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Splash Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Splash Potion of Swiftness JE1 BE1.png|32px]] [[File:Splash Potion of Slowness JE1 BE1.png|32px]] [[File:Splash Potion of Healing JE1 BE1.png|32px]] [[File:Splash Potion of Harming JE1 BE1.png|32px]] [[File:Splash Potion of Poison JE1 BE1.png|32px]] [[File:Splash Potion of Regeneration JE1 BE1.png|32px]] [[File:Splash Potion of Strength JE1 BE1.png|32px]] [[File:Splash Potion of Weakness JE1 BE1.png|32px]] Added splash potions.}}
{{History||xbox=TU14|ps=1.04|[[File:Splash Potion of Night Vision JE1 BE1.png|32px]] [[File:Splash Potion of Invisibility JE1 BE1.png|32px]] Added splash potions of [[Night Vision]] and splash potions of [[Invisibility]].
|Extended-enhanced potions are now listed individually for four potion effects.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Splash Potion of Leaping JE1 BE1.png|32px]] [[File:Splash Potion of Water Breathing JE1 BE1.png|32px]] Added splash potions of [[Leaping]] and splash potions of [[Water Breathing]]. These are both available in four variants unlike ''Java'' and ''Bedrock'' where the latter group only added two variants of water breathing and three variants for leaping.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|switch=1.0.1|[[File:Splash Water Bottle JE1 BE1.png|32px]] Added splash [[water bottle]]s.
|[[File:Splash Potion of Luck JE1.png|32px]] Added splash potions of [[Luck]].
|Added [[lingering potion]]s, which can be [[brewing|brewed]] with splash potions to create [[dragon's breath]].
|Added dragon's breath, which can be brewed from lingering potions and splash potions.
|Splash potions no longer only have 75% of the durations from their corresponding normal potions.
|Removed all types of extended-enhanced potions for all five potion effects.}}
{{History||xbox=TU54|xbone=CU44|ps=1.52|wiiu=Patch 24|switch=1.0.4|Splash water bottles now deal {{hp|1}} [[damage]] to [[endermen]] and [[blaze]]s.}}
{{History||xbox=TU57|xbone=CU49|ps=1.56|wiiu=Patch 27|switch=1.0.7|Splash potions once again only have 75% of the duration from their corresponding normal potions.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|[[File:Splash Potion of Decay BE1.png|32px]] [[File:Splash Potion of the Turtle Master JE1 BE1.png|32px]] [[File:Splash Potion of Slow Falling JE1 BE1.png|32px]] Added splash potions of [[Decay]], Turtle Master, and [[Slow Falling]].}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Splash Water Bottle JE1 BE1.png|32px]] [[File:Splash Potion of Night Vision JE1 BE1.png|32px]] [[File:Splash Potion of Invisibility JE1 BE1.png|32px]] [[File:Splash Potion of Leaping JE1 BE1.png|32px]] [[File:Splash Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Splash Potion of Swiftness JE1 BE1.png|32px]] [[File:Splash Potion of Slowness JE1 BE1.png|32px]] [[File:Splash Potion of Water Breathing JE1 BE1.png|32px]] [[File:Splash Potion of Healing JE1 BE1.png|32px]] [[File:Splash Potion of Harming JE1 BE1.png|32px]] [[File:Splash Potion of Poison JE1 BE1.png|32px]] [[File:Splash Potion of Regeneration JE1 BE1.png|32px]] [[File:Splash Potion of Strength JE1 BE1.png|32px]] [[File:Splash Potion of Weakness JE1 BE1.png|32px]] Added splash potions.
|Splash water bottles, mundane, thick, and awkward splash potions are all available in the Creative inventory.}}
{{History||1.3.12|[[File:Splash Potion of Decay BE1.png|32px]] Added splash potions of [[Decay]].}}
{{History|foot}}

==Issues==
{{issue list}}

==Trivia==
*If an enderman is targeted directly by a splash potion, it teleports away before the potion can affect it. However, if an enderman is caught in the splash radius of a potion not aimed at it, it takes damage from the potion.
*If killed by a splash potion of harming, the death message would be: ''<player> was killed by <attacker> using magic''
*A thrown splash potion faces toward the [[player]] in first-person view, while it appears rotated horizontally in third-person view. This is the case for all throwable [[item]]s ([[ender pearl]]s, [[eggs]], [[snowball]]s, and all throwable potions).

==Unused splash potions==
[[Bedrock Edition]] has [[History of textures/Unused textures#Unused potions|unused splash potion textures]] for several [[effect]]s, along with their [[Potion#Unused potions|normal variants]]. These effects are: [[Absorption]], [[Blindness]], [[Haste]], [[Health Boost]], [[Hunger]], [[Mining Fatigue]], [[Nausea]], [[Resistance]], [[Saturation]], and [[Levitation]], as well as the [[Luck]] potion textures also present in [[Java Edition]]. These unused textures were added along with the other potion textures in [[Pocket Edition v0.12.1 alpha]], except for the potion of levitation, which was added in [[Pocket Edition 1.0.0]]. The textures were changed along with the other potion textures during the [[texture update]] in [[Bedrock Edition 1.10.0]]. Strangely, the potion of levitation texture is a duplicate of the splash potion of levitation texture.
<gallery>
Splash Potion of Absorption BE2.png|Splash Potion of Absorption
Splash Potion of Blindness BE2.png|Splash Potion of Blindness
Splash Potion of Haste BE2.png|Splash Potion of Haste
Splash Potion of Health Boost BE2.png|Splash Potion of Health Boost
Splash Potion of Hunger BE2.png|Splash Potion of Hunger
Splash Potion of Mining Fatigue BE2.png|Splash Potion of Mining Fatigue
Splash Potion of Nausea BE2.png|Splash Potion of Nausea
Splash Potion of Resistance BE2.png|Splash Potion of Resistance
Splash Potion of Saturation BE2.png|Splash Potion of Saturation
Potion of Levitation BE2.png|Splash Potion of Levitation
</gallery>

== Gallery ==
<gallery>
Splash Water Bottle.png|Splash water bottle
Splash Potion of Night Vision.png|Night Vision
Splash Potion of Invisibility.png|Invisibility
Splash Potion of Leaping.png|Leaping
Splash Potion of Fire Resistance.png|Fire Resistance
Splash Potion of Swiftness.png|Swiftness
Splash Potion of Slowness.png|Slowness
Splash Potion of the Turtle Master.png|Turtle Master
Splash Potion of Water Breathing.png|Water Breathing
Splash Potion of Healing.png|Healing
Splash Potion of Harming.png|Harming
Splash Potion of Poison.png|Poison
Splash Potion of Regeneration.png|Regeneration
Splash Potion of Strength.png|Strength
Splash Potion of Weakness.png|Weakness
Splash Potion of Slow Falling.png|Slow Falling
Splash Potion of Luck.png|Luck
Splash Potion of Decay.png|Decay
Uncraftable Splash Potion.png|Uncraftable splash potion
</gallery>
=== Other ===
<gallery>
Splash Potion Weakness.png|A splash potion hovered over in a brewing stand
Splash Potion Radius.png|Splash potions' area of effect
</gallery>

== See also==
* {{ItemLink|Glass Bottle}}
* {{ItemLink|Lingering Potion}}
* {{ItemLink|Bottle o' Enchanting}}

== Notes ==
{{notelist|n}}

== References ==
{{reflist}}

== External links ==
* [http://www.minecraftforum.net/topic/673147-all-about-potions-and-brewing-19-reference-guidepics-and-a-mod-download-to-make-them-usable/ Minecraft Forum: All About Potions And Brewing - 1.9 Reference Guide]
* [http://potioncraft.net/ Minecraft Potions - A Visual Guide]

{{Items}}
{{entities}}

[[Category:Combat]]

[[cs:Vrhací lektvar]]
[[de:Wurftrank]]
[[fr:Potion jetable]]
[[ja:スプラッシュポーション]]
[[ko:투척용 물약]]
[[nl:Spattende dranken]]
[[pl:Mikstury miotane]]
[[pt:Poção arremessável]]
[[ru:Взрывающиеся зелья]]
[[zh:喷溅药水]]</li></ul>
pre1Added functions.
pre3Commands are no longer allowed to begin with a / (forward slash)
Comments can now only be preceded with #; using // is no longer allowed
pre4Added new arguments to the /function command: [if|unless] [selector]
pre6Skipped functions (when a conditional fails) are now considered failures when used in commands.
1.13
{{Extension DPL}}<ul><li>[[Lapis Lazuli|Lapis Lazuli]]<br/>{{Item
| image = Lapis Lazuli.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}
{{About|the item|the ore|Lapis Lazuli Ore|the mineral block|Lapis Lazuli Block}}

'''Lapis lazuli''' is a mineral required to [[Enchanting|enchant]] items in an [[Enchanting Table|enchanting table]].

== Obtaining ==

=== Mining ===

When mined with a stone [[pickaxe]] or better, [[lapis lazuli ore]] drops 4–9 lapis lazuli. With the [[Fortune]] III enchantment, a single block has a chance of dropping up to 36 items.

=== Crafting ===

{{Crafting
  |Block of Lapis Lazuli
  |Output=Lapis Lazuli,9
  |type=Material
}}

=== Smelting ===
{{Smelting
  |showname=1
  |Lapis Lazuli Ore; Deepslate Lapis Lazuli Ore
  |Lapis Lazuli
  |0.2
}}

=== Villager gifts ===

{{IN|java}}, cleric [[villager]]s give [[player]]s lapis lazuli if they have the [[Hero of the Village]] effect.

=== Trading ===

Apprentice-level cleric villagers sell one lapis lazuli for an [[emerald]] as part of their trades.

{{IN|bedrock}}, [[wandering trader]]s may sell 3 lapis lazuli for an emerald.

=== Chest loot ===
{{see also|Lapis Lazuli Ore#Natural generation}}
{{LootChestItem|lapis-lazuli}}

== Usage ==

=== Enchanting ===

1–3 pieces of lapis lazuli are required to use an [[Enchanting Table|enchanting table]] to enchant an [[items|item]]. More specifically, the enchanting table UI shows 3 options (see [[Enchanting mechanics]] for details): the first, second, and third options cost 1, 2, and 3 lapis lazuli, respectively.

=== Crafting ingredient ===

Lapis lazuli can be used to make [[blocks of lapis lazuli]] and [[blue dye]]. {{IN|bedrock}}, it can also be used directly as a substitute for blue dye.
{{crafting usage}}

{{IN|bedrock}}, lapis lazuli can be also used in banner patterns:
{{banner crafting usage}}

=== Loom ingredient === 
{{Banner loom usage|Lapis Lazuli}}

=== Dye ===
{{Dye usage}}

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Lapis Lazuli
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Lapis Lazuli
|Lapis Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.<br/>
|tail=1
}}

;Trim color palette
The following color palette is shown on the designs on trimmed armor:
*{{TrimPalette|lapis lazuli}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Lapis Lazuli
|spritetype=item
|nameid=lapis_lazuli
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lapis Lazuli
|spritetype=item
|nameid=lapis_lazuli
|aliasid=dye / 4
|id=414
|form=item
|translationkey=item.dye.blue.name
|foot=1}}

== Advancements ==
{{load advancements|Enchanter}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||1.2_02|[[Lapis lazuli ore]] can now be found at [[bedrock]] level and now drops 4–8 lapis lazuli per block mined (increased from 1) on [[singleplayer]] only. However, servers have not been affected yet.}}
{{History||1.8|snap=Pre-release|Lapis lazuli can now be found in [[mineshaft]] [[chest]]s.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Lapis lazuli can now be used to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Lapis lazuli can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|Lapis lazuli can now be used to craft blue [[stained clay]].}}
{{History||1.7.2|snap=13w41a|Lapis lazuli can now be used to craft blue [[stained glass]].}}
{{History||1.8|snap=14w02a|[[Enchanting]] now requires lapis lazuli. Different enchantments require different amounts of levels and different amounts of levels now require different amounts of lapis lazuli (between 1-3).
|Cleric [[villager]]s now [[trading|sell]] 1–2 lapis lazuli for 1 [[emerald]], making it a [[renewable resource]].}}
{{History|||snap=14w30a|Lapis lazuli can now be used to dye [[banner]]s.}}
{{History||1.9|snap=15w44a|The average yield of lapis lazuli in [[mineshaft]] [[chest]]s has been decreased.}}{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Can now be used to craft blue [[concrete powder]].}}
{{History|||snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History|||snap=18w11a|Lapis lazuli now generates in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|Lapis lazuli can now be used to craft [[blue dye]].
|Lapis lazuli can no longer be used as a [[dye]].
|All of the dye-related functions and crafting recipes of lapis lazuli (except lapis lazuli blocks) have been transferred to blue dye.
|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History|||snap=18w50a|Lapis lazuli can now be found in chests in [[village]] temples.}}
{{History|||snap=19w13a|Cleric villagers now give lapis lazuli to players under the [[Hero of the Village]] effect.}}
{{History||1.17|snap=21w08a|Lapis lazuli can now drop and be smelted from [[deepslate lapis lazuli ore]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Lapis lazuli can now be used as an armor trim material.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||v0.3.2|Lapis lazuli can now be crafted into lapis lazuli blocks, and vice versa.}}
{{History||v0.12.1|snap=build 1|Lapis lazuli is now required for [[enchanting]].}}
{{History||v0.14.0|snap=build 1|Lapis lazuli can now be found inside [[minecart with chest]]s in [[mineshaft]]s.
|Lapis lazuli can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Cleric [[villager]]s now [[trading|sell]] 1–2 lapis lazuli for 1 [[emerald]].
|Lapis lazuli can now be used to [[dyeing|dye]] [[shulker shell]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Lapis lazuli can now be used to dye [[shulker box]]es and [[bed]]s.
|Lapis lazuli can now be used to [[crafting|craft]] blue [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Lapis lazuli can now be used to dye [[banner]]s, [[firework star]]s and [[glass]].}}
{{History||1.4.0|snap=beta 1.2.14.2|Lapis lazuli can now be found in [[shipwreck]] treasure chests.}}
{{History|||snap=beta 1.2.20.1|Lapis lazuli can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.10|Lapis lazuli can now be used to craft [[blue dye]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Lapis lazuli are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Lapis lazuli can now be found in [[desert]] [[village]] temple [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Cleric [[villager]]s now [[trading|sell]] one lapis lazuli for one [[emerald]].}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of lapis lazuli has been changed from <code>dye/4</code> to <code>lapis_lazuli</code>.}}
{{History||1.17.0|snap=beta 1.16.230.52|Lapis lazuli can now drop and be smelted from [[deepslate lapis lazuli ore]].}}
{{History||1.19.80|snap=beta 1.19.80.21|Lapis lazuli can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|Lapis lazuli can now be used in [[enchanting]].}}
{{History|Ps4}}
{{History||1.90|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* In real life, lapis lazuli is a blue gem that can be ground and processed into ultramarine pigment. Lapis lazuli pigment has been famously used in the production of illuminated manuscripts, stained glass, and cave paintings. [[Wikipedia:Lapis lazuli|See the Wikipedia article for more information]].
* Lapis lazuli is the only [[ore]] that can be used as a [[dye]]{{only|BE|short=1}} or making a dye.
* It is the only item that can be put in the second slot of an [[enchantment table]].

== References ==
{{reflist}}

{{Items}}

[[Category:Dyes]]

[[cs:Lazurit]]
[[de:Lapislazuli]]
[[es:Lapislázuli]]
[[fr:Lapis-lazuli]]
[[hu:Lazurit]]
[[ja:ラピスラズリ]]
[[ko:청금석]]
[[nl:Lapis lazuli]]
[[pl:Lazuryt]]
[[pt:Lápis-lazúli]]
[[ru:Лазурит]]
[[th:แร่แลพิสแลซูลี]]
[[uk:Лазурит]]
[[zh:青金石]]
[[Category:Renewable resources]]</li><li>[[Raw Mutton|Raw Mutton]]<br/>{{Distinguish|Cooked Mutton}}
{{Item
| title = Raw Mutton
| image = Raw Mutton.png
| heals = {{hunger|2}}
| renewable = Yes
| stackable = Yes (64)
}}
'''Raw mutton''' is a [[food]] item dropped by [[sheep]] when killed.

== Obtaining ==

=== Mob loot ===

An adult [[sheep]] drops 1–2 raw mutton when killed. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 1–5 with Looting III. If killed while on fire, a sheep drops [[cooked mutton]] instead.

=== Chest loot ===

{{LootChestItem|raw-mutton}}

== Usage ==

=== Food ===

To eat raw mutton, press and hold {{control|use}} while it is selected in the [[hotbar]]. Eating one restores {{hunger|2}} [[hunger]] and 1.2 [[Hunger#Mechanics|saturation]].

=== Smelting ingredient ===

{{Smelting
  |showname=1
  |Raw Mutton
  |Cooked Mutton
|0.35
}}

=== Wolves ===

Raw mutton can be used to [[breed]] and heal tamed [[wolves]], lead them around, and make baby tamed wolves grow up faster by 10% of the remaining time.

=== Trading ===

Journeyman-level butcher [[villager]]s have a 50% chance to buy 7 raw mutton for an [[emerald]] as part of their trades.{{only|bedrock}}

Journeyman-level butcher villagers always offer to buy 7 raw mutton for an emerald.{{only|java}}

==Sounds==
{{Sound table/Entity/Food}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Mutton
|spritetype=item
|nameid=mutton
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Mutton
|spritetype=item
|nameid=mutton
|aliasid=muttonraw
|id=550
|form=item
|translationkey=item.muttonRaw.name
|foot=1}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet}}

== Video ==

<div style="text-align:center">{{yt|PXlW-sZygTs}}</div>

== History ==

{{History||September 23, 2011|link={{tweet|jeb|117313469900009472}}|Mutton is mentioned by [[Jeb]].}}
{{History||September 11, 2012|link={{tweet|jeb|245503714167750656}}|Jeb again mentions the possibility of mutton as well as calamari being added into the game.}}
{{History|java}}
{{History||June 30, 2014|link=https://twitter.com/TheMogMiner/status/483636993780232192|[[Ryan Holtz]] tweets images of raw mutton and some other new items.}}
{{History||1.8|snap=14w27a|[[File:Raw Mutton JE1.png|32px]] Added raw mutton.}}
{{History||1.8|snap=14w33b|[[File:Raw Mutton JE2 BE1.png|32px]] The texture of raw mutton has been changed. The new texture was created by [[wikipedia:Reddit|Reddit]] user [http://www.reddit.com/u/zeldahuman zeldahuman].<ref>{{reddit|2bjzes/a_reminder_of_the_blocks_and_items_added_in_18_so|cj69zie|context=3}}</ref><ref>{{reddit|2c5f35/minecraft_snapshot_14w31a_has_been_released|cjct7gb}}</ref>}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 423.}}
{{History||1.14|snap=18w43a|[[File:Raw Mutton JE3 BE2.png|32px]] The texture of raw mutton has been changed.}}
{{History|||snap=18w49a|Raw mutton can now be found in [[chest]]s in [[village]] butcher shops.}}
{{History|||snap=19w11a|Butcher villagers now [[trading|buy]] raw mutton.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Raw Mutton JE2 BE1.png|32px]] Added raw mutton.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Raw Mutton JE3 BE2.png|32px]] The texture of raw mutton has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Raw mutton can now be found in [[village]] butcher [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Raw mutton can now be [[trading|sold]] to butcher [[villager]]s.}}
{{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed; journeyman butcher villagers now buy 7 raw mutton for an emerald instead of 8.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of raw mutton has been changed from <code>muttonraw</code> to <code>mutton</code>.}}
{{History||1.16.210|snap=beta 1.16.210.51|Raw mutton is [[drops|dropped]] by [[goats]].}}
{{History||1.17.0|snap=beta 1.17.0.52|Goats no longer drop raw mutton.}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Raw Mutton JE2 BE1.png|32px]] Added raw mutton.}}
{{History|PS4}}
{{History||1.90|[[File:Raw Mutton JE3 BE2.png|32px]] The texture of raw mutton has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Raw Mutton JE2 BE1.png|32px]] Added raw mutton.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Rabbit Items 3 Ryan Holtz.png|First image of the item by [[Ryan Holtz]].
Pocket Edition Mutton.jpg|First image of the item in ''Bedrock Edition'' by [[Jason Major]].
</gallery>

== References ==
{{reflist}}

{{items}}

[[de:Rohes Hammelfleisch]]
[[es:Cordero crudo]]
[[fr:Mouton cru]]
[[ja:生の羊肉]]
[[ko:익히지 않은 양고기]]
[[nl:Rauw schapenvlees]]
[[pl:Surowa baranina]]
[[pt:Carneiro cru]]
[[ru:Сырая баранина]]
[[zh:生羊肉]]
[[Category:Food]]
[[Category:Renewable resources]]</li></ul>
17w43aCustom functions have been moved into data packs.
17w45aFunctions are now completely parsed and cached on load.
17w49bFunction can now be tagged.
Functions tagged in minecraft:tick now run every tick in the beginning of the tick.

Issues

Issues relating to "Function (Java Edition)" are maintained on the bug tracker. Report issues there.

References

Advertisement