Minecraft:Atlas.terrain - Revision history

SyncBot: Sync: updated from Minecraft

2026-05-13T11:02:16Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 13 May 2026
Line 13:		Line 13:
	* How exactly are Vibrant Visuals related texture augmentations, such as bump/normal maps and emissivity (if this exist), dealt with?		* How exactly are Vibrant Visuals related texture augmentations, such as bump/normal maps and emissivity (if this exist), dealt with?
	}}		}}
	<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.		<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 occurred 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}}.		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}}.

SyncBot: Sync: updated from Minecraft

2026-05-09T11:02:43Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 9 May 2026
Line 11:		Line 11:
	* 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''?
			* How exactly are Vibrant Visuals related texture augmentations, such as bump/normal maps and emissivity (if this exist), dealt with?
	}}		}}
	<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.		<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.

SyncBot: Sync: updated from Minecraft

2026-05-07T11:02:12Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 7 May 2026
Line 41:		Line 41:
	\|{{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\|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]]~~.}}		\|{{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.}}
			\|{{HistoryLine\|\|\|dev=Preview 26.30.27\|Fixed the above issue.}}
	}}		}}
	[[File:RTX terrain atlas issue.png\|left\|thumb\|The RTX terrain atlas issue. Note that the grass on the right has biome-tinted pixels.]]		[[File:RTX terrain atlas issue.png\|left\|thumb\|The RTX terrain atlas issue. Note that the grass on the right has biome-tinted pixels.]]

SyncBot: Sync: updated from Minecraft

2026-05-02T11:01:25Z

Sync: updated from Minecraft

Show changes

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T19:02:00Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 19:02, 9 April 2026
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}}		{{MC/For\|a comprehensive history of block texture changes\|Bedrock Edition history of textures/Blocks}}
	{{~~exclusive~~\|bedrock\|education}}		{{MC/Exclusive\|bedrock\|education}}
	{{~~stub~~}}		{{MC/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 {{~~code~~\|terrain_textures.json}}.		'''atlas.terrain''' is a texture atlas used to store all [[Minecraft:block]] textures defined in {{MC/Code\|terrain_textures.json}}.

	== Format ==		== Format ==
	{{~~info~~ needed section\|		{{MC/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 {{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 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 {{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.

	Any textures added to {{~~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 {{~~code~~\|chemistry}}.		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}}.

	== Viewing ==		== Viewing ==
	{{~~info~~ needed section\|		{{MC/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.{{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}}		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}}

	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?}}		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?}}

	=== External programs ===		=== External programs ===
	{{~~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.}}		{{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.}}
	{{~~disclaimer~~\|section=1}}		{{MC/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}}		\|{{MC/HistoryLine\|pocket alpha}}
	\|{{HistoryLine\|\|v0.15.0\|dev=build 1\|Added atlas.terrain following the deprecation of terrain-atlas.tga		\|{{MC/HistoryLine\|\|v0.15.0\|dev=build 1\|Added atlas.terrain following the deprecation of 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.}}		\|{{MC/HistoryLine\|\|\|dev=?\|Mipmapped versions now have anisotropic filtering.}}
	\|{{HistoryLine\|?}}		\|{{MC/HistoryLine\|?}}
	\|{{HistoryLine\|\|?\|Mipmapped versions use normal padding again.		\|{{HistoryLine\|\|?\|Mipmapped versions use normal padding again.
	\|Unused space is no longer filled with black.{{~~more~~ info\|Which of these came first and when?}}}}		\|Unused space is no longer filled with black.{{MC/More info\|Which of these came first and when?}}}}
	\|{{HistoryLine\|bedrock}}		\|{{MC/HistoryLine\|bedrock}}
	\|{{HistoryLine\|\|1.21.60\|dev=Preview 1.21.60.21\|Improved logic for handling very large textures within atlases.}}		\|{{MC/HistoryLine\|\|1.21.60\|dev=Preview 1.21.60.21\|Improved logic for handling very large textures within atlases.}}
	}}		}}

Line 65:		Line 65:
	\| [[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.{{~~verify~~}}		\| Added shelves.{{MC/Verify}}
	\|		\|
	\|		\|
Line 72:		Line 72:
	\| [[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.{{~~verify~~}}		\| Added lightning rod oxidization states.{{MC/Verify}}
	\|		\|
	\|		\|
Line 79:		Line 79:
	\| [[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.{{~~verify~~}}		\| Added copper bars, copper chain, copper lantern, and copper torch.{{MC/Verify}}
	\|		\|
	\|		\|
Line 94:		Line 94:

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

	==== ''Minecraft Education'' features ====		==== ''Minecraft Education'' features ====
Line 113:		Line 113:
	\| [[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.{{~~verify~~}}		\| Added shelves.{{MC/Verify}}
	\|		\|
	\|		\|
Line 120:		Line 120:
	\| [[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.{{~~verify~~}}		\| Added lightning rod oxidization states.{{MC/Verify}}
	\|		\|
	\|		\|
Line 127:		Line 127:
	\| [[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.{{~~verify~~}}		\| Added copper bars, copper chain, copper lantern, and copper torch.{{MC/Verify}}
	\|		\|
	\|		\|
Line 142:		Line 142:

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

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

SyncBot: Remove broken links to missing pages

2026-04-09T15:19:20Z

Remove broken links to missing pages

← Older revision		Revision as of 15:19, 9 April 2026
Line 4:		Line 4:
	{{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 ~~[[Minecraft:~~texture atlas]] used to store all [[Minecraft:block]] textures defined in {{code\|terrain_textures.json}}.		'''atlas.terrain''' is a texture atlas used to store all [[Minecraft:block]] textures defined in {{code\|terrain_textures.json}}.

	== Format ==		== Format ==
Line 12:		Line 12:
	* 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 {{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.		<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 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}}.		Any textures added to {{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 {{code\|chemistry}}.

	== Viewing ==		== Viewing ==
Line 20:		Line 20:
	* 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 ~~[[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}}		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.{{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?}}		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.}}		{{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.}}
	{{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.
Line 32:		Line 32:
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|pocket alpha}}		\|{{HistoryLine\|pocket alpha}}
	\|{{HistoryLine\|\|v0.15.0\|dev=build 1\|Added atlas.terrain following the deprecation of ~~[[Minecraft:~~terrain-atlas.tga]]		\|{{HistoryLine\|\|v0.15.0\|dev=build 1\|Added atlas.terrain following the deprecation of 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\|\|\|dev=?\|Mipmapped versions now have anisotropic filtering.}}
Line 55:		Line 55:
	\|-		\|-
	\| [[Minecraft:Pocket Edition v0.15.0 alpha\|v0.15.0 alpha]]		\| [[Minecraft:Pocket Edition v0.15.0 alpha\|v0.15.0 alpha]]
	\| ~~[[Minecraft:Pocket Edition v0.15.0 alpha~~ build 1~~\|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''

imported>NmF: /* Format */They are ordered by size, and animated textures are still ordered by the size of the texture instead of the frame size.

2026-03-17T20:39:30Z

Format: They are ordered by size, and animated textures are still ordered by the size of the texture instead of the frame size.

New page

{{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}}