Minecraft Wiki
Register
Advertisement
This article is about the modern custom world type. For the world type before Java Edition 1.13, see Old Customized. For the Easter egg dimensions in Java Edition 20w14∞, see Java Edition 20w14∞ § World generation.
"Custom world" redirects here. For creating custom dimensions, see Custom dimension. For controlling world generation using data packs, see Custom world generation.
Information icon
This feature is exclusive to Java Edition. 

Custom is a world type that allow users to change the generation of the Overworld, Nether, and End dimensions as well as the ability to create custom dimensions. It is edited using a JSON file that is imported on the world creation screen.

Access

Custom world generation works using JSON files, which need to be imported before world creation.

In the world creation menu, go to more options and select the "Import World" option. Then, select a world generation JSON file. A warning appears saying that custom worlds are experimental. Click "Yes" to continue.

The only way to access added dimensions is through commands, such as /execute in <dimension name> run tp @s ~ ~ ~, which teleports the player to the specified dimension (see § JSON format).

JSON format

Jigsaw Block (top texture) JE2 BE2
This section needs expansion. 
You can help by expanding it.
Instructions: explanations on each component of the JSON file. Useful sources: [1], [2]

Custom generation files take the following format:

  • The root tag.
    •  bonus_chest (Boolean): Whether the world has a bonus chest or not (equivalent to the "Bonus chest" option).
    •  generate_features (Boolean): Whether structures should be generated or not (equivalent to the "Generate structures" option).
    •  seed (integer): The numerical seed of the world.
    •  legacy_custom_options (string): The custom world preset that was used to generate the world when it was an old customized world. Exists only for old customized worlds.
    •  dimensions: A list of the dimensions in this world where the key is the namespace ID of the dimension.
      • A dimension. The dimensions minecraft:overworld, minecraft:the_nether and minecraft:the_end are required for a well functioning world. Any other namespaced ID is allowed for custom dimensions.
        •  generator: Generation settings used for that dimension.
          •  type (string): The ID of the generator. Can be minecraft:flat for a superflat dimension, minecraft:noise for noise generation, or minecraft:debug for a debug dimension.
          • Other compounds (see below)
        •  type: This can be a list of options for the dimensions, the namespaced ID of a dimension type file in a data pack, or one of the four default dimension types (minecraft:overworld, minecraft:the_nether, minecraft:the_end, minecraft:overworld_caves).
          • Custom dimension/Data

Generator types

    •  type: The ID of the genarator. One of noise, flat, or debug.
      If  type is minecraft:noise, additional fields are as follows:
    •  settings: The noise settings used in this generator. Can be set to an ID of noise settings, or a object of noise_settings.
    •  biome_source: Settings dictating which biomes and biome shapes.
      •  type: The type of biome generation. One of multi_noise, fixed, checkerboard, or the_end.
        If type is multi_noise(3D biome generation used in the nether, and in the overworld in snapshot 21w37a and after.) , additional fields are as follows:
      •  preset: (mutually exclusive with  biomes) An ID or an object of a multi-noise biome source parameter list.
      •  biomes: (mutually exclusive with  preset) (Cannot be empty) A parameter list of biomes, including their IDs and target noise parameters.
        • : A biome and its properties.
          •  biome: The biome ID. A single biome ID may be repeated several times with different parameters.
          •  parameters: Represent optimal intervals for where the biome should be placed. These values do not affect the generation of terrain within biomes, instead, they only affect where the game chooses to place biomes. Thinking of a six-dimensional space, in the space these intervals are defined for biomes. If the six parameters at a location based on the noise router in noise settings fall into an interval, the corresponding biome is generated here. If the six parameters at a location do not fall into a defined biome interval in this list, it uses the closest biome interval to the 6D parameter point, in order to form a transition between biomes. Parameter combinations should be unique in the biomes list.
            • Noise parameter for biome (See Biome for usages of each parameter in vanilla game)
        If type is the_end(Biome generation used in the end with biome minecraft:the_end in the center and other end biomes around) , no additional field.
        If type is fixed(single biome) , additional fields are as follows:
      •  biome: The ID of the single biome to generate.
        If type is checkerboard(A biome generation in which biomes are square (or close to square) and repeat along the diagonals) , additional fields are as follows:
      •  biomes: A list of biomes that repeat along the diagonals. Can be a ID of biome or a tag of biome, or a list of biome IDs.
      •  scale: (optional, defaults to 2) Value between 0 and 62 (both inclusive). Determines the size of the squares on an exponential scale.
      If  type is minecraft:debug(used for Debug world generation) , no additional fields.
      If  type is minecraft:flat(used for Superflat world generation) , additional fields are as follows:
    •  settings: Superflat settings.
      • Flat generation settings


Defaults

Moved to Custom world generation#Noise settings

Noise generator preset defaults

These are the settings used by the 6 presets available for the minecraft:noise generator.

Structure defaults

These are the default values for all namespaced structures. Every preset uses the same values for all of these structures, with the exception of minecraft:ruined_portal.

*Placeholder values, have no effect

**Salt values aren't used for theses structures; changing them produces no effect }}

Biome parameter defaults

These are the default values used for each biome in the multi_noise biome_source. Interestingly, although only the values for nether biomes are accessible through a preset, several overworld biomes have default values as well.

Type defaults

These are the settings used by the 3 dimensions present in Vanilla and the additional Overworld Caves settings provided by Minecraft.

Examples

Jigsaw Block (top texture) JE2 BE2
This section needs expansion. 
You can help by expanding it.
Instructions: more examples and the actual info for what the default generator uses.

Default settings

The following is the settings for an exported default Minecraft world.

Expanded default settings

This file contains the same settings used to produce a default world, but with all of the presets expanded to their default values. Note that there is a bug that makes it impossible to create the ender dragon fight without using the dimension type preset minecraft:the_end, as the flag that creates the fight is hardcoded and not accessible through JSON. However, it is otherwise identical to the default world.

Custom superflat dimension

Custom superflat dimension

An overview of a world made with the adjacent settings.

This dimension is a Superflat world with a layer of grass on four layers of coarse dirt on top of five layers of basalt. The entire world is full of village houses as spacing is set to 3 (default: 32) and separation is set to 1 (default: 8). The words starts by default at time 1000.

History

Java Edition
May 15, 2018The return of customized worlds was mentioned.[1][2][3]
1.16
{{Extension DPL}}<ul><li>[[Map|Map]]<br/>{{about|the craftable map|maps showing the locations of certain structures|Explorer Map|other uses|Map (disambiguation)}}
{{distinguish|World}}
{{Item
| image = Map Zoom 4.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''map''' is an [[item]] used to view explored [[Chunk|terrain]] and mark landmarks.

==Obtaining==
===Crafting===
{{crafting
|head=1
|showname=0
|showdescription=1
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Compass
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description=This variation is called an "empty locator map" {{in|bedrock}}, or an "empty map" {{in|java}}.

When the player first creates a map, it is blank. It needs to be activated by holding it and pressing ''{{Control|use item}}''. after which it records terrain and location markers as the player travels within (or close to) the area it maps.
}}
{{crafting
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Paper
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description={{only|bedrock}}

This variation is called an "empty map". It does not show location markers. It is intended for cloning and zooming locator maps without having to consume an additional [[compass]] (thereby saving [[iron ingot]]s and [[redstone dust]]), but it can also be {{Control|use|text=activated}} and later converted to a locator map by combining it with a compass on an [[anvil]], [[crafting table]], or [[cartography table]].
|foot=1
}}

=== Natural generation ===
==== Chest loot ====
{{LootChestItem|empty-map,map 
}}

=== Cartography table ===
A map can also be created using a single paper on a [[cartography table]] to create an empty map, or a paper with a compass for an empty locator map.{{only|bedrock}}

=== Starting map ===
{{exclusive|bedrock|section=1}}
When creating a new world {{in|bedrock}}, the player can enable the "Starting Map" option to spawn with an empty locator map in the hotbar. The map's zoom scale is 1:8. The map is updated only while the player holds it.

=== Trading ===
Novice-level cartographer [[Villager|villagers]] sell a single empty map for 7 [[Emerald|emeralds]] as their trades.

{{IN|java}}, cartographer villagers may give players with the [[Hero of the Village]] effect an empty map.

== Usage ==
{{See also|Tutorials/Mapping}}

=== Mapping ===

Crafting a map creates an empty map. The map is drawn for the first time when it is held and used (with ''{{control|use item}}''). This map can then be adjusted to different zoom levels. After conversion to a drawn map item, it starts to draw a top-down view of the player's surroundings, with North pointing to the top of the map. A pointed oval pointer indicates the player's position on the map, and moves in real-time as the player moves across the terrain shown on the map. The map does ''not'' center on the player when created, rather, the world is broken up into large invisible grid squares, and the map displays the area of whichever grid square it is in when it is first used. For example, if a player uses a new map in a certain grid square, and then moves a distance away and uses another fresh map but is still within the same grid square, both maps appear identical. To make a map that is not identical to the first one, the player would have to move outside of the edges of the first map (because then they would be in a new grid square). This way, no two maps of the same size can ever partially overlap and every map can display only a fixed area.

To record the world on a map, that specific map must be held in the player's hands while the player moves around the world. The world is recorded as-is during exploration, meaning that if the world is modified, a player must revisit the area while holding the map to update the map's view. Maps can also be [[Map#Cloning|cloned]]. If a player holds a map whose one or more clones are on display in item frames, updates are made on all clone-connected maps. 

Other players are displayed on the map only if they have a map in their inventory cloned from the one being looked at. When placing a map into an [[item frame]], the map displays with a green pointer shown at the location of the item frame. This is to help the player see where they are in relation to the area that the map is showing. If the player leaves a map in an item frame and views a clone of it, the green pointer remains in the spot of the framed copy. This can be used to set up waypoints. Unexplored areas are transparent, making the item frame visible.

When the player leaves the area shown on a specific map, the player pointer transforms into a white dot that moves on that map. The marker shrinks to a smaller white dot if the player is far from the map's center: the area is 320 by 320 blocks per scale factor. The dot moves along the edge of the map to show the relative location of the player. However {{in|bedrock}}, the pointer remains as an arrow but shrinks until the player is near the area shown on the map.

While maps in [[the Nether]] work, they show only the red-and-gray pattern, regardless of the blocks placed. The only useful function is finding where the player is in relation to placed framed maps, which show as green pointers.  Additionally, the player pointer rapidly spins and is not a good indicator of direction. Placing a [[banner]] in [[the Nether]] still shows it on the map as usual.  Having a smaller map image while riding a [[strider]] in the Nether can help one to see one's footing while traveling over [[lava]].

{{IN|java}}, when using a map from another dimension, the map shows the player's position and direction when they were last in the dimension of the map. {{IN|bedrock}}, however, the player can use maps from one dimension while in another dimension. For locator maps, the place marker changes color depending on the dimension that the player is currently in (white for the Overworld, red for [[the Nether]], and magenta for [[the End]]). An Overworld map in the Nether shows the player's corresponding location and direction in the Overworld.<ref name=multiverse>{{ytl|EpP1diZdEdI}}</ref> Similarly, a Nether Map in the Overworld shows the player's corresponding location in the Overworld, but the place marker spins, just like a Nether map in the Nether. An Overworld map in the End shows the world spawn.<ref name=multiverse/> A Nether map cannot be used in the End — the map appears, but the place marker is not shown anywhere — and similarly, an End map cannot be used in the Overworld or the Nether.

A player can make a large piece of pixel art (128×128) facing upward, center a map on it, and place that map in an [[item frame]] to create a custom picture. Locking is recommended. See [[Map item format#Map Pixel Art]] for details on the techniques.

Maps display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the map is full-sized only when held in the dominant hand with both hands free.

A map always positions itself facing towards North when placed horizontally within an item frame regardless of how the map is placed.

=== Map content ===
{{Main|Map item format}}

Maps consist of square pixels arranged like pixels in a 128×128 square pattern, with each pixel representing a square portion of land. {{IN|java}}, the [[Map item format#Color table|color of a map pixel]] generally matches the color of the most common [[opaque]] block in the corresponding area, as seen from the sky. 'Minority blocks' in the target area have no effect on the color of the pixel, thus small features tend to be undetectable on zoomed-out maps.

{{IN|bedrock}}, the [[Map item format#Color table|color of a map pixel]] instead matches the single top-most opaque block in a grid sized by the map magnification pixel size (see the table in the "Player marker and pointer" section below). For example, a 3/4 magnification map has a pixel size of 8x8 blocks; this means the map will read only the top-most opaque blocks at the 0,0 coordinate, the 8,0 coordinate, the 0,8 coordinate, etcetera, ignoring all other blocks in the area. This means that {{in|bedrock}}, map pixel art requires only one block per pixel regardless of map magnification.

{{IN|bedrock}}, grass, foliage and water colors that are biome-dependent are represented accurately on a map.

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Map Zoom 4.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Map item BE.png|216px]]
|-
| Biome colors on ''Java Edition''.
| Biome colors on ''Bedrock Edition''.
|-
|}

Maps also show ground up to about 15 blocks below the surface of the water in oceans as slightly lighter blue, to show where the ground rises. This is not true with land above water. Higher elevations in the world mean lighter colors on the map. The map records the surface even as the player moves below the surface.

A standard map represents 128x128 blocks (1 block per pixel, 8x8 [[chunks]]) but maps can be zoomed-out to represent up to 2048x2048 blocks (16 square blocks per pixel, 128x128 [[chunks]]).

Some relevant distances: 64 blocks (4 chunks) is the update radius from a player in the Overworld and the End. However, it is half this (32 blocks) in the Nether. Also, 1024 blocks is the minimum Overworld distance from a [[nether portal]], at which players can build another portal and expect to reach a new location in the Nether. This is the distance across a 1:8 map, and also from a 1:16 map's center to its edge.

=== Player marker and pointer ===
{{IN|java}}, every map contains a marker that marks the position of the player, and points in the same direction as the player. When a player moves out of a map, a big white dot appears and moves relative to the player's position. The pointer either disappears when the player moves away a certain distance from the border of the map or, in case of [[explorer map]]s, the big white dot changes to a smaller white dot. The distance required for the small white dot to appear(explorer maps) or for the big dot to vanish (normal maps) changes with the scaling of the map.
* '''Level 0/4 :''' 128×128 blocks (each map pixel represents 1 block)
* '''Level 1/4 :''' 256×256 blocks (2×2 blocks per map pixel)
* '''Level 2/4 :''' 512×512 blocks (4×4 blocks per map pixel)
* '''Level 3/4 :''' 1024×1024 blocks (8×8 blocks per map pixel)
* '''Level 4/4 :'''  2048×2048 blocks  (16×16 blocks per map pixel)
{{IN|bedrock}}, a map can be crafted with or without this marker, and a map without a position marker can add one later by adding a compass to the map.  When a map is crafted without a compass, it's simply called an "empty map", but when crafted with a compass, it's called an "empty locator map". The marker also turns red if the player enters the Nether with an Overworld map and shows the player's Overworld location relative to the Nether location. A map created in the End has a purple marker showing the player's location. If an Overworld map is used in the End, a magenta dot appears on the player's spawn point.{{/BE|position}}
{{crafting
|name=Map<br>(with marker)
|ingredients=[[Map]] or Empty Map +<br>[[Compass]]
|showdescription=1
|Map (no markers);Empty Map 
|Compass
|Output= Locator Map;Empty Locator Map
|type= Miscellaneous
|description={{el|be}} only.
Maps crafted from only paper do not show the location marker; to add it, a compass must be added to the map.
|foot=1
}}

{{IN|bedrock}}, a cartography table can also be used to add a pointer to create a locator map or empty locator map. This can be done by adding a compass to paper, or to an empty map or map.

=== Zooming out ===
[[File:Cartography table UI zoom.png|thumb|300px|{{IN|java}}, cartography table's UI, showing the map is being zoomed out.]]

A [[cartography table]] can also be used to zoom out, taking only one piece of paper per zoom level.

A blank map can not be zoomed out. A map has to have something already marked on it for the zooming to be possible.

{{Crafting
  |A1= Paper |B1= Paper |C1= Paper
  |A2= Paper |B2= Map;Locator Map   |C2= Paper
  |A3= Paper |B3= Paper |C3= Paper
  |Output= Map;Locator Map
  |showdescription=1
  |description=Locator Map {{el|be}} only.
}}
{{/BE|zoom}}

==== Zoom details ====
The zooming function starts from when the map is created (zoom level 0) up to its fourth zoom step (zoom level 4).

{| class="wikitable" style="text-align: center" data-description="Zoom levels"
! colspan="2" | 
! Zoom step 0  
! Zoom step 1  
! Zoom step 2  
! Zoom step 3  
! Zoom step 4
|-
! colspan="2" |
| [[File:Map Zoom 0.png|116px|Zoom step 0, 1:1]]
| [[File:Map Zoom 1.png|116px|Zoom step 1, 1:2]]
| [[File:Map Zoom 2.png|116px|Zoom step 2, 1:4]]
| [[File:Map Zoom 3.png|116px|Zoom step 3, 1:8]]
| [[File:Map Zoom 4.png|116px|Zoom step 4, 1:16]]
|-
! colspan="2" | Zoom level
| 0/4
| 1/4
| 2/4
| 3/4
| 4/4
|-
! colspan="2" | 1 map pixel represents
| 1 block
| 2×2 blocks
| 4×4 blocks
| 8×8 blocks
| 16×16 blocks<br>(1×1 chunk)
|-
! colspan="2" | Scaling ratio
| 1:1
| 1:2
| 1:4
| 1:8
| 1:16
|-
! rowspan="2" colspan="2" | Map covers an area of
| 128×128 blocks
| 256×256 blocks
| 512×512 blocks
| 1024×1024 blocks
| 2048×2048 blocks
|-
| 8×8 chunks
| 16×16 chunks
| 32×32 chunks
| 64×64 chunks
| 128×128 chunks
|-
! colspan="2" | Smallest discernible features
| Blocks
| Trees, Paths
| Lakes, Buildings
| Mountains, Rivers
| Biomes, Mountain Ranges
|-
! colspan="2" | Use cases
| Pixel art, Base plans
| Base surroundings
| Structure mapping
| Landscape mapping
| Biome mapping
|-
! rowspan="2" | Total paper needed to zoom out from Level 0
! in anvil{{only|bedrock|short=1}} or crafting table
| -
| {{ItemSprite|Paper}} 8
| {{ItemSprite|Paper}} 16
| {{ItemSprite|Paper}} 24
| {{ItemSprite|Paper}} 32
|-
! in cartography table
| -
| {{ItemSprite|Paper}} 1
| {{ItemSprite|Paper}} 2
| {{ItemSprite|Paper}} 3
| {{ItemSprite|Paper}} 4
|}

Maps are always aligned to a grid at all zoom levels. That means zooming out any different map in a specific area covered by that map always has the same center. As such, maps are aligned by map width (1024 blocks for a level 3 maps) minus 64. A level 3 map generated at spawn covers X and Z coordinates from -64 to 959. All maps generated in this area zoom out to the same coordinates, guaranteeing that they are always 'aligned' on a map wall. For a zoomed-out map to cover a new area, it must start with a base (level 0) map that is in that area.

At zoom level 0, a map created on the point (0,0) has (0,0) at the center of the map. At higher zoom levels of the same map, the coordinate (0,0) is in the top left square of the map.

{{IN|java}}, zoom level can be seen on a map by turning on Advanced Tooltips (a [[Debug screen#More debug keys|debug screen]] option that can be toggled by using the key combination {{key|F3+H}}). The tooltip of the map then shows the zoom level, scaling factors, and map ID.

=== Cloning ===
[[File:Cartography table UI clone.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being cloned.]]

A mix of empty maps and empty locator maps may be used. Whether the cloned maps show position markers is dependent only on the input map.

A [[cartography table]] can also be used to clone a map.

The parts of the world that have already been explored and mapped are copied, and newly explored areas appear on both instances. If one of the maps is later zoomed out, then the maps lose their connection to each other and function as completely separate maps that have to be individually filled by exploring.

In Creative mode, a map in an item frame may be cloned by using {{control|pick block}} on it, as long as that map is not also in the player's inventory.

It doesn't matter if the map to be cloned is at a higher zoom level (made of more paper) than the blank map. Upon copying the map, both resulting maps have the same magnification as the starting map.

{{/BE|clone}}

=== Crafting ingredient ===

{{crafting usage|Map, Empty Map}}

=== Marking points ===
{{IN|java}} the player has the ability to mark spots on a map. To do this, {{control|use}} a map on a placed-down [[banner]], and the spot of the banner gets marked on the map. The mark takes the color of whatever the base color is for the banner, and if the banner has a name, the mark shows that name. Banner marks on a map are always oriented with their top facing north, regardless of the banner's actual orientation. If the banner is destroyed, the mark of the banner remains at first, but if the player gets closer to where the banner previously was, it disappears as the area is updated on the map.

If a map is mounted on an item frame and is within the area it depicts, the mounted map displays its current location with a green indicator rotated to match its orientation.

[[File:Map Marker Bedrock on Item frame.png|thumb|181x181px|{{IN|bedrock}} this is what a map lying on an item frame looks like, while showing markers.]]
{{IN|bedrock}} the player can place copies of locator maps in [[item frame]]s in order to create a land mark. The marker is a green dot that resembles the shape of the player's marker, but in green color. The position the marker points at depends on the direction the item frame is facing. It is worth noting that the markers work only on copies of the same map. Other maps of the same area do not show the existing markers that the player(s) had placed.

If a player has a cloned map in their inventory, their pointer appears white when viewed on the same map held by another player. Hence, if all players have the same cloned map in their inventory, all markers would appear white when the clone map is viewed. 

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Tracking map with markers bedrock.png|216px]]
|-
| How every banner appears {{IN|java}} on a map, including named banners.
| {{IN|bedrock}} this is how a locator map shows map markers while held by a player.
|-
|}

===Locking===
[[File:Cartography table UI lock.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being locked.]]

Maps can be locked when using a [[glass pane]] in a [[cartography table]]. This creates a new map containing the same data and locks it. All copies of this new map are also locked. A locked map never changes, even when the depicted terrain changes. {{IN|Be}}, locked maps have a unique texture.

{| class="wikitable" style="text-align: center;"
|-
! Condition
! style="width: 200px;" | Newly created map
! style="width: 200px;" | Map after terrain alteration
|-
! Unlocked map
| [[File:Map Zoom 0.png|174px]] || [[File:Unlocked Map.png|174px]]
|-
! Locked map
| [[File:Map Zoom 0.png|174px]] || [[File:Map Zoom 0.png|174px]]
|-
|}

{{-}}

== Sounds ==
{{Edition|Java}}:
{{Sound table
|rowspan=2
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|subtitle=Map drawn
|source=player
|description=When a map is drawn
|id=ui.cartography_table.take_result
|translationkey=subtitles.ui.cartography_table.take_result
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Map drawn
|source=block
|description=When a 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}}:
{{Sound table
|type=bedrock
|rowspan=2
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|source=block
|description=When a map is drawn<wbr>{{Upcoming|BE 1.20.20.20}}
|id=ui.cartography_table.take_result|idnote={{Verify|Could be block.cartography_table.use}}
|volume=0.8
|pitch=1.0}}
{{Sound table
|type=bedrock
|source=block
|description=When a map is edited using a cartography table
|id=ui.cartography_table.take_result
|volume=0.8
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=map
|form=item}}
{{ID table
|displayname=Map
|spritetype=item
|nameid=filled_map
|form=item
|translationkey=item.minecraft.filled_map, filled_map.buried_treasure, filled_map.explorer_jungle{{upcoming|java 1.20.2}}, filled_map.explorer_swamp{{upcoming|java 1.20.2}}, filled_map.mansion, filled_map.monument, filled_map.unknown, filled_map.village_desert{{upcoming|java 1.20.2}}, filled_map.village_plains{{upcoming|java 1.20.2}}, filled_map.village_savanna{{upcoming|java 1.20.2}}, filled_map.village_snowy{{upcoming|java 1.20.2}}, filled_map.village_taiga{{upcoming|java 1.20.2}}
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=empty_map
|aliasid=emptymap
|id=515
|form=item
|translationkey=item.emptyMap.name, item.emptyLocatorMap.name}}
{{ID table
|displayname=Map
|spritetype=item
|spritename=map-be
|nameid=filled_map
|aliasid=map
|id=420
|form=item
|translationkey=item.map.name, item.map.exploration.mansion.name, item.map.exploration.monument.name, item.map.exploration.treasure.name
|foot=1}}

=== Metadata ===
{{see also|Bedrock Edition data values}}
{{IN|bedrock}}, maps use the following data values:

{{/DV}}

=== Item data ===
{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Maps}}
</div>

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

=== Map icons ===
{{see also|Player.dat format|Map item format|map_icons.png}}
Map icons are 8×8 in ''Java Edition'', but 16×16 in Bedrock Edition. As such, there are minor misalignment issues in ''Java Edition''.<ref>{{bug|MC-214649|||WF}}</ref>
[[File:Map icons.png|thumb|128px|Map icons texture {{in|Java}}]]
[[File:Map icons BE.png|thumb|128px|Map icons texture {{in|Bedrock}}]]

{| class="wikitable"
|-
! Java ID !! Bedrock ID !! Text ID !! Appearance !! Purpose !! Shown in item frames?
|-
| 0 ||  ||<code>player</code> || [[File:Player (texture) JE1 BE1.png|16px]] [[File:Player (texture) BE2.png|16px]] White marker || Players (on map) || No
|-
| 1 || 1 ||<code>frame</code> || [[File:Green Marker (texture) JE1 BE1.png|16px]] [[File:Green Marker (texture) BE2.png|16px]] Green marker || The current map in an item frame || Yes
|-
| 2 ||  ||<code>red_marker</code> || [[File:Red Marker (texture) JE1 BE1.png|16px]] [[File:Red Marker (texture) BE2.png|16px]] Red marker || Position converted to Overworld when opening Overworld map in the Nether{{Only|bedrock}} || No
|-
| 3 ||  ||<code>blue_marker</code> || [[File:Blue Marker (texture) JE1 BE1.png|16px]] [[File:Blue Marker (texture) BE2.png|16px]] Blue marker || Other players || No
|-
| 4 ||  ||<code>target_x</code> || [[File:Target X (texture) JE1 BE1.png|16px]] White X || Unused || Yes
|-
| 5 ||5
|<code>target_point</code> || [[File:Target Point (texture) JE1 BE1.png|16px]] [[File:Target Point (texture) BE2.png|16px]] Red triangle || Unused || Yes
|-
| 6 || 6 ||<code>player_off_map</code> || [[File:Player Off Map (texture) JE1 BE1.png|16px]] Large white dot || Players off map, nearby{{only|java}} || No
|-
| 7 || 13 ||<code>player_off_limits</code> || [[File:Player Off Limits (texture) JE1.png|16px]] [[File:Player Off Limits (texture) BE.png|16px]] Small white dot || Players off map, far away{{only|java}} || No
|-
| 8 ||14
|<code>mansion</code> || [[File:Mansion (texture) JE1.png|16px]] [[File:Mansion (Texture) BE2.png|frameless|16x16px]] Woodland mansion || Woodland mansion || Yes
|-
| 9 || 15 ||<code>monument</code> || [[File:Monument (texture) JE1.png|16px]] [[File:Monument Texture BE2.png|frameless|16x16px]] Ocean monument || Ocean monument || Yes
|-
| 10 - 25 ||  ||<code>{{tooltip|banner_*|banner_white, banner_orange, banner_magenta, banner_light_blue, banner_yellow, banner_lime, banner_pink, banner_gray, banner_light_gray, banner_cyan, banner_purple, banner_blue, banner_brown, banner_green, banner_red, banner_black}}</code> || [[File:Banner White (texture) JE1.png|16px]] [[File:Banner Light Gray (texture) JE1.png|16px]] [[File:Banner Gray (texture) JE1.png|16px]] [[File:Banner Black (texture) JE1.png|16px]] [[File:Banner Brown (texture) JE1.png|16px]] [[File:Banner Red (texture) JE1.png|16px]] [[File:Banner Orange (texture) JE1.png|16px]] [[File:Banner Yellow (texture) JE1.png|16px]] [[File:Banner Lime (texture) JE1.png|16px]] [[File:Banner Green (texture) JE1.png|16px]] [[File:Banner Cyan (texture) JE1.png|16px]] [[File:Banner Light Blue (texture) JE1.png|16px]] [[File:Banner Blue (texture) JE1.png|16px]] [[File:Banner Magenta (texture) JE1.png|16px]] [[File:Banner Purple (texture) JE1.png|16px]] [[File:Banner Pink (texture) JE1.png|16px]]<br>Banners in all 16 wool colors{{only|java}}|| Banner markers || Yes
|-
| 26 ||4
|<code>red_x</code> || [[File:Red X (texture) JE1.png|16px]] [[File:Target X (texture) BE2.png|16px]] Red X || Buried treasure || Yes
|-
| || 8 || || [[File:Magenta Marker (texture) BE1.png|16px]] Magenta marker
| Position converted to Overworld when opening Overworld map in the End{{Only|bedrock}} || No 
|-
| || 9 || || [[File:Orange Marker (texture) BE1.png|16px]] Orange marker{{more info}}
|Other players
|Yes
|-
| || 10 || || [[File:Yellow Marker (texture) BE1.png|16px]] Yellow marker
| Other players || No
|-
| || 11 || || [[File:Cyan Marker (texture) BE1.png|16px]] Cyan marker
| Other players || No
|- 
| -
|12
| || [[File:Green Point (texture) BE1.png|16px]] Green Triangle
| Other structure such as stronghold, fortress, end city, etc. when used as explorer map destination{{Only|bedrock}} || Yes
|}
It should be noted that even if the player used a NBT editor to add an additional icon on the map, ''Minecraft'' shows only the first one listed when the player loads up their world.

== Achievements ==
{{load achievements|Map Room}}

== History ==
{{see also|section=24|map_icons.png|Java Edition history of textures#Map icons}}
{{more images|section=24|{{bug|MC-72962}}}}
{{History||April 27, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps|[[Notch]] unveiled screenshots of the map.}}
{{History||April 28, 2011|link={{tweet|notch|63500114005721088}}|[[Notch]] said that he would try to make maps place-able on [[wall]]s.}}
{{History|java beta}}
{{History||1.6|snap=Test Build 3|[[File:Map (item) JE1 BE1.png|32px]] Added maps.}}
{{History||1.6.6|The ability to auto-craft maps using shift-click has been disabled.}}
{{History||1.8|snap=Pre-release|Maps can now be found in library chests in the brand-new [[stronghold]]s.
|Auto crafting maps has been restored. Map cloning, therefore, is unavailable for a period of time.}}
{{History||1.8.1|Maps now work both while walking and flying.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 5|Prior to this update, the [[sun]] in ''[[Minecraft]]'' rose in the North, which threw off many [[player]]s and led to a common misconception that ''Minecraft'' maps/[[world]]s were oriented with East at the top. The sun now rises in the east and sets in the west, making navigation much more intuitive.
|Before the change in sun position, it was commonly said that ''Minecraft'' maps/worlds are oriented with East at the top; sunrise, by definition, occurs at the East, which means it is certainly true that the maps were oriented "East" since the Sun rose from the top (North). However, [[Jeb]] asserted (and [[Notch]] agreed) that the sun rose in the north.<ref>{{Tweet|jeb|87815841160237056}}</ref><ref>{{Tweet|notch|88155424880201728}}</ref> Most mods and map-making tools, however, used the terms East and North consistent with their actual definitions (e.g. a [[Programs and editors/Cartograph|Cartograph]]-generated map with North at the top is rotated 90 degrees from the in-game map).}}
{{History||1.4.2|snap=12w34a|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now creates an empty map. The map is drawn for the first time when it is held and right clicked, and is centered near the location of the [[player]] when clicked (not as before where it was centered on the location it was crafted.)
|Previously, in order to map a new area, the map had to be ''crafted'' in that area (rather than carrying a previously-crafted map to the new area). The point where a map is crafted becomes its permanent center, and could never be changed. 
|The pointer no longer disappears when leaving the map, but transforms into a white dot, indicating on what side of the map the player is located.
|Maps now align to a grid, making it easier to create adjacent maps.
|Maps can now be zoomed out (but not zoomed in).
|Maps can now be cloned and scaled.}}
{{History||1.4.2|snap=12w34b|Maps now have a ''zoom level'', which was fixed at 1:8 prior to snapshot [[Java Edition 12w34a|12w34a]],<ref name="mapinfo">https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps</ref> but  now starts at 1:1 and can be increased up to 1:16 by re-crafting an existing map.
|Maps are no longer numbered on the top-left corner and is labeled through the tooltip.}}
{{History|||snap=12w36a|New maps are now crafted at a scale factor of 1:1. A zoomed in map can be zoomed out by re-crafting it with another 8 sheets of [[paper]] on a [[crafting table]]. Each time this is done, the scale increases - 1:1, 1:2, 1:4, 1:8, 1:16 with a map scale of 1:16 being the current maximum.}}
{{History||1.7.2|snap=13w38a|The map size has been increased when placed on a [[wall]] using the [[item frame]].
|More colors have been added to maps for different [[block]]s.<ref name="infodump2">https://web.archive.org/web/0/https://www.mojang.com/2013/10/minecraft-1-7-the-update-that-changed-the-world</ref>}}
{{History||1.8|snap=14w31a|Zoomed maps now conform to an expanded grid based on their zoom level. Previously, careful considerations would need to be taken to creating a wall of adjoining maps.}}
{{History||1.8.1|snap=pre1|Some colors have been changed on maps to more accurately represent their respective [[block]].}}
{{History||1.9|snap=15w31a|Maps now display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the (old) large version is visible only when held in the dominant hand with the secondary hand free.}}
{{History|||snap=15w34a|New maps can now be [[crafting|crafted]] at a scale factor of 1:4.
|A crafting recipe has been added for zooming in maps.}}
{{History|||snap=15w43a|The average yield of empty maps from [[stronghold]] library [[chest]]s has been doubled.}}
{{History|||snap=15w45a|New maps are once again [[crafting|crafted]] at a scale factor of 1:1, as they had been before snapshot [[15w34a]].
|The [[crafting]] recipe, that was introduced in 15w34a, for zooming in maps has been removed.}}
{{History|||snap=15w49a|Map making now uses armor equipping sounds.}}
{{History||1.11|snap=16w39a|Maps now work in [[the End]].
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s as their tier 3 [[trading|trade]].
|Added [[explorer map]]s, sold by cartographers as their tier 4 trades.}}
{{History||1.12|snap=17w17a|Maps now have separate colors for colored [[terracotta]] blocks from other colored blocks.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 358 and 395.
|Maps now use additional NBT to specify which map they contain. Prior to this version, they used the [[damage]] value instead.
|Map IDs are no longer limited to 32,768.}}
{{History|||snap=17w50a|Maps can now be placed on floor and ceiling [[item frame]]s.}}
{{History|||snap=18w10a|Spots on maps can now be marked using [[banner]]s.}}
{{History|||snap=18w11a|Empty maps can now generate in [[shipwreck]] [[chest]]s.}}
{{History|||snap=pre7|Maps have been changed slightly, in regard to which [[block]]s are shown and which blocks are not.}}
{{History||1.14|snap=18w43a|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History|||snap=18w48a|Empty maps can now be found in chests in [[village]] cartographer houses.}}
{{History|||snap=19w02a|Maps can now be cloned and zoomed out (extended) by using a [[cartography table]].
|Maps can now be locked by using a [[glass pane]] with a cartography table.
|The recipes for cloning and zooming out maps have been removed.}}
{{History|||snap=19w06a|Map making is now silent again.}}
{{History|||snap=19w13a|Cartographer villagers now give empty maps to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w21a|Map making sounds are now the same as when using a cartography table.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Empty Map JE1 BE1.png|32px]] [[File:Map (item) JE1 BE1.png|32px]] Added maps.
|Maps are crafted using nine [[paper]], one for every slot of the [[crafting]] grid.
|Maps must be combined with a [[compass]] using an [[anvil]] in order to show the [[player]]'s position.
|Maps can be zoomed using an anvil.}}
{{History|||snap=build 3|New maps are now [[crafting|crafted]] at full zoom.
|Empty maps now have a "Create Map" button to initialize them.}}
{{History|||snap=build 7|New maps are now crafted at a scale factor of 1:1.}}
{{History||v0.15.0|snap=unknown|Maps can now be crafted either with 8 pieces of [[paper]] and a [[compass]] ''or'' 9 pieces of paper, to get a map with or without a position marker.}}
{{History||v0.16.0|snap=build 1|Different colors have been added to maps for different [[biome]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=?|[[Windows 10 Edition]] can now use the [[anvil]] as well as the [[crafting table]] to clone, zoom and apply markers, just as [[Pocket Edition]] in general could.
|Maps can now be found inside [[stronghold]] library [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Empty maps with direction markers built-in are now called "locator maps".}}
{{History|||snap=alpha 1.1.0.3|"Locator maps" are now called "empty locator maps".
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s for 7-11 [[emerald]]s as their tier 3 [[trading|trade]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Maps can now be found inside map room [[chest]]s in [[shipwreck]]s.}}
{{History||?|The texture of the filled map overlay has been changed.}}
{{History||?|Maps now function in dimensions other than the dimension in which they were created.}}
{{History||1.10.0|snap=beta 1.10.0.3|Maps can now be found in cartographer house [[chest]]s in [[village]]s.
|[[File:Empty Map JE2 BE2.png|32px]] The texture of empty maps has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Empty maps can now be created from 1 [[paper]] in [[cartography table]]s.
|Maps can now be zoomed, cloned, renamed, and have pointers added in cartography tables.}}
{{History|||snap=beta 1.11.0.4|Cartographer [[villager]]s now [[trading|sell]] empty map for an [[emerald]] as their first tier [[trading|trades]].
|Empty locator maps can now be [[trading|bought]] from cartographer villagers.}}
{{History||1.13.0|snap=beta 1.13.0.1|[[File:Map (item) BE3.png|32px]] [[File:Locked Map (item) BE2.png|32px]] Filled maps and locked maps now have unique inventory icons.}}
{{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed, novice-level cartographer now sell an empty map for 7 emeralds. Cartographer villager no longer sell empty locator map.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of maps have been changed from <code>emptymap</code> to <code>empty_map</code> and <code>map</code> to <code>filled_map</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Map (item) JE1 BE1.png|32px]] Added maps. 
|The [[player]] spawns with a free map. 
|Maps are available only as zoom step 3 maps centered at coordinates 0,0. Biome colors do not appear on maps.}}
{{History||xbox=none|xbone=CU1|ps=1.0|wiiu=none|Larger sized worlds on Xbox One, Playstation 4, and Nintendo Switch have zoom step 3 maps aligned to a grid with maps centered at 0, 1024, or 2048 on the X or Z coordinates.}}
{{History||xbox=TU21|xbone=CU9|ps=1.14|wiiu=Patch 1|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now produces an empty map.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The outer end islands appear on different maps; even on Xbox 360, Playstation 3, Vita, and Wii U editions.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History||ps=1.91|Maps can now be created and used in [[cartography table]]s.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Use of the {{key|F1}} key can allow the player to hold a map without blocking their view at all.
* In ''Java Edition'', a map created using {{cmd|give}} can be any map by using the Map parameter to specify the map number desired. E.g. {{cmd|give [player] minecraft:filled_map{map:5<nowiki>}}} gives the specified player map_5. If no data value is supplied it defaults to map_0. If map_0 has not ever been crafted, it is centered on x=0, z=0.
* The maps are stored separately as their own data (<code>.dat</code>) file as <code>map_x.dat</code> with (x) being the map number, see [[map item format]] for more info. By manipulating this number, players can organize their maps to suit them, or if they accidentally create a map in the same location, they can delete their extra map so as to save the number they make.
* Certain programs can be used to make customized maps with images or text on them instead of actual maps, many people use these in adventure maps to show pictures or to tell a story.
* Since all copies of a map are links to the same file, copying an unfinished map keeps it synchronized with the copy as the player fills it in. Thus, a copy stored in a chest can act as a remote backup.
* A map that is in an item frame does not update itself until a player picks it up, lets it reload, and places it back again. However, if a player holds a clone of the map, both maps update.
* Filled maps are the only items that make 90 degree rotations in item frames, and also the only items that can expand the item frame into full block wide.
* On [[Legacy Console Edition]], the player always spawns with a map in their inventory after creating a world. This was later added to Bedrock Edition as an optional feature in the world creation menu.
* Maps on Legacy Console Edition always show the player's current coordinates, as a substitute for the optional [[Coordinates|coordinate display]] in other editions.
* A map cannot be created on [[New Nintendo 3DS Edition]]. Instead, the map is always displayed on the bottom screen along with the coordinates. Biome colors do not appear on maps.

== Gallery ==
<gallery>
MapItem1.png|A fully zoomed map.
MapRotation.png|Having a map in hand does not stop the ability to see ahead.
MapItem3.png|A world being recorded onto a map.
Mcmap4.png|Nearly fully explored map.
Zoomed Map.png|A map edited to the scale of 1.
Sky Map.png|A map mapping the [[Sky Dimension]].
MapOfVillage.png|A village and how it is represented on a map.
Pumpkin map.png|A map containing a custom image made by placing a large number of blocks.
Complete Map.png|A completely explored map.
MapZooms.png|A diagram showing how maps zoomed out before [[Java Edition 1.8]]. Notice how the larger maps have borders made of half and quarter small maps.
Map18zooms.png|From 1.8, zoomed maps are aligned to this grid exactly.
Large Biome Map.png|A map of a [[Large Biomes]] world.
Map0140-0160.png|A comparison of maps between versions in Pocket Edition Alpha [[Pocket Edition Alpha 0.14.0|0.14.0]] and [[Pocket Edition Alpha 0.16.0|0.16.0]].
Mycelium Map.png|A map view of a mushroom biome, showing that mycelium appears purple on a map.
MiniMap.png|Maps held in the off-hand or in either hand while [[dual wielding]] appear as mini-maps.
Partly filled treasure map.png|Partly filled treasure map with an odd area at the bottom left. Normally a partly filled map would look striped (as in the top left), but this map seems to be bugged and is possibly showing caves, or something, in the bottom left.
Partly filled ocean explorer map.png|Partly filled ocean explorer map. Updating the game from an older version (in this case the area was first generated before 1.18) and buying a map after updating (in this case in 1.19.4) can result in the map displaying rivers and terrain where there is really a frozen sea.
Map Stained Glass 1.png|Stained glasses' appearances on maps before and after 1.13.
Map Stained Glass 2.png|Stained glasses' appearances on maps before and after 1.13.
Map Various Blocks 1.png|Various blocks' appearances on maps before and after 1.13.
Map Various Blocks 2.png|Various blocks' appearances on maps before and after 1.13.
Better Together Map.jpg|Holding a map in the offhand in ''Bedrock Edition''.
Better Together Map Icon.jpg|Holding a map in both hands in ''Bedrock Edition''.
</gallery>

=== The Nether ===
<gallery>
Nethermap.png|A map in [[the Nether]].
Maponnether.png|A map in the Nether; the arrow turns around itself, like in [[compass]].
</gallery>

=== The End ===
<gallery>
Jeb End Map.png|The first image of a map in [[the End]].
Endmap.png|A map in the End.
</gallery>

=== Maps in item frames ===
<gallery>
FramedMap.png|A map displayed on an item frame, as it looked before [[Java Edition 1.7.2]].
Structure Map Collection.png|Multiple maps in item frames. Notice a [[village]], two [[desert temple]]s and a lava lake.
Minecraft maps 3by3.png|A collection of 9 connected full maps.
Full Map.png|A combination of 25 maps pasted together as one map.
Map wall BE.png|A map wall on ''Bedrock Edition'', showing large areas of biome colors for each biome.
Map's in item frames.png|Maps can be placed into [[item frame]]s so they can be viewed together.
Comparing Maps.png|The comparison between 3 zooms of maps.
SuperflatMap.png|A map in a [[Superflat]] world, with some [[village]]s.
MapWallWithMarkers.png|A 3x3 map wall with banner markers.
HEYYEYAAEYAAAEYAEYAA.png|He-Man map art.
Map Player Icons 1.png|First image of player icons on maps.
Map Player Icons 2.png|Second image of player icons on maps.
</gallery>

== See also ==
* [[Explorer Map]]
* [[Clock]]
* [[Tutorials/Navigation|Navigation]]

== References ==
{{Reflist}}

{{Items}}

[[cs:Mapa]]
[[de:Karte]]
[[es:Mapa]]
[[fr:Carte (objet)]]
[[hu:Térkép (tárgy)]]
[[ja:地図]]
[[ko:지도]]
[[nl:Kaart]]
[[pl:Mapa]]
[[pt:Mapa]]
[[ru:Карта]]
[[tr:Harita]]
[[th:แผนที่]]
[[uk:Мапа]]
[[zh:地图]]
[[Category:Renewable resources]]</li><li>[[Bundle|Bundle]]<br/>{{Experimental feature|bundle}}
{{planned|BE}}
{{Item
| image = Bundle.png
| image2 = Bundle Filled.png
| rarity = Common
| renewable = No
| stackable = No
}}

A '''bundle''' is an [[item]] that can store up to a stack's worth of mixed [[item]] types within itself in a single [[inventory]] slot. Items that stack to 16 occupy more space within the bundle, and items that do not stack occupy the entire bundle without allowing space for any other items.

== Obtaining ==

=== Crafting ===
{{Crafting
  |showdescription=1
  |A1=String      |B1=Rabbit Hide |C1=String 
  |A2=Rabbit Hide                 |C2=Rabbit Hide
  |A3=Rabbit Hide |B3=Rabbit Hide |C3=Rabbit Hide
  |Output=Bundle
  |type=Tool
  |description={{OnlyExperimental|bundle}}
}}

== Usage ==
<!--The tooltip does not reflect the current bundle "tooltip"-->
{{FakeImage|style=max-width:250px;
|1={{Slot|Stick,64}}{{Slot|Ender Pearl,16}}{{Slot|Iron Sword}}<br>{{Slot|Stick,1}}{{Slot|Ender Pearl,4}}{{Slot|Iron Sword,64}}<br>{{Slot|Filled Bundle[Stick x32/Ender Pearl x8]| title = Bundle|link=none}}
|2=Item stack sizes (top row) and the number of bundle slots they take up (middle row). Sticks stack to 64, so they take up one bundle slot; ender pearls stack to 16, so they take up four; and swords do not stack, so they take up the whole bundle. So, for instance, a bundle may have 32 sticks and 8 ender pearls inside (bottom), which take up a total of {{Tooltip|(32×1)|32 Sticks}}+{{Tooltip|(8×4)|8 Ender Pearls}}=64 bundle slots.
}}
Bundles are used to store different [[item|item type]]s in the same [[inventory]] slot. This does not, however, increase the total capacity of the slot: each bundle has 64 "bundle slots" and each item placed in the bundle takes up these slots similar to how they take up space in a normal inventory slot: items that stack to 64 take up 1 bundle slot, items that stack to 16 (for example, [[egg]]s) take up 4, and items that do not stack (such as tools/weapons/armor) take up the whole bundle, all 64 slots.

Although bundles themselves cannot be stacked, a bundle can be placed inside another (nested): the inner bundle itself uses 4 slots plus the number of slots already occupied by the items in that bundle.<ref>{{bug|MC-203567||Bundles can be placed inside of bundles|WAI}}</ref>  

To place items inside a bundle, either (1) pick up the bundle in the inventory and right-click on the item(s) to be placed inside or (2) pick up the item(s) and right-click on the bundle. When placing bundles inside another bundle, the interface uses the first method: picking up Bundle A and right clicking on Bundle B attempts to store Bundle B inside A.  

Bundles can be {{ctrl|used}} inside the inventory to take out the last item put in. In this way, items are accessible LIFO (last in, first out). When {{ctrl|used}} outside the inventory, it dumps all the items out into the world.

Hovering over the bundle shows its contained items in its inventory slots. The number of bundle slots used is displayed as ''<fullness>''/64 in the tooltip. If the bundle is full, then the empty slots are greyed out with an <span class="invslot">{{SlotSprite|Bundle full}}</span>.

[[Shulker box]]es cannot be placed inside of bundles.

[[File:MinecraftBundle.jpg|thumb|Hovering the mouse over a bundle filled with mob loot, nearly full, with 61 items.]]

== Sounds ==
{{Sound table
|sound=Bundle drop contents1.ogg
|sound2=Bundle drop contents2.ogg
|sound3=Bundle drop contents3.ogg
|subtitle=Bundle empties
|source=player
|description=When a bundle's items are thrown onto the ground
|id=item.bundle.drop_contents
|translationkey=subtitles.item.bundle.drop_contents
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 0.8-1.2 or 0.76-1.14 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Bundle insert1.ogg
|sound2=Bundle insert2.ogg
|sound3=Bundle insert3.ogg
|subtitle=Item packed
|source=player
|description=When items are placed into a bundle
|id=item.bundle.insert
|translationkey=subtitles.item.bundle.insert
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 0.8-1.2, 0.76-1.14, or 0.84-1.26 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Bundle remove one1.ogg
|sound2=Bundle remove one2.ogg
|sound3=Bundle remove one3.ogg
|subtitle=Item unpacked
|source=player
|description=When items are removed from a bundle
|id=item.bundle.remove_one
|translationkey=subtitles.item.bundle.remove_one
|volume=0.8
|pitch=''varies' <ref group=sound>Can be 0.8-1.2, 0.84-1.26, or 0.88-1.32 for each sound</ref>
|distance=16
|foot=1}}

== Data values ==
=== ID ===
{{JE}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Bundle
|spritetype=item
|nameid=bundle
|form=item
|foot=1}}

=== Item data ===

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound|tag}}: The '''tag''' tag.
{{:Player.dat_format/Bundle}}
</div>
== History ==
{{History||October 3, 2020|link={{ytl|DBvZ2Iqmm3M|t=1846s}}|[[File:Bundle JE1.png|32px]][[File:Bundle Filled JE1.png|32px]] Bundles are revealed at [[Minecraft Live 2020]]. Hovering over them shows all items inside scattered around a large area, and incomplete bundles have the empty texture.}}
{{History||October 16, 2021|link=https://clips.twitch.tv/AffluentEncouragingOryxPeteZaroll-cd8pIapkfD4PRHxO|Ulraf, a game developer on ''Minecraft'', states that bundles will not be included in [[Caves & Cliffs]].}}
{{History||November 17, 2021|link=https://www.minecraft.net/en-us/article/caves---cliffs-update-part-ii-coming|Bundles are announced to be added after [[The Wild Update]].}}
{{History|java}}
{{History||1.17|snap=20w45a|[[File:Bundle JE1.png|32px]][[File:Bundle Filled JE1.png|32px]] Added bundles. Hovering over them shows some of the items contained and their quantities, much like the tooltip of a [[shulker box]]. Incomplete bundles have the full texture.}}
{{History|||snap=20w46a|[[File:Bundle JE2.png|32px]][[File:Bundle Filled JE2.png|32px]] The textures of bundles have been changed.
|Hovering over bundles now shows its contained items in special slots, similar to slots in the [[inventory]]. If the bundle is not full, it also has an empty slot with a plus on it.}}
{{History|||snap=20w48a|Bundles now show fullness as a number when [[advanced tooltips]] are enabled.
|{{ctrl|Using}} a bundle in the inventory now empties one item from the bundle instead of emptying all the contents out to the [[inventory]].
|{{ctrl|Using}} a bundle now throws out its entire content into the world.}}
{{History|||snap=20w49a|Bundle fullness is now always shown.
|Full bundles now show the blue bar instead of hiding it, to distinguish from empty bundles.}}
{{History|||snap=20w51a|Bundles now drop its contents when destroyed as an [[Item (entity)|item entity]].
|Bundle fullness has been changed from <code>Fullness: ''<fullness>'' / 64</code> to <code>''<fullness>''/64</code>
|The slots in the tooltip when hovering over bundles have changed to have a border, and rows of slot have a thicker edge between them.
|When the bundle is not full, it instead shows empty slots instead of one slot with a plus. When it is full, those empty slots become greyed out with an X.}}
{{History|||snap=21w05a|The player now receives a tutorial when first having a bundle in the inventory.}}
{{History|||snap=21w19a|Bundles are now accessible only through commands.}}
{{History||1.18|snap=Experimental Snapshot 1|Bundles are now available in the creative inventory and can be crafted once again.}}
{{History|||snap=21w37a|Bundles are once again accessible only through commands.}}
{{History||1.19.3|snap=22w42a|Bundles have been made available once again, and have been moved behind their own datapack.}}
{{h|bedrock}} 
{{h||1.19.50|snap=beta 1.19.50.21|Added bundle GUI textures in the Vanilla Packs.}} 
{{History|foot}}

== Issues ==
{{Issue list}}

== Gallery ==
<gallery>
JE 1.17 Development Bundle.png|The original bundle UI
Bundle in Inventory.jpg|A bundle inventory in the inventory
</gallery>

== References ==
{{Reflist}}

{{Items}}

[[Category:Storage]]
[[Category:Tools]]
[[Category:Renewable resources]]

[[de:Bündel]]
[[es:Saco]]
[[fr:Sac]]
[[ja:バンドル]]
[[pl:Sakwa]]
[[pt:Trouxa]]
[[ru:Мешок]]
[[zh:收纳袋]]</li></ul></nowiki>
20w21aAdded custom worlds.
Custom worlds are JSON-driven.
Custom dimensions can be added and vanilla dimensions can be modified.
There is currently no in-game menu to modify worlds; custom worlds can be generated only by importing a JSON file.
pre1The "temparature" biome parameter is now spelled "temperature".
Dimensions and dimension settings can be created through data packs.
1.16.2
{{Extension DPL}}<ul><li>[[3D|3D]]<br/>{{about|the edible item|the April Fools' snapshot itself|Java Edition 3D Shareware v1.34}}

{{Joke feature}}
{{Item
| image = 3D (item).png
| renewable = Yes
| stackable = Yes (64)
}}

'''3D''' was a joke item from [[Java Edition 3D Shareware v1.34]]. Eating it shows a picture of the developer cast.

== Obtaining ==
=== Mob drops ===
3D was dropped by a creeper summoned by the cheat code "'''NEEEERD'''".

== Usage ==
Eating the 3D item when the hunger bar was not full shows a picture of the developer cast of Minecraft.
== Data values ==

=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=3D
|spritetype=item
|nameid=3d
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||3D Shareware v1.34|[[File:3D (item).png|32px]] Added the 3D item.}}
{{History|foot}}

== Gallery ==

<gallery>
File:3D Shareware Mojang Team.png|The developer cast of Minecraft.
File:Tasty 3D Item.gif|The "'''Tasty!'''" 3D Item lore.
</gallery>

{{Items}}
{{Jokes}}

[[Category:Non-renewable resources]]
[[Category:Joke items]]</li><li>[[Banner|Banner]]<br/>{{for|the image|Banner (image)}}
{{Block
| image = <gallery>
White Banner.gif | Banner
White Wall Banner.png | Wall Banner
</gallery>
| rarity = Common
| transparent = Yes
| light = No
| tool = axe
| renewable = Yes
| stackable = Yes (16)
| flammable = No
| lavasusceptible = Yes
}}

'''Banners''' are tall decorative [[blocks]], featuring a field that is highly customizable using [[dye]]s and [[banner pattern]]s.

== Obtaining ==

=== Breaking ===

Banners can be broken with or without a [[tool]], but an [[axe]] is fastest.
{{breaking row|horizontal=1|Banners|Axe}}

A banner also breaks and drops itself as an [[Item (entity)|item]] if the block the banner is attached to is moved, removed, or destroyed.

=== Natural generation ===

{| class="wikitable collapsible"
! Name !! Location !! Appearance !! Design
|-
! Magenta Banner
| Outside of [[end cities]].
| style="text-align: center" | [[File:End City Banner.png|32px]]
| Magenta Banner
* Black Inverted Chevron
* Black Chevron
|-
! Gray Banner
| In banner room in [[woodland mansion]]s.
| style="text-align: center" | [[File:Gray Banner.png|32px]]
| Gray Banner
|-
! Light Gray Banner
| In master bedroom in [[woodland mansion]]s.
| style="text-align: center" | [[File:Master Bedroom Banner.png|32px]]
| Light Gray Banner
* White Flower Charge
|- id="Ominous Banner"
! Ominous Banner{{only|java|short=1}} 
Illager Banner{{only|bedrock|education|short=1}}
| Carried by [[raid captain]]s.<br> Located in [[pillager outpost]]s.

{{IN|java}}, the ominous banner cannot be crafted or copied because the design uses 8 patterns.

{{IN|bedrock}}, the illager banner is a separate type that cannot be placed in a loom.
| style="text-align: center" | [[File:Ominous Banner.png|32px]]<br/>[[File:Ominous Banner BE.png|32px]]
| White Banner{{only|java|short=1}}
* Cyan Lozenge
* Light Gray Base
* Gray Pale
* Light Gray Bordure
* Black Fess
* Light Gray Per Fess
* Light Gray Roundel
* Black Bordure
Separate type entirely{{only|bedrock|short=1}}
|-
! Brown Banner
| Outside of some houses, meeting points, and pillar fountains in savanna [[village]]s. 
| style="text-align: center" | [[File:Brown Banner.png|32px]]
| Brown Banner
|-
! Black Banner
| In altar room in [[woodland mansions]].
| style="text-align: center" | [[File:Black Banner.png|32px]]
| Black Banner
|}

=== Crafting ===

Banners can be crafted from six [[wool]] and a [[stick]] in a pattern resembling a [[sign]].
{{Crafting
|head=1
|showdescription=1
|A1=Matching Wool |B1=Matching Wool |C1=Matching Wool
|A2=Matching Wool |B2=Matching Wool |C2=Matching Wool
|B3=Stick
|Output=Matching Banner
|Olink=Banner
|type=Decoration block
|description=Once the banner is crafted, its base color cannot be changed.{{only|java}}
}}
{{Crafting
|showdescription=1
|Any Banner
|Bleach
|Output=White Banner
|type=Decoration block
|description=Bleach can be used to remove the color of a banner, resulting in a white banner. This includes removing patterns from a white banner.{{only|bedrock|education}}
|foot=1
}}

=== Trading ===
Expert-level cartographer [[villager]]s always offer to [[trading|sell]] 1 or 2 blank banners of a random color for 3 [[emeralds]]. Expert-level shepherd villagers have a {{frac|2|7}} chance of offering the same trade.{{only|java}}

{{IN|bedrock}}, expert-level cartographer and shepherd villagers both offer to sell one of 16 blank banners for 3 emeralds as part of their trades.

=== Mob loot ===

[[Illager]]s that spawn carrying an ominous banner{{only|java|short=1}} / illager banner{{only|bedrock|education|short=1}} always drop it upon death.

== Usage ==

[[File:Standing banner with block.png|thumb|upright|Overlapping block on a banner.]]
[[File:Wall banner with block.png|thumb|upright|Overlapping on a wall mounted banner.]]

There are 16 colored blank banners, and numerous patterns each available in each of the 16 colors. A banner can feature up to 6 different patterns. The top layer of a banner (or the last pattern added) can be washed off by {{control|using}} it on a [[cauldron]] containing water.

Banners, much like signs, can be placed both on the ground facing in any direction, or on a wall. They gently sway as if affected by a breeze, regardless of dimension or location. 

Banners have no collision mask as they are completely non-solid, so [[entities]] can move through them.

Other blocks (including other banners) can be placed on any edge of a banner's hitbox, which is only one block high despite the banner appearing as two blocks tall. This makes it possible to overlap another solid block on the top half of a banner for floor banners, or the bottom half of wall banners.

When a banner is placed on the side of a block, its position is set by the top block, and it is possible to place it so it appears half buried.

Banners can also be placed in [[item frame]]s, where they simply appear as their item model.

[[Water]] and [[lava]] flow around banners. {{IN|bedrock}}, banners can be [[waterlogged]].

<gallery>
File:Wall banner with water below.png| Water can be placed below wall banners
File:Water flowing around banner.png| Water flows around a banner on the ground
</gallery>

Lava can create [[fire]] in air blocks next to banners as if the banners were flammable, but the banners do not burn (and cannot be burned by other methods). Banners also cannot be moved by [[piston]]s.

If a banner is renamed on an [[anvil]], it retains its name when a pattern is added, but not when a pattern is removed.

=== Helmet ===
{{exclusive|java|section=13}}
While a banner cannot be equipped in the [[Helmet|head slot]] in [[Survival]] mode, equipping it using commands causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|java|short=1}}.

=== Chestplate ===
{{exclusive|bedrock|section=13}}
While a banner cannot be equipped in the [[chestplate]] slot in Survival mode, equipping it using NBT editors causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|bedrock|education|short=1}}.
<gallery>
Steve wearing White Banner.png|
Alex wearing White Banner.png|
Pillager with Ominous Banner.png|
Vindicator with Ominous Banner.png|
Evoker with Ominous Banner.png|Illusioner with Ominous Banner.png|
</gallery>

=== Crafting ingredient ===

[[Shield]]s can have patterns applied to them using banners. The shield pattern has a smaller resolution than the banner pattern, causing them to look different or offset. Banners that have more than six patterns, such as Ominous Banners or banners obtained through inventory editors, will be reduced to six patterns on the shield.

{{Crafting
|showdescription=1
|Shield
|Matching Banner; Ominous Banner
|Output=Matching Shield; Ominous Shield
|B2link=Banner
|type=Combat
|description=Applies the banner pattern to the shield. The banner is consumed.<br>The shield must have no pre-existing patterns.<br>Does not change existing durability or enchantments on the shield.
}}

=== Copying ===

Banners can be copied with a blank banner to make multiple identical banners. Banners with more than 6 patterns applied using commands cannot be copied in this manner.

{{Crafting
|showdescription=1
|Matching Banner
|Matching Banner
|Output=Matching Banner
|A2link=Banner
|B2link=Banner
|Olink=Banner
|type=Decoration block
|ignoreusage=1
|description=Copies pattern; both banners must have the same base color, and the one having a pattern copied onto it must have no preexisting pattern.
}}

=== Map marker ===
[[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|thumb|right|How every banner appears {{IN|java}} on a map, including named banners.]]

{{exclusive|java|section=13}}
{{IN|java}}, {{control|using}} on a standing banner with a [[map]] selected places a marker of the banner's position on the selected map, and {{control|using}} on the banner again removes the marker. Note that wall banners cannot serve as map markers. The marker has the same color as the banner's base without decorations. The marker is removed if the banner is destroyed unless the map is locked using a [[cartography table]]. If the banner is renamed, the name appears below the marker.

=== Patterns ===
{{see also|Banner/Patterns|title1=List of patterned banners}}
[[File:Spawned-in Banner.png|thumb|100px|Example of a banner with more than 6 patterns, a result of using the {{cmd|give}} command.]]

A banner may have up to six layers of patterns, which are overlaid with the last-crafted on top. A banner can have up to 16 layers of patterns with the use of commands. The total number of unique banners is approximately 2.3x10^16 (or 23 quadrillion).

Any color banner can be used; the pattern overlays the color. {{IN|java}}, a [[loom]] is used to make patterns. However, {{in|bedrock}}, the patterns can be made in a [[loom]] or a [[crafting table]].

A banner can have more than six layers of patterns through the commands <code>/[[Commands/give|give]]</code>, <code>/[[Commands/setblock|setblock]]</code> or <code>/[[Commands/fill|fill]]</code>. This only works in ''Java Edition'', as Bedrock Edition doesn't have any NBT commands. Here is an example of a mining banner with seven different patterns. There is specific codes for the [[Banner#Item data:~:text=white-,Item,-In Java Edition|colors]] and [[Banner/Patterns|patterns]] that you have to input. 

<code><nowiki>/give @p white_banner{display:{Name:"\"Mining Industries Banner\""},BlockEntityTag:{Patterns:[{Pattern:"cr",Color:15},{Pattern:"bs",Color:15},{Pattern:"sc",Color:12},{Pattern:"ms",Color:0},{Pattern:"hh",Color:15},{Pattern:"bo",Color:15},{Pattern:"tts",Color:8}]}} 1</code>

{{LoadPage|Template:Banner pattern loom recipes|Loom recipes|h4}}
{{LoadPage|Banner/Banner pattern crafting recipes|Crafting recipes|h4|transcluded=1}}

=== Renaming ===
{{IN|java}}, a banner can be given a custom name that remains as the banner is placed and retrieved. The player can use an [[anvil]] to rename the banner item, or may change the <code>CustomName</code> tag using the {{cmd|data}} command on the banner block.

=== Fuel ===
Banners can be used as a fuel in [[furnace]]s, smelting 1.5 items per banner.

=== Note Blocks ===
Banners can be placed under [[note block]]s to produce "bass" sounds.

== Sounds ==
=== Generic ===
{{Sound table/Block/Wood}}
=== Unique ===
{{edition|java}}: ''None''

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Water Splash Old.ogg
|source=block
|description=When all patterns are removed from a banner using a cauldron
|id=cauldron.cleanbanner
|volume=0.1
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=White Banner
|spritetype=block
|nameid=white_banner
|blocktags=banners, wall_post_override
|itemtags=banners
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner
}}
{{ID table
|displayname=Orange Banner
|spritetype=block
|nameid=orange_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Magenta Banner
|spritetype=block
|nameid=magenta_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Blue Banner
|spritetype=block
|nameid=light_blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Yellow Banner
|spritetype=block
|nameid=yellow_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Lime Banner
|spritetype=block
|nameid=lime_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Pink Banner
|spritetype=block
|nameid=pink_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Gray Banner
|spritetype=block
|nameid=gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Gray Banner
|spritetype=block
|nameid=light_gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Cyan Banner
|spritetype=block
|nameid=cyan_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Purple Banner
|spritetype=block
|nameid=purple_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Blue Banner
|spritetype=block
|nameid=blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Brown Banner
|spritetype=block
|nameid=brown_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Green Banner
|spritetype=block
|nameid=green_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Red Banner
|spritetype=block
|nameid=red_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Black Banner
|spritetype=block
|nameid=black_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=White Wall Banner
|spritetype=block
|nameid=white_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner}}
{{ID table
|displayname=Orange Wall Banner
|spritetype=block
|nameid=orange_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.orange_banner}}
{{ID table
|displayname=Magenta Wall Banner
|spritetype=block
|nameid=magenta_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.magenta_banner}}
{{ID table
|displayname=Light Blue Wall Banner
|spritetype=block
|nameid=light_blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_blue_banner}}
{{ID table
|displayname=Yellow Wall Banner
|spritetype=block
|nameid=yellow_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.yellow_banner}}
{{ID table
|displayname=Lime Wall Banner
|spritetype=block
|nameid=lime_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.lime_banner}}
{{ID table
|displayname=Pink Wall Banner
|spritetype=block
|nameid=pink_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.pink_banner}}
{{ID table
|displayname=Gray Wall Banner
|spritetype=block
|nameid=gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.gray_banner}}
{{ID table
|displayname=Light Gray Wall Banner
|spritetype=block
|nameid=light_gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_gray_banner}}
{{ID table
|displayname=Cyan Wall Banner
|spritetype=block
|nameid=cyan_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.cyan_banner}}
{{ID table
|displayname=Purple Wall Banner
|spritetype=block
|nameid=purple_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.purple_banner}}
{{ID table
|displayname=Blue Wall Banner
|spritetype=block
|nameid=blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.blue_banner}}
{{ID table
|displayname=Brown Wall Banner
|spritetype=block
|nameid=brown_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.brown_banner}}
{{ID table
|displayname=Green Wall Banner
|spritetype=block
|nameid=green_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.green_banner}}
{{ID table
|displayname=Red Wall Banner
|spritetype=block
|nameid=red_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.red_banner}}
{{ID table
|displayname=Black Wall Banner
|spritetype=block
|nameid=black_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.black_banner
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=banner
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Banner
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Standing
|spritename=Banners
|spritetype=block
|nameid=standing_banner
|translationkey=tile.standing_banner.black.name, tile.standing_banner.red.name, tile.standing_banner.green.name, tile.standing_banner.brown.name, tile.standing_banner.blue.name, tile.standing_banner.purple.name, tile.standing_banner.cyan.name, tile.standing_banner.silver.name, tile.standing_banner.gray.name, tile.standing_banner.pink.name, tile.standing_banner.lime.name, tile.standing_banner.yellow.name, tile.standing_banner.lightBlue.name, tile.standing_banner.magenta.name, tile.standing_banner.orange.name, tile.standing_banner.white.name
|id=176
|form=block}}
{{ID table
|displayname=Wall
|spritename=Banners
|spritetype=block
|nameid=wall_banner
|id=177
|form=block
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=Banners
|spritetype=item
|nameid=banner
|translationkey=item.banner.black.name, item.banner.red.name, item.banner.green.name, item.banner.brown.name, item.banner.blue.name, item.banner.purple.name, item.banner.cyan.name, item.banner.silver.name, item.banner.gray.name, item.banner.pink.name, item.banner.lime.name, item.banner.yellow.name, item.banner.lightBlue.name, item.banner.magenta.name, item.banner.orange.name, item.banner.white.name
|id=567
|form=item
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=Banner
|foot=1}}

=== Metadata ===
==== Item ====
{{IN|Bedrock}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 0 || black
|-
|| 1 || red
|-
|| 2 || green
|-
|| 3 || brown
|-
|| 4 || blue
|-
|| 5 || purple
|-
|| 6 || cyan
|-
|| 7 || light gray
|-
|| 8 || gray
|-
|| 9 || pink
|-
|| 10 || lime
|-
|| 11 || yellow
|-
|| 12 || light blue
|-
|| 13 || magenta
|-
|| 14 || orange
|-
|| 15 || white
|}

=== Item ===
{{IN|Java}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 15 || black
|-
|| 14 || red
|-
|| 13 || green
|-
|| 12 || brown
|-
|| 11 || blue
|-
|| 10 || purple
|-
|| 9 || cyan
|-
|| 8 || light gray
|-
|| 7 || gray
|-
|| 6 || pink
|-
|| 5 || lime
|-
|| 4 || yellow
|-
|| 3 || light blue
|-
|| 2 || magenta
|-
|| 1 || orange
|-
|| 0 || white
|}

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

=== Block data ===

A banner has a block entity associated with it that holds additional data about the block. 

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

{{el|java}}:
{{see also|Block entity format}}
{{/BE}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
Banners, as items, use an NBT tag <code>BlockEntityTag</code> to indicate the patterns and details when it is placed.

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound|Item}}: The item
** {{nbt|compound|tag}}: Additional information about the item. This tag is optional for most items.
*** {{nbt|compound|BlockEntityTag}}: The details of the shulker box.
**** All block data, except tags common to all block entities.
</div>

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

== Achievements ==
{{load achievements|Fruit on the Loom}}

== Advancements ==
{{load advancements|Voluntary Exile}}

== History ==
{{info needed section|The Nether Update}}
{{History|java}}
{{History||1.8|snap=July 21, 2014|slink=https://twitter.com/jeb_/status/491238882789572608|[[Jeb]] posted a picture of banners, and stated that he is working on them.}}
{{History|||snap=14w30a|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History|||snap=14w30c|Added four additional patterns: Cross (+), Border, Curly Border and Thing (Mojang logo).}}
{{History|||snap=14w31a|Added two additional patterns: Inverted Halves and Base Gradient.
|The banner pattern terminology has been changed based on vexillology advice [[Jeb]] received from [http://www.reddit.com/r/Minecraft/comments/2bkxej/i_made_a_huge_mistake_banners/ his Reddit post].
|Banners can now be used as a [[fuel]] in [[furnace]]s.}}
{{History||1.8.8|snap=pre|The number of layers attainable by using [[commands]] is now limited to 16 per banner.}}
{{History||1.9|snap=15w31a|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History|||snap=15w33c|Banners can be used to apply patterns to [[shield]]s.}}
{{History||1.11|snap=16w33a|Banners now require a [[dye]] when applying a pattern that uses a non-dye [[item]], such as a [[mob head|creeper head]] or [[golden apple|enchanted golden apple]]. Previously, the lack of a dye would have applied the black variant of the pattern.}}
{{History|||snap=16w39a|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.12|snap=January 24, 2017|slink={{tweet|jeb_|823817090511601664}}|[[Jeb]] tweets a screenshot of the changes to the banner color palette.}}
{{History|||snap=17w06a|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History|||snap=pre6|"Chief fess" and "base fess" banners are now just "chief" and "base" banners.}}
{{History||1.13|snap=17w47a|The colors for the <code>banner</code>, <code>wall_banner</code> and <code>standing_banner</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[block]]s' numeral IDs were 176 and 177, and the [[item]]'s 425.}}
{{History|||snap=18w10a|{{control|Using}} a [[map]] on a banner now mark the spot of the banner on the map.}}
{{History||1.14|snap=18w43a|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|All recipes for banner patterns have been removed.}}
{{History|||snap=18w45a|[[File:Ominous Banner Revision 1.png|17px]] Added [[illager patrol]]s, where the leader of an illager patrol carries an [[illager]] banner.}}
{{History|||snap=18w46a|[[File:Ominous Banner.png|17px]] The pattern of [[illager]] banner now has a black border.}}
{{History|||snap=19w11a|Cartographer and shepherd [[villager]]s now [[trading|sell]] banners.}}
{{History|||snap=Pre-Release 2|"Illager Banners" have been renamed to "Ominous Banners".}}
{{History||1.17|snap=20w46a|The unused "base" pattern has been renamed to the "field" pattern and given proper translation strings (its ID is still "base").}}
{{History||1.19.3|snap=22w43a|The ominous banner is now available in the Creative inventory.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Added banners.
|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].
|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|The white banner can now be crafted from a colored banner and [[bleach]], which also removes all patterns, if used on a white banner.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|Brown banners now generate in new [[savanna]] [[village]]s.
|Black banners now generate in [[pillager outpost]] watchtowers.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray banners now generate in pillager outpost watchtowers, instead of black banners.
|[[File:Ominous Banner BE.png|17px]] Added [[illager captain]]s, which drop an [[illager]] banner upon [[death]].}}
{{History|||snap=beta 1.11.0.3|Illager banners now generate in [[pillager outpost]] watchtowers, instead of gray banners.}}
{{History|||snap=beta 1.11.0.4|Banners can now be [[trading|bought]] from cartographer and shepherd [[villager]]s.}}
{{History||1.20.0|snap=beta 1.20.0.20|Banners can now be used to customise [[shield]]s.}}

{{History|console}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|switch=1.0.1|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|switch=1.0.1|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[Loom]]s have been added to help the [[player]] edit banners more easily.}}
{{History||ps=1.91|[[File:Ominous Banner BE.png|17px]] Added [[illager]] banners, which generate with [[pillager outpost]]s and are [[drops|dropped]] by [[illager captain]]s upon [[death]].}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* With 16 blank banners, 38 patterns of 16 colors each (608 uniquely-colored patterns), and 0 to 6 patterns per banner, the number of uniquely crafted banners is 16 × (608<sup>0</sup> + 608<sup>1</sup> + 608<sup>2</sup> + 608<sup>3</sup> + 608<sup>4</sup> + 608<sup>5</sup> + 608<sup>6</sup>) ≈ 809 quadrillion - 809 with 15 zeros (809,573,616,779,945,488). The number of visually distinct banners is smaller, because one or more patterns may completely cover other patterns, or the entire banner, or be duplicated due to the symmetric set of patterns (e.g. field or (yellow) + per pale azure (blue) = field azure + per pale or inverted).
** Not 38 patterns are available on BE, but 40 patterns of 16 colors each (640 uniquely-colored patterns), so the number is even greater. 16 × (640<sup>0</sup> + 640<sup>1</sup> + 640<sup>2</sup> + 640<sup>3</sup> + 640<sup>4</sup> + 640<sup>5</sup> + 640<sup>6</sup>) ≈ 1 quintillion - 1 with 18 zeros (1,101,232,303,249,827,856). This increases the number by almost 1.4 times, or almost 292 quadrillion, despite the addition of only 2 patterns.
* If a banner has over 6 patterns, only the six bottom-most patterns are displayed when hovered over in the [[inventory]].
* The Mojang logo is called "Thing" in-game, which could be considered an alternate translation for [[wiktionary:mojäng|mojäng]]. If [[wikipedia:Google Translate|Google Translate]] is used, it translates to "thingys" or "contraption".
** In the Swedish translation of the game, this pattern is, in fact, called ''mojäng''.
* [[List of block textures#Banner Textures|Banner textures]] are located in \assets\minecraft\textures\entity\banner.
** There are 40 monochrome textures, each containing all 6 sides of the banner.
** The texture of the back side is the mirrored texture of the front side.
** Compared to the texture files, textures' colors are inverted in-game due to them acting as masks for the re-colored base texture, base.png. That means white is visible, while black is transparent.
* Banners that have the purple NBT+ line in the bottom (obtained by holding Ctrl and middle-clicking the banner, which also copies the NBT [[tag]] of anything that the player points their crosshair to) actually have no difference with the base banner obtained by middle click.
*The Illager Banner in Bedrock Edition is available as a separate item but is just a second variant of the white banner.
**Standard variant of white banner is set to type 0.
**Illager variant is set to type 1.

== Gallery ==
<gallery>
Banners Jeb.png|The first image of banners, as tweeted by Jens Bergensten.
Iceland and Norway Flags.png|Another banner image from Jeb.
Searge Banners.png|Several banners made by Searge.
The Bountiful Update.png|Banners in the official 1.8 poster.
BannersBeforeAndAfter.png|An image, tweeted by Jeb, showcasing the changes he made to the banner color palette in the 1.12 update.
Gradients Overlay.png|The result of using gradient different numbers of times, each time increasing the level of gradient by 1.
All positions and rotations of a banner.png|All positions and rotations of a banner
Item Frame with Banner.png|A banner with the [[Mojang]] logo in an [[item frame]].
EndCityBanners.png|Banners floating outside of an [[End city]] tower.
Woodland mansion 1x2 d1.png|Banners hanging above the doorway of a [[woodland mansion]] master bedroom.
Replaceitembanner.png|Banner put in the helmet slot by using the command {{cmd|replaceitem}}{{Only|BE}} or {{cmd|item replace}}{{Only|JE}}.
Better Together Banners.jpg|Banners in ''Bedrock Edition''.
Better Together Banner Crafting 1.jpg|A banner in the hand.
Better Together Banner Crafting 2.jpg|A banner in the inventory.
Better Together Banner Crafting 3.jpg|A banner in the crafting grid.
Better Together Banner Crafting 4.jpg|A banner being given a pattern.
</gallery>

=== Renders ===
<gallery>
Ominous Banner.gif
White Banner.gif
Light Gray Banner.gif
Gray Banner.gif
Black Banner.gif
Brown Banner.gif
Red Banner.gif
Orange Banner.gif
Yellow Banner.gif
Lime Banner.gif
Green Banner.gif
Cyan Banner.gif
Light Blue Banner.gif
Blue Banner.gif
Purple Banner.gif
Magenta Banner.gif
Pink Banner.gif
Ominous Wall Banner.png| 
White Wall Banner.png| 
Light Gray Wall Banner.png| 
Gray Wall Banner.png| 
Black Wall Banner.png| 
Brown Wall Banner.png| 
Red Wall Banner.png| 
Orange Wall Banner.png| 
Yellow Wall Banner.png| 
Lime Wall Banner.png| 
Green Wall Banner.png| 
Cyan Wall Banner.png| 
Light Blue Wall Banner.png| 
Blue Wall Banner.png| 
Purple Wall Banner.png| 
Magenta Wall Banner.png| 
Pink Wall Banner.png
</gallery>

<gallery>
File:Ominous Banner.gif|Ominous banner pattern in Java Edition.
File:Ominous Banner BE.gif|Illager banner pattern in Bedrock Edition.
File:Ominous Banner Revision 1.gif|Old Ominous banner pattern.
File:Ominous Banner washing.gif|Washing with cauldron shows how to apply the ominous banner pattern.
</gallery>

=== [[Lego Minecraft]] Banners ===
<gallery>
File:Lego Red Creeper Banner Collage.jpg|Lego banners from 21127 and 21131
File:Lego Melon Banner.png|Lego banner from 21138
File:Lego Fish Banner.png|Lego banner from 21142
File:Lego Beetroot Banner.png|Lego banner from 21144
File:Lego Wheat Banner.png|Another lego banner from 21144
File:Lego Carrot Banner.png|A third lego banner from 21144
File:Lego Crossbones Banner.png|Lego banner from 21152
File:Lego Green Creeper Banner Collage.jpg|Lego banners from 21155
File:Lego Ominous Banner.png|Lego ominous banner from 21160
</gallery>

== References ==
{{reflist}}

{{Blocks|Utility}}
{{Items}}

[[Category:Generated structure blocks]]
[[Category:Manufactured blocks]]
[[Category:Block entities]]
[[Category:Non-solid blocks]]

[[cs:Prapor]]
[[de:Banner]]
[[es:Estandarte]]
[[fr:Bannière]]
[[ja:旗]]
[[ko:현수막]]
[[nl:Banier]]
[[pl:Sztandar]]
[[pt:Estandarte]]
[[ru:Флаг]]
[[uk:Стяг]]
[[zh:旗帜]]</li></ul></nowiki>
20w28aExperimental custom biome support is now included in custom worlds.
Upcoming Java Edition
1.17
{{Extension DPL}}<ul><li>[[Copper Ingot|Copper Ingot]]<br/>{{About|the ingot|the ore|Copper Ore|the mineral block|Block of Copper}}
{{Item
| image = Copper Ingot.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Copper ingots''' are [[metal]] ingots obtained from smelting [[raw copper]] or killing [[drowned]].

== Obtaining ==

=== Crafting ===
{{Crafting
 |Block of Copper;Waxed Block of Copper|Output=Copper Ingot,9
 |type=Miscellaneous
}}

=== Smelting ===
Copper ingots can be obtained by smelting [[raw copper]] in a [[furnace]] or [[blast furnace]], as well as the ore itself if mined using [[Silk Touch]].

{{Smelting
|head=1
|Raw Copper
|Copper Ingot
|0.7
}}
{{Smelting
|foot=1
|Copper Ore; Deepslate Copper Ore
|Copper Ingot
|0.7
}}

=== Mob loot ===

==== Drowned ====

When killed by a [[player]] or a tamed [[wolf]], a [[drowned]] has a 11% ({{frac|11|100}}) chance of dropping a copper ingot. With the [[Looting]] enchantment, the chance can be increased to 13% ({{frac|13|100}}) with Looting I, 15% ({{frac|3|20}}) with Looting II, and 17% ({{frac|17|100}}) with Looting III.

== Usage ==

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

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

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Copper Ingot
|spritetype=item
|nameid=copper_ingot
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Copper Ingot
|spritetype=item
|nameid=copper_ingot
|form=item
|id=504
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=20w45a|[[File:Copper Ingot JE1.png|32px]] Added copper ingots.}}
{{History|||snap=20w46a|[[File:Copper Ingot JE2 BE1.png|32px]] The texture of copper ingots has been changed.|Crafting copper ingots from and into copper blocks now outputs/requires only 4 ingots.}}
{{History|||snap=21w05a|[[Drowned]] can now drop copper ingots when killed instead of [[gold ingots]], making copper ingots renewable.}}
{{History|||snap=21w10a|Copper ingots can now be smelted from [[deepslate copper ore]].}}
{{History|||snap=21w14a|Copper ingots can now be smelted from [[raw copper]].}}
{{History|||snap=21w17a|The amount of copper ingots required to make a [[block of copper]] has been changed back to 9.}}
{{History||1.17.1|snap=Pre-release 1|Increased the chance of [[drowned]] dropping a copper ingot from 5% to 11% and the increase of this chance for each level of [[Looting]] enchantment from 1% to 2% to match {{el|be}}.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Copper ingots can now be used as an armor trim material.}}
{{History|||snap=1.19.4 Pre-release 1|Copper ingots can now be used to craft [[brush]]es.}}

{{History|bedrock}}
{{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.210.57|[[File:Copper Ingot JE2 BE1.png|32px]] Added copper ingots.}}
{{History||1.17.0|snap=beta 1.17.0.50|Copper ingots can now be used to craft [[spyglass|spyglasses]].}}
{{History|||snap=beta 1.17.0.52|Copper ingots are now available without enabling [[experimental gameplay]].}}
{{History|||snap=beta 1.17.0.54|The amount of copper ingots required to make a [[block of copper]] has been changed to 9.}}
{{History||Vanilla Experiments (experimental)|link=1.18.30|snap=beta 1.18.30.26|Copper ingots can now be used to craft copper horns.}}
{{History||1.19.0|snap=beta 1.19.0.24|Copper ingots can no longer be used to craft copper horns, as copper horns have been removed.}}
{{History||1.20.0<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|Copper ingots can now be used to craft [[brush]]es.}}
{{History|||snap=beta 1.19.80.21|Copper ingots can now be used as an armor trim material.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--copper-ingot Taking Inventory:Copper Ingot] – Minecraft.net on December 22, 2022

{{Items}}

[[Category:Renewable resources]]

[[de:Kupferbarren]]
[[es:Lingote de cobre]]
[[fr:Lingot de cuivre]]
[[it:Lingotto di rame]]
[[ja:Copper Ingot]]
[[ko:구리괴]]
[[pl:Sztabka miedzi]]
[[pt:Barra de cobre]]
[[ru:Медный слиток]]
[[uk:Мідний злиток]]
[[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>
20w49aMax build heights and bedrock ceiling heights are now customizable over 256 blocks via custom json files.
21w05aMinimum and maximum y values changed from -2048 and 2048 to -2032 and 2032

Issues

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

Gallery

External links

See also

Notes


References

  1. "Customized worlds will be returning. I can't speak for the extra options you mentioned though." – u/AlmightyZing
    "But after 1.13"u/_Grum on Reddit, May 15, 2018
  2. "Would you really not consider holding off 1.13 until customised worlds are finished? Seems pretty crazy to set a precedent for the chance of losing features for several updates.
    We came so close to having access to customising structures in world gen this update too, a shame that hasn't made the cut" – u/DaUltraMarine
    "No, they will come back but completely different from before."u/_Grum on Reddit, May 15, 2018
  3. "No customization until after 1.13, or the other things?" – u/Kobbett
    "No more screens with 50 vague sliders indeed."u/_Grum on Reddit, May 15, 2018
Advertisement