Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 
This article is about functions in Java Edition. For functions in Bedrock Edition, see Function (Bedrock 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:

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>[[:Category:Tools|Category:Tools]]<br/>[[Category:Items]]

[[fr:Catégorie:Outil]]
[[it:Categoria:Attrezzi]]</li><li>[[Bamboo|Bamboo]]<br/>{{for|the plant feature|Bamboo (feature)}}
{{Distinguish|text = [[Sugar Cane]], which was colloquially known as Bamboo}}
{{Block
| image = <gallery>
Leafless Bamboo.png|Leafless
Small Leaves Bamboo.png|Small
Big Leaves Bamboo.png|Big
Leafless Old Bamboo.png|Leafless Old
Small Leaves Old Bamboo.png|Small Old
Big Leaves Old Bamboo.png|Big Old
</gallery>
| image2 = Bamboo Shoot.png<!--different infobox for this later down the line, like with pistons?-->
| image3 = Bamboo (item) JE1 BE1.png
| transparent = Yes
| light = No
| tool = Sword
| tool2 = Axe
| renewable = Yes
| stackable = Yes (64)
| flammable = '''Bamboo''': Yes (60)<br>'''Shoot''': No
| lavasusceptible = Yes
}}
'''Bamboo''' is a versatile, fast-growing, [[Bone Meal|bonemealable]] [[plant]] found primarily in [[jungle]]s, which is used for [[crafting]] (particularly [[scaffolding]] and [[Block of Bamboo|bamboo wood]]), [[smelting]] and [[breeding]] [[Panda|pandas]]. 

A '''bamboo shoot''' is the initial non-solid sapling form of planted bamboo.

== Obtaining ==
Bamboo shoots cannot be obtained through vanilla means. {{IN|bedrock}}, they can be obtained through [[add-on]]s or inventory editing. {{IN|java}}, they are completely unobtainable.

=== Breaking ===
Bamboo can be mined with any [[tool]], but a [[sword]] breaks the block [[instant mining|instantly]], even with [[Mining Fatigue]]. Flowing [[water]] also breaks bamboo shoots, but not mature bamboo stalks.

{{breaking row|Bamboo|Sword|sword=1|horizontal=1}}
{{notelist}}
=== Natural generation ===
Bamboo generates in widely scattered single shoots within [[jungle]] [[biome]]s. Bamboo generates much more densely in the [[bamboo jungle|bamboo variant]]s of jungles, covering large areas of the landscape. Bamboo does ''not'' generate in [[sparse jungle]]s.<ref>{{bug|MC-156638|||WAI}}</ref>

=== Mob loot ===
{{IN|java}}, a [[panda]] drops 1 bamboo when killed. [[Looting]] does not affect the drop rate.<ref>{{bug|MC-160006}}</ref>

{{IN|bedrock}}, a panda drops 0-2 bamboo when killed. Looting increases the drop by 1 per level.

=== Fishing ===
Bamboo can be found while [[fishing]] in [[jungle]] [[biome]]s as a junk [[item]].

=== Chest loot ===
{{LootChestItem|bamboo}}

== Usage ==
When broken, any bamboo [[block]] placed or grown above it is also broken. A bamboo block drops itself as an [[item]] if a [[piston]] pushes it or moves a block into its space. When bamboo is first placed as a shoot it's not solid and can be destroyed by water flowing into it. After growing at least one block taller it becomes solid and can't be destroyed by water. To transform a bamboo shoot into a solid bamboo block place another bamboo on top of it.

Unlike most plants, bamboo cannot be [[Composter#Composting|composted]].<ref>{{bug|MC-142452|||WAI}}</ref>

=== Farming ===
Bamboo can be planted on [[moss block]]s{{only|java|short=1}}, [[grass block]]s, [[dirt]], [[coarse dirt]], [[rooted dirt]], [[gravel]], [[mycelium]], [[podzol]], [[sand]], [[red sand]], [[suspicious sand]], [[suspicious gravel]], [[mud]], bamboo shoot, or on itself. At default random tick speed (3), each plant grows on average every {{convert|4096|ticks|seconds}}. When [[bone meal]] is {{control|used}} on it, it grows by 1–2 [[blocks]]. Bamboo can grow up to 12–16 blocks tall. The top of a bamboo plant requires a [[light]] level of 9 or above to grow.

Because bamboo breaks in almost the same way as [[sugar cane]]s, [[Tutorials/Sugar cane farming|a sugar cane farm]] can be easily adapted to this use. While water is not needed with such a farm, some spacing is recommended if the harvest is done manually as mature stalks are solid.

=== Pandas ===
Bamboo [[item]]s are eaten by [[panda]]s and can be used to speed up the growth of baby pandas. Bamboo can also be used to breed pandas when at least 8 [[block]]s of bamboo are within 5 blocks of the pandas, making the panda the only animal in the game to have extra breeding requirements. At this point, the [[player]] can feed them bamboo and they [[breeding|mate]] to have a baby.

=== Fuel ===
Bamboo can be used as fuel for [[smelting]]. Each bamboo item smelts 0.25 [[item]]s. Crafting two bamboo into a [[stick]] and using that as fuel is equivalent, smelting 0.5 items. 

Bamboo can be crafted into other items to increase its fuel efficiency.
* By crafting 9 bamboo into 2 [[bamboo planks]], 3 items can be smelted instead of 2.25, a 33.3% increase in efficiency.
** {{IN|bedrock}}, the fuel efficiency can be further doubled by crafting the bamboo planks into twice the amount of [[slab]]s.<ref>{{bug|MCPE-94368||Wooden slabs last for the same amount of time as planks in a furnace}}</ref>
* {{IN|java}}, by crafting 14 bamboo into 3 [[ladder]]s, 4.5 items can be smelted instead of 3.5, a 28.6% increase in efficiency.

=== Flower pots ===
Bamboo can be placed in a [[flower pot]], where it retains the design it has in its item form.

=== Crafting ingredient ===
{{crafting usage}}

== Appearance ==
[[File:Bamboo stages.png|thumb|The different stages of bamboo growth.]]

The appearance of bamboo changes as it grows. When first placed, it takes the form of a small shoot, which has no [[hitbox]]. When it grows one [[block]] taller it grows to 2 pixels in length and width and the top block has leaves coming off it. At 3 blocks, the top 2 blocks have leaves and at 4 blocks the bamboo expands to 3×3 pixels. At 5 blocks tall, the top 3 blocks have leaves on them. As the bamboo grows, the leaves move up and stay at the top 3 blocks. Destroying a block of bamboo does not change the appearance of the blocks below it. Bamboo is oriented at a random position in the block that it is in.

== Sounds ==
=== Bamboo ===
{{Sound table/Block/Bamboo}}

=== Bamboo Shoot ===
{{Sound table/Block/Bamboo shoot}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bamboo
|spritetype=block
|nameid=bamboo
|blocktags=bamboo_plantable_on}}
{{ID table
|displayname=Bamboo Shoot
|spritetype=block
|nameid=bamboo_sapling
|blocktags=bamboo_plantable_on
|form=block
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bamboo
|spritetype=block
|nameid=bamboo
|id=418}}
{{ID table
|displayname=Bamboo Sapling
|spritetype=block
|nameid=bamboo_sapling
|id=419
|form=block
|translationkey=-
|foot=1}}

=== Block states ===
{{see also|Block states}}

{{/BS}}

== Achievements ==
{{load achievements|Zoologist}}

== History ==
{{History||September 29, 2018|link={{tweet|minecraft|1046096508570009602}}|Bamboo is announced at [[MINECON Earth 2018]].}}
{{History|java}}
{{History||1.14|snap=18w43a|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.
|Added [[bamboo jungle]]s, where bamboo naturally generates.}}
{{History||1.16|snap=20w06a|"Bamboo Sapling" has been renamed to "Bamboo Shoot".}}
{{History|||snap=20w13a|Bamboo has been moved from the Miscellaneous tab to the Decoration Blocks tab in the [[Creative inventory]].<ref name="misc decoration">https://bugs.mojang.com/browse/MC-174434</ref>}}
{{History||1.17|snap=21w13a|Bamboo can now be planted on rooted dirt.}}
{{History|||snap=21w16a|Bamboo can now be planted on moss blocks.}}
{{History||1.18|snap=21w39a|Bamboo no longer generates underground.<ref>{{bug|MC-145376}}</ref><ref>{{bug|MC-214894}}</ref>}}
{{History||1.19|snap=22w15a|Bamboo can now be planted on mud.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Bamboo can now be used to craft [[bamboo planks]].}}
{{History|||snap=22w45a|Bamboo can no longer be used to craft bamboo planks.|Bamboo can now be used to craft a [[block of bamboo]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Bamboo can now be planted on [[suspicious sand]].}}
{{History||1.20|snap=23w14a|Bamboo can now be planted on [[suspicious gravel]].}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.8|[[File:Leafless Bamboo BE1.png|32px]] [[File:Small Leaves Bamboo BE1.png|32px]] [[File:Big Leaves Bamboo BE1.png|32px]] [[File:Leafless Old Bamboo BE1.png|32px]] [[File:Small Leaves Old Bamboo BE1.png|32px]] [[File:Big Leaves Old Bamboo BE1.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.}}
{{History||1.9.0|snap=beta 1.9.0.0|Bamboo can now generate in [[jungle]] [[biome]]s in single shoots.
|Added [[bamboo jungle]]s, where bamboo naturally generates.}}
{{History||1.12.0|snap=beta 1.12.0.3|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] The bamboo texture brightness has been updated to match {{el|je}}.<ref>{{bug|MCPE-42635}}</ref>}}
{{History||1.17.30|snap=beta 1.17.20.20|Swords now break bamboo instantly to match ''Java Edition''.<ref>{{bug|MCPE-64013}}</ref>}}
{{History||1.20.0|link=Bedrock Edition 1.20.0|snap=beta 1.19.50.21|Bamboo can now be used to craft [[bamboo planks]].}}
{{History|||snap=beta 1.19.60.20|Bamboo can no longer be used to craft bamboo planks.|Bamboo can now be used to craft a [[block of bamboo]].}}

{{History|console}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.}}
{{History|foot}}

=== Bamboo shoot "item" ===
{{:Technical blocks/Bamboo Shoot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Because bamboo grows quickly (on average 1 growth per 200 seconds), just 500 plants in an automatic farm produce more [[item]]s than a [[hopper]] can collect (2.5 items per second). A single hopper can move only enough items to keep 6.25 [[furnace]]s running.
* Bamboo is the fastest-growing plant in ''[[Minecraft]]'', which reflects its status as the fastest-growing plant known in real life.
* While bamboo cannot be composted in ''Minecraft'', it can be composted in real life.

== Gallery ==
<gallery>
File:PandaMinecon.png|The first image featuring bamboo, from [[MINECON Earth 2018]].
File:PandasEatingMinecon.jpg|A group of [[Panda|pandas]] eating bamboo, shown at [[MINECON Earth 2018]].
File:Growing bamboo BE.png|Planted bamboo growing.
File:Bamboo in tree.png|A bamboo shoot growing through a [[tree]].
File:Bamboo Jungle.png|Bamboo seen in a [[jungle]] [[biome]] variant.
File:Bamboo Jungle in Amplified world.png|Bamboo Jungle in an [[Amplified]] world in 1.19-rc2.
File:Naturalbamboo.png|Multiple naturally generated bamboo stems growing by a river.
File:Tall Bamboo.png|Grown Bamboo with three parts
File:Zuri Chopping Bamboo Pixel Art.png|[[Zuri]] chopping down bamboo for a baby panda.
File:Bamboo Wallpaper.png|Smartphone wallpaper of the aforementioned artwork, showing more of the treetops and bamboo.
File:Panda Packaging.jpg|Packing for the ''Diamond Level Panda'', modeled after bamboo.
</gallery>

==References==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

[[Category:Plants]]
[[Category:Food]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]
[[Category:Flammable blocks]]

[[cs:Bambus]]
[[de:Bambus]]
[[es:Bambú]]
[[fr:Bambou]]
[[it:Bambù]]
[[ja:竹]]
[[ko:대나무]]
[[pl:Bambus]]
[[pt:Bambu]]
[[ru:Бамбук]]
[[th:ไม้ไผ่]]
[[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>[[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><li>[[Name Tag|Name Tag]]<br/>{{about|the item that gives names to mobs|the nameplate above a player's head|Player#Username}}
{{Item
| image = Name Tag.png
| renewable = Yes
| stackable = Yes (64)
}}
A '''name tag''' is an [[item]] used to name [[mob]]s in the world and prevent them from despawning naturally.

== Obtaining ==

=== Chest loot ===

{{LootChestItem|name-tag}}

=== Fishing ===

Name tags can be caught from [[fishing]] as part of the treasure category with a {{frac|1|6}} chance after the 5% chance of being a treasure catch. The chance of catching treasure increases with the [[Luck of the Sea]] enchantment.

=== Trading ===

Master-level librarian [[villagers]] offer to sell a name tag for 20 [[emerald]]s as one of their available trades.

== Usage ==

To use a name tag, it must first be renamed with an [[anvil]], costing 1 [[experience]] level. 

If it is not renamed, it has no effect when used on a mob. After the name tag is renamed, the player can {{control|use}} it on a mob to give it the name given to the name tag from the anvil. Mobs and name tags can be renamed any number of times. Name tags with the same name are stackable. 

Once a mob is named, it keeps its name, and the name tag is consumed.

When a mob is named, it is excluded from the mob cap count.

Effects on various mobs:
* A named [[silverfish]] that goes into a block appears to lose its name because it is replaced by a newly generated unnamed silverfish when the block is broken.
* A baby (animal or villager) keeps its name when becoming an adult.
** A named [[villager]] keeps its name when transformed into a [[Zombie Villager|zombie villager]].
** A named zombie villager keeps its name when cured.
* [[Wandering Trader|Wandering trader]]s still despawn even if they are named, or in a [[minecart]] or [[boat]].
* A named [[wither]]'s boss bar displays its name instead of "Wither".
* Naming an [[ender dragon]] with commands also displays the name in the boss bar.

=== Limitations ===

Any mob can be named except for the [[ender dragon]] and [[player]]s.

A name tag can rename an [[armor stand]], though it does not show the nameplate above its head until <code>CustomNameVisible:1b</code> is set as an extra step.

{{control|Using|use}} a name tag on a villager renames the villager instead of opening the trading interface. A saddled pig is renamed instead of being ridden. Using a name tag on any other mob that can be interacted with performs the {{control|use}} action instead of being named. These mobs can be renamed if the player uses the name tag while crouching or standing in a [[nether portal]] because the portal suppresses the {{control|use}} action.

Once a name tag is used on a mob, it is impossible to remove the name of that mob without the use of commands or external modifications.

=== Behavior ===

Renamed mobs have their name displayed over their head in the same fashion as a mob named through a renamed [[spawn egg]]. Their names can be seen only if they are aimed at from four or fewer blocks away.

Mobs that are named using the name tag never despawn in the world, similar to tamed mobs.<ref>{{tweet|dinnerbone|327485109940916226}}</ref> The exceptions are [[wandering trader]]s or if the mob is hostile and the difficulty is switched to "[[Peaceful]]", causing any hostile mobs or any named hostile mobs to despawn immediately. 

If a renamed mob kills a player, the custom name is used in the death message in place of the mob type name. For instance, if a vindicator named "Johnny" kills a player, the death message is "Player was slain by Johnny". 

A renamed [[wither]] also has a renamed health bar, and the boss bar doesn't regenerate{{verify}}.

=== Easter eggs ===

* Any mob that receives the name "[[Easter eggs#Upside-down mobs|Dinnerbone]]" or "[[Easter eggs#Upside-down mobs|Grumm]]" is rendered upside down. This even includes the player in early versions of Bedrock Edition if the username is set to either of these and you are not signed into Xbox Live.
* Naming a [[sheep]] "[[Easter eggs#Jeb sheep|jeb_]]" causes its wool to fade between the dye colors, producing a rainbow effect. The [[wool]] that drops when the sheep is [[shear]]ed or killed is the original color of the sheep before the sheep was named.
* Naming a [[rabbit]] "[[Rabbit#Toast|Toast]]" causes it to have a special memorial skin of user xyzen420's girlfriend's [http://www.reddit.com/r/minecraftsuggestions/comments/27hjog/to_themogminer_my_bunny_is_missing_please_help_me/ missing rabbit].
* Naming a [[vindicator]] "Johnny" causes it to be aggressive and attack all [[mob]]s including the wither (except [[ghast]]s and other [[illager]]s). The hostility even extends to [[Ravager|ravagers]] in [[Java Edition|''Java Edition'']], as the "Johnny" vindicator can also attack the ravager while it's riding it.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Name Tag
|spritetype=item
|nameid=name_tag
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Name Tag
|spritetype=item
|nameid=name_tag
|id=548
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.6.1|snap=13w16b|[[File:Name Tag JE1 BE1.png|32px]] Added name tags. They can now be found in [[dungeon]] [[chest]]s.}}
{{History|||snap=13w25a|A [[mob]] named "Dinnerbone" or "Grumm" now renders upside down.}}
{{History||1.7.2|snap=13w36a|Name tags can now rarely be acquired by [[fishing]], making them [[renewable resource|renewable]].}}
{{History||1.7.4|snap=13w48b|A sheep named "jeb_" now fades between the [[dye]] colors.}}
{{History||1.8|snap=14w02a|Name tags can now be [[trading|bought]] from librarian [[villager]]s, at 20–22 [[emerald]]s for 1 name tag.}}
{{History|||snap=14w27a|[[Rabbit]]s have been added and naming one "Toast" gives it a special memorial skin.}}
{{History||1.9|snap=15w44a|Added name tags to [[mineshaft]] [[chest]]s.
|The average yield of name tags in [[dungeon]] chests has been decreased.}}
{{History||1.11|snap=16w39a|Name tags can now be found in the new [[woodland mansion]] chests.
|Added [[vindicator]]s, which attack almost all mobs if named "Johnny".}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 421.}}
{{History||1.14|snap=18w43a|[[File:Name Tag JE2 BE2.png|32px]] The texture of name tags has been changed.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Name tags now generate in [[ancient city]] chests.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Name Tag JE1 BE1.png|32px]]  Added name tags, and a new "Name" Interact button.
|A [[mob]] named "Dinnerbone" or "Grumm" renders upside down.
|A [[sheep]] named "jeb_" fades between the [[dye]] colors.
|Naming a [[rabbit]] "Toast" gives it a special memorial skin.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Name tags can now be [[trading|bought]] from librarian [[villager]]s for 20-22 [[emerald]]s as their last tier trade.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Naming a [[vindicator]] "Johnny" now makes it hostile to any [[mob]], except other [[illager]]s.
|Name tags can now be found in [[woodland mansion]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Name tags can now be found in buried treasure [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Name Tag JE2 BE2.png|32px]] The texture of name tags has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Name tags [[trading|sold]] by librarian [[villager]]s now cost 20 [[emerald]]s.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|[[File:Name Tag JE1 BE1.png|32px]] Added name tags.}}
{{History|PS4}}
{{History||1.90|[[File:Name Tag JE2 BE2.png|32px]] The texture of name tags has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Name Tag JE1 BE1.png|32px]] Added name tags.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Name tags were added at the request of [https://www.youtube.com/user/paulsoaresjr/ Paulsoaresjr].<ref>{{tweet|paulsoaresjr|326865482839883777}}</ref><ref>{{tweet|Dinnerbone|326812168630722561}}</ref>
* A stack of up to 64 name tags can be renamed at once. The cost is 1 [[experience]] level per stack, regardless of how many name tags were stacked.
* To name a [[mob]] “Name Tag” the player must give the name tag a random name, then rename it back to “Name Tag”.
* A [[villager]] with a name tag turned into a [[zombie villager]] by a [[zombie]] with a name tag does not despawn, but a villager with a name tag turned into a zombie by a zombie without a name tag does despawn.
* It is impossible to have a rainbow [[sheep]] upside-down, because it is impossible for it to be named “Jeb_” and “Dinnerbone” at the same time.

== Gallery ==
<gallery>
NameTag2.png|To use a name tag, the [[player]] must first rename it using an [[anvil]].
NameTag1.png|A [[wolf]] that has been renamed using a name tag.
RenamedCreeper.png|A [[creeper]] renamed using the name tag.
RenamedWither.png|A [[Wither Boss|wither]] renamed using a name tag. The custom name takes place of "Wither" over the [[health bar]] as well.
YoYo.png|How to use "Grumm" and "Dinnerbone" name tag [[easter egg]] and [[lead]] to make another animal Yo-yo.
Grumm Horse.png|A [[horse]] using the "Grumm" or "Dinnerbone" easter egg to be rendered upside-down.
MineshaftNameTag.png|Name Tag found in a mineshaft chest.
Pocket Edition Name Tag.jpg|First image of a name tag in bedrock edition.
</gallery>

== See also ==
* [[Spawn Egg]]

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--name-tag Taking Inventory: Name Tag] – Minecraft.net on March 15, 2019

{{items}}

[[de:Namensschild]]
[[es:Etiqueta]]
[[fr:Étiquette]]
[[it:Targhetta]]
[[ja:名札]]
[[ko:이름표]]
[[nl:Naamkaartje]]
[[pl:Znacznik]]
[[pt:Etiqueta]]
[[ru:Бирка]]
[[zh:命名牌]]
[[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