Function (Java Edition)

For the command, see Commands/function.

See also: Function (Bedrock Edition)

Functions are data pack files, allowing players to run lists of commands. Being text files, they are easily modifiable and less likely than command blocks to induce lag when used in large quantities.

This page covers how functions are defined and invoked in Java Edition.

Definition

A function is a text file with the file extension .mcfunction. The recommended encoding for function files is ANSI or UTF-8, without BOM.

Function files belong in the following folder of a data pack's structure, highlighted below:

• (data pack name)
  • pack.mcmeta
  • pack.png
  • data
    • (namespace)
      • advancements
        • (advancement).json
      • functions
        • (function).mcfunction
      • item_modifiers
        • (modifier).json
      • loot_tables
        • (loot table).json
      • predicates
        • (predicate).json
      • Further folders…

As with all other data pack files, the functions folder may also contain subfolders to further organize the function files within a namespace. These subfolders must be referenced when invoking the function.

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 beginning a line with #. Multiple spaces between command arguments are not allowed but a line can have tabs and spaces before and after the command.

Allowed commands

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 still obey /gamerule maxCommandChainLength, which is 65,536 commands by default; any commands beyond this limit are ignored.

In a singleplayer or a LAN world, like a command block, a function can run any command that is no more restrictive than permission level 2.

On the default multiplayer software, a function can run any command that is no more restrictive than the permission level prescribed in function-permission-level setting in server.properties.

Invocation

Functions can be invoked in several different manners from other data pack files.

Invocation from commands

Functions can be invoked using the /function command.

A single function can be invoked by specifying its resource location.

Unlike other data pack files, functions are supported by tags, allowing them to be grouped together. /function also accepts a function tag's resource location, invoking all listed functions.

Invocation from 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:subfolder/function"
  }
}

Invocation from function tags

Functions can be grouped together using function tags. Functions in a tag get executed in the defined order, but only the first occurrence of the same function if it occurs multiple times.

In addition, there are two function tags within the minecraft namespace that have special behavior:

• Functions listed in the minecraft:load tag run when the world is loaded, or when the server is started. Listed functions also run whenever the data pack is reloaded.
  • These functions run before the player joins the world, meaning any target selectors do not find players. Therefore, commands like /tellraw and /title do not appear for any player.
• Functions listed in the minecraft:tick tag run at the beginning of each tick, repeating every tick.

Note: The first instance of functions tagged minecraft:tick run before minecraft:load runs. This means that when reloading or loading, the order of execution is tick, load, tick, tick, tick, …

When invoked

Functions run all their commands in a single tick and other functions called from within also run their commands in the same tick as their parent. Functions use the execution context of whatever called the function. This includes executing entity, as well as execution position, rotation, dimension, and anchor. Contextual parameters are preserved for every command in the function. An /execute command can change the context, but that change does not carry through to any following commands in the same function.

For example:

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

# function foo:bar
teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute at @s run setblock ~ ~-1 ~ diamond_block

When invoked, this function teleports the nearest 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.

As seen in the above example, contextual parameters can be changed as usual by their respective /execute sub-commands.

History

Java Edition
1.12 {{Extension DPL}}<ul><li>[[Brown Dye|Brown Dye]]<br/>{{Item | image = Brown Dye.png | renewable = Yes | stackable = Yes (64) }} '''Brown dye''' is a [[Dye#Primary|primary color dye]] derived from [[cocoa beans]]. == Obtaining == === Crafting === {{Crafting |Cocoa Beans |Output=Brown Dye |type=Material |head= }} == Usage == {{dye usage}} === Crafting ingredient === {{crafting usage|ignore=Banner|continue=1}} {{banner crafting usage}} === Loom ingredient === {{Banner loom usage|Brown Dye}} === Trading === Apprentice-level Shepherd villagers have a 20% chance to buy 12 brown dye for an emerald.‌{{only|bedrock}} Expert-level Shepherd villagers have a {{frac|2|7}} chance to buy 12 brown dye for an emerald.{{only|java}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Brown Dye |spritetype=item |nameid=brown_dye |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showaliasids=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Brown Dye |spritetype=item |nameid=brown_dye |aliasid=dye / 17 |id=398 |form=item |translationkey=item.dye.brown_new.name |foot=1}} == History == {{expand section|Item textures and more from a development video on twitter by bartek.}} {{History|java}} {{History||1.14|snap=18w43a|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}} {{History|||snap=18w44a|Brown dye now can change the text color on [[sign]]s to brown.}} {{History|||snap=19w05a|Added the [[wandering trader]], which sell brown dyes.}} {{History|||snap=19w11a|Brown dye can now be [[trading|bought]] by shepherd villagers.}} {{History||1.17|snap=20w45a|Brown dye can now used to craft newly added [[brown candle]]s.}} {{History|||snap=21w19a|Brown dye can no longer used to craft brown candles.}} {{History|||snap=Pre-release 1|Brown dye can once again used to craft brown candles.}} {{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Brown dye now can change the text color on [[hanging sign]]s to brown.}} {{History|bedrock}} {{History||1.8.0|snap=beta 1.8.0.10|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}} {{History||1.11.0|snap=beta 1.11.0.4|Brown dye can now be [[trading|sold]] to shepherd [[villager]]s.}} {{History||1.16.100|snap=beta 1.16.100.56|The ID of brown dye has been changed from <code>dye/17</code> to <code>brown_dye</code>.}} {{History|ps4}} {{History||1.83|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}} {{History|foot}} == Issues == {{issue list}} {{Items}} [[Category:Dyes]] [[Category:Renewable resources]] [[de:Brauner Farbstoff]] [[es:Tinte marrón]] [[fr:Teinture marron]] [[ja:茶色の染料]] [[ko:갈색 염료]] [[pl:Brązowy barwnik]] [[pt:Corante marrom]] [[th:สีย้อมสีน้ำตาล]] [[zh:棕色染料]]</li><li>[[:Category:Minecraft Earth items|Category:Minecraft Earth items]]<br/>All items in ''[[Minecraft Earth]]''. [[Category:Items]] [[Category:Minecraft Earth|Items]]</li></ul>		pre1			Added functions.
		pre3			Commands are no longer allowed to begin with a / (forward slash)
					Comments can now only be preceded with #; using // is no longer allowed
		pre4			Added new arguments to the /function command: [if|unless] [selector]
		pre6			Skipped functions (when a conditional fails) are now considered failures when used in commands.
1.13 {{Extension DPL}}<ul><li>[[Brewing Stand|Brewing Stand]]<br/>{{Block | image = <gallery> Brewing Stand (empty) JE10.png | Empty Brewing Stand (right) JE10.png | Right Brewing Stand (left) JE10.png | Left Brewing Stand (full) JE10.png | Full </gallery> | transparent = Yes | light = Yes (1) | tool = Wooden Pickaxe | renewable = Yes | stackable = Yes (64) | flammable = No | lavasusceptible = No }} A '''brewing stand''' is a [[block]] used for [[brewing]] [[potion]]s using [[Glass Bottle|bottles]] and suitable ingredients. It also serves as a [[cleric]]'s [[job site block]]. == Obtaining == === Breaking === A brewing stand can be obtained using any [[pickaxe]]. If mined without a pickaxe, it drops nothing {{in|JE}}, while it drops itself {{in|BE}}. {{breaking row|horizontal=1|Brewing Stand|Pickaxe|Wood|foot=1}} === Natural generation === Brewing stands generate in [[end ship]]s. They have two [[potion of Healing|Instant Health II potions]] in their holders. A brewing stand also generates in the basement of [[igloo]]s with a [[splash potion of Weakness]] in it. Brewing stands can generate without potions in [[village]] churches. === Crafting === {{Crafting |head=1 |showdescription=1 |B1= Blaze Rod |A2= Any stone-tier block |B2= Any stone-tier block |C2= Any stone-tier block |Output= Brewing Stand |type= Brewing |description=Can use cobblestone and its other variants interchangeably. |foot=1 }} == Usage == [[File:Brewing Stand GUI.png|thumb|right|176px|Brewing stand GUI {{in|java}}]] By default, the interface of a brewing stand is labeled "Brewing Stand", but this name can be customized by naming it in an [[anvil]] before placing it. Brewing stands cannot be pushed by [[piston]]s {{in|java}}. === Brewing === {{main|Brewing}} The main purpose of brewing stands is to allow for the [[brewing]] of [[potion]]s. Its interface can be opened by pressing {{control|use}} on them. Brewing stands need [[blaze powder]] as fuel. Each piece brews 20 batches of potions, with each stage of brewing counting separately. Unlike [[furnace]]s, there is no time limit; fuel is consumed only when there are [[Glass Bottle|bottles]] and an ingredient to brew into it. Brewing stands interact with [[hopper]]s as follows: * They accept brewing ingredients from hoppers pointing down into the top. * Any valid potion recipe can be preloaded for "hands-free" brewing of a complex recipe, with the [[Nether Wart|nether wart]] falling through into the stand for the first step. * Bottles and fuel are accepted from hoppers pointing into the side. * Finished products can be pulled out by hoppers below, but each stage of brewing counts as a batch of "finished" potions. {{IN|education}}, elements can be combined in the brewing stand to make the [[medicine]] potions: antidote, elixir, eye drops, and tonic. === Changing profession === If a village has a brewing stand that has not been claimed by a villager, any villager who hasn't already picked a [[job site]] block in the village has a chance to change their profession into cleric. === Light source === Brewing stands emit a light level of 1. == Sounds == === Generic === {{Sound table/Block/Stone}} === Unique === {{edition|java}}: {{Sound table |rowspan=2 |sound=Brewing Stand brew1.ogg |sound2=Brewing Stand brew2.ogg |subtitle=Brewing Stand bubbles |source=block |description=When a potion finishes brewing |id=block.brewing_stand.brew |translationkey=subtitles.block.brewing_stand.brew |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Cleric works |source=neutral |description=Randomly while a cleric is working |id=entity.villager.work_cleric |translationkey=subtitles.entity.villager.work_cleric |volume=1.0 |pitch=0.8-1.2 |distance=16}} {{Sound table |sound=Door close.ogg |sound2=Door open.ogg |subtitle=Chest locked<ref group=sound name=lock>{{Bug|MC-98316||Wrong subtitles caused by missing distinction}}</ref> |source=block |description=When a player attempts to open a brewing stand locked using the {{nbt|string|Lock}} tag |id=block.chest.locked|idnote=<ref group=sound name=lock/> |translationkey=subtitles.block.chest.locked|translationkeynote=<ref group=sound name=lock/> |volume=1.0 |pitch=1.0 |distance=16 |foot=1}} {{Edition|Bedrock}}: {{Sound table |type=bedrock |rowspan=2 |sound=Brewing Stand brew1.ogg |sound2=Brewing Stand brew2.ogg |source=block |description=When a potion finishes brewing |id=random.potion.brewed |volume=1.0 |pitch=1.0}} {{Sound table |source=block |description=Randomly while a cleric is working |id=random.potion.brewed |volume=1.0 |pitch=1.0 |foot=1}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Brewing Stand |spritetype=block |nameid=brewing_stand |translationkey=block.minecraft.brewing_stand, item.minecraft.brewing_stand |foot=1}} {{ID table |displayname=Block entity |spritename=brewing-stand |spritetype=block |nameid=brewing_stand |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |firstcolumnname=Brewing Stand |shownumericids=y |showforms=y |generatetranslationkeys=y |displayname=Block |spritename=brewing-stand |spritetype=block |nameid=brewing_stand |id=117 |form=block |itemform=item.brewing_stand |translationkey=-}} {{ID table |displayname=Item |spritename=brewing-stand |spritetype=item |nameid=brewing_stand |id=431 |form=item |foot=1}} {{ID table |notnamespaced=y |displayname=Block entity |spritename=brewing-stand |spritetype=block |nameid=BrewingStand |foot=1}} === Block states === {{see also|Block states}} {{/BS}} === Block data === A brewing stand has a block entity associated with it that holds additional data about the block. {{el|java}}: {{see also|Block entity format}} {{/BE}} {{el|bedrock}}: : See [[Bedrock Edition level format/Block entity format]]. == Achievements == {{load achievements|Local Brewery}} == Advancements == {{Load advancements|Local Brewery}} == History == {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[Cauldron]]s are implemented to be used to brew [[potion]]s, but are not available in-game yet.}} {{History|||snap=September 30, 2011|slink={{tweet|jeb|119762786619359232}}|[[File:Brewing Stand (pre-release).png|32px]] [[Jens Bergensten|Jeb]] reveals that brewing is done through a brewing stand instead of a [[cauldron]].}} {{History|||snap=Beta 1.9 Prerelease 3|[[File:Brewing Stand (empty) JE1 BE1.png|32px]] [[File:Brewing Stand (right) JE1.png|32px]] [[File:Brewing Stand (left) JE1.png|32px]] [[File:Brewing Stand (full) JE1.png|32px]] [[File:Brewing Stand (item) JE1 BE1.png|32px]] Added brewing stands. |Brewing [[potion]]s with brewing stands currently take 30 seconds. |When the first brewing stand was shown by Jeb, it had an additional 2D sub-stand for [[Glass Bottle|bottles]], but the stands for bottles are now designed in 3D.<ref>{{tweet|jeb|119763532312096769|I'm fully aware the potions are very thin (diet?), but it looks cute. (Always work in progress, of course)|September 30, 2011}}</ref>}} {{History||1.1|snap=12w01a|Brewing time for brewing stands has been reduced to 20 seconds.}} {{History||1.3.1|snap=12w15a|{{key|Shift}} + clicking can now be used to put items in brewing stands.}} {{History||1.8|snap=14w11a|[[File:Brewing Stand (empty) JE2.png|32px]] [[File:Brewing Stand (right) JE2.png|32px]] [[File:Brewing Stand (left) JE2.png|32px]] [[File:Brewing Stand (full) JE2.png|32px]] The [[model]] of brewing stands has been changed. Stands with no bottles appear glitched from some angles, the left and right slots appear identical when filled in (although both distinct appearences still exist as metadata), and the arm angles have changed due to the 22.5º rotation limit. |Brewing stands' targeting [[hitbox]] is now a full cube - previously it was a cuboid around the base plates.}} {{History|||snap=14w11b|[[File:Brewing Stand (empty) JE3.png|32px]] [[File:Brewing Stand (right) JE3.png|32px]] [[File:Brewing Stand (left) JE3.png|32px]] [[File:Brewing Stand (full) JE3.png|32px]] Empty brewing stands' model have been fixed, although the other changes still remain.}} {{History|||snap=14w25a|[[File:Brewing Stand (empty) JE4.png|32px]] [[File:Brewing Stand (right) JE4.png|32px]] [[File:Brewing Stand (left) JE4.png|32px]] [[File:Brewing Stand (full) JE4.png|32px]] Brewing stand models have changed such that bottles in the left and right slots now indeed appear different. However, the leftmost one appears stretched. Arms are also now affected by directional shading.<ref>{{bug|MC-68302|||WAI}}</ref>}} {{History||1.9|snap=15w31a|Brewing stands now generate in [[End City|end cities]].}} {{History|||snap=15w33a|Brewing stands can now brew [[Lingering Potion|lingering potion]]s.}} {{History|||snap=15w33c|A bug where the [[player]] couldn't put in a [[splash potion]] to make a lingering potion has been fixed.}} {{History|||snap=15w42a|Brewing stands now require [[Blaze Powder|blaze powder]] to operate.}} {{History|||snap=15w43a|Brewing stands now generate in the basement of [[igloo]]s. |Each blaze powder now fuels 20 brewing stand operations rather than 30.}} {{History|||snap=15w44a|[[File:Brewing Stand (empty) JE5.png|32px]] [[File:Brewing Stand (right) JE5.png|32px]] [[File:Brewing Stand (left) JE5.png|32px]] [[File:Brewing Stand (full) JE5.png|32px]] Brewing stand models no longer have a stretched bottle.}} {{History|||snap=15w47b|[[Sound]]s have been added for brewing stands.}} {{History||1.11|snap=16w32a|The block entity ID has been changed from <code>Cauldron</code> to <code>brewing_stand</code>.}} {{History||1.13|snap=17w47a|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 117, and the [[item]]'s 379.}} {{History||1.14|snap=18w43a|[[File:Brewing Stand (empty) JE6 BE2.png|32px]] <!-- [[File:Brewing Stand (left) JE6 BE2.png|32px]] [[File:Brewing Stand (right) JE6 BE2.png|32px]] -->[[File:Brewing Stand (Full) JE6 BE2.png|32px]] [[File:Brewing Stand (item) JE2.png|32px]] The textures of brewing stands have been changed.}} {{History|||snap=18w44a|[[File:Brewing Stand (item) JE3 BE2.png|32px]] The texture of the brewing stand [[item]] has been changed.}} {{History|||snap=18w48a|Brewing stands now generate in the updated [[plains]] [[village]]s.}} {{History|||snap=18w49a|Brewing stands now generate in the updated [[savanna]] villages and the new [[Snowy Tundra|snowy]] villages.}} {{History|||snap=18w50a|Brewing stands now generate in the updated [[desert]] and [[taiga]] villages.}} {{History|||snap=19w03c|The three plates, but not the rod, of a brewing stand now use correct cullface arguments.}} {{History|||snap=19w11a|Brewing stands now serve as cleric [[villager]]s' job site block.}} {{History||1.16.2|snap=20w28a|Brewing stands can now be [[crafting|crafted]] with [[blackstone]].}} {{History||1.17|snap=21w07a|Brewing stands can now be crafted with [[deepslate|grimstone]] (now deepslate).}} {{History||1.17|snap=21w08a|Brewing stands can no longer be crafted with deepslate. |Brewing stands can now be crafted with [[Cobbled Deepslate|cobbled deepslate]].}} {{History|||snap=21w11a|<!--[[File:Brewing Stand (empty) JE7.png|32px]] [[File:Brewing Stand (right) JE7.png|32px]] [[File:Brewing Stand (left) JE7.png|32px]] [[File:Brewing Stand (Full) JE7.png|32px]] Changed [[lighting]].-->Tweaked the brewing stand GUI texture.}} {{History||1.18|snap=21w39a|[[File:Brewing Stand (empty) JE8.png|32px]] [[File:Brewing Stand (right) JE8.png|32px]] [[File:Brewing Stand (left) JE8.png|32px]] [[File:Brewing Stand (full) JE8.png|32px]] The default [[brightness]] has been changed from "Moody" to 50.}} {{History||1.19|snap=22w11a|[[File:Brewing Stand (empty) JE9.png|32px]] [[File:Brewing Stand (right) JE9.png|32px]] [[File:Brewing Stand (left) JE9.png|32px]] [[File:Brewing Stand (full) JE9.png|32px]] Changed texture and model.}} {{History|||snap=22w17a|[[File:Brewing Stand (empty) JE10.png|32px]] [[File:Brewing Stand (right) JE10.png|32px]] [[File:Brewing Stand (left) JE10.png|32px]] [[File:Brewing Stand (full) JE10.png|32px]] Changed base texture and model.}} {{History|pocket alpha}} {{History||v0.12.1|snap=build 1|[[File:Brewing Stand (empty) JE1 BE1.png|32px]] [[File:Brewing Stand (item) JE1 BE1.png|32px]] Added brewing stands.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|Brewing stands now generate in [[igloo]] basements. |Brewing stands now generate in [[end ship]]s.}} {{History|bedrock}} {{History||1.2.0|snap=beta 1.2.0.2|Brewing stands now require [[blaze powder]] to operate.}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Brewing Stand (empty) JE6 BE2.png|32px]] [[File:Brewing Stand (item) JE3 BE2.png|32px]] The textures of brewing stands have been changed.|A brewing stand can now generate in [[village]] temples.}} {{History||1.16.100|snap=beta 1.16.100.52|Brewing stands can now be [[craft]]ed with [[blackstone]].}} {{History||1.17.0|snap=beta 1.17.0.50|Brewing stands can now be [[craft]]ed with [[cobbled deepslate]].}} {{History||1.19.0|snap=beta 1.19.0.20|[[File:Brewing Stand (empty) JE10.png|32px]] [[File:Brewing Stand (right) JE10.png|32px]] [[File:Brewing Stand (left) JE10.png|32px]] [[File:Brewing Stand (full) JE10.png|32px]] Slightly changed its texture, to make their arms connect to their bases.}} {{History|console}} {{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Brewing Stand (empty) JE1 BE1.png|32px]] [[File:Brewing Stand (item) JE1 BE1.png|32px]] Added brewing stands.}} {{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Brewing stands now appear in [[igloo]]s. The lack of a fuel requirement means that potions can now be made without going to the Nether.}} {{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|Brewing stands now require [[blaze powder]] to operate.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Brewing Stand.png|32px]] [[File:Brewing Stand (item) JE3 BE2.png|32px]] The textures of brewing stands have been changed.}} {{History|new 3ds}} {{History||0.1.0|[[File:Brewing Stand (empty) JE1 BE1.png|32px]] [[File:Brewing Stand (item) JE1 BE1.png|32px]] Added brewing stands.}} {{History|foot}} <gallery> File:Brewingstand Potion.png|The first picture of a brewing stand. A [[giant mushroom]] is also seen in this picture. </gallery> === Brewing stand "item" === {{:Technical blocks/Brewing Stand}} == Issues == {{issue list}} == Trivia == * Even when the brewing stand is not in use, there is still smoke coming out of the top of it. * In ''[[Java Edition]]'', when a brewing stand is broken, particles from a bottle appear, even if no bottle is in the stand. * No matter what potion (including water bottles) is in the stand it always looks like a full red bottle. * Brewing stands always face east, no matter what direction they are placed. * According to [[Michael Stoyke|Searge]], for thematic reasons, a brewing stand was added to the basement of the [[igloo]]. Because of this, blaze powder was required for fuel to preserve game progression. In this way, the player is prevented from using it before going to the Nether.<ref>https://minecraft.net/en-us/article/meet-blaze</ref> == Gallery == <gallery> File:Brewing stand in action.png|A brewing stand in action. File:Igloobasement.png|A brewing stand in an igloo basement. File:1.8 and below brewing stand.png|The GUI of the brewing stand in 1.8.x and below. </gallery> == See also == *[[Glass Bottle]] *[[Splash Potion]] == References == {{reflist}} == External links == *[https://www.minecraft.net/en-us/article/taking-inventory--brewing-stand Taking Inventory: Brewing Stand] – Minecraft.net on October 11, 2019 {{Blocks|Utility}} {{items}} [[Category:Job blocks]] [[Category:Utility blocks]] [[Category:Manufactured blocks]] [[Category:Generated structure blocks]] [[Category:Storage]] [[Category:Block entities]] [[Category:Light sources]] [[de:Braustand]] [[es:Soporte para pociones]] [[fr:Alambic]] [[hu:Főzőállvány]] [[it:Alambicco]] [[ja:醸造台]] [[nl:Brouwstandaard]] [[pl:Statyw alchemiczny]] [[pt:Suporte de poções]] [[ru:Варочная стойка]] [[uk:Варильна стійка]] [[zh:酿造台]]</li><li>[[Minecart|Minecart]]<br/>{{about|the rideable minecart in Minecraft|other uses|Minecart (disambiguation)|}} {{distinguish|Minecraft}} {{ItemEntity |image=Minecart.png |renewable=Yes |stackable=No |size=Height: 0.7 Blocks<br>Width: 0.98 Blocks |networkid='''[[JE]]''': 10 |drops={{ItemLink|Minecart}} (1) |health={{hp|6}} }} A '''minecart''' is a train-like vehicle [[entity]] that runs on [[Rail (disambiguation)|rail]]s. == Obtaining == Minecarts can be retrieved by {{control|attack|text=attacking}} them for some time. Minecarts can also be retrieved with one attack from a [[pickaxe]] provided the player's attack cooldown is reset. A minecart is also destroyed if it makes contact with a [[cactus]], or if shot with a [[bow]] and arrow. === Crafting === {{Crafting |A2= Iron Ingot |C2= Iron Ingot |A3= Iron Ingot |B3= Iron Ingot |C3= Iron Ingot |Output= Minecart |type= Transportation }} === Entity loot === [[Minecart with command block]]s can be given to the player with the {{cmd|/give}} command or through the creative inventory under certain conditions{{only|java}}; [[minecart with spawner]]s{{only|java}} are available only via the {{cmd|/summon}} command. Each drop 1 minecart when broken. == Usage == [[File:RideableMinecart.png|thumb|right|A rideable minecart on rails surrounded by wood slabs]] A minecart can be placed in the same manner as most blocks but can be placed only on top of a [[rail]]. Once placed, it may be derailed by pushing it off the end of the track. After this, it can be railed again by placing a rail directly below it or pushing it onto a track. === Crafting ingredient === {{crafting usage}} === Transportation === [[File:Steve Riding a Minecart.png|thumb|right|upright|[[Steve]] riding a minecart]] {{see also|Transportation|Riding}} Minecarts can be ridden by {{control|use|text=pressing the "use" control}} on them. Once inside, an external impulse may be needed to make the minecart start moving. The player can slowly move the minecart forward while riding it, by pressing {{control|forward}}. If a mob walks in front of an empty minecart, it is pulled into the cart. After rolling off of the end of a track, a minecart can be pushed around on open blocks. If a minecart is pushed onto or falls onto tracks, it "snaps" to those tracks. When riding a minecart, if the minecart lands on a rail, the player does not take any fall damage. <!--Minecarts and arrows don't interact anymore.--> Unlike with [[bed]]s, there is no message above the hotbar for attempting to enter a fully occupied minecart.<ref>{{Cite bug|MC|161251|Attempting to enter an occupied bed displays a message over the hotbar, but attempting to enter an occupied vehicle does not|date=September 18, 19|resolution=Works as Intended}}</ref> === Dismounting === Players can exit the minecart by pressing {{control|sneak}}. When a player or mob dismounts a minecart, either by choice, by breaking the minecart, or by passing over an [[activator rail]], the minecart tries to find a safe ejection destination one block away. First it checks the eight horizontally adjacent blocks in the following order of priority relative to direction of travel: right, left, rear right, rear left, front right, front left, rear, front. A valid destination has a block underneath with a solid (not necessarily full) top surface and a space with enough headroom and width for the passenger to fit in when standing at the center. The space can even contain liquid or have open trapdoors if the mob is slim enough, and presence of other mobs doesn't matter. If no valid destination exists on same horizontal level, the minecart then checks the blocks one above, then one below. For a player, the minecart also checks for crawlable destinations. If still none, the minecart chooses its own location. Once the minecart picks a destination, it actually ejects the passenger one block up in the air and the passenger settles down on its own. Under a low ceiling this may cause one tick of suffocation damage. The air drop exists to allow passengers to land on carpet or bottom slabs. == Behavior == === Speed === Minecarts have a predefined speed limit of exactly 8 blocks per second ''per axis of travel''. A minecart traveling diagonally can, therefore, travel up to 11.314 blocks per second.<ref>The square root of 8<sup>2</sup> + 8<sup>2</sup>. See [[wikipedia:Pythagorean theorem|Pythagorean theorem]].</ref> When a minecart comes to a turn it moves diagonally across that turn. [[Powered rail]]s powered by redstone give minecarts a boost of speed. Speed is gradually decreased if there are no powered rails to assist its movement, and an unpowered powered rail slows down a minecart rapidly. The speed decreases at a faster rate when going uphill, compared to when moving horizontally. A minecart does not need powered rails to assist its movement down a hill. <!-- Is this comparison to real-life physics necessary? - One unit of kinetic energy could be defined as the energy gained by a cart going down a one-block slope and lost by a cart when it goes up a one-block slope. If a 45-degree downward slope is connected directly into an upward slope, an initial height of 60 blocks results in a final height of 40 blocks, a loss of 20 units of potential energy. But if 20 sections of flat track are inserted between the slopes, the final height is 35. This implies that one unit of energy is lost for every 4 sections of horizontal track traveled with an initial stored energy of between 60 and 40. At much lower speeds, much less energy is lost, implying that the energy lost is a percentage of the cart's current energy. The above gives about 0.5% energy loss per section of track. One implication of this is that more energy lost when the cart has more energy, so a gradual slope should allow you to travel much farther distances than a steep slope followed by a long flat section. (This is different from real-life physics, where friction does not increase with velocity. However, it may be an attempt to mirror air resistance, which ''does'' increase with velocity.) --> Anything in the way of the minecart brings it to a stop. Once a minecart has left the track, it rapidly decelerates within one or two blocks. When mobs touch a minecart, they affect it in the same way a player would, i.e. mobs that move up against a still cart set it in motion. If a minecart is moving fast enough, it can skip across one block without a track and reattach to track on the other side, at significantly reduced energy and speed. A minecart's hitbox can skip turns if the minecart is boosted using enough powered rails.<ref>{{Cite bug|MC|179971|Minecart skips turns if too fast|date=April 22, 2020}}</ref> The speed and momentum of a minecart can differ depending on whether or not it is empty, and in the case where a minecart has a container, the speed can differ depending on the quantity and type of items inside. === Merged minecarts === {{IN|java}}, two or more minecarts can be merged by pushing them into each other so that they overlap. Merged minecarts move as a collective, like a train, and can be useful for long-distance transport because while moving in a straight line, they ''do not need powered rails to keep their speed''. To summarize: * Minecarts can also be merged by ''dropping'' a minecart on another minecart. * Merged minecarts do not lose speed while traveling on straight rails * ''Corners'' in the rails might cause merged minecarts to unmerge. * Minecarts with ''chest'' (even fully filled) can also be merged and also do ''not'' require powered rails. === Distance traveled by empty carts starting on a downward slope === This table shows the distance traveled by an unoccupied minecart on a downward slope, with a boost (or no boost). The most efficient way is to use only 1 boost at the bottom of the incline on the flat surface. Using 2 increases distance by about 20% or 1.5 blocks. All distance trends based on the height seem to be logarithmic. The carts started from rest, on a slope Height blocks up. {| class="wikitable" data-description="Distance traveled" |- ! Height !! No Boost !! Bottom !! Bottom and Top !! All boosts on incline and bottom |- | 1 || 2.77m || 8.77 || 10.8 || 10.8 |- | 2 || 4.59m || 9.59 || 10.83 || 13.37 |- | 3 || 5.81m || 9.81 || 11.66 || 15.12 |- | 4 || 7.04m || 10.04 || 12.46 || 16.95 |- | 5 || 7.87m || 10.87 || 12.29<!--(Yes, it did actually travel less)--> || 17.95 |- | 10 || 11.65m || 13.38 || 15.12 || 21.68 |- | 100 || 15.87m || 17.05 || 17.54 || 25.34 |} === Collision === Minecarts are about the same size as a block (1×1). Because of this, a ladder, door, or trapdoor prevents it from falling down a 1×1 hole. Carts on [[rail]]s also ignore collision in certain situations. A cart traveling uphill, downhill, or on a curve with a block placed in front of it, goes through the block.<ref>{{Cite bug|MC|8004|Minecarts glitch through the stop block of a track that ends with a turn or a downward slope|date=January 20, 2013}}</ref> A minecart that reaches the end of a rail up against an opaque solid block bounces back, but if the block is transparent then it stops. The minecart can even bounce against an opaque block from a standstill if the rail underneath is powered. A player or mob riding in a minecart does not collide with or suffocate in any transparent blocks but suffocates inside opaque blocks. Minecarts are completely unaffected by [[ice]], [[packed ice]], and [[blue ice]]<ref>{{Cite bug|MC|8265|Minecarts don't slide on any sort of ice|date=January 25, 2013}}</ref>; they can also be destroyed by coming in contact with [[lava]] or [[fire]]. === Mobs === {{missing information|section|some other mobs that cannot be picked up by minecarts}} [[File:Minecart shake.gif|thumb|right|Minecart shaking due to being on top of an activator rail.]] Mobs can ride minecarts, but cannot control them. Mobs cannot exit the minecart unless the minecart is destroyed or moves onto an active [[activator rail]].<ref>{{bug|MC-3866||Endermen, Tamed Wolves and Ocelots cannot teleport when in a Minecart|WAI}}</ref> However, {{in|bedrock}}, [[endermen]] are able to teleport out of minecarts.<ref>{{bug|MCPE-31761||Endermen can still teleport out of the boats and minecarts}}</ref> A mob can ride a minecart when pushing by a moving minecart on rails {{in|java}} or when colliding with a minecart {{in|bedrock}}. It is easier to pick up a mob when a minecart is turning. {{IN|bedrock}}, [[armor stand]]s can also be picked up. Most mobs can be picked up by minecarts, except [[ender dragon]]s, [[warden]]s, and [[wither]]s. {{IN|java}}, [[iron golem]]s cannot be picked up either. A [[jockey]] riding a minecart automatically accelerates the minecart.<ref>{{bug|MC-71998||Minecarts that have passengers within them riding mobs can move automatically when not on rails}}</ref> Mobs in minecarts don't despawn, and don't count towards the mob cap.{{only|java}}<ref>{{bug|MC-182897||Some passenger mobs don't count to the mob cap|WAI}}</ref> === Boats === {{exclusive|java|section=yes}} {{UsesBug|section=yes}} Due to the bug {{bug|MC-113871}}, [[boat]]s can be captured by minecarts. When a boat is placed in a minecart, the minecart travels faster on rails, approximately as fast as on powered rails. The movement in the boat minecart is glitchy and moving forward with the W key moves the cart backward relative to the player, and vice versa for moving backward with the S key. The minecart also moves on the rail-less ground at a crawling speed, but it does not float in the water despite being in a boat. Using this glitch can be far more resource-efficient since the boat minecart can move at the speed of a powered rail track on flat ground and on slopes. Another physics glitch with the boat minecart is the extreme reduction in friction when the minecart is on rails, which is similar to the lack of friction when a boat is riding on ice. This glitch can be done in Survival without cheats simply by pushing a minecart into a boat on the track. This bug is now patched. == Sounds == {{Edition|Java}}:<br> Minecarts use the Friendly Creatures sound category for entity-dependent sound events.<ref group="sound" name="oddcats" /> {{Sound table |sound=Minecart inside.ogg |subtitle=MC-177078 |source=Friendly Creatures <ref group="sound" name="oddcats">{{Cite bug|MC|42132|The sounds of minecarts aren't controlled by the correct sound slider|date=December 13, 2013}}</ref> |overridesource=1 |description=While the player is inside of a moving minecart |id=entity.minecart.inside |translationkey=- |volume=0.0-0.75 <ref group=sound name=insidevolume>Based on horizontal speed; it is clamped between 0.0 and 0.75 and will not play if speed is less than 0.01</ref> |pitch=1.0 |distance=16 (technical) / rider only (effective)}} {{Sound table |sound=Minecart inside underwater1.ogg |sound2=Minecart inside underwater2.ogg |sound3=Minecart inside underwater3.ogg |subtitle=MC-204124 |source=Friendly Creatures <ref group="sound" name="oddcats"/> |overridesource=1 |description=While inside of a moving minecart when the player's eye level is underwater |id=entity.minecart.inside.underwater |translationkey=- |volume=0.0-0.75 <ref group=sound name=insidevolume/> |pitch=1.0 |distance=16 (technical) / rider only (effective)}} {{Sound table |sound=Minecart rolling.ogg |subtitle=Minecart rolls <ref group="sound">Shows far less often than it should - see {{bug|MC-181831}}</ref> |source=Friendly Creatures <ref group="sound" name="oddcats"/> |overridesource=1 |description=While a minecart is moving |id=entity.minecart.riding |translationkey=subtitles.entity.minecart.riding |volume=0.0-0.35 <ref group=sound>Relates linearly with horizontal velocity (max 0.5)</ref> |pitch=0.0-1.0 <ref group=sound>Will increase by 0.0025 per tick if the minecart's horizontal velocity is more than 0.01</ref> |distance=16 |foot=1}} {{Edition|Bedrock}}: {{Sound table |type=bedrock |sound=Minecart inside.ogg |source=neutral |description=While the player is inside of a moving minecart |id=minecart.inside}} {{Sound table |sound=Minecart rolling.ogg |source=neutral |description=While a minecart is moving |id=minecart.base |foot=1}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |firstcolumnname=Item |showforms=y |generatetranslationkeys=y |displayname=Minecart |spritetype=item |nameid=minecart |form=item |foot=1}} {{ID table |edition=java |generatetranslationkeys=y |firstcolumnname=Entity |displayname=Minecart |spritetype=entity |nameid=minecart |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |firstcolumnname=Item |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Minecart |spritetype=item |nameid=minecart |id=370 |form=item |foot=1}} {{ID table |edition=bedrock |firstcolumnname=Entity |shownumericids=y |generatetranslationkeys=y |displayname=Minecart |spritetype=entity |nameid=minecart |id=84 |foot=1}} === Entity data === Minecarts have entity data associated with them that contain various properties of the entity. {{el|java}}: {{main|Entity format}} {{/ED}} {{el|bedrock}}: : See [[Bedrock Edition level format/Entity format]] == Achievements == {{load achievements|On A Rail}} == History == {{History|java infdev}} {{History||20100618|[[File:Minecart JE1.png|32px]] [[File:Minecart (item) JE1.png|32px]] Added minecarts. |Minecarts are not rideable but instead are used to store things in. |Right-clicking minecarts opens them like a [[chest]] (with the container called "Minecart". Filling them up makes the [[dirt]] layer inside them rise.}} {{History||20100624|[[File:Minecart JE2.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] The entity model and item texture of minecarts have been changed. |The minecart mechanics have been changed to being rideable, removing their ability to store items. | Minecarts now render a chest inside for unknown reasons.}} {{History|java alpha}} {{History||v1.0.4|[[File:Minecart JE3 BE1.png|32px]] Removed the phantom chest from minecarts. |A [[sitting]] animation for riding minecarts has been added.}} {{History||v1.0.14|Minecarts are now used to craft [[minecart with furnace]] and [[minecart with chest]].}} {{History||v1.2.2|Minecarts now appear to other players and can be ridden in multiplayer. |Minecarts are no longer fully solid - they no longer block movement, and can no longer be stood on top of.}} {{History|java beta}} {{History||1.5|Minecarts now break faster with hands. |[[Powered rail]]s have been introduced, which enables minecarts to move automatically, although previous methods of boosting no longer works, or does not work as effectively. |The [[detector rail]]s have been introduced for use in detecting minecarts. Prior to this update, carts were detected by using [[pressure plate]]s in line with cart tracks. This had the often undesirable effect of dramatically slowing or even stopping the minecart, which limited the use of this design mostly to boosters.}} {{History||1.6|snap=Test Build 3|A minecart now transfers any [[Damage#Fall damage|fall damage]] it suffers onto its rider and is not destroyed upon impact.}} {{History||1.8|snap=Pre-release|If the [[player]] punches a minecart when descending from a jump, it shows the [[Damage#Critical hit|critical hit]] animation. This also happens if the player punches the cart while still in it.}} {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease|[[Daniel Rosenfeld|C418]] posted a [[sound]] showing the sound that minecarts make.}} {{History|||snap=Beta 1.9 Prerelease 6|The texture of minecarts has changed slightly.}} {{History||1.3.1|snap=12w15a|Minecarts can now be shot out from [[dispenser]]s.}} {{History|||snap=12w21b|The [[player]] no longer spawns on top/inside of the minecart after getting out. Instead, the player gets out a few [[block]]s away. Also, the player can nudge a stationary minecart while inside it to move onto a [[Powered Rail|powered rail]], etc.}} {{History||1.4.2|snap=12w38b|[[Sound]]s for minecarts have been added.}} {{History||1.5|snap=13w02a|Minecarts can now be edited with a third-party program to show any [[block]] inside of it (it does not take on the characteristics of this block), as well as make it take on the characteristics of any cart. |Minecart types no longer all share the same [[entity]] ID – <code>Minecart</code> – and are no longer distinguished by a <code>Type</code> field. They have been given separate entity IDs. |Minecarts are now used to craft [[TNT minecart]]s.}} {{History|||snap=13w03a|Minecarts are now used to craft [[hopper minecart]]s.}} {{History|||snap=13w06a|Added [[minecart with spawner]].}} {{History||1.6.2|snap=release|A [[player]] in a moving minecart no longer turns with the minecart.}} {{History||1.7.2|snap=13w39a|Added [[minecart with command block]].}} {{History||1.8|snap=14w11a|Minecart physics have been changed - they now go faster and further, can derail at corners if going too fast and refuse to go uphill and they can also (if going fast enough) go over 1 [[block]]. |The collision and position handling of minecarts have been improved.}} {{History|||snap=14w17a|All changes to old minecart physics used before 14w11a have been reverted.}} {{History||1.9.1|snap=pre2|Extreme typos in minecarts with hoppers and chests, reading "''container.minecart'''' have been fixed.}} {{History||1.11|snap=16w32a|The [[entity]] ID has been changed from <code>MinecartRideable</code> to <code>minecart</code>. |The player's [[hunger]] bar is now visible when riding in a minecart.}} {{History||1.13|snap=17w47a|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 328.}} {{History||1.14|snap=18w43a|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The textures of minecarts have been changed.}} {{History|||snap=19w13a|Minecarts now move much slower when pushed along standard [[rail]]s using the W key, even slower on unpowered golden rails, and cannot be pushed off of unpowered golden rails without the [[player]] looking at a certain angle.}} {{History||1.16|snap=20w09a|Minecart now checks dismount position height against entity height.}} {{History|||snap=20w16a<!--cannot confirm due to how assets are handled - assuming this due to MC-91163 fix version-->|Minecarts no longer have subtitles for movement.}} {{History|||snap=20w18a|Mobs in minecarts no longer [[Spawn#Despawning|despawn]].}} {{History||1.17|snap=20w45a|Minecarts can now move in [[water]].}} {{History||1.19|snap=22w13a|Minecarts no longer drop when breaking a [[Minecart with Chest|minecart with chest]], [[Minecart with Hopper|hopper]], [[Minecart with Furnace|furnace]], or [[Minecart with TNT|TNT]].<ref>{{bug|MC-249493|||Fixed}}</ref>}} {{History||1.20|snap=23w16a|Sniffers can now enter [[minecart]]s.}} {{History|pocket alpha}} {{History||v0.8.0|snap=build 2|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] Added minecarts.}} {{History|||snap=build 3|Minecarts now ride smoother.}} {{History||v0.13.0|snap=build 1|[[Sound]]s for minecarts have been added.}} {{History|||snap=build 2|Minecarts now stack on top of each other.}} {{History||v0.14.0|snap=build 1|Minecarts can now be used to craft [[Minecart with Chest|storage]], [[Minecart with TNT|TNT]], and [[Minecart with Hopper|hopper minecart]]s.}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The textures of minecarts have been changed.}} {{History|console}} {{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart (item) JE2 BE1.png|32px]] Added minecarts.}} {{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|Minecarts are now twice the speed than in other editions.}} {{History||xbox=TU12|Minecarts are now slower.}} {{History||xbox=TU13|ps=1.0|Minecarts are now faster again.}} {{History||xbox=TU21|xbone=CU9|ps=1.14|The minecart limit has been increased.}} {{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Minecart [[sound]]s have been updated.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Minecart JE4 BE2.png|32px]] [[File:Minecart (item) JE3 BE2.png|32px]] The texture of minecarts has been changed.}} {{History|new 3DS}} {{History||0.1.0|[[File:Minecart JE3 BE1.png|32px]] [[File:Minecart_(item)_JE2_BE1.png|32px]] Added minecarts.}} {{History|foot}} == Issues == {{issue list}} == Trivia == * Minecarts appear to float above the track, as their model has no wheels. * If the player views their inventory while riding in a minecart, they appear sitting down in mid-air. * The player can teleport to another minecart while sitting in a minecart by right-clicking a minecart in their range. This can be used as an elevator to quickly rise up when minecarts are placed on top of each other. * If the sound is muted in the options while riding a minecart, and then turned back up, the minecart no longer makes noise in the client until the player exits the minecart. * If a saddled pig is riding a minecart, the player can ride the pig. Doing so causes the minecart to be able to ride freely at the player's walking speed. It is unknown whether this is a glitch. * It seems that hunger does not deplete while inactive in a minecart (at least in normal difficulty). * A minecart (alongside rails and powered rails) are used as Steve's Side-Special in the crossover fighting game Super Smash Bros. Ultimate. == Gallery == <gallery> Minecart fire pig.png|A pig inside a burning minecart MinecartInfdev1.png|A Minecart opened in Minecraft Infdev MinecartInfdev2.png|A Minecart filled in Minecraft Infdev 2ed Spawner Minecart Image and 1st Dispenser cart image.jpg|An image of two [[Minecart with Spawner]]s and unimplemented Minecart with Dispensers. Minecart with chest and head thing.png|The first image [[Jens Bergensten|Jeb]] released.<ref>{{Tweet|jeb|289000646210904064}}</ref> Pocket Edition v0.8.0 alpha Development minecarts.png|The first image of minecarts in {{edition|PE}}. Minecart Booster.png|Minecart booster. MinecartStack.png|Minecarts being stacked on each other. Villager minecart.png|Villager in a minecart. Minecartride.jpg|Player in minecart. Blocks in Invisible Minecarts.png|Minecarts can be edited to show any block inside, and can also be edited to be invisible. File:Minecart (Trails and Tales Summer Event) Render.png|A wooden minecart, featured in the [[Trails & Tales Event]]. File:Minecoins 5.png|Two minecarts, as depicted on [[Minecraft Marketplace|Minecoin]] gift cards. </gallery> == References == {{reflist}} == External Links == *[https://www.minecraft.net/en-us/article/taking-inventory--minecart Taking Inventory: Minecart] – Minecraft.net on September 6, 2019 {{Items}} {{entities}} [[Category:Mechanics]] [[cs:Vozík]] [[de:Lore]] [[es:Vagoneta]] [[fr:Wagonnet]] [[hu:Csille]] [[it:Carrello da miniera]] [[ja:トロッコ]] [[ko:광산 수레]] [[nl:Mijnkar]] [[pl:Wagonik]] [[pt:Carrinho de mina]] [[ru:Вагонетка]] [[th:รถราง]] [[uk:Вагонетка]] [[zh:矿车]]</li></ul>		17w43a			Custom functions have been moved into data packs.
		17w45a			Functions are now completely parsed and cached on load.
		17w49b			Removed /gamerule gameLoopFunction.
					Function can now be tagged.
					Functions tagged in tick now run every tick in the beginning of the tick.
		18w01a			Functions tagged in load now run after (re)loading the datapack.
1.14.4 {{Extension DPL}}<ul><li>[[Fish|Fish]]<br/>{{About|the type of mob|the action|Fishing}} '''Fish''' are aquatic creatures that are found in [[river]] and [[ocean]] biomes. == Mobs == There are four categories of fish mobs in ''Minecraft'': *{{EntityLink|Cod}} *{{EntityLink|Salmon}} *{{EntityLink|Pufferfish}} *{{EntityLink|Tropical Fish}} - many color and pattern varieties In addition, there are other fish-like mobs that have different characteristics from fish: {{EntityLink|Axolotl}}, {{EntityLink|Guardian}}, and {{EntityLink|Elder Guardian}}. ==Obtaining and transporting== A live fish can be captured by using a [[water bucket]] on a fish, to obtain a [[bucket of fish]], which is the only way to obtain the live mob in item form. Using the bucket of fish on a water source block transfers the fish from the bucket to the body of water. A water bucket may also be used on [[axolotl]]s in this manner. ==Items== Fish exist in several different item forms. Upon death, fish drop their item form equivalent (cooked if on fire), with a chance to drop a [[bone]]{{only|bedrock}} or [[bone meal]].{{only|java}} ;Non-living *{{ItemLink|Raw Cod}} *{{ItemLink|Cooked Cod}} *{{ItemLink|Raw Salmon}} *{{ItemLink|Cooked Salmon}} *{{ItemLink|Pufferfish|link=Pufferfish (item)}} *{{ItemLink|Tropical Fish|link=Tropical Fish (item)}} ;Living *{{ItemLink|Bucket of Cod}} *{{ItemLink|Bucket of Salmon}} *{{ItemLink|Bucket of Pufferfish}} *{{ItemLink|Bucket of Tropical Fish}} == Spawning == Various fish can be found in different [[ocean]] [[biomes]], but only [[salmon]] appear in rivers. Fish can also spawn in player-created bodies of water, as long as they are within a river or ocean biome. {| class="wikitable sortable" style="text-align:left" data-description="Fish biomes" !'''Fish''' ! style="text-align:left" |{{BiomeLink|Warm Ocean}} ! style="text-align:left" |{{BiomeLink|Lukewarm Ocean}}<br>{{BiomeLink|Deep Lukewarm Ocean}} ! style="text-align:left" |{{BiomeLink|Ocean}}<br>{{BiomeLink|Deep Ocean}} ! style="text-align:left" |{{BiomeLink|Cold Ocean}}<br>{{BiomeLink|Deep Cold Ocean}} ! style="text-align:left" |{{BiomeLink|Frozen Ocean}}<br>{{BiomeLink|Deep Frozen Ocean}} ! style="text-align:left" |{{BiomeLink|River}}<br>{{BiomeLink|Frozen River}} |- ! rowspan=2 style="text-align:left" |{{EntityLink|Cod}} | rowspan=2 {{tc|no}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} | {{tc|no|No{{only|je|short=1}}}} | rowspan=2 {{tc|no}} |- | {{tc|yes|Yes{{only|be|short=1}}}} |- ! rowspan=2 style="text-align:left" |{{EntityLink|Salmon}} | rowspan=2 {{tc|no}} | {{tc|no|No{{only|je|short=1}}}} | {{tc|no|No{{only|je|short=1}}}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} |- | {{tc|yes|Yes{{only|be|short=1}}}} | {{tc|yes|Yes{{only|be|short=1}}}} |- ! rowspan=2 style="text-align:left" |{{EntityLink|Pufferfish}} | rowspan=2 {{tc|yes}} | {{tc|yes|Yes{{only|je|short=1}}}} | rowspan=2 {{tc|no}} | rowspan=2 {{tc|no}} | rowspan=2 {{tc|no}} | rowspan=2 {{tc|no}} |- | {{tc|no|No{{only|be|short=1}}}} |- ! style="text-align:left" |{{EntityLink|Tropical Fish}}<ref group="note">Also spawns in {{BiomeLink|Lush Caves}} at any Y-level.</ref> | {{tc|yes}} | {{tc|yes}} | {{tc|no}} | {{tc|no}} | {{tc|no}} | {{tc|no}} |- ! style="text-align:left" |{{EntityLink|Squid}} | {{tc|yes}} | {{tc|yes}} | {{tc|yes}} | {{tc|yes}} | {{tc|yes}} | {{tc|yes}} |- ! rowspan=2 style="text-align:left" |{{EntityLink|Dolphin}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} | rowspan=2 {{tc|yes}} | {{tc|no|No{{only|je|short=1}}}} | rowspan=2 {{tc|no}} | rowspan=2 {{tc|no}} |- | {{tc|yes|Yes{{only|be|short=1}}}} |} {{notelist}} In ''Java Edition'', fish can spawn inside a water block at Y-level 50 to 63 (from 13 blocks below sea level up to inside the block one above it), that also has water above and below it. The spawn block and the block below can be any kind of water, such as a source block, falling water, bubble column, kelp, or even a waterlogged block (as long as the fish can be placed at the bottom center of the spawn block without colliding with anything solid). The block above must be pure water, such as a source block, falling water, or flowing water of any depth. Particularly, the block above cannot also be a bubble column, so fish no longer spawn inside bubble elevators.<ref>{{cite bug|MC|244683|Tropical fish spawn in bubble columns (fixed in 22w07a)}}</ref> ''Bedrock Edition'' does permit fish to spawn in bubble columns.<ref>{{cite bug|MCPE|73967|Squids, Dolphins, and fish not spawning in bubble columns (fixed in 1.16.20)}}</ref> Fish can spawn between 24 and 64 block spherical range away from the player.{{only|java}} === Despawning === As of [[1.16]], fish can despawn at range of 40 blocks or more from the player, and will instantly despawn more than 64 blocks away, except when spawned using a [[bucket of fish]]. {{Items}} {{Entities}} [[cs:Ryba]] [[de:Fisch (Begriffsklärung)]] [[es:Pez]] [[fr:Poisson]] [[it:Pesce]] [[ja:魚]] [[ko:물고기]] [[nl:Vis]] [[pl:Ryba (ujednoznacznienie)]] [[pt:Peixe]] [[ru:Рыба]] [[th:ปลา (แก้ความกำกวม)]] [[uk:Риба]] [[zh:鱼]]</li><li>[[Green Dye|Green Dye]]<br/>{{redirect|Cactus Green|the plant|Cactus}}{{Item | title = Green Dye | renewable = Yes | stackable = Yes (64) }} '''Green dye''' is a [[primary color dye]]. == Obtaining == === Chest loot === {{LootChestItem|green-dye}} === Smelting === {{Smelting |head=1 |showdescription=1 |Cactus |Green Dye |1 |description={{only|Java}}<ref>{{bug|MC-210211||Smelting cactus gives too much experience since 1.13}}</ref> }} {{Smelting |head=0 |showdescription=1 |Cactus |Green Dye |0,2 |description={{only|Bedrock}} |foot=1 }} === Trading === [[Wandering trader]]s sell 3 green dye for an [[emerald]]. == Usage == {{dye usage}} === Crafting ingredient === {{crafting usage|ignore=Banner|continue=1}} {{banner crafting usage}} === Loom ingredient === {{Banner loom usage|Green Dye}} === Trading === Expert level shepherd villagers have {{frac|1|6}} chance to buy 12 green dye for an emerald.{{only|bedrock}} Expert level shepherds have a {{frac|2|7}} chance to buy 12 green dye for 1 emerald.{{only|java}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Green Dye |spritetype=item |nameid=green_dye |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showaliasids=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Green Dye |spritetype=item |nameid=green_dye |aliasid=dye / 2 |id=397 |form=item |translationkey=item.dye.green.name |foot=1}} == Video == <div style="text-align:center">{{yt|O4KVTPI4qIc}}</div> == History == {{History|java beta}} {{History||1.2|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green, together with all other dyes.}} {{History|java}} {{History||1.3.1|snap=1.3|[[File:Green Dye JE2 BE2.png|32px]] The texture of cactus green has been changed.}} {{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}} {{History||1.4.6|snap=12w49a|Cactus green can be crafted with [[gunpowder]] to create a [[firework star]].}} {{History||1.6.1|snap=13w19a|[[Stained clay]] can now be [[crafting|crafted]].}} {{History||1.7.2|snap=13w41a|[[Stained glass]] can now be crafted.}} {{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}} {{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}} {{History||1.12|snap=17w06a|Cactus green can now be used to craft green [[concrete powder]].}} {{History||1.12|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 now been split up into their own IDs. |Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}} {{History||1.14|snap=18w43a|"Cactus Green" has been renamed to "Green Dye". |[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}} {{History|||snap=18w44a|Green dye can now change the text color on [[sign]]s to green.}} {{History|||snap=18w50a|Green dye can now be found in [[chest]]s in [[desert]] [[village]] houses.}} {{History|||snap=19w05a|Added the [[wandering trader]], which sells green dye.}} {{History|||snap=19w11a|Green dye can now be [[trading|bought]] by shepherd villagers.}} {{History||1.17|snap=20w45a|Green dye can now be used to craft [[green candle]]s.}} {{History|||snap=21w19a|Green dye can no longer be used to craft green candles.}} {{History|||snap=Pre-release 1|Green dye can once again be used to craft green candles.}} {{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Green dye can now change the text color on [[hanging sign]]s to green.}} {{History|pocket alpha}} {{History||v0.3.0|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green. It is currently unobtainable and has no usage.}} {{History||v0.3.2|Cactus green is now obtainable by [[smelting]] cacti in a [[furnace]]. It still has no usage.}} {{History||v0.4.0|Cactus green can now be used to craft [[cyan dye]], [[lime dye]], and [[green wool]].}} {{History||v0.8.0|snap=build 1|[[File:Green Dye JE2 BE2.png|32px]] The texture of cactus green has been changed.}} {{History||v0.14.0|snap=build 1|Cactus green can now be used to dye [[water]] in [[cauldron]]s.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|Cactus green can now be used to dye [[shulker]]s.}} {{History||1.1.0|snap=alpha 1.1.0.0|Cactus green can now be used to dye [[bed]]s, [[shulker box]]es, and craft [[concrete powder]].}} {{History|bedrock}} {{History||1.2.0|snap=beta 1.2.0.2|Cactus green can now be used to craft [[stained glass]], patterns on [[banner]]s, and [[firework star]]s.}} {{History||1.4.0|snap=beta 1.2.20.1|Cactus green can now be used to craft [[balloon]]s and [[glow stick]]s.}} {{History||1.8.0|snap=beta 1.8.0.10|"Cactus Green" has been renamed to "Green Dye".}} {{History||1.10.0|snap=beta 1.10.0.3|Green dye is now sold by [[wandering trader]]s. |[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Green dye can now be found in [[desert]] [[village]] house [[chest]]s.}} {{History|||snap=beta 1.11.0.4|Green dye can now be [[trading|sold]] to shepherd [[villager]]s.}} {{History||1.16.100|snap=beta 1.16.100.56|The ID of green dye has been changed from <code>dye/2</code> to <code>green_dye</code>.}} {{History|console}} {{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green.}} {{History|PS4}} {{History||1.83|"Cactus Green" has been renamed to "Green Dye".}} {{History||1.90|[[File:Green Dye JE3 BE3.png|32px]] The texture of green dye has been changed.}} {{History|new 3ds}} {{History||0.1.0|[[File:Green Dye JE1 BE1.png|32px]] Added cactus green.}} {{History|foot}} == Issues == {{issue list}} {{Items}} [[cs:Kaktusová zeleň]] [[de:Grüner Farbstoff]] [[es:Tinte verde]] [[fr:Teinture verte]] [[hu:Kaktuszzöld]] [[ja:緑色の染料]] [[ko:초록색 염료]] [[nl:Cactusgroen]] [[pl:Zielony barwnik]] [[pt:Corante verde]] [[ru:Зелёный краситель]] [[Category:Items]] [[Category:Dyes]] [[Category:Renewable resources]]</li></ul>		pre4			Added function-permission-level to server.properties
Upcoming Java Edition
1.20.2 {{Extension DPL}}<ul><li>[[Melon Slice|Melon Slice]]<br/>{{Dungeons hatnote|type=consumable|Melon}} {{Item | title = Melon Slice |typeimage=Melon Slice.png | renewable = Yes | heals = {{hunger|2}} | stackable = Yes (64) }} A '''melon slice'''{{efn|Known as '''Melon Slice''' {{in|java}} and '''Melon''' {{in|bedrock}}.}} is a [[food]] item that can be eaten by the [[player]]. == Obtaining == === Block loot === {{see also|Tutorials/Pumpkin and melon farming|title1 = Pumpkin and melon farming}} Melon slices can be obtained by breaking (harvesting) [[melon]]s using any [[tool]] or by hand. [[Axe]]s, followed by [[sword]]s, are the fastest tools for harvesting melons. A melon drops 3–7 melon slices, when broken; by hand, using a [[tool]], or after being broken by the movement of a [[piston]], with an average of 4.64 slices per melon. Breaking a melon with a tool enchanted with [[Fortune]] increases the potential number of drops by 1 slice per level, up to a maximum of 9 slices. == Usage == === Food === {{see also|Tutorials/Hunger management|title1=Hunger management}} To eat a melon slice, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|2}} [[hunger]] and 1.2 hunger [[Hunger#Mechanics|saturation]]. === Crafting ingredient === {{crafting usage}} === Composting === Placing a melon slice into a [[composter]] has a 50% chance of raising the compost level by 1. ==Sounds== {{Sound table/Entity/Food}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Melon Slice |spritetype=item |nameid=melon_slice |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showaliasids=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |spritename=melon-slice |displayname=Melon |spritetype=item |nameid=melon_slice |aliasid=melon |id=272 |form=item |translationkey=item.melon.name |foot=1}} == Advancements == {{load advancements|Husbandry;A Balanced Diet}} == History == {{History|java beta}} {{History||1.8|snap=Pre-release|[[File:Melon Slice JE1 BE1.png|32px]] Added melons.}} {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease 4|Melons are now used in the [[crafting]] recipe of [[glistering melon]]s.}} {{History|||snap=Beta 1.9 Prerelease 5|Melons once again drop the correct number of slices.}} {{History||1.3.1|snap=12w21a|Melons can now be [[trading|bought]] from farmer [[villager]]s, at 5–8 melon slices for 1 [[emerald]].}} {{History||1.7.2|snap=13w37a|Block ID 105, [[melon stem]], has been removed from the {{cmd|give}} [[commands|command]].}} {{History||1.8|snap=14w02a|[[Villager]]s no longer [[trading|sell]] melons. They now buy [[melon]]s instead.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 360.}} {{History|||snap=18w20b|"Melon" has been renamed to "Melon Slice." |The ID of melon slices has been changed from <code>melon</code> to <code>melon_slice</code>.}} {{History||1.14|snap=18w43a|[[File:Melon Slice JE2 BE2.png|32px]] The texture of melon slices has been changed.}} {{History|||snap=19w03a|Placing a melon slice into the new [[composter]] has a 20% chance of raising the compost level by 1.}} {{History|||snap=19w05a|Melon slices now have a 50% chance of increasing the compost level in a composter by 1.}} {{History|pocket alpha}} {{History||v0.5.0|[[File:Melon Slice JE1 BE1.png|32px]] Added melons. |Melons restore {{health|2}} each, rather than {{hunger|2}}.}} {{History||v0.12.1|snap=?|Added Melon slice to the Creative inventory.}} {{History|||snap=build 1|Melons now restores [[hunger]] instead of [[health]]. |Melons can no longer be obtained from [[nether reactor]]s.}} {{History|pocket}} {{History||1.1.0|snap=alpha 1.1.0.3|[[Breaking]] a [[melon]] with [[shears]] now always yields 9 melons.}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Melon Slice JE2 BE2.png|32px]] The texture of melons has been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Melons can now be used to fill up [[composter]]s.}} {{History|||snap=beta 1.11.0.4|Melons can now be [[trading|sold]] to farmer [[villager]]s.}} {{History||1.16.0|snap=beta 1.16.0.57|[[Trading]] has been changed, melon slices can no longer be sold to farmer villagers.}} {{History||1.16.100|snap=beta 1.16.100.56|The ID of melon slices has been changed from <code>melon</code> to <code>melon_slice</code>.}} {{History|console}} {{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Melon Slice JE1 BE1.png|32px]] Added melons.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Melon Slice JE2 BE2.png|32px]] The texture of melons has been changed.}} {{History|new 3ds}} {{History||0.1.0|[[File:Melon Slice JE1 BE1.png|32px]] Added melons.}} {{History|foot}} == Issues == {{issue list}} == See also == * [[Pumpkin]] * [[Glistering Melon Slice]] == Notes == {{fnlist}} {{Items}} [[Category:Plants]] [[cs:Meloun]] [[de:Melone]] [[es:Rodaja de sandía]] [[fr:Tranche de pastèque]] [[hu:Dinnye Szelet]] [[ko:수박]] [[nl:Meloenschijf]] [[pl:Arbuz]] [[pt:Fatia de melancia]] [[ru:Ломтик арбуза]] [[zh:西瓜片]] [[Category:Food]] [[Category:Renewable resources]]</li><li>[[:Category:Education Edition items|Category:Education Edition items]]<br/>[[Category:Education Edition]] [[Category:Items]]</li></ul>		23w31a			A single backslash \ as the last non-whitespace character of a line now allows a command to be continued on the next line.
					Functions can now contain macro lines, making them Function Macros.
		1.20.2 Pre-release 1			Numbers used as macro arguments are now always inserted without suffixes, regardless of numeric type.

Issues

Issues relating to "Function" are maintained on the bug tracker. Report issues there.