Function (Java Edition)

This article is about functions in Java Edition. For functions in Bedrock Edition, see Function (Bedrock).

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.

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

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>[[Tool|Tool]]<br/>{{About|the in-game items|program enhancing software|Programs and Editors}} A '''tool''' is an [[item]] used by the [[player]] while held to perform actions faster and more efficiently, to gather materials not obtainable by hand, to gain information, or to perform completely new actions. With the exception of the [[clock]], [[compass]], empty [[bucket]], and [[lead]], tools do not stack in the inventory. Tools can be repaired; see [[Item repair]]. == Obtaining == === Mob loot === {{main|Drops#Mob drops|title1=Drops}} Some tools can be obtained by killing mobs that carry the equipment. === Crafting === Most tools can be obtained through crafting. {{:Crafting/Tools}} === Upgrading === [[Netherite]] tools can be obtained only through upgrading. {{Smithing |head=1 |Netherite Upgrade |Diamond Pickaxe; Diamond Axe; Diamond Shovel; Diamond Hoe |Netherite Ingot |Netherite Pickaxe; Netherite Axe; Netherite Shovel; Netherite Hoe }} == Usage == === Best tools === {{main|Breaking#Best tools|title1=Breaking}} Many blocks have a preferred tool to break them. Some blocks can be broken only with certain tools. The tool's material also affects how fast a block is mined. Materials from worst to best in terms of mining speed are wooden, stone, iron, diamond, netherite, gold. === Item durability === {{main|Durability}} Different tools have different amounts of durability. Some uses require more durability to be used than others. A tool's durability is also affected by its material. Materials from worst to best in terms of durability are gold, wooden, stone, iron, diamond, netherite. Some tools are not block-breaking tools: This includes bows, fishing rods, carrots on sticks, flint & steel, and buckets. Such tools are no better than bare fists at breaking blocks, but they do not take damage from doing so—they take damage from being used in their own intended manners. === Item enchantability === Materials from worst to best in terms of [[enchantability]] are stone, diamond, iron, wooden/netherite, gold. === Smelting === {{main|Smelting}} Iron or golden tools can be smelted into [[nugget]]s. {{Smelting|showname=1|head=1|Any iron tools|Iron Nugget|0,1}} {{Smelting|showname=1|foot=1|Any golden tools|Gold Nugget|0,1}} ; Fuel * Wooden tools can be used as a fuel in [[furnace]]s, smelting 1 item per tool. * A [[fishing rod]] can be used as fuel in [[furnace]]s, smelting 1.5{{only|java|short=1}}/1{{only|bedrock|short=1}} items per fishing rod. == History == {{info needed section|earlier Java Edition history between Indev and 1.3.1|section=10}} {{History|java indev}} {{History||0.31|snap=20091231-2|Added iron shovels.}} {{History|||snap=20100110|Added iron axes and pickaxes.}} {{History|||snap=20100128|Added wooden, stone, and diamond tools.}} {{History|||snap=20100129|Added crafting recipes for wooden, stone, iron, and diamond tools.}} {{History|||snap=20100130|Added golden tools.}} {{History|||snap=20100131|A [[Tiers|tier system]] for wooden, stone, iron, diamond, and gold tools is added. Each tier has a different mining speed multiplier and durability.}} {{History|||snap=20100201-2|Tools are now required to break blocks and ores.}} {{history|java}} {{History||1.0.0|snap=RC1|Tools now make a breaking sound and have a breaking animation. |All tools now also have breaking animation.}} {{History|||snap=RC2|Tools no longer break quickly after loading a world that was saved in RC1.}} {{History||1.3.1|snap=12w17a|Tools now have infinite [[durability]] in [[Creative]] mode.}} {{history|||snap=12w18a|Wooden tools became able to be used as [[fuel]] for [[furnace]]s in case players didn't want to repair them or finish using them.}} {{History|||snap=12w24a|Breaking a block that can be [[instant mining|instantly mined]] by hand ([[tall grass]], [[torch]], etc.) while holding a block-breaking tool no longer reduces the tool's [[durability]].}} {{history||1.6.1|snap=13w21a|Instead of replacing the barehanded damage ({{hp|1}}), pickaxes, shovels, axes and swords now add their damage onto the barehanded damage.}} {{History||1.11.1|snap=16w50a|Golden and iron tools now smelt down into one of their respective nuggets.}} {{History||1.14|snap=18w48a|Tools cannot be repaired by crafting.}} {{History||1.14.3|snap=Pre-Release 3|Tools can be once again be repaired by crafting.}} {{History||1.16.2|snap=20w29a|Tools have a new arrange in the Creative inventory.}} {{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond tools to netherite tools now requires the netherite upgrade [[smithing template]].}} {{History|||snap=23w07a|Added brushes.}} {{History|pocket alpha}} {{History||v0.2.0|Added stone tools and shears.}} {{History||v0.3.0|Added wooden tools.}} {{History||v0.3.2|Added iron, diamond, and golden tools.}} {{History||v0.3.3|Added bows.}} {{History||v0.4.0|Added flint and steel and all hoe types.}} {{History||v0.7.0|Added buckets.}} {{History||v0.7.4|Flint and steel now ignite creepers.}} {{History||v0.8.0|snap=build 1|Added flint and steel to the Creative inventory.}} {{History|||snap=build 3|Added shears to the Creative inventory.}} {{History||v0.11.0|snap=build 1|Added fishing rod.}} {{History||v0.15.0|snap=build 1|Added carrot on a stick and leads.}} {{History|pocket}} {{History||1.1.0|snap=alpha 1.1.0.0|Golden and iron tools now smelt down into one of their respective nuggets.}} {{History|console}} {{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Golden and iron tools now smelt down into one of their respective nuggets.}} {{History|foot}} == Issues == {{issue list}} == Trivia == * Gold tools are actually ranked as superior to diamond tools on the [[Legacy Console Edition]]'s crafting screen. * Wooden tools can be burned in a furnace regardless of its durability; this means the player can burn a wooden tool that has only 1 use left. == See also == * [[Item Repair]] * [[Breaking]] * [[Weapon]] {{Items}} [[Category:Tools|*]] [[cs:Nástroje]] [[de:Werkzeug]] [[es:Herramientas]] [[fr:Outils]] [[hu:Eszközök]] [[it:Attrezzi]] [[ja:道具]] [[ko:도구]] [[nl:Gereedschap]] [[pl:Narzędzia]] [[pt:Ferramentas]] [[ru:Инструменты]] [[tr:Alet]] [[zh:工具]]</li><li>[[Block Inspector|Block Inspector]]<br/>{{MinecraftEdu feature}} {{stub}} {{Item | image = BlockInspector.png | stackable = No {{verify}} }} '''Block Inspector''' is an item used to display the name of the block the player is looking at on screen. == Data values == {{ID table |generatetranslationkeys=java |displayname=Block Inspector |spritetype=item |nameid=block_inspector|foot=1}} ==History== {{History|MinecraftEDU}} {{History||0.9848|[[File:BlockInspector.png|32px]] Added block inspectors.}} {{History|foot}} {{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>[[Explorer Map|Explorer Map]]<br/>{{about|the map used to find rare structures|the craftable map|Map|others|Map (disambiguation)}}{{Needs updating|Add info on the new jungle, swamp, and village maps in Java 1.20.2 Pre-Release 1}}{{Item | image = <gallery> Ocean Explorer Map.png | Ocean Woodland Explorer Map.png | Woodland Buried Treasure Map.png | Buried Treasure </gallery> |image2 = <gallery> Ocean Explorer Map BE.png | Ocean (BE) Woodland Explorer Map BE.png | Woodland (BE) Buried Treasure Map BE.png | Buried in Treasure (BE) </gallery> | renewable = * '''Buried Treasure''': No * '''Woodland and Ocean''': Yes | stackable = Yes (64) }} An '''explorer map''' is a special [[map]] used to aid in finding rare [[generated structures]], including [[woodland mansion]]s, [[ocean monument]]s, and [[buried treasure]]s. == Obtaining == === Trading === Apprentice-level [[cartographer]] villagers sell ocean explorer maps for 13 emeralds and a compass. Journeyman-level cartographer villagers sell woodland explorer maps for 14 emeralds and a compass. {{IN|java}}, if the cartographer is in [[the Nether]] or [[the End]], either spawned or transported, the trades for the map do not unlock. However, {{in|bedrock}}, the cartographer trades for the map are unlocked, but the purchased map shows the same layout as in the corresponding dimension and shows no destination structure, but if cartographer trades are unlocked in an old world type (prior-1.11.0), the game stops ticking. In ''Java Edition'', each cartographer sells its own unique explorer map that points to a different location than other cartographers. Purchasing another explorer map from the same cartographer results in the same explorer map. In Bedrock Edition, a cartographer sells an explorer map that points to the nearest location, regardless of whether it is explored or previously mapped by another cartographer.<!-- start to glitched out--> === Chest loot === Treasure maps, in contrast to explorer maps, generate in underwater ruins or in shipwrecks. {{LootChestItem|buried-treasure-map}} == Usage == [[File:Explorer Map Comparison.gif|thumb|217px|Unexplored and partially explored maps.]] {{See also|Map#Mapping|Map#Map content}} === Locating structures === There are three types of explorer maps: woodland, [[ocean]], and buried treasure. The maps differ from a normal map, in that it shows the area's land-water outline, with an orange striated (striped) texture for water<ref>Specifically, biomes in the "water_on_map_outlines" [[Tag#Biomes|biome tag]].</ref>, and the blank map texture for land. The maps show a section of land that contains a [[woodland mansion]], [[monument]] or [[buried treasure]] respectively. This may not be the nearest such [[structure]] to the [[player]]. The structures are displayed as a small icon. If the player icon is smaller than it would be on a normal map, that means the player is a great distance away. When the player is less than 1027 blocks away from the map border, the icon returns to the proper size. When the player reaches the map's area of land (512×512), the [[map]] fills in like a normal map. The basic functions of a buried treasure explorer map are similar to that of the other two. However, instead of showing the structure icon on the map, it shows a red X instead. The [[buried treasure]] structure is located on the same X and Z coordinates as the middle of the X (the player marker may need to be aligned with the bottom of the middle 2×2 pixel square of the X). To locate the [[chest]] spot, hold the treasure map with both hands, not in the offhand slot. === Cloning === {{Crafting |showdescription=1 |shapeless=1 |name=[[Explorer Map]]<br>(cloned) |;;;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map |;;;;Empty Map;Empty Map;Empty Map;Empty Map |;;;;;Empty Map;Empty Map;Empty Map |Ocean Explorer Map; Woodland Explorer Map; Buried Treasure Map; Ocean Explorer Map; Woodland Explorer Map; Buried Treasure Map; Ocean Explorer Map; Woodland Explorer Map |Empty Map |;;;;;;Empty Map;Empty Map |;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map |;;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map |;;;;;;;Empty Map |Output= Ocean Explorer Map,2; Woodland Explorer Map,3; Buried Treasure Map,4; Ocean Explorer Map,5; Woodland Explorer Map,6; Buried Treasure Map,7; Ocean Explorer Map,8; Woodland Explorer Map,9 |type= Miscellaneous |description=The output has the same map center as the input map, and the same [[monument]], [[woodland mansion]] or [[buried treasure]] marker. Cloned maps are stackable. }} The parts of the world that have already been explored and mapped are copied, and newly explored areas appear on both instances. In Creative mode, cloned explorer maps can be obtained by pick blocking on the explorer map displayed on [[item frames]] (the map needs to be out of the [[player]]'s inventory when using pick block, or else that map moves into the active hotbar slot). == Sounds == {{edition|java}}: {{Sound table |sound=Drawmap1.ogg |sound2=Drawmap2.ogg |sound3=Drawmap3.ogg |subtitle=Map drawn |source=block |description=When an explorer map is edited using a cartography table |id=ui.cartography_table.take_result |translationkey=subtitles.ui.cartography_table.take_result |volume=1.0 |pitch=1.0 |distance=16 |foot=1}} {{edition|bedrock}}: ''None'' == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Map |spritetype=item |nameid=filled_map |form=item |translationkey=filled_map.mansion,filled_map.ocean,filled_map.buried_treasure |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showaliasids=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Map |spritetype=item |nameid=filled_map |aliasid=map |id=358 |form=item |translationkey=item.map.exploration.monument.name,item.map.exploration.mansion.name,item.map.exploration.treasure.name |foot=1}} === Metadata === {{see also|Bedrock Edition data values}} {{IN|bedrock}}, the item [[Data value]] distinguishes explorer maps from one another: {{:Map/DV}} === Item data === An explorer map differs from a map in that its <code>display</code> tag is set, which includes a <code>Mapcolor</code> and a <code>LocName</code>; also its <code>Decorations</code> list includes an entry for its target monument, mansion or buried treasure. Its [[Map item format#map_<#>.dat format|map item entry]] is identical to that of a normal map, except that by the time the player sees it, its <code>colors</code> byte array is pre-filled with explorer maps' characteristic land-water boundary lines and water shading. <div class="treeview"> It should be noted that this additional data is stored in the Cartographer's NBT data and in the inventory item's NBT data, and not in the map file (e.g. <samp>map_0.dat</samp>). If the [[player]] were to use the {{cmd|give}} command to give themselves a map with the same map ID as an existing explorer map, it would still have the Ocean Monument or the Woodland Mansion icon on the map, but it would simply be named "Map" instead of, for example, "Ocean Explorer Map". * {{nbt|compound}} Item data ** {{nbt|compound|tag}}: *** {{nbt|compound|display}}: How the map looks in an item slot. See also [[Player.dat_format#Display Properties]]. **** {{nbt|string|Name}}: The name the map is given. In this case, they are localized strings: either <code>{"translate":"filled_map.monument"}</code>,<code>{"translate":"filled_map.mansion"}</code> or <code>{"translate":"filled_map.buried_treasure"}</code>. **** {{nbt|int|MapColor}}: Color codes are calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''.<ref group=note>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref> Monument maps use 3830373, which is {{color swatch|58|114|101}}. Mansion maps use 5393476, which is {{color swatch|82|76|68}}. Buried treasure explorer maps do not use a color code. *** {{nbt|list|Decorations}}: **** {{nbt|compound}}: One of these for each icon on the map. Explorer maps always have at least one representing their target. ***** {{nbt|string|id}}: An arbitrary unique string identifying the decoration. For explorer map target structures, this is "+". ***** {{nbt|double|rot}}: The rotation of the icon. For explorer map target structures, this is always 180. ***** {{nbt|byte|type}}: The ID of the [[Map#Map icons|map icon]]: 8 for a mansion map, 9 for a monument map, 26 for a treasure map. ***** {{nbt|double|x}}: The world x-coordinate of the target structure icon. ***** {{nbt|double|z}}: The world z-coordinate of the target structure icon. </div> ; Notes {{notelist}} == Achievements == {{load achievements|Treasure Hunter}} == History == {{History|java}} {{History||1.11|snap=16w39a|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added woodland and ocean explorer maps.}} {{History|||snap=16w41a|Explorer maps can now no longer be zoomed out.}} {{History||1.13|snap=18w10a|[[File:Map (item) JE1 BE1.png|32px]] Added buried treasure explorer maps.}} {{History|||snap=18w11a|Buried treasure explorer maps now generate in the [[chest]]s of [[shipwreck]]s.}} {{History||1.14|snap=18w43a|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}} {{History||1.20.2|snap=1.20.2 Pre-release 1|Updated structure icons on explorer maps sold by cartographers.}} {{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=1.20.2 Pre-release 1|Added seven new maps which cartographers can sell.}} {{History|pocket}} {{History||1.1.0|snap=alpha 1.1.0.0|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.<ref>{{Mcnet|discovery-update-pocket-and-win-10-soon|The Discovery Update: on Pocket and Win 10 soon|March 29, 2017}}</ref> |Explorer maps are not yet obtainable in [[survival]] mode.}} {{History|||snap=alpha 1.1.0.3|Explorer maps are now obtainable as [[trading|trades]] from [[cartographer]] [[villager]]s.}} {{History|bedrock}} {{History||1.4.0|snap=beta 1.2.14.2|[[File:Map (item) JE1 BE1.png|32px]] Added buried treasure explorer maps.}} {{History|||snap=beta 1.2.20.1|Treasure maps now generate in [[underwater ruins]] [[chest]]s.}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}} {{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed, woodland and ocean explorer maps now cost a [[compass]] and 12 [[emerald]]s. |Journeyman-level [[cartographer]] [[villager]]s no longer [[trading|sell]] 2 type of explorer map as they now have {{frac|1|3}} chance to sell woodland explorer maps, {{frac|1|3}} chance to sell ocean explorer maps, or {{frac|1|3}} chance to sell other [[item]]s<!-- empty locator map--> as part of their [[trading|trades]]. |Woodland explorer maps can now be [[trading|bought]] from fletcher [[villager]]s.}} {{History||1.12.0|snap=beta 1.12.0.3|Journeyman-level fletcher villagers no longer [[trading|sell]] woodland explorer maps.}} {{History||1.13.0|snap=beta 1.13.0.1|[[File:Woodland Explorer Map BE3.png|32px]] [[File:Ocean Explorer Map BE3.png|32px]] [[File:Buried Treasure Map BE3.png|32px]] The textures of explorer maps have now been changed.}} {{History||1.16.100|snap=beta 1.16.100.56|The ID of maps has been changed from <code>map</code> to <code>filled_map</code>.}} {{History|console}} {{History||xbox=TU54|xbone=CU44|ps=1.52|wiiu=Patch 24|switch=1.0.4|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.}} {{History|PS4}} {{History||1.90|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}} {{History|new3ds}} {{History||1.9.19|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.}} {{History|foot}} == Issues == {{Issue list}} == Trivia == * When a [[cartographer]] generates the trade offers for the explorer maps, it chooses the location of one of the nearest structures of the respective type ([[monument]] or [[woodland mansion]]). * For the reason above, explorer maps obtained from one cartographer are always the same. Also, if two cartographers unlock the explorer map trades approximately at the same place and at the same time, the map locations are usually identical. This sometimes also happens when finding multiple treasure maps from [[ocean ruins]]. * Explorer maps fill as the [[chunk]]s are generated, rather than when the [[player]] holds them while in the area; leaving an explorer map while exploring the area still fills the map. * Buried treasure explorer maps are named ''Buried Treasure Map'' {{in|java}} while {{in|bedrock}}, they are named ''Treasure Map''. * It is possible for a cartographer to give a monument or woodland mansion explorer map for areas where the [[generated structures|structures]] would have spawned in the world, but were unable to as a result of terrain generation. As a result, explorer maps, unfortunately, don't always guarantee that a structure exists at the purported location. This is most common with woodland mansion explorer maps, due to its generation algorithm. * On [[Bedrock Edition]], inventory editors and add-ons can be used to create Explorer Maps that lead to any structure. == Gallery == <gallery> File:Explorer Maps.png|An ocean explorer map in the [[off-hand]], a woodland explorer map in the main hand, and a [[cartographer]] [[villager]] in between them. File:Partial Explorer Map.png|A partially-explored explorer map. File:ExplorerToNormal Map Comparison.png|Two fully-explored maps of the same place, one of which is a woodland explorer map. File:Buried Treasure Explorer Map.png|An [[item frame]] holding a buried treasure explorer map. The player can see the red X on the left side of the map. File:Purchase.png|Purchasing explorer maps from a cartographer. </gallery> == See also == * [[Map]] * [[Woodland Mansion]] * [[Ocean Monument]] * [[Shipwreck]] * [[Buried treasure]] == References == {{reflist}} == External Links == *[https://www.minecraft.net/en-us/article/taking-inventory--explorer-map Taking Inventory: Explorer Map] – Minecraft.net on November 13, 2019 {{Items}} [[de:Schatzkarte]] [[es:Mapa (localización de estructura)]] [[fr:Carte d'exploration]] [[ja:探検家の地図]] [[ko:탐험 지도]] [[pl:Mapa eksploracyjna]] [[pt:Mapa de exploração]] [[ru:Карта сокровищ]] [[zh:探险家地图]]</li><li>[[Raw Salmon|Raw Salmon]]<br/>{{about|the item|the mob|Salmon}} {{Item | title = Raw Salmon | image = Raw Salmon.png | renewable = Yes | heals = {{hunger|2}} | stackable = Yes (64) }} '''Raw salmon''' is a food item that can be eaten by the [[player]] or cooked to make [[cooked salmon]]. == Obtaining == === Mob loot === ====Salmon==== [[Salmon]] always drops 1 raw salmon when killed, unaffected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref> If it is killed while on [[fire]], it drops 1 [[Cooked Salmon|cooked salmon]] instead. ====Guardians and elder guardians ==== [[Guardian|Guardians]] and [[Elder Guardian|elder guardians]] have a 2.5% chance to drop a random fish, with 25% of them being raw salmon, which drops as cooked if the guardian was on fire. The chance of getting the fish drop is increased by 1% per level with [[Looting]] (for a maximum of 5.5% with Looting III), but the type of fish is not affected. ====Polar bears==== [[Polar bear]]s have a 25% chance of dropping 0–2 raw salmon when killed. The maximum amount can be increased by 1 per level of Looting, for a maximum of 0-5 with Looting III. If killed while on fire, they drop cooked salmon instead. === Fishing === {{main|Fishing}}Raw salmon can be obtained from [[fishing]]. The wait time of one being caught is decreased with the [[Lure]] enchantment and the chance of one being caught is slightly decreased with the [[Luck of the Sea]] enchantment (named as such because it increases treasure, not fish). Catching salmon awards 1-6 experience. === Chest loot === {{LootChestItem|raw-salmon}} === Villager gifts === {{in|java}}, Fisherman villagers throw raw salmon at [[player]]s under the [[Hero of the Village]] effect. == Usage == === Smelting ingredient === {{smelting |Raw Salmon |Cooked Salmon |0.35 }} === Food === Raw salmon restores {{hunger|2}} [[hunger]] and 0.2 [[Hunger#Mechanics|saturation]]. === Cats === Raw salmon can be used to tame [[cat]]s with {{frac|1|3}} chance of success, get cats off of [[chest]]s, and [[bed]]s, [[breed]] cats, and make baby cats grow up faster by 10% of the remaining time. Additionally, raw salmon can be used to heal cats by {{hp|2|mob=1}}. Raw salmon can be used to gain [[ocelot]] trust, breed ocelots, and make baby ocelots grow up by 10%. === Dolphins === A [[dolphin]] can be fed raw salmon to increase its trust of the player and cause it to interact with the player more often. However, unlike most other animal mobs, this does not cause them to breed. Additionally, dolphins swim to the nearest chest in a [[shipwreck]] or [[underwater ruin]] after they are fed raw salmon. If the chest in the nearest structure is broken, they swim to another structure with a chest. === Trading === Apprentice-level Fisherman [[villager]]s have 50%{{only|bedrock}} or {{frac|2|3}}{{only|java}} chance to buy 6 raw salmon and one [[emerald]] for 6 cooked salmon. Journeyman-level Fisherman villagers offer to buy 13 raw salmon for an emerald. === Wolves === {{IN|bedrock}}, raw salmon can be fed only to [[wolves]] not at full health, healing them by {{hp|2|mob=1}}. Unlike other wolf food, raw salmon cannot be used to breed wolves or to accelerate the growth of baby wolves. ==Sounds== {{Sound table/Entity/Food}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showitemtags=y |showforms=y |generatetranslationkeys=y |displayname=Raw Salmon |spritetype=item |nameid=salmon |itemtags=fishes |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Raw Salmon |spritetype=item |nameid=salmon |id=265 |form=item |foot=1}} == Achievements == {{load achievements|Lion Hunter}} == Advancements == {{load advancements|Husbandry;A Balanced Diet;Fishy Business;A Complete Catalogue}} == Video == <span style="display:inline-block">{{yt|s_GcAFeoREk}}</span> == History == {{History|java}} {{History||1.7.2|snap=13w36a|[[File:Raw Salmon JE1 BE1.png|32px]] Added raw salmon.}} {{History||1.8|snap=14w25a|Raw salmon is now obtainable rare drops from [[guardian]]s and [[elder guardians]].}} {{History||1.9|snap=15w44a|Raw salmon can now be found in [[bonus chest]]s.}} {{History||1.10|snap=16w20a|Raw salmon is now dropped from [[polar bear]]s.}} {{History||1.13|snap=17w47a|The different data values for the <code>fish</code> and <code>cooked_fish</code> IDs have been split up into their own IDs. |Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 349 and 250.}} {{History|||snap=18w08b|Salmon has been added as a [[mob]], which drops raw salmon when killed (cooked while on [[fire]]). |[[File:Raw Salmon JE2 BE2.png|32px]] The texture for raw salmon has been changed.}} {{History||1.14|snap=18w48a|Raw salmon can now be found in chests in [[village]] fisher cottages.}} {{History|||snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] raw salmon.}} {{History|||snap=19w13a|Fisherman villagers now give raw salmon to players under the [[Hero of the Village]] effect.}} {{History|pocket alpha}} {{History||v0.11.0|snap=build 1|[[File:Raw Salmon JE1 BE1.png|32px]] Added raw salmon.}} {{History||v0.12.1|snap=build 1|Salmon now restores [[hunger]] instead of [[health]]. |Raw salmon can now be used to tame [[ocelot]]s.}} {{History||v0.16.0|snap=build 1|Salmon is now [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|Added [[polar bear]]s, which drop raw salmon.}} {{History|bedrock}} {{History||1.2.0|snap=beta 1.2.0.2|Raw salmon is now found inside [[bonus chest]]s.}} {{History||1.4.0|snap=beta 1.2.14.2|Salmon has been added as a [[mob]], which drops raw salmon when killed (cooked while on [[fire]]). |[[File:Raw Salmon JE2 BE2.png|32px]] The texture for raw salmon has been changed.}} {{History|||snap=beta 1.2.20.1|Added [[dolphin]]s, which can be [[breeding|bred]] with raw salmon.}} {{History||1.5.0|snap=beta 1.5.0.0|Raw salmon can no longer be used to breed dolphins. |Giving raw salmon to dolphins now leads the [[player]] to nearest [[underwater ruins]] or [[shipwreck]].}} {{History||1.8.0|snap=beta 1.8.0.8|Raw salmon can no longer be used to tame [[ocelot]]s. |Raw salmon can now be used to [[breeding|breed]] ocelots. |Added stray [[cat]]s, which can be tamed by being fed raw salmon.}} {{History||1.11.0|snap=beta 1.11.0.4|Raw salmon can now be [[trading|sold]] to fisherman [[villager]]s.}} {{History||1.16.100|snap=beta 1.16.100.52|If [[salmon]] is [[death|killed]] while on [[fire]], then they now drop [[cooked salmon]] instead of a raw salmon.}} {{History|console}} {{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Raw Salmon JE1 BE1.png|32px]] Added raw salmon.}} {{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Raw Salmon JE2 BE2.png|32px]] The texture for raw salmon have been changed.}} {{History|new 3ds}} {{History||0.1.0|[[File:Raw Salmon JE1 BE1.png|32px]] Added raw salmon.}} {{History|foot}} == Issues == {{issue list}} == See also == * [[Fishing]] == References == {{reflist}} {{items}} [[de:Roher Lachs]] [[es:Salmón crudo]] [[ja:生鮭]] [[ko:생연어]] [[pt:Salmão cru]] [[ru:Сырой лосось]] [[tr:Çiğ Somon]] [[zh:生鲑鱼]] [[Category:Renewable resources]] [[Category:Food]]</li></ul>		17w43a			Custom functions have been moved into data packs.
		17w45a			Functions are now completely parsed and cached on load.
		17w49b			Function 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.