Minecraft:Atlas.terrain: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:<samp>atlas.terrain</samp>}} | {{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.]] | [[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 {{ | '''atlas.terrain''' is a [[Minecraft:texture atlas]] used to store all [[Minecraft:block]] textures defined in {{code|terrain_textures.json}}. | ||
== Format == | == Format == | ||
{{ | {{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 {{ | <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 {{ | 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 == | ||
{{ | {{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.{{ | 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 {{ | 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 === | ||
{{ | {{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. | 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 | ||
|{{ | |{{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.}} | |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. | |{{HistoryLine||?|Mipmapped versions use normal padding again. | ||
|Unused space is no longer filled with black.{{ | |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.}} | ||
|{{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.{{ | | 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.{{ | | 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.{{ | | Added copper bars, copper chain, copper lantern, and copper torch.{{verify}} | ||
| | | | ||
| | | | ||
| Line 94: | Line 98: | ||
==== Mipmapped versions ==== | ==== Mipmapped versions ==== | ||
{{ | {{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.{{ | | 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.{{ | | 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.{{ | | Added copper bars, copper chain, copper lantern, and copper torch.{{verify}} | ||
| | | | ||
| | | | ||
| Line 142: | Line 146: | ||
===== Mipmapped versions ===== | ===== Mipmapped versions ===== | ||
{{ | {{empty section}} | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox texture atlases}} | ||
Revision as of 11:01, 2 May 2026
Template:For Template:Exclusive Template:Stub
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
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
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. | |||