Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Atlas.terrain: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Fix template calls: add MC/ prefix
SyncBot (talk | contribs)
Sync: updated from Minecraft
Line 1: Line 1:
{{DISPLAYTITLE:<samp>atlas.terrain</samp>}}
{{DISPLAYTITLE:<samp>atlas.terrain</samp>}}
{{MC/For|a comprehensive history of block texture changes|Bedrock Edition history of textures/Blocks}}
{{for|a comprehensive history of block texture changes|Bedrock Edition history of textures/Blocks}}
{{MC/Exclusive|bedrock|education}}
{{exclusive|bedrock|education}}
{{MC/Stub}}
{{stub}}
[[File:atlas.terrain 1.21.111.png|thumb|atlas.terrain as of 1.21.111.]]
[[File:atlas.terrain 1.21.111.png|thumb|atlas.terrain as of 1.21.111.]]
'''atlas.terrain''' is a texture atlas used to store all [[Minecraft:block]] textures defined in {{MC/Code|terrain_textures.json}}.
'''atlas.terrain''' is a [[Minecraft:texture atlas]] used to store all [[Minecraft:block]] textures defined in {{code|terrain_textures.json}}.


== Format ==
== Format ==
{{MC/Info needed section|
{{info needed section|
* Is it deterministic like ''Java Edition''<nowiki/>'s?
* Is it deterministic like ''Java Edition''<nowiki/>'s?
* If ''Minecraft Earth'' was based on the BE engine, does it also have this atlas?
* 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''?
* 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 {{MC/Cd|terrain_textures.json}}, ordered alphabetically by entry, when a world is loaded. Textures with animations (defined in {{MC/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 {{MC/Code|terrain_textures.json}}, it will appear once in the first spot it occurs. If a broken or nonexistent texture is referenced, a 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.
<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 {{MC/Code|terrain_textures.json}} in loaded resource packs will show up in atlas.terrain, including those in [[Minecraft:add-on]]s and in internal packs such as {{MC/Code|chemistry}}.
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 ==
== Viewing ==
{{MC/Info needed section|
{{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 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}}
* method to get mipmapped versions without external programs}}
The file generated for atlas.terrain can be extracted by using a structure block to 3D export a structure. There has to be a semi-transparent block like stained glass to export the right image.{{MC/Needs testing}} The exported file can then be converted into an OBJ file, where its UV, identical to the atlas, can be accessed.{{MC/Info needed|check if this works in beta 1.2.0.2, or if it only became possible later}}
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 {{MC/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]]). {{MC/Info needed|How far back do these work?}}
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 ===
=== External programs ===
{{MC/Missing info|section|can this be used to obtain blocks-atlas and items-atlas from 13w18a to 13w37b? From testing it crashes in older versions.}}
{{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.}}
{{MC/Disclaimer|section=1}}
{{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.
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 ==
== History ==
{{HistoryTable
{{HistoryTable
|{{MC/HistoryLine|pocket alpha}}
|{{HistoryLine|pocket alpha}}
|{{MC/HistoryLine||v0.15.0|dev=build 1|Added atlas.terrain following the deprecation of terrain-atlas.tga
|{{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.}}
|Empty areas which are not used by any textures are solid black.}}
|{{MC/HistoryLine|||dev=?|Mipmapped versions now have anisotropic filtering.}}
|{{HistoryLine|||dev=?|Mipmapped versions now have anisotropic filtering.}}
|{{MC/HistoryLine|?}}
|{{HistoryLine|?}}
|{{HistoryLine||?|Mipmapped versions use normal padding again.
|{{HistoryLine||?|Mipmapped versions use normal padding again.
|Unused space is no longer filled with black.{{MC/More info|Which of these came first and when?}}}}
|Unused space is no longer filled with black.{{more info|Which of these came first and when?}}}}
|{{MC/HistoryLine|bedrock}}
|{{HistoryLine|bedrock}}
|{{MC/HistoryLine||1.21.60|dev=Preview 1.21.60.21|Improved logic for handling very large textures within atlases.}}
|{{HistoryLine||1.21.60|dev=Preview 1.21.60.21|Improved logic for handling very large textures within atlases.}}
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||26.30|dev=Preview 26.30.20|Removed padding from terrain atlas on [[Minecraft:RenderDragon]]. There is currently an issue where [[Minecraft:RTX]] cannot handle this correctly and renders all block textures with the terrain atlas, also showing MERS textures and animations. This will be fixed in the ''Preview'' following [[Minecraft:Bedrock Edition Preview 26.30.25]].}}
}}
}}
[[File:RTX terrain atlas issue.png|left|thumb|The RTX terrain atlas issue. Note that the grass on the right has biome-tinted pixels.]]
{{-}}


=== Versions of the atlas ===
=== Versions of the atlas ===
Line 55: Line 59:
|-
|-
| [[Minecraft:Pocket Edition v0.15.0 alpha|v0.15.0 alpha]]
| [[Minecraft:Pocket Edition v0.15.0 alpha|v0.15.0 alpha]]
| build 1
| [[Minecraft:Pocket Edition v0.15.0 alpha build 1|build 1]]
| [[File:Atlas.terrain v0.15.0 alpha build 1.png|1024px]]
| [[File:Atlas.terrain v0.15.0 alpha build 1.png|1024px]]
| colspan="3" style="text-align:center"| ''Introduction''
| colspan="3" style="text-align:center"| ''Introduction''
Line 65: Line 69:
| [[Minecraft:Bedrock Edition Preview 1.21.110.20|Preview 1.21.110.20]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.20|Preview 1.21.110.20]]
| [[File:Atlas.terrain 1.21.110.20.png|2048px]]
| [[File:Atlas.terrain 1.21.110.20.png|2048px]]
| Added shelves.{{MC/Verify}}
| Added shelves.{{verify}}
|
|
|
|
Line 72: Line 76:
| [[Minecraft:Bedrock Edition Preview 1.21.110.22|Preview 1.21.110.22]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.22|Preview 1.21.110.22]]
| [[File:Atlas.terrain 1.21.110.22.png|2048px]]
| [[File:Atlas.terrain 1.21.110.22.png|2048px]]
| Added lightning rod oxidization states.{{MC/Verify}}
| Added lightning rod oxidization states.{{verify}}
|
|
|
|
Line 79: Line 83:
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[File:Atlas.terrain 1.21.111.png|2048px]]
| [[File:Atlas.terrain 1.21.111.png|2048px]]
| Added copper bars, copper chain, copper lantern, and copper torch.{{MC/Verify}}
| Added copper bars, copper chain, copper lantern, and copper torch.{{verify}}
|
|
|
|
Line 94: Line 98:


==== Mipmapped versions ====
==== Mipmapped versions ====
{{MC/Empty Section}}
{{empty section}}


==== ''Minecraft Education'' features ====
==== ''Minecraft Education'' features ====
Line 113: Line 117:
| [[Minecraft:Bedrock Edition Preview 1.21.110.20]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.20]]
| [[File:Atlas.terrain ME features 1.21.110.20.png|2048px]]
| [[File:Atlas.terrain ME features 1.21.110.20.png|2048px]]
| Added shelves.{{MC/Verify}}
| Added shelves.{{verify}}
|
|
|
|
Line 120: Line 124:
| [[Minecraft:Bedrock Edition Preview 1.21.110.22]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.22]]
| [[File:Atlas.terrain ME features 1.21.110.22.png|2048px]]
| [[File:Atlas.terrain ME features 1.21.110.22.png|2048px]]
| Added lightning rod oxidization states.{{MC/Verify}}
| Added lightning rod oxidization states.{{verify}}
|
|
|
|
Line 127: Line 131:
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[Minecraft:Bedrock Edition Preview 1.21.110.23|Preview 1.21.110.23]]
| [[File:Atlas.terrain ME features 1.21.110.23.png|2048px]]
| [[File:Atlas.terrain ME features 1.21.110.23.png|2048px]]
| Added copper bars, copper chain, copper lantern, and copper torch.{{MC/Verify}}
| Added copper bars, copper chain, copper lantern, and copper torch.{{verify}}
|
|
|
|
Line 142: Line 146:


===== Mipmapped versions =====
===== Mipmapped versions =====
{{MC/Empty Section}}
{{empty section}}


== Navigation ==
== Navigation ==
{{MC/Navbox texture atlases}}
{{Navbox texture atlases}}

Revision as of 11:01, 2 May 2026

Template:For Template:Exclusive Template:Stub

File:Atlas.terrain 1.21.111.png
atlas.terrain as of 1.21.111.

atlas.terrain is a Minecraft:texture atlas used to store all Minecraft:block textures defined in Template:Code.

Format

Template:Info needed section atlas.terrain 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 Template:Cd, ordered alphabetically by entry, when a world is loaded. Textures with animations (defined in Template:Code) 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 Template:Code, 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 Template:Code in loaded Minecraft:resource packs will show up in atlas.terrain, including those in Minecraft:add-ons and in internal packs such as Template:Code.

Viewing

Template:Info needed section 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.Template:Needs testing The exported file can then be converted into an OBJ file, where its UV, identical to the atlas, can be accessed.Template:Info needed

Like other atlases Template:In, atlas.terrain can also be viewed in-game by applying the resource location "atlas.terrain" to another object (e.g. an entity or a particle). Template:Info needed

External programs

Template:Missing info Template:Disclaimer 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

Template:HistoryTable

File:RTX terrain atlas issue.png
The RTX terrain atlas issue. Note that the grass on the right has biome-tinted pixels.


Versions of the atlas

Game version Atlas Additions Changes Removals Notes
Main Development
v0.15.0 alpha build 1 File:Atlas.terrain v0.15.0 alpha build 1.png Introduction
More information needed
1.21.111 Preview 1.21.110.20 File:Atlas.terrain 1.21.110.20.png Added shelves.Template:Verify
Preview 1.21.110.22 File:Atlas.terrain 1.21.110.22.png Added lightning rod oxidization states.Template:Verify
Preview 1.21.110.23 File:Atlas.terrain 1.21.111.png Added copper bars, copper chain, copper lantern, and copper torch.Template:Verify
1.21.120 Preview 1.21.120.21 File:Atlas.terrain 1.21.120.png Changed copper lanterns, copper torches, and weathered copper bars.

Mipmapped versions

Template:Empty section

Minecraft Education features

Game version Atlas Additions Changes Removals Notes
Main Development
More information needed
1.21.111 Minecraft:Bedrock Edition Preview 1.21.110.20 File:Atlas.terrain ME features 1.21.110.20.png Added shelves.Template:Verify
Minecraft:Bedrock Edition Preview 1.21.110.22 File:Atlas.terrain ME features 1.21.110.22.png Added lightning rod oxidization states.Template:Verify
Preview 1.21.110.23 File:Atlas.terrain ME features 1.21.110.23.png Added copper bars, copper chain, copper lantern, and copper torch.Template:Verify
1.21.120 Preview 1.21.120.21 File:Atlas.terrain ME features 1.21.120.png Changed copper lanterns, copper torches, and weathered copper bars.
Mipmapped versions

Template:Empty section

Navigation

Template:Navbox texture atlases