Minecraft Wiki
Advertisement
Information icon
This feature is exclusive to Java Edition. 
This article is about functions in Java Edition. For functions in Bedrock Edition, see Function (Bedrock Edition).
Move arrows
It has been suggested that this page be moved to Function (Java Edition).
If this move affects many pages or may potentially be controversial, do not move the page until a consensus is reached.
 [discuss]
Reason: This page will be a disambiguation page, less confusion between editions.
When moving, be sure to use the appropriate tool instead of simply copying and pasting the page's contents, to preserve edit history.

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

Usage

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

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

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

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

Function syntax

TestingFunctions

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

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

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

Running a function

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

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

For example:

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

foo:bar

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

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

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

Commands

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

Advancements

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

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

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

Tags

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

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

History

Java Edition
1.12
{{Extension DPL}}<ul><li>[[Eye of Ender|Eye of Ender]]<br/>{{redirect|Ender Eye|the boss|Ender Dragon}}
{{ItemEntity
|image=Eye of Ender.png
|stackable=Yes (64)
|renewable=Yes
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
|networkid='''[[JE]]''': 72
}}
An '''eye of ender''' is a craftable item used to locate [[stronghold]]s and activate the [[end portal]]s within them.

== Obtaining ==
=== Crafting ===
{{Crafting
  |Blaze Powder
  |Ender Pearl
  |Output=Eye of Ender
  |type=Miscellaneous
}}

== Usage ==
=== Locating strongholds ===
[[File:Eye of Ender (break).gif|thumb|right|An animation of an eye of ender shattering.]]

To locate [[stronghold]]s (and the [[end portal]]s they house):
* Pressing {{control|use}} while holding an eye of ender causes it to fly approximately 12 blocks in the direction of the nearest stronghold, traveling through any blocks necessary, and leave a trail of purple particles, the same particle effect used for [[endermen]] and [[ender chests]]. 
** The eye leads to the [[chunk]] where a spiral staircase, the first room generated in the stronghold, is located.
** The center of this entrance staircase is always exactly at the chunk coordinates 4, ~, 4, although the eye of ender leads to chunk coordinates 0, ~, 0 (the northwest corner of the chunk).
* While over 12 blocks away from the northwest corner of the staircase chunk, the eye will travel upward to offer an easily-visible indication of the horizontal direction the player must travel.
* When closer than 12 blocks to the northwest corner of the staircase chunk, the eye will travel downward, to indicate the player is above a stronghold and must mine downward.
* After two or three seconds of travel, the eye floats in the air briefly, then either falls (becoming collectable again) or shatters in mid-air. The eye has a 20% chance of shattering (80% chance of surviving) per throw, therefore throwing it three times has approximately 50% overall chance to shatter the eye (0.8<sup>3</sup>=51.2%).
* The eye of ender's flying function works only in the [[Overworld]]. It does nothing in [[the Nether]], [[the End]], [[custom dimension]]s{{verify|type=current}}, or in worlds with no strongholds.

Note that the eyes may point to an incorrect location if the target chunks were generated with a different biomes map in an older version or through different generation settings.<ref>See also {{bug|MC-135996}}</ref>

=== Activating end portals ===
[[File:Active End Portal.png|thumb|right|An end portal activated with eyes of ender.]]
Once an end portal is found, the eyes of ender are required to activate it. End portals require a total of 12 eyes of ender in order to activate, though each individual frame-block has a 10% chance of containing an eye of ender when generated. Eyes can be placed in empty [[End portal frame]]s by pressing {{control|use}} on them until the entire ring of 12 is filled, thereby activating the portal. Due to the fact that there is a 10% chance of each individual end portal frame having an eye in it, there is a one out of one trillion chance of every frame having an eye in it thereby activating the portal even if the player doesn't have any eyes of ender.
{| class="wikitable sortable mw-collapsible"
|+End Portal Pre-Filled Eyes
!Eyes
!0
!1
!2
!3
!4
!5-12
|-
|Exactly
|28%
|38%
|23%
|9%
|2%
|<1%
|-
|Or More
|100%
|72%
|34%
|11%
|3%
|<1%
|}

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

== Sounds ==
{{Edition|Java}}:<br>
Eyes of ender use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Ender Eye death1.ogg
|sound2=Ender Eye death2.ogg
|subtitle=Eye of Ender falls <ref group=sound name=LousyEvents>{{Bug|MC-98316||Wrong subtitles caused by missing distinction}}</ref>
|source=neutral
|description=When an eye of ender drops or breaks
|id=entity.ender_eye.death|idnote=<ref group=sound name=LousyEvents/>
|translationkey=subtitles.entity.ender_eye.death|translationkeynote=<ref group=sound name=LousyEvents/>
|volume=1.3
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Ender Eye launch1.ogg
|sound2=Ender Eye launch2.ogg
|subtitle=Eye of Ender shoots
|source=neutral
|description=When an eye of ender is thrown
|id=entity.ender_eye.launch
|translationkey=subtitles.entity.ender_eye.launch
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16}}
{{Sound table
|sound=End portal eye place1.ogg
|sound2=End portal eye place2.ogg
|sound3=End portal eye place3.ogg
|subtitle=Eye of Ender attaches
|source=block
|description=When an eye of ender is placed in an end portal frame
|id=block.end_portal_frame.fill
|translationkey=subtitles.block.end_portal_frame.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Item Frame break1.ogg
|sound2=Item Frame break2.ogg
|sound3=Item Frame break3.ogg
|source=block
|description=When an eye of ender breaks <ref group=sound>{{Bug|MCPE-115646}}</ref>
|id=block.itemframe.break}}
{{Sound table
|sound=Bow shoot.ogg
|source=player
|description=When an eye of ender is thrown
|id=random.bow
|volume=0.5
|pitch=0.33-0.5}}
{{Sound table
|sound=End portal eye place1.ogg
|sound2=End portal eye place2.ogg
|sound3=End portal eye place3.ogg
|source=block
|description=When an eye of ender is placed in an end portal frame
|id=block.end_portal_frame.fill
|volume=0.3
|pitch=0.9/1.0/1.1
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Eye of Ender
|spritetype=item
|nameid=ender_eye
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Eye of Ender
|spritetype=entity
|nameid=eye_of_ender
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Eye of Ender
|spritetype=item
|nameid=ender_eye
|id=433
|form=item
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Eye of Ender
|spritetype=entity
|nameid=eye_of_ender_signal
|id=70
|foot=1}}

===Entity data===
The purple particles left by eyes of ender have entity data that define various properties of the entity.

{{el|java}}:
{{main|Entity format}}
{{/ED}}

{{el|bedrock}}:

:See [[Bedrock Edition level format/Entity format]].

==Advancements==
{{load advancements|Eye Spy}}

==Video ==
{{Video note|This video does not mention that eyes of ender can be used to craft [[ender chest]]s or [[end crystal]]s.}}

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

==History==
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|[[File:Eye of Ender JE1 BE1.png|32px]] Added eyes of ender.
|Eyes of ender can be used on a [[end portal frame|portal block]] to repair them, but repairing them does nothing.}}
{{History|||snap=Beta 1.9 Prerelease 4|Each eye can now be placed in a [[end portal frame|portal block]] or used to hone in on a [[stronghold]]. [[Jens Bergensten|Jeb]] demonstrated the new uses for an eye in his livestream.<ref>http://www.twitch.tv/jebox/b/297000418</ref> An [[end portal]] within a stronghold could be seen in the stream with two eyes inserted into blocks.
|In older worlds with chunks generated before [[Java Edition Beta 1.9 Prerelease 3|Beta 1.9 Prerelease 3]], the eyes may mislead the [[player]] to a place where there isn't a [[stronghold]] at all. This happens because the eyes lead to where a stronghold should be based on the world seed in the current version, but before Beta 1.9 Prerelease 3 strongholds generated differently based on the seed. Therefore, if the player saved the coordinates the eye traveled to in an old world and generated a new world with the same seed, the player could travel to those same coordinates and find a stronghold.}}
{{History|||snap=Beta 1.9 Prerelease 6|Eyes of ender no longer render like a tool in third person.}}
{{History|||snap=RC1|The throwing sound of eyes of ender has been changed.}}
{{History||1.3.1|snap=12w21a|Eyes of ender can now be used to craft [[ender chest]]s.
|Priest [[villager]]s would [[trading|buy]] 2–3 eyes of ender for one [[emerald]].}}
{{History|||snap=12w22a|Priest villagers no longer buy eyes of ender, instead selling them for 7–10 emeralds.}}
{{History||1.6.4|snap=1.6.3-pre|Eyes of ender now lead to [[stronghold]]s based on the structure data saved in the world file instead of calculating their approximate location via the [[seed (level generation)|world seed]]. Therefore, strongholds generated in old versions can still be found even if the distribution of strongholds is changed.}}
{{History||1.7.2|snap=13w41a|Eyes of Ender now lead to the entrance of a stronghold instead of the portal room.}}
{{History||1.8|snap=14w02a|With changes that have been made to villagers and the [[trading]] system, cleric villagers now sell eyes of ender for 7–11 [[emerald]]s, as one of their tier III trades.}}
{{History||1.9|snap=15w41a|Eyes of ender are no longer [[trading|sold]] by cleric [[villager]]s.}}
{{History|||snap=15w44b|An eye of ender is now used to craft an [[end crystal]].}}
{{History|||snap=pre3|Eyes of ender now point to the 125 new strongholds.<ref>{{bug|MC-91173}} resolved as "Fixed"</ref>}}
{{History||1.11|snap=16w32a|The [[entity]] ID has been changed from <code>EyeOfEnderSignal</code> to <code>eye_of_ender_signal</code>.}}
{{History||1.12|snap=17w17a|A new ''pop'' [[sound]] has been added when a thrown eye of ender bursts.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 381.}}
{{History|||snap=pre5|The [[entity]] ID has been changed to <code>eye_of_ender</code>.}}
{{History||1.14|snap=18w43a|[[File:Eye of Ender JE2 BE2.png|32px]] The texture of eyes of ender has been changed.}}
{{History||1.19|snap=22w11a|Eyes of Ender now lead to the corner of the chunk (0, ~, 0) instead of the center (8-9, ~, 8-9).<ref>{{bug|MC-253394}}</ref>}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Eye of Ender JE1 BE1.png|32px]] Added eyes of ender.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Eye of Ender JE2 BE2.png|32px]] The texture of eyes of ender has been changed.}}
{{History||1.16.0|snap=beta 1.15.0.51|The [[particles]] of eyes of ender have been changed to match {{el|je}}.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Eye of Ender JE1 BE1.png|32px]] Added eyes of ender.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Eye of Ender JE2 BE2.png|32px]] The texture of eyes of ender has been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Eye of Ender JE1 BE1.png|32px]] Added eyes of ender.}}
{{History|foot}}


=== Historical images ===
<gallery>
File:Held_Eye_of_Ender.png|The eye of ender used to appear large in third-person view.
</gallery>

==Issues==
{{issue list}}

==Trivia ==
*When thrown in third-person view, the eyes of ender fly out from the player's feet instead of their hand.
*Before [[Java Edition 1.9]], eyes of ender can be purchased from cleric villagers, which means players can find a [[stronghold]] and go to [[the End]] without accessing [[the Nether]] at all.
*{{IN|bedrock}} if the player travels beyond a certain radius (roughly 740,000 blocks), eyes of ender always point to a stronghold near spawn, even though strongholds continue to generate past this limit. If one travels to this limit, they can see eyes of ender suddenly switching direction. A similar phenomenon occurs with the {{cmd|locate}} command.

==Gallery==
===Screenshots===
<gallery>
Stronghold Portal Room.png|An end portal frame containing a few eyes of ender.
EnderChestexample.png|An [[ender chest]] depicting an eye of ender on the front.
</gallery>
===In other media===
<gallery>
File:Eye of Ender JINX.jpg|Official T-shirt artwork "Eye of Ender" sold by JINX.
File:Happy Halloween Eye.jpg|A Halloween T-Shirt design featuring an eye of ender.
</gallery>

==External links==
*[http://www.strongholdfinder.com/ A super-easy stronghold triangulation tool]
*[http://jsfiddle.net/42EDX/40/ JSFiddle Eye of Ender triangulator - can guess the location of other 2 strongholds in the first ring]
*[https://ens-gijs.github.io/minecraft-stronghold-locator/ Minecraft Stronghold Locator Eye of Ender throw plotting visualizer - zoomable to show all possible stronghold rings]
*[https://github.com/winny-/stronghold Python Eye of Ender throw plotting tool]
*[http://www.purplefrog.com/~thoth/MinecraftStronghold/stronghold.html HTML Eye of Ender throw plotting visualizer (not updated after 1.9 stronghold placement changes)]
*[http://chunkbase.com/apps/stronghold-finder Chunk Base Stronghold Finder (seed-based)]
*[https://github.com/toolbox4minecraft/amidst/releases Amidst - File-based world visualizer]
*[http://minecraft.tournier.org/StrongholdLocator/ Find strongholds by analyzing stronghold.dat file]


== References==
{{reflist}}

{{Items}}
{{entities}}

[[cs:Endové oko]]
[[de:Enderauge]]
[[es:Ojo de ender]]
[[fr:Œil de l'Ender]]
[[hu:Végzet szeme]]
[[ja:エンダーアイ]]
[[ko:엔더의 눈]]
[[nl:Enderoog]]
[[pl:Oko Endera]]
[[pt:Olho de ender]]
[[ru:Око Края]]
[[th:ดวงตาแห่งเอนเดอร์]]
[[uk:Око Краю]]
[[zh:末影之眼]]</li><li>[[Gray Dye|Gray Dye]]<br/>{{Item
| image = Gray Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Gray dye'''{{fn|Known as '''Grey Dye''' in British, Canadian, Australian, and New Zealand English variants.}} is a [[Dyeing#Secondary colors|secondary color]] dye.

== Obtaining ==

=== Crafting ===

{{Crafting
  |Black Dye
  |White Dye
  |Output=Gray Dye,2
  |type=Material
  |head=1
  |showdescription=1
  |showname=0
}}
{{Crafting
  |Ink Sac;Black Dye;Ink Sac
  |Bone Meal;Bone Meal;White Dye
  |Output=Gray Dye,2
  |type=Material
  |description={{only|bedrock|education}}
  |foot=1
}}

=== Trading ===

[[Wandering trader]]s sell 3 gray dye for an [[emerald]].{{only|bedrock}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}

=== Loom ingredient ===
{{Banner loom usage|Gray Dye}}

=== Trading ===
Journeyman-level villagers have a 20% chance to buy 12 gray dye for an emerald.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|aliasid=dye / 8
|id=403
|form=item
|translationkey=item.dye.gray.name
|foot=1}}

== Video ==
{{yt|wGalHy0_fj0}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Gray dye can be now [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary [[dye]]s.}}
{{History|||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=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|Gray dye is now [[crafting|crafted]] using [[black dye|black]] and [[white dye]]s, instead of [[ink sac]] and [[bone meal]].
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History|||snap=18w44a|Gray dye can now change the text color on the [[sign]]s to gray.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell gray dyes.}}
{{History|||snap=19w11a|Gray dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Gray dye can now used to craft [[gray candle]]s.}}
{{History|||snap=21w19a|Gray dye can no longer be used to craft gray candles.}}
{{History|||snap=Pre-release 1|Gray dye can once again be used to craft gray candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Gray dye can now change the text color on [[hanging sign]]s to gray.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.8.0|snap=build 1|Gray dye can be [[craft]]ed with [[bone meal]] and an [[ink sac]], despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Gray dye is now available in [[creative]] mode.}}
{{History||v0.9.0|snap=build 3|Gray dye can now be obtained in [[survival]] mode.}}
{{History|||snap=build 11|Gray dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Gray dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Gray dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gray dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gray dye can now be used to craft [[concrete powder]], colored [[bed]]s and dyed [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gray dye can now be used to craft [[firework star]]s, [[stained glass]] and patterns on [[banner]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Gray dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Gray dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Gray dye is now [[trading|sold]] by [[wandering trader]]s.
|Gray dye can now be used to dye white [[carpet]]s and undyed [[glass pane]]s.
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of gray dye has been changed from <code>dye/8</code> to <code>gray_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|PS4}}
{{History||1.90|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Notes ==
{{fnlist}}

== References ==
{{Reflist}}

{{Items}}

[[Category:Dyes]]
[[Category:Renewable resources]]

[[cs:Šedé barvivo]]
[[de:Grauer Farbstoff]]
[[es:Tinte gris]]
[[fr:Teinture grise]]
[[hu:Szürke festék]]
[[ja:灰色の染料]]
[[ko:회색 염료]]
[[nl:Grijze kleurstof]]
[[pl:Szary barwnik]]
[[pt:Corante cinza]]
[[ru:Серый краситель]]
[[zh:灰色染料]]</li></ul>
pre1Added functions.
pre3Commands are no longer allowed to begin with a / (forward slash)
Comments can now only be preceded with #; using // is no longer allowed
pre4Added new arguments to the /function command: [if|unless] [selector]
pre6Skipped functions (when a conditional fails) are now considered failures when used in commands.
1.13
{{Extension DPL}}<ul><li>[[Bone Meal|Bone Meal]]<br/>{{Item
| image = Bone Meal.png
| renewable = Yes
| stackable =  Yes (64)
}}
'''Bone meal''' is a material that can be used as a fertilizer for most plants and fungi, as well as a crafting ingredient for [[dye]]s.

== Obtaining ==

=== Crafting ===

{{Crafting
|Bone
|Output=Bone Meal,3
|type=Material
|showname=0
|head=1
}}
{{Crafting
|Bone Block
|Output= Bone Meal,9
|type=Material
|foot=1
}}

=== Mob loot ===

==== Fish ====
All fish mob variants ([[cod]], [[salmon]], [[tropical fish]], and [[pufferfish]]) have a 5% chance to drop 1 bone meal upon death.{{only|java}} In [[Bedrock Edition]], they drop [[bones]] instead.

=== Composters ===

When a [[composter]] is completely filled, a single bone meal drops the next time the composter is {{ctrl|used}}.

=== Trading ===

[[Wandering trader]]s sell 3 bone meal for an [[emerald]].{{only|bedrock}}

== Usage ==

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

{{IN|bedrock}}, bone meal can be also used in [[banner pattern]]s:
{{banner crafting usage}}

=== Loom ingredient === 
{{Banner loom usage|Bone Meal}}

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

=== Fertilizer ===
Bone meal can also be used on the following [[plants]] to have a chance to increase their growth stage:
{| class="wikitable"
|+
!Plant
!Action
|-
|{{BlockLink|Wheat}}<br>{{BlockLink|Carrots}}<br>{{BlockLink|Potatoes}}
|The plant matures 2–5 growth stages.
|-
|{{BlockLink|Beetroots}}
|The plant has a 75% chance of growing to the next growth stage.
|-
|{{BlockLink|Bamboo}}
|Grows the [[bamboo]] by 1-2 stems.
|-
|{{BlockLink|Melon Stem|link=Melon seeds|text=Melon Seeds}}<br>{{BlockLink|Pumpkin Stem|link=Pumpkin seeds|text=Pumpkin Seeds}}
|The planted stem matures 2–5 growth stages. Bone meal affects only the stem's growth; it does not cause [[melon]]s or [[pumpkin]]s to sprout from a mature stem.
|-
|{{BlockLink|Saplings}}<br>{{BlockLink|Azalea}}<br>{{BlockLink|Flowering Azalea}}<br>{{BlockLink|Mangrove Propagule}} (not hanging)
|The [[sapling]] has a 45% chance of growing to the next growth stage, if possible. Saplings have two growth stages (with no visible difference between them) before growing into trees as the third stage. A tree cannot grow unless the sapling is planted in proper ground and sufficient space is available. Using bone meal on such an obstructed sapling with no chance of growing wastes the bone meal.
|-
|{{BlockLink|Sunflower}}s<br>{{BlockLink|Lilac}}s<br>{{BlockLink|Rose Bush}}es<br>{{BlockLink|Peony|Peonies}}
|The corresponding item form drops, without destroying the original plant.
|-
|{{BlockLink|Grass}}<br>{{BlockLink|Fern}}s<br>{{BlockLink|Seagrass}}
|A one-block-high tall [[grass]], [[fern]], or [[seagrass]] (that is on [[grass block]], [[dirt]], [[coarse dirt]], [[rooted dirt]], [[farmland]], [[podzol]], [[mycelium]], [[moss block]], [[mud]], or [[muddy mangrove roots]] (only exception is seagrass, will need to on a full surface)) grows into a two-block-high tall grass, fern or seagrass.
|-
|{{BlockLink|Mushrooms}}
|Has a 40% chance of growing into a {{EnvLink|huge mushroom}} if on [[grass block]], [[dirt]], [[coarse dirt]], [[rooted dirt]], [[farmland]], [[podzol]], [[mycelium]], [[moss block]], [[mud]], or [[muddy mangrove roots]].
|-
|{{BlockLink|Cocoa}}
|The cocoa plant matures 1 growth stage.
|-
|{{BlockLink|Sweet Berry Bush}}
|Grows every stage.
|-
|{{BlockLink|Sea Pickle}}
|If the [[sea pickle]] is on a [[coral block]] and in [[water]] at least 2 blocks deep, the sea pickle colony grows, and additional sea pickles generate nearby.
|-
|{{BlockLink|Sugar Cane}}{{only|bedrock|short=1}}
|The sugar cane grows to maximum height (three blocks tall).
|-
|{{BlockLink|Kelp}}
|The kelp plant grows by 1 block per bone meal used, up to its maximum height.
|-
|{{BlockLink|Flower|id=poppy}} (excluding wither roses){{only|bedrock|short=1}}
|One-block-high flowers make more flowers of the same type grow in the surrounding area.
|-
|{{BlockLink|Fungus|id=fungi}}
|Grows into [[huge fungi]], but only if on the respective [[nylium]].
|-
|{{BlockLink|Weeping Vines}}
|Grows the [[weeping vine]]s a few blocks downward.
|-
|{{BlockLink|Twisting Vines}}
|Grows the [[twisting vine]]s a few blocks upward.
|-
|{{BlockLink|Cave Vines}}
|Produces [[glow berries]] if the vine did not have any [[glow berries]] on it already.
|-
|{{BlockLink|Glow Lichen}}
|The [[glow lichen]] spreads to a random adjacent block.
|-
|{{BlockLink|Moss Block}}
|The [[moss block]] causes nearby [[stone]], [[cave vine]]s, and [[dirt]] to become moss blocks.
|-
|{{BlockLink|Big Dripleaf}}<br>{{BlockLink|Small Dripleaf}}
|A [[big dripleaf]] grows one block higher, and a [[small dripleaf]] becomes a big dripleaf.
|-
|{{BlockLink|Rooted Dirt}}
|Causes [[hanging roots]] to grow underneath the [[rooted dirt]] if there is space.
|-
|{{BlockLink|Mangrove Leaves}}
|Creates a hanging [[mangrove propagule]] under the [[mangrove leaves]].
|-
|{{BlockLink|Mangrove Propagule}} (hanging)
|The [[mangrove propagule]] matures 1 growth age.
|-
|{{BlockLink|Pink Petals}}
|Produces another pink petal in the block. If there are already four pink petals in the block, it will drop a pink petal as an item.
|-
|{{BlockLink|Torchflower Crop}}<br>{{BlockLink|Pitcher Crop}}
|Grows every stage.
|}

Bone meal does not affect:
* [[Cactus]]
* [[Vines]]
* [[Nether wart]]
* [[Sugar cane]]{{only|JE}}
* [[Chorus plant]]s, or other plants not listed above.

==== Wasting bone meal ====
Bone meal can be used on the following objects in the following situations, consuming it without any real effect:

* On [[grass]], [[fern]]s, and [[seagrass]] that do not have enough space to grow.<ref>{{bug|MC-125642}}</ref>
* On [[seagrass]] that doesn't have [[water]] above.
* On a [[dark oak sapling]] that is not in a group of four.<ref>{{bug|MC-168446}}</ref>
* On a [[mushroom]] that is not on a block that allows it to grow into a huge mushroom.<ref>{{bug|MC-173213}}</ref>
* On a [[sea pickle]] that is already in a group of four and has no valid locations to expand to.<ref>{{bug|MC-127995}}</ref>
* On a [[bamboo]] (not [[bamboo shoot]]) that is blocked in the way.
* On a [[sea pickle]] that is not on a [[coral block]].
* On a [[fungus]] that is not on its respective [[nylium]].
* Any plants that can't grow due to being block by the [[build limit]].

=== Creating new plants ===

If bone meal is {{ctrl|used}} on a [[grass block]]; [[tall grass]], [[grass]], [[flower]]s, and [[pink petals]] form on the targeted block and on random adjacent grass blocks in an 15×5×15{{only|java|short=1}}/7×5×7{{only|bedrock|short=1}} area centered on the targeted block. The flowers/pink petals that appear depend on the biome, meaning that in order to obtain specific flowers, the player must travel to biomes where the flowers are found naturally. See {{slink|Flower|Flower biomes}} for more information.

Using bone meal on a 2-block flower (rose bushes, sunflowers, lilacs or peonies) will cause one of the same type of flower to drop, without breaking the original. This is the only way to reproduce these flowers, since they cannot generate from using bone meal on grass blocks.

Using bone meal on a non-transparent block that is underwater generates [[seagrass]] on that block and surrounding blocks. Sometimes, if in a [[warm ocean]] biome, [[coral]] and [[coral fan]]s may have a chance to generate as well, and in Bedrock Edition, coral (not coral fan) can be generated in any biome. In order for this to work, there must be 2 water blocks above the block the bone meal is being used on, and the lower one must be non-flowing water.

Using bone meal on a [[sea pickle]] on a [[coral block]] creates sea pickles. This generates sea pickles up to 3 [[block]]s (of coral) away, so a 7+ × 7+ block (49+ blocks) of coral may be necessary, to return the most sea pickles per given bone meal attempt (more attempts grows them more numerously, exactly - including the range of it growing, like grass with heights on grass blocks - as coral and coral fans, though those others being non-solid blocks).

Using bone meal on [[netherrack]] adjacent to [[nylium]] converts the netherrack into nylium of the same type. If both crimson and warped nylium are adjacent to the netherrack that was applied with bone meal, there is a 50% chance that either type of nylium is created.

Using bone meal on [[nylium]] causes the corresponding [[roots]] and both types of [[fungi]] to appear on the nylium block and other nylium nearby, with the type of fungi matching the type of nylium being more common. In addition, using bone meal on the side of warped nylium creates [[nether sprouts]] and [[twisting vines]].

=== Farmer villagers ===
[[Villager]]s with the farmer profession can collect bone meal from a full [[composter]], with which they can make their crops grow faster.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Bonemeal1.ogg
|sound2=Bonemeal2.ogg
|sound3=Bonemeal3.ogg
|sound4=Bonemeal4.ogg
|sound5=Bonemeal5.ogg
|subtitle=Bone Meal crinkles
|description=When bone meal is successfully used
|source=block
|id=item.bone_meal.use
|translationkey=subtitles.item.bone_meal.use
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|be}}:
{{Sound table
|type=bedrock
|sound=Bonemeal1.ogg
|sound2=Bonemeal2.ogg
|sound3=Bonemeal3.ogg
|sound4=Bonemeal4.ogg
|sound5=Bonemeal5.ogg
|description=When bone meal is successfully used
|source=block
|id=item.bone_meal.use
|volume=1.0
|pitch=0.9-1.1
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Bone Meal
|spritetype=item
|nameid=bone_meal
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bone Meal
|spritetype=item
|nameid=bone_meal
|aliasid=dye / 15
|id=411
|form=item
|translationkey=item.dye.white.name
|foot=1}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Bone Meal JE1 BE1.png|32px]] Added bone meal.
|Bone meal can now only be applied to [[sapling]]s and [[wheat]].}}
{{History||1.6.6|Bone meal can now be applied on [[grass block]]s.}}
{{History||1.8|snap=Pre-release|Bone meal can now be used on [[mushroom]]s to make [[huge mushroom]]s, and the block the mushroom is on changes to [[dirt]].}}
{{History|||snap=Pre-release 2 ;)|Bone meal can now be applied on [[pumpkin seeds|pumpkin]] and [[melon seed]]s.}}
{{History|java}}
{{History||1.3.1|snap=12w19a|Bone meal can now be applied on [[cocoa bean]]s.}}
{{History|||snap=1.3|[[File:Bone Meal JE2 BE2.png|32px]] The texture of bone meal has been changed.}}
{{History||1.4.2|snap=12w34a|Bone meal can now be used to dye [[leather armor]] and [[tamed wolf]]'s collar.}}
{{History||1.4.6|snap=12w49a|Bone meal can now be [[crafted]] with [[gunpowder]] to create a [[firework star]].}}
{{History||1.5|snap=13w04a|Bone meal has been significantly nerfed.<br>
[[Wheat]], [[melon seeds|melon]] and [[pumpkin seed]]s, [[potato]]es and [[carrot]]s: one bone meal is now consumed for all seven stages of growth (melon and pumpkin seeds do not spawn right away).<br>
[[Sapling]]s: one bone meal is now consumed for each of the two growth stages, then it grows into a tree.<br>
[[Cocoa]]s: one bone meal is now consumed for each of the three stages of growth.
|Green [[particle]]s are now displayed when bone meal is used.
|Bone meal can now be used from [[dispenser]]s.}}
{{History|||snap=13w05a|The balancing of bone meal has been adjusted. Growing a plant to its last state now takes on average 2-5 uses of bone meal (results vary from plant to plant).<ref>https://web.archive.org/web/20220921040940/https://imgur.com/a/gOngk</ref>}}
{{History||1.6.1|snap=13w19a|Bone meal can now be used to craft white [[stained clay]].}}
{{History||1.7.2|snap=13w36a|The [[flower]]s generated when using bone meal on grass blocks is now biome dependent.}}
{{History|||snap=13w41a|Bone meal can now be used to craft white [[stained glass]].}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed with [[bone meal]].}}
{{History||1.10|snap=16w20a|Bone meal can now be used to craft [[bone block]]s.}}
{{History||1.11|snap=16w39b|Bone meal can now be used to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Bone meal can now be used to craft white [[concrete powder]].}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History|||snap=18w07a|Bone meal can now be used underwater to create [[seagrass]].}}
{{History|||snap=18w14b|Bone meal can now be used for spreading [[sea pickle]]s.}}
{{History||1.13.1|snap=18w31a|Bone meal used in [[water]] of warm ocean biomes now has a chance of growing [[coral]].
|[[Cod]], [[salmon]], [[tropical fish]], and [[pufferfish]] now have a chance of dropping bone meal upon death.}}
{{History|||snap=18w32a|Bone meal used in [[water]] of warm ocean biomes now has a chance of growing [[coral fan]]s.}}
{{History||1.14|snap=18w43a|Bone meal can now used to craft [[white dye]].
|Bone meal can no longer be used as a [[dye]].
|All of the dye-related functions and crafting recipes of bone meal (except bone blocks) have been transferred to white dye.
|[[File:Bone Meal JE3 BE3.png|32px]] The texture of bone meal has been changed.
|Bone meal can now be used on [[bamboo]] and [[bamboo shoot]].}}
{{History|||snap=19w03a|Bone meal can now be obtained from [[composter]]s.}}
{{History||1.16|snap=20w06a|Bone meal can now be used to grow [[fungi]] into [[huge fungi]].
|Bone meal can now be used to spread [[nylium]] onto netherrack.}}
{{History|||snap=20w09a|Using bone meal to grow fungi now works only on the respective [[nylium]].}}
{{History|||snap=20w11a|Bone meal can now grow [[kelp]], [[weeping vines]], and [[twisting vines]].}}
{{History|||snap=20w12a|Bone meal can now be used to grow [[roots]], [[fungi]], and [[nether sprouts]] on nylium.}}
{{History|||snap=20w13a|Farmers can now use bone meal to grow crops.}}
{{History||1.17|snap=21w03a|Bone meal can now be used to spread [[glow lichen]]s.}}
{{History|||snap=21w05a|Bone meal can now be used on [[moss block]]s, [[small dripleaf]], [[big dripleaf]], and [[cave vines]].}}
{{History|||snap=21w11a|Bone meal can now be used on [[rooted dirt]].}}
{{History|||snap=21w15a|Bone meal now makes a sound when used.}}
{{History|||snap=21w16a|Moss patches obtained from fertilizing moss blocks contain less vegetation and are now smaller and more irregular in shape.
|Bone meal can now be used on [[azalea]] and [[flowering azalea]].}}
{{History||1.19|snap=22w11a|Bone meal can now be used on [[mangrove propagule]]s and [[mangrove leaves]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Bone meal can now be used on [[pink petals]] and [[torchflower crop]]s.|Using bone meal on [[cherry grove]]s now have a chance to generate [[pink petal]]s.}}
{{History||1.20|snap=23w12a|Bone meal can now be used on [[pitcher crop]]s.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Bone Meal JE1 BE1.png|32px]] Added bone meal. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.3|Bone meal can now be crafted from bones.
|Bone meal can now be applied to grass blocks and saplings.}}
{{History||v0.4.0|Added the first [[crop]]s, which bone meal can be applied to.}}
{{History||v0.8.0|snap=build 1|[[File:Bone Meal JE2 BE2.png|32px]] The texture of bone meal has been changed.
|Bone meal no longer instantly grows [[crop]]s to full size.
|Bone meal can now be used to craft white [[wool]].}}
{{History|||snap=build 5|[[Pumpkin]] and [[melon]] stems now grow by only one stage when bone meal is used.
|Some [[flower]]s now spawn certain other flowers when bone meal is used on them.
|Bone meal can now grow [[fern]]s and [[tall grass]] in [[survival]] and [[creative]].
|Bone meal can now grow [[sugar cane]]s to maximum height.}}
{{History||v0.9.0|snap=build 11|Bone meal can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Bone meal can now be used from [[dispenser]]s.
|Bone meal can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Bone meal can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Bone meal can now be used to craft white [[concrete powder]], white [[bed]]s and white [[shulker box]]es.}}
{{History||1.1.3|snap=alpha 1.1.3.0|Bone meal can now be used to craft [[bone block]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Bone meal can now be used to craft white [[stained glass]].
|Bone meal can now be used to craft [[firework star]]s.
|Bone meal can now be used to create [[banner]] patterns.}}
{{History||1.4.0|snap=beta 1.2.14.2|Bone meal can now be used underwater for growing [[seagrass]] and [[coral]].}}
{{History|||snap=beta 1.2.20.1|Bone meal can now be used for spreading [[sea pickle]]s.
|Bone meal can now be used to craft white [[balloon]]s and white [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Bone meal can now be used to grow [[bamboo]].}}
{{History|||snap=beta 1.8.0.10|Bone meal can now be used to craft [[white dye]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Bone meal are now sold by [[wandering trader]]s.
|[[File:Bone Meal JE3 BE3.png|32px]] The texture of bone meal has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Bone meal can now be obtained from [[composter]]s.}}
{{History||1.16.0|snap=beta 1.16.0.51|Bone meal can now grow [[fungus|fungi]] into [[huge fungi]].
|Bone meal can now be used to turn [[netherrack]] into [[nylium]].
|Bone meal can now be used to grow [[roots]], [[fungi]], and [[nether sprouts]] on nylium.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of bone meal has been changed from <code>dye/15</code> to <code>bone_meal</code>.}}
{{History||1.16.210|snap=beta 1.16.210.51|Bone meal used in [[water]] now has a chance of growing [[coral fan]]s.}}
{{History||1.16.220|snap=beta 1.16.220.52|Bone meal can now be used on [[moss block]]s, [[small dripleaf]], [[big dripleaf]], [[cave vines]] and [[rooted dirt]].}}
{{History||1.17.0|snap=beta 1.16.230.50|Bone meal can now be used to spread [[glow lichen]]s.}}
{{History|||snap=beta 1.16.230.54|Bone meal can be used to grow [[azalea]]s into azalea trees.}}
{{History|||snap=beta 1.17.0.50|Bone meal now makes a sound when used.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Bone Meal JE1 BE1.png|32px]] Added bone meal.}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|Bone meal no longer instantly grows [[crop]]s to full size.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bone Meal JE3 BE3.png|32px]] The texture of bone meal has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Bone Meal JE2 BE2.png|32px]] Added bone meal.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==

* Bone meal can be used on the sides or bottom of a [[grass block]], as well as on a grass block with [[plant]]s already on top of it.
* Regardless of if it succeeds in fertilizing, bone meal makes green sparkles. However, like smoke from a [[torch]], the sparkles appear only if the [[player]] has [[particles]] set All or Decreased.
* In real life, [[Wikipedia:bone meal|bone meal]] is used as a fertilizer to provide nitrogen and phosphorus to plants.

==Gallery==

<gallery>
File:Bone Meal On Grass.png|Bone meal used on [[grass block]]s.
</gallery>

== See also ==

* [[Farming]]

== References ==
{{reflist}}

{{Items}}

[[Category:Dyes]]
[[Category:Plants]]
[[Category:Renewable resources]]

[[cs:Kostní moučka]]
[[de:Knochenmehl]]
[[es:Polvo de hueso]]
[[fr:Poudre d'os]]
[[hu:Csontliszt]]
[[ja:骨粉]]
[[ko:뼛가루]]
[[nl:Beendermeel]]
[[pl:Mączka kostna]]
[[pt:Farinha de osso]]
[[ru:Костная мука]]
[[th:ผงกระดูก]]
[[zh:骨粉]]</li><li>[[Painting|Painting]]<br/>{{ItemEntity
|title=Painting
|image=Painting JE2 BE2.png
|extratext=View [[#Renders|all renders]]
|renewable=Yes
|stackable=Yes (64)
|drops=1 {{ItemLink|Painting}}
}}
'''Paintings''' are decorative [[entity|entities]] that hang on walls.

== Obtaining ==
=== Crafting ===
{{Crafting
|A1= Stick |B1= Stick    |C1= Stick
|A2= Stick |B2= Any Wool |C2= Stick
|A3= Stick |B3= Stick    |C3= Stick
|Output= Painting
|type= Decoration block
}}

Paintings can be crafted with any color of [[wool]]. The color of the wool used does not influence the picture chosen when the painting is placed.
Once placed, it displays a random painting.

=== Breaking ===
To remove a painting from a wall, the player can {{control|attack}} it, break one of its supporting blocks, cover one square of it with a block, hit it with an arrow, egg, ender pearl, snowball, or fire charge, or subject it to an explosion. The painting then drops as an item. Arrows that hit paintings disappear.

=== Trading ===
Master-level shepherd [[villager]]s sell 3 paintings for 2 [[emerald]]s.

== Usage ==
=== Placement ===
Paintings can be placed on the sides of [[solid block]]s, [[sign]]s, [[banner]]s, or [[sculk vein]]s . A small gap is visible between the painting and attachment surface. There are several different sizes of paintings (see below). When placed, a painting checks for the largest amount of space it has. It then chooses a random painting of that size. The player can add blocks around the painting to ensure it is the size wanted. When the supporting blocks are removed, the painting breaks after 20 game [[tick]]s (1 second) if no supporting blocks are replaced during that interval.

=== Properties ===
Being an entity, paintings can simultaneously exist in the same space as blocks such as water or torches. Specifically, they can share the space with any block whose collision box does not intersect its hitbox.

Players and mobs are able to walk through paintings, as long as the blocks supporting the painting allow it. Secret doorways can be created this way. [[Light]] propagates through paintings as well.

If a player is concealed behind a painting, the player's name is also concealed from other players.{{verify|Is this true in Bedrock?}}

Paintings are non-flammable.

== Canvases ==
There are 26 paintings in the game. These are mostly based on paintings by [[Kristoffer Zetterstrand]], who also created the ''Minecraft'' versions.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:150px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:3em" |Original
! style="min-width:3em" |Name
! style="min-width:3em;max-width:4.5em" |[[Resource location]]
! style="min-width:10em" |Description
! Java Edition version added
|-
! [[File:Alban (texture).png|64px]]
| rowspan="7" | 1×1 blocks<br>16×16 pixels || [https://zetterstrand.com/work/pictures/archive/alban.jpeg "Albanian"] || Albanian || <code>alban</code> || A man wearing a fez next to a house and a bush. As the name of the painting suggests, it may be a landscape in [[Wikipedia:Albania|Albania]]. || rowspan="9" | [[Indev 20100223]]
|-
! [[File:Aztec (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/2aztbig.jpg "de_aztec"]|| de_aztec || <code>aztec</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Aztec2 (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/11aztec_for_print.jpg "de_aztec"]|| de_aztec || <code>aztec2</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Bomb (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/12bomb.jpg "Target successfully bombed"]|| Target Successfully Bombed || <code>bomb</code> || The map [[w:c:counterstrike:Dust II|de_dust2]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]'', named “target successfully bombed" in reference to the game. 
|-
! [[File:Kebab (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/kebab2.jpg "Kebab med tre pepperoni"] || Kebab med tre pepperoni || <code>kebab</code> || A kebab with three green chili peppers. 
|-
! [[File:Plant (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/paradistrad.jpeg "Paradisträd"] || Paradisträd || <code>plant</code> || Still life of two plants in pots. "Paradisträd" is Swedish for "[[Wikipedia:Crassula ovata|money tree]]", which is a common name for the depicted species in Scandinavia. 
|-
! [[File:Wasteland (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Wasteland_1920.jpg "Wasteland"]|| Wasteland || <code>wasteland</code> || A view of some wastelands; a small animal (presumably a rabbit) is sitting on the window ledge. 
|-
! [[File:Courbet (texture).png|128px]]
| rowspan="5" | 2×1 blocks<br>32×16 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bonjourmonsieurcourbet_BIG.jpg "Bonjour monsieur Courbet"]|| Bonjour Monsieur Courbet || <code>courbet</code> || Two hikers with pointy beards seemingly greeting each other. Based on Gustave Courbet's painting ''[[Wikipedia:La rencontre|The Meeting or "Bonjour, Monsieur Courbet"]]''. 
|-
! [[File:Pool (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/thepool_1920.jpg "The pool"]|| The Pool || <code>pool</code> || Some men and women skinny-dipping in a pool over a cube of sorts. Also there is an old man resting in the lower-right edge. 
|-
! [[File:Sea (texture).png|128px]]
| rowspan=2 |[https://zetterstrand.com/eventz/wp-content/uploads/SeaSide_1920.jpg "Seaside"]
| Seaside
| <code>sea</code>
| Mountains and a lake, with a small photo of a mountain and a bright-colored plant on the window ledge. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Creebet (texture).png|128px]]
| Creebet || <code>creebet</code> || Mountains and a lake, with a small photo of a mountain and a creeper looking at the viewer through a window. || [[Alpha v1.1.1]]
|-
! [[File:Sunset (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/sunset_dense.jpg "sunset_dense"]|| sunset_dense || <code>sunset</code> || A view of mountains at sunset. || [[Indev 20100223]]
|-
! [[File:Graham (texture).png|64px]]
| rowspan="2" | 1×2 blocks<br>16×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/graham.jpg "Graham"]|| Graham || <code>graham</code> || King Graham, the player character in the video game series ''[[Wikipedia:King's Quest|King's Quest]]''. The original is based on ''[[Wikipedia:File:Sánchez_Cotán_(Bodegón_con_membrillo,_repollo,_melón_y_pepino).jpg|Still Life with Quince, Cabbage, Melon, and Cucumber]]'' by Juan Sánchez Cotán.|| [[Alpha v1.1.1]]
|-
! [[File:Wanderer (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/wanderer_1920.jpg "Wanderer"]|| Wanderer || <code>wanderer</code> || A version of Caspar David Friedrich's famous painting ''[[Wikipedia:Wanderer above the Sea of Fog|Wanderer above the Sea of Fog]]''. || rowspan="4" | [[Indev 20100223]]
|-
! [[File:Bust (texture).png|128px]]
| rowspan="6" | 2×2 blocks<br>32×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bust_1915.jpg "Bust"]|| Bust || <code>bust</code> || A bust of [[Wikipedia:Marcus Aurelius|Marcus Aurelius]] surrounded by fire. 
|-
! [[File:Match (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Match_rgb_1918.jpg "Match"]|| Match || <code>match</code> || A hand holding a match, causing fire on a white cubic gas fireplace. 
|-
! [[File:Skull and Roses (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/moonlight-installation_1920.jpg "Moonlight Installation"]|| Skull and Roses || <code>skull_and_roses</code> || A skeleton at night with red flowers in the foreground. The original painting was different, depicting a woman sitting in a couch, while the skull is in the middle of a body of glacial water of sorts. 
|-
! [[File:Stage (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/The-stage-is-set-1.jpg "The stage is set"]
| The Stage Is Set
| <code>stage</code>
| Scenery from ''[[Wikipedia:Space Quest I|Space Quest I]]'', with the character Graham from the video game series ''[[Wikipedia:King's Quest|King's Quest]]'' appearing twice. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Void (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/the-void_1920.jpg "The Void"]|| The void || <code>void</code> || An angel praying into a void with fire below. || [[Indev 20100223]]
|-
! [[File:Wither (painting texture).png‎|128px]]
| – || Wither || <code>wither</code> || The creation of a [[wither]]. 
This is the only painting not based on a real painting. Made by Jens Bergensten.<ref>{{Citation|url=https://www.youtube.com/watch?v=kK5Y4k-vVXc|title=Who Made Minecraft’s LAST Painting?!|author=AntVenom|website=YouTube|date=29 October 2022}}</ref><ref>https://www.reddit.com/r/Minecraft/comments/1tzav2/comment/cedagcy/</ref>
|| [[Java Edition 1.4.2]] ([[12w36a]])
|-
! [[File:Fighters (texture).png|128px]]
| 4×2 blocks<br>64×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/fighters.jpg "Fighters"]|| Fighters || <code>fighters</code> || Two men poised to fight. Paper versions of fighters from the game ''[[Wikipedia:International Karate +|International Karate +]]''. || [[Indev 20100223]]
|-
! [[File:Donkey Kong (texture).png|128px]]
| rowspan="2" | 4×3 blocks<br>64×48 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/kong.jpg "Kong"]|| Kong || <code>donkey_kong</code> || A paper-looking screenshot of the level [https://www.mariowiki.com/100m 100m] from the arcade game ''[[Wikipedia:Donkey Kong (arcade game)|Donkey Kong]]''. || rowspan="2" | [[Alpha v1.1.1]]
|-
! [[File:Skeleton (painting texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/mortal_coil.jpg "Mortal Coil"]|| Mortal Coil || <code>skeleton</code> || [[w:c:grim-fandango:Bruno Martinez|Bruno Martinez]] from the adventure game ''[[Wikipedia:Grim Fandango|Grim Fandango]]''. 
|-
! [[File:Burning Skull (texture).png‎|128px]]
| rowspan="3" | 4×4 blocks<br>64×64 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/skull_on_fire_framed_c_1910.jpg "Skull on Fire"]|| Skull On Fire || <code>burning_skull</code> || A Skull on fire; in the background there is a moon in a clear night sky.<br>This painting is based on a Minecraft screenshot,<ref>{{Citation|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|website=Imgur|date=22 August 2020|title=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH}}</ref> with the grass block and a 3D skull added on top.<ref>{{Citation|url=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|title=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|website=Imgur|date=23 August 2020}}</ref>
(See the [[:en:Painting#Trivia|trivia]] section for more info.)
| [[Java Edition Beta 1.2 01|Beta 1.2_01]] / [[Java Edition Beta 1.3|Beta 1.3]]
|-
! [[File:Pigscene (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/rgb_1914.jpg "RGB"]|| Pigscene || <code>pigscene</code> <!-- yes, without an underscore --> || A girl pointing to a pig on a canvas. In the original version, the canvas showed red, green and blue blocks, representing the three colors of the [[Wikipedia:RGB color model|RGB color model]] that is typically used by computer displays. It is based on the painting ''[[Wikipedia:File:Jacob van Oost (I) - The Artist's Studio - WGA16654.jpg|The Artist's Studio]]'' by Jacob van Oost.|| [[Alpha v1.1.1]]
|-
! [[File:Pointer (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/pointer_1920.jpg "Pointer"]|| Pointer || <code>pointer</code> || The main character of the game ''[[Wikipedia:International Karate +|International Karate +]]'' in a fighting stance touching a large hand. It could also be interpreted as a play on Michelangelo's famous painting ''[[Wikipedia:The Creation of Adam|The Creation of Adam]]''. || [[Indev 20100223]]
|}

=== Unused paintings ===
In [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]], with the addition of paintings to Pocket Edition, four unused 32×32 paintings were present in <samp>[[kz.png]]</samp> which remained unused. See {{slink|Bedrock Edition unused features|Paintings}} for more information. They were also added to Java Edition in snapshot [[Java Edition 22w16a|22w16a]]. They cannot be placed by default, but can be summoned by [[commands]] (such as {{cmd|/summon painting ~ ~ ~ {variant:"water"} }}) or through a [[datapack]].

According to [[Helen Zbihlyj]],<ref>https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 ([https://web.archive.org/web/20220422115723/https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 archived])</ref> these paintings were originally added "as part of a Pocket Edition promo map" (no footage found) which was planned to be a part of [[Pocket Edition]] promotion at [[MINECON 2012]] [[MINECON 2013|or 2013]] and have never been used in game. The artist of these paintings remains unknown.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:100px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:6em" |Name
! style="min-width:10em" |[[Resource location]]
! style="min-width:10em" |Description
! style="min-width:5em;max-width:10em" |Bedrock Edition version added
! style="min-width:5em;max-width:8em" |Java Edition version added
|-
! [[File:Earth (texture) BE2.png|128px]]
| rowspan="4" | 2×2 blocks<br>32×32 pixels || Earth || <code>earth</code> || One of the four {{Wikipedia|Classical element|classical elements}}: Earth. || rowspan="4" | [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]] || rowspan="4" | [[Java Edition 22w16a|22w16a]]
|-
! [[File:Fire (texture) BE2.png|128px]]
| Fire || <code>fire</code> || One of the four classical elements: Fire. 
|-
! [[File:Water (texture) BE2.png|128px]]
| Water || <code>water</code> || One of the four classical elements: Water. 
|-
! [[File:Wind (texture) BE2.png|128px]]
| Wind || <code>wind</code> || One of the four classical elements: Air. 
|}

==Sounds==
{{Edition|Java}}:
{{Sound table
|sound=Painting break1.ogg
|sound2=Painting break2.ogg
|sound3=Painting break3.ogg
|subtitle=Painting breaks<ref>{{Cite bug|MC|194948|Painting, item frame and lead breaking subtitles inconsistent with block breaking subtitle|date=July 14, 2020}}</ref>
|source=neutral
|description=When a painting is broken or pops off
|id=entity.painting.break
|translationkey=subtitles.entity.painting.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Painting place1.ogg
|sound2=Painting place2.ogg
|sound3=Painting place3.ogg
|sound4=Painting place4.ogg
|subtitle=Painting placed
|source=neutral
|description=When a painting is placed
|id=entity.painting.place
|translationkey=subtitles.entity.painting.place
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Item Frame break1.ogg
|sound2=Item Frame break2.ogg
|sound3=Item Frame break3.ogg
|source=block
|description=When a painting is broken or pops off
|id=block.itemframe.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Item Frame add item1.ogg
|sound2=Item Frame add item2.ogg
|soumd3=Item Frame add item3.ogg
|sound4=Item Frame add item4.ogg
|source=block
|description=When a painting is placed
|id=block.itemframe.add_item
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=item
|nameid=painting
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Painting
|spritetype=entity
|nameid=painting
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=item
|nameid=painting
|id=357
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=entity
|nameid=painting
|id=83
|foot=1}}

=== Entity data ===

Paintings have entity data that defines various properties of the entity.

{{el|java}}:
{{main|Entity format}}
{{/ED}}

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

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

== History ==
{{History|java indev}}
{{History||20100223|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 19 canvases, which can be viewed at [[Java Edition history of textures/Paintings]].
|The [[crafting]] recipe of paintings uses eight [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Oak Planks
  |B1=Oak Planks
  |C1=Oak Planks
  |A2=Oak Planks
  |B2=Light Gray Wool
  |C2=Oak Planks
  |A3=Oak Planks
  |B3=Oak Planks
  |C3=Oak Planks
  |Output=Painting
}}
{{!}}}
|Painting textures are currently stored on a [[texture atlas]] called <samp>[[kz.png]]</samp>.}}
{{History|java infdev}}
{{History||20100227-1|The [[crafting]] recipe has of paintings has been changed, so that it now uses [[stick]]s, rather than [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Stick
  |B1=Stick
  |C1=Stick
  |A2=Stick
  |B2=Light Gray Wool
  |C2=Stick
  |A3=Stick
  |B3=Stick
  |C3=Stick
  |Output=Painting
}}
{{!}}}
}}
{{History|java alpha}}
{{History||v1.1.1|Added five more painting canvases, for a total of 24.
|The textures of two paintings have been changed.}}
{{History|java beta}}
{{History||1.2_01|Added a new painting, although it uses an untextured part of <samp>kz.png</samp> due to the painting texture not yet being implemented.}}
{{History||1.3|The texture of the new painting, has been added to the part of <samp>kz.png</samp> displayed by the new painting.}}
{{History||April 27, 2011|link=https://web.archive.org/web/20201111211000/https://notch.tumblr.com/post/4988431144/the-maps|Custom paintings are mentioned by [[Notch]].}}
{{History||1.7.3|Paintings pushed by [[piston]]s now pop off.}}
{{History|java}}
{{History||1.4.2|snap=12w36a|Added new painting canvas 'Wither'.
|Paintings can now be placed overlapping one another.}}
{{History||1.8|snap=14w10a|Paintings can no longer be placed directly inside of each other.}}
{{History||1.9|snap=15w49a|Paintings can no longer be destroyed by [[lightning]].}}
{{History|||snap=15w50a|Added [[sound]]s for placing and breaking paintings: <code>entity.painting.place</code> and <code>entity.painting.break</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID for paintings has been changed from <code>Painting</code> to <code>painting</code>.}}
{{History||1.12|snap=17w06a|Paintings now have a more intuitive placement system. When placed, a painting always uses the maximum possible amount of available space.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 321.}}
{{History|||snap=18w02a|Paintings now use a [[resource location]] for their motive.}}
{{History||1.14|snap=18w43a|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History|||snap=19w07a|Paintings are now stored as individual image files instead of parts of a single large image file, and now support animations.}}
{{History|||snap=19w11a|Shepherd [[villager]]s now [[trading|sell]] paintings.}}
{{History||1.17|snap=21w11a|The painting back texture has been updated to be in line with the texture update.}}
{{History||1.19|snap=22w16a|Added the four unused paintings from Bedrock Edition: "Earth", "Wind", "Fire", and "Water".|These paintings can only be added through a [[data pack]], or with the {{cmd|summon}} command.}}
{{History||1.19.4|snap=23w06a|Added [[painting]] variants to "Functional Blocks" tab.|Paintings with pre-defined variant will now display author, title and size in description when hovered over.|The "Operator Utilities" tab now contains the four paintings that are not available in Survival mode.}}

{{History|pocket alpha}}
{{History||v0.5.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Bedrock Edition history of textures/Paintings]].}}
{{History||v0.8.0|snap=build 3|A new painting rendering has been added.{{info needed|What exactly changed?}}}}
{{History||v0.12.1|snap=build 1|Paintings are no longer available from the [[nether reactor]].}}
{{History||v0.15.0|snap=build 1|Paintings now have [[sound]]s when placed and broken.}}
{{History|pocket}}
{{History||1.0.7|Added new painting canvas 'Wither'.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Paintings can now be [[trading|bought]] from shepherd [[villager]]s.}}
{{History||1.17.0|snap=beta 1.17.0.50|The painting back texture has been updated to be in line with the texture update.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Legacy Console Edition history of textures/Paintings]].}}
{{History||xbox=TU11|The limit for paintings in a world has been increased. 
|A message is now displayed when the maximum paintings are reached.}}
{{History||xbox=TU14|ps=1.04|Added new painting canvas 'Wither'.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for paintings.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[New Nintendo 3DS Edition history of textures/Paintings]].}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* On April 26, 2011, Notch stated that the automapping code can be used to share custom paintings and books in the future.<ref>{{tweet|notch|62970142207913984|The auto mapping code can be used to share custom paintings and books in the future. There's a hard cap on 65536 of each/world, though|April 26, 2011}}</ref>
* The texture on the back of a painting is the same as the wooden planks texture, but with a yellowish color similar to that of [[chests]] (but slightly darker).
* The "Skull on Fire" painting contains a Minecraft world in the background, which is based on a screenshot taken by the artist in [[Java Edition Alpha v1.1.2 01|Alpha 1.1.2_01]] (or earlier) on October 12, 2010, at 13:22:49 (UTC+2).<ref>{{cite|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|title=The original (never publicly shared before) screenshot that Kristoffer Zetterstrand took and based his painting on.|website=Imgur}}</ref>
**The seeds for this world are -1044887956651363087 and -6984854390176336655 (both are the same), standing at X=-249.65, Y=91, Z=-29.04.<ref>https://pastebin.com/fzAY9ES4</ref><ref>https://www.reddit.com/r/Minecraft/comments/iqg3ey/the_original_screenshot_seed_of_the_minecraft/</ref>
* The "Skull on Fire" painting's texture was added in [[Java Edition Beta 1.3|Beta 1.3]]. However, the code for paintings to randomly display the part of the [[Kz.png]] texture that was to be occupied by the Burning Skull painting was added earlier, in [[Java Edition Beta 1.2_01|Beta 1.2_01]]. As there was nothing on this part of the texture except for a purple background grid, this is what would be displayed if the painting was randomly chosen, until the Burning Skull painting texture was actually added.
* The original "Skull on Fire" painting was given to the winner of an official texture pack competition by Mojang.<ref>https://web.archive.org/web/20110110003612/http://www.webhallen.com:80/minecraft/</ref>

== Gallery ==
<gallery>
File:Notch Painting Screenshot.png|The first image of paintings released by [[Notch]].
File:Skull on Fire world.jpg|The original screenshot behind the "Skull on Fire" painting.
File:Burning Skull Render.jpg|A render of the "Skull on Fire" painting that [[Kristoffer Zetterstrand]] used as a reference image.
File:Skull on Fire IRL.jpg|The original "Skull on Fire" painting being painted.
File:Burning Skull JE1.png|The "Skull on Fire" painting as it appeared between versions [[Java Edition Beta 1.2_01|Beta 1.2_01]] and [[Java Edition Beta 1.2_02|Beta 1.2_02]], prior to its texture being added in [[Java Edition Beta 1.3|Beta 1.3]].
</gallery>

=== Renders ===
<gallery>
Alban.png | Albanian
Aztec.png | de_aztec
Aztec2.png | de_aztec
Bomb.png | Target Successfully Bombed
Kebab.png | Kebab med tre pepperoni
Plant.png | Paradisträd
Wasteland.png | Wasteland
Courbet.png | Bonjour Monsieur Courbet
Creebet.png | Creebet
Pool.png | The Pool
Sea.png | Seaside
Sunset.png | sunset_dense
Graham.png | Graham
Wanderer.png | Wanderer
Bust.png | Bust
Match.png | Match
Skull and Roses.png | Skull and Roses
Stage.png | The Stage Is Set
Void.png | The void
Wither (painting).png | Wither
Fighters.png | Fighters
Donkey Kong.png | Kong
Skeleton (painting).png | Mortal Coil
Burning Skull.png | Skull On Fire
Pigscene.png | Pigscene
Pointer.png | Pointer
Earth BE2.png | Earth
Fire BE2.png | Fire
Water BE2.png | Water
Wind BE2.png | Wind
</gallery>

== See also ==
* [[Item Frame]]
* [[Bedrock Edition unused features#Paintings|Unused paintings]]
* [[Kz.png]]
* [[Kristoffer Zetterstrand]]

== References ==
{{reflist}}

== External links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-painting Taking Inventory: Painting] – Minecraft.net on January 18, 2019

{{items}}
{{entities}}

[[cs:Obraz]]
[[de:Gemälde]]
[[es:Cuadro]]
[[fr:Tableau]]
[[hu:Festmény]]
[[it:Quadro]]
[[ja:絵画]]
[[ko:그림]]
[[nl:Schilderij]]
[[pl:Obraz]]
[[pt:Quadro]]
[[ru:Картина]]
[[th:ภาพวาด]]
[[uk:Картина]]
[[zh:画]]</li></ul>
17w43aCustom functions have been moved into data packs.
17w45aFunctions are now completely parsed and cached on load.
17w49bFunction can now be tagged.
Functions tagged in minecraft:tick now run every tick in the beginning of the tick.

Issues

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

References

Advertisement