View source for Minecraft:Atlas.terrain

{{DISPLAYTITLE:<samp>atlas.terrain</samp>}}
{{for|a comprehensive history of block texture changes|Bedrock Edition history of textures/Blocks}}
{{exclusive|bedrock|education}}
{{stub}}
[[File:atlas.terrain 1.21.111.png|thumb|atlas.terrain as of 1.21.111.]]
'''atlas.terrain''' is a [[Minecraft:texture atlas]] used to store all [[Minecraft:block]] textures defined in {{code|terrain_textures.json}}.

== Format ==
{{info needed section|
* Is it deterministic like ''Java Edition''<nowiki/>'s?
* If ''Minecraft Earth'' was based on the BE engine, does it also have this atlas?
* Does ''Minecraft Education'' have the same atlas as ''Bedrock Edition''?
}}
<samp>atlas.terrain</samp> is a 2048×1024 pixel file that is usually split into 16×16-pixel squares with 8 pixels of padding for blocks. Its textures are generated from {{cd|terrain_textures.json}}, ordered alphabetically by entry, when a world is loaded. Textures with animations (defined in {{code|flipbook_textures.json}}) are placed at the end, due to the texture being large, and are additionally animated within the atlas texture. If a texture file is referenced in multiple entries within {{code|terrain_textures.json}}, it will appear once in the first spot it occurs. If a broken or nonexistent texture is referenced, a [[Minecraft:missing texture]] will appear in its spot, even if there is a missing texture occured before it. This does not necessarily mean that the missing texture ends up being visible in-game for relevant such blocks.

Any textures added to {{code|terrain_textures.json}} in loaded [[Minecraft:resource pack]]s will show up in atlas.terrain, including those in [[Minecraft:add-on]]s and in internal packs such as {{code|chemistry}}.

== Viewing ==
{{info needed section|
* method to export or even just see the atlas from versions a0.15.0-b1 to 1.1.7 without external programs
* method to get mipmapped versions without external programs}}
The file generated for atlas.terrain can be extracted by using a [[Minecraft:structure block]] to 3D export a structure. There has to be a semi-transparent block like stained glass to export the right image.{{Needs testing}} The exported file can then be converted into an OBJ file, where its UV, identical to the atlas, can be accessed.{{info needed|check if this works in beta 1.2.0.2, or if it only became possible later}}

Like other atlases {{in|BE}}, atlas.terrain can also be viewed in-game by applying the resource location "atlas.terrain" to another object (e.g. an entity or a [[Minecraft:Particles (Bedrock Edition)|particle]]). {{info needed|How far back do these work?}}

=== External programs ===
{{missing info|section|can this be used to obtain [[Minecraft:blocks-atlas]] and [[Minecraft:items-atlas]] from 13w18a to 13w37b? From testing it crashes in older versions.}}
{{disclaimer|section=1}}
Using external programs such as RenderDoc, you can obtain the texture atlas and its mipmapped versions. The image needs to be flipped vertically after being downloaded as a png.

== History ==
{{HistoryTable
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.15.0|dev=build 1|Added atlas.terrain following the deprecation of [[Minecraft:terrain-atlas.tga]]
|Empty areas which are not used by any textures are solid black.}}
|{{HistoryLine|||dev=?|Mipmapped versions now have anisotropic filtering.}}
|{{HistoryLine|?}}
|{{HistoryLine||?|Mipmapped versions use normal padding again.
|Unused space is no longer filled with black.{{more info|Which of these came first and when?}}}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.21.60|dev=Preview 1.21.60.21|Improved logic for handling very large textures within atlases.}}
}}

=== Versions of the atlas ===
{| class="wikitable pixel-image"
! colspan="2" | Game version
! rowspan="2" | Atlas
! rowspan="2" | Additions
! rowspan="2" | Changes
! rowspan="2" | Removals
! rowspan="2" | Notes
|-
! Main
! Development
|-
| [[Minecraft:Pocket Edition v0.15.0 alpha|v0.15.0 alpha]]
| [[Minecraft:Pocket Edition v0.15.0 alpha build 1|build 1]]
| [[File:Atlas.terrain v0.15.0 alpha build 1.png|1024px]]
| colspan="3" style="text-align:center"| ''Introduction''
|
|-
| colspan="7"| ''More information needed''
|-
| rowspan="3"|[[Minecraft:Bedrock Edition 1.21.111|1.21.111]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.20|Preview 1.21.110.20]]
| [[File:Atlas.terrain 1.21.110.20.png|2048px]]
| Added shelves.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition Preview 1.21.110.22|Preview 1.21.110.22]]
| [[File:Atlas.terrain 1.21.110.22.png|2048px]]
| Added lightning rod oxidization states.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[File:Atlas.terrain 1.21.111.png|2048px]]
| Added copper bars, copper chain, copper lantern, and copper torch.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition 1.21.120|1.21.120]]
| [[Minecraft:Bedrock Edition Preview 1.21.120.21|Preview 1.21.120.21]]
| [[File:Atlas.terrain 1.21.120.png|2048px]]
|
| Changed copper lanterns, copper torches, and weathered copper bars.
|
|
|}

==== Mipmapped versions ====
{{empty section}}

==== ''Minecraft Education'' features ====
{| class="wikitable pixel-image"
! colspan="2" | Game version
! rowspan="2" | Atlas
! rowspan="2" | Additions
! rowspan="2" | Changes
! rowspan="2" | Removals
! rowspan="2" | Notes
|-
! Main
! Development
|-
| colspan="7"|''More information needed''
|-
| rowspan="3"|[[Minecraft:Bedrock Edition 1.21.111|1.21.111]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.20]]
| [[File:Atlas.terrain ME features 1.21.110.20.png|2048px]]
| Added shelves.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition Preview 1.21.110.22]]
| [[File:Atlas.terrain ME features 1.21.110.22.png|2048px]]
| Added lightning rod oxidization states.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[File:Atlas.terrain ME features 1.21.110.23.png|2048px]]
| Added copper bars, copper chain, copper lantern, and copper torch.{{verify}}
|
|
|
|-
| [[Minecraft:Bedrock Edition 1.21.120|1.21.120]]
| [[Minecraft:Bedrock Edition Preview 1.21.120.21|Preview 1.21.120.21]]
| [[File:Atlas.terrain ME features 1.21.120.png|2048px]]
|
| Changed copper lanterns, copper torches, and weathered copper bars.
|
|
|}

===== Mipmapped versions =====
{{empty section}}

== Navigation ==
{{Navbox texture atlases}}