Minecraft:Atlas - Revision history

SyncBot: Sync: updated from Minecraft

2026-09-16T11:06:14Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:06, 16 September 2026
Line 83:		Line 83:
	**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.		**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.
	**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.		**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.
	**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (~~relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}}~~ relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.		**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.
	**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (~~relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}}~~ relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.		**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.
	</div>		</div>

Line 182:		Line 182:
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	~~\|{{HistoryLine\|java upcoming}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.		\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.
	\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.		\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.

SyncBot: Sync: updated from Minecraft

2026-09-11T11:01:27Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:01, 11 September 2026
Line 91:		Line 91:
	All the atlases that are currently used by the game.		All the atlases that are currently used by the game.

	For atlases which support {{Wikipedia\|mipmap\|mipmapping}}, all sprites should be a minimum of ~~16x16~~ pixels in size and a multiple of 2. If these guidelines aren't met the maximum mipmap level is limited and a message is printed in the log along the lines of '<code>Texture <sprite id> with size <width>x<height> limits mip level from <target mip level> to <limited mip level></code>'.		For atlases which support {{Wikipedia\|mipmap\|mipmapping}}, all sprites should be a minimum of 16×16 pixels in size and a multiple of 2. If these guidelines aren't met the maximum mipmap level is limited and a message is printed in the log along the lines of '<code>Texture <sprite id> with size <width>x<height> limits mip level from <target mip level> to <limited mip level></code>'.

	{\| class="wikitable"		{\| class="wikitable"

SyncBot: Sync: updated from Minecraft

2026-09-08T11:00:57Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:00, 8 September 2026
Line 11:		Line 11:
	It is not possible to define custom atlases simply by creating the JSON file for one as atlases must be registerred in the game code. Unknown atlas files are ignored by the game when loading resources.		It is not possible to define custom atlases simply by creating the JSON file for one as atlases must be registerred in the game code. Unknown atlas files are ignored by the game when loading resources.

	=== JSON format ===		== JSON format ==

	<div class="treeview">		<div class="treeview">
	*{{nbt\|compound}} The root tag.		*{{nbt\|compound}} The root tag.
	**{{nbt\|list\|sources}}: Contains a list of sprite sources. Every entry runs in during load, in order of definition, adding or removing new textures to the atlas.		**{{nbt\|list\|sources}}: Contains a list of sprite sources. Every entry runs in during load, in order of definition, adding or removing new textures to the atlas.
	***{{nbt\|compound}} ~~Source element~~.		***{{nbt\|compound}} A sprite source.
	****{{nbt\|string\|type}}: The ~~type~~ of ~~the~~ sprite source. ~~Can be one of the following:~~		****{{nbt\|string\|type}}: The [[Minecraft:Identifier]] of a sprite source. See {{slink\|\|Sprite source types}}
	*****''directory~~'':~~ Lists all files in a directory and its subdirectories, across all namespaces.		**** Additional fields depending on value of {{code\|type}}
	******{{nbt\|string\|source}}: Directory in pack to be listed (relative to {{code\|textures}} directory).		</div>
	~~**~~{{nbt\|string\|prefix}}: String to be prefixed to the sprite name when loaded.
	*****''single~~'':~~ Adds a single ~~file~~.		=== Sprite source types ===
	******{{nbt\|string\|resource}}: ~~Location~~ of a resource ~~within the pack~~ (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
	~~**~~{{nbt\|string\|sprite}}: ~~Sprite name~~ (optional, defaults to the value of {{code\|resource}}).		==== {{code\|minecraft:directory}} ====
	*****''filter~~'':~~ Removes sprites ~~matching~~ the given pattern (only works for entries ~~already~~ in the ~~list~~).
	~~~~{{nbt\|~~compound~~\|~~pattern~~}}		Lists all files in a directory and its subdirectories, across all namespaces.
	~~***~~{{nbt\|string\|namespace}}: ~~{{W\|~~Regular expression}} of the namespace ~~identificator~~ to be removed~~, if~~ omitted, any value is matched.
	~~***~~{{nbt\|string\|path}}: Regular expression of the path to be removed~~, if~~ omitted, any value is matched.		<div class="treeview">
	*****''unstitch~~'':~~ Copies rectangular regions from other images.		*{{nbt\|compound}} The root compound
	******{{nbt\|string\|resource}}: ~~Location~~ of a resource ~~within the pack~~ (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).		**{{nbt\|string\|type}}: {{code\|minecraft:directory}}
	~~**~~{{nbt\|double\|divisor_x}}: Used for determining the units used by in the {{code\|x}} coordinate of regions.		**{{nbt\|string\|source}}: Directory in pack to be listed (relative to {{code\|textures}} directory).
	~~**~~{{nbt\|double\|divisor_y}}: Used for determining the units used by in the {{code\|y}} coordinate of regions.		**{{nbt\|string\|prefix}}: String to be prefixed to the sprite name when loaded.
	~~**~~{{nbt\|list\|regions}}: List of regions to copy from the source image.		</div>
	~~**~~*{{nbt\|string\|sprite}}: ~~Specifies~~ the sprite ~~name~~.
	~~**~~*{{nbt\|double\|x}}: Specifies the {{code\|x}} coordinate of the top-left corner of the region.		==== {{code\|minecraft:single}} ====
	~~**~~*{{nbt\|double\|y}}: Specifies the {{code\|y}} coordinate of the top-left corner of the region.
	~~**~~*{{nbt\|double\|width}}: Specifies the width of the region.		Adds a single sprite to the atlas.
	~~**~~*{{nbt\|double\|height}}: Specifies the height of the region.
	*****''paletted_permutations~~'':~~ Dynamically generate ~~textures~~ in-memory ~~with~~ color ~~sets~~.		<div class="treeview">
	******{{nbt\|list\|textures}}: A list of ~~namespaced~~ [[Minecraft:~~resource location~~]]s of ~~base~~ textures. These textures are used to generate variants of them that have been modified by color palettes.		*{{nbt\|compound}} The root compound
	~~**~~{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.		**{{nbt\|string\|type}}: {{code\|minecraft:single}}
	~~**~~{{nbt\|string\|palette_key}}: ~~A namespaced resource location~~ of a color palette key ~~file~~. This is used to define the set of key pixel colors to swap out with the color palettes defined.		**{{nbt\|string\|resource}}: The [[Minecraft:Identifier\|identifier]] of a resource (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
	~~**~~{{nbt\|compound\|permutations}}: A map of permutations from suffix to ~~a namespaced resource location~~ of a color palette file. The suffix is appended to the ~~resource location~~ of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the palette_key defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the palette_key are copied over to the resulting texture as-is.		**{{nbt\|string\|sprite}}: Name (as an [[Minecraft:Identifier\|identifier]]) of the sprite that is added to the atlas (optional, defaults to the value of {{code\|resource}}).
			</div>

			==== {{code\|minecraft:filter}} ====

			Removes sprites whose [[Minecraft:Identifier\|identifier]] match the given {{Wikipedia\|Regular expression}} pattern (only works for entries in packs with a lower priority to the current one {{verify\|I'm pretty sure this is how it works, but need to verify it}}).

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:filter}}
			**{{nbt\|string\|namespace}}: Regular expression of the namespace to be removed. If omitted, any value is matched.
			**{{nbt\|string\|path}}: Regular expression of the path to be removed. If omitted, any value is matched.
			</div>

			==== {{code\|minecraft:unstitch}} ====

			Copies rectangular regions from other images and adds them to the atlas with the specified names.

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:unstitch}}
			**{{nbt\|string\|resource}}: The [[Minecraft:Identifier\|identifier]] of a resource (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
			**{{nbt\|double\|divisor_x}}: Used for determining the units used by in the {{code\|x}} coordinate of regions.
			**{{nbt\|double\|divisor_y}}: Used for determining the units used by in the {{code\|y}} coordinate of regions.
			**{{nbt\|list\|regions}}: List of regions to copy from the source image.
			***{{nbt\|string\|sprite}}: Name (as an [[Minecraft:Identifier\|identifier]]) of the sprite that is added to the atlas.
			***{{nbt\|double\|x}}: Specifies the {{code\|x}} coordinate of the top-left corner of the region.
			***{{nbt\|double\|y}}: Specifies the {{code\|y}} coordinate of the top-left corner of the region.
			***{{nbt\|double\|width}}: Specifies the width of the region.
			***{{nbt\|double\|height}}: Specifies the height of the region.
			</div>

			==== {{code\|minecraft:paletted_permutations}} ====

			Dynamically generate sprites in-memory from a set of color palettes and base textures.

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:paletted_permutations}}
			**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.
			**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.
			**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}} relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.
			**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}} relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.
	</div>		</div>

Line 141:		Line 183:
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.
			\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.
			}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-08-06T11:05:48Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 6 August 2026
Line 58:		Line 58:
	\|-		\|-
	\| armor_trims		\| armor_trims
	\| Contains paletted ~~pemutations~~ of all armor trim equipment textures. This does not include the item overlays, those are defined in the <code>items</code> atlas.		\| Contains paletted permutations of all armor trim equipment textures. This does not include the item overlays, those are defined in the <code>items</code> atlas.
	\| Rendering of armor trim layers on equipment		\| Rendering of armor trim layers on equipment
	\| {{tc\|No}}		\| {{tc\|No}}

SyncBot: Sync: updated from Minecraft

2026-07-12T11:06:19Z

Sync: updated from Minecraft

@@ Line 2: / Line 2: @@
 {{Exclusive|java}}
-'''Atlases''' are configuration files in [[Minecraft:resource pack]]s, that control which textures are included in the atlases.
+An '''atlas''' is effectively a collection of individual sprites that are combined into one large image when resource packs are loaded. In Minecraft, these are used by various objects such as terrain, items, most gui widgets, and certain block entity textures.
-== JSON format ==
+== Specification ==
-Atlases are stored as [[Minecraft:JSON]] files in a resource pack in the <code>assets/''<namespace>''/atlases</code> folder.
+The sprites that are included in an atlas are controlled by json files in a [[Minecraft:resource pack]]. These are stored in the <code>assets/<namespace>/atlases/<id>.json</code> directory of a resource pack with the following format.
 <div class="treeview">
@@ Line 40: / Line 46: @@
 == List of atlases ==
-* <code>armor_trims</code> {{until|je 26.3}}
-* <code>banner_patterns</code>
+All the atlases that are currently used by the game.
-* <code>blocks</code>
-* <code>celestials</code>
+For atlases which support {{Wikipedia|mipmap|mipmapping}}, all sprites should be a minimum of 16x16 pixels in size and a multiple of 2. If these guidelines aren't met the maximum mipmap level is limited and a message is printed in the log along the lines of '<code>Texture <sprite id> with size <width>x<height> limits mip level from <target mip level> to <limited mip level></code>'.
-* <code>chests</code>
-* <code>decorated_pot</code>
+{| class="wikitable"
-* <code>gui</code>
+! Identifier
-* <code>items</code>
+! Contents
-* <code>map_decorations</code>
+! Used for
-* <code>paintings</code>
+! Supports mipmapping
-* <code>particles</code>
+|-
-* <code>shield_patterns</code>
+| armor_trims
-* <code>shulker_boxes</code>
+| Contains paletted pemutations of all armor trim equipment textures. This does not include the item overlays, those are defined in the <code>items</code> atlas.
 == History ==

SyncBot: Sync: updated from Minecraft

2026-06-27T11:15:37Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:15, 27 June 2026
Line 67:		Line 67:
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}
	\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.		\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.
	\|Moved ~~armour~~ trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}		\|Moved armor trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}

SyncBot: Sync: updated from Minecraft

2026-06-24T11:08:47Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 24 June 2026
Line 40:		Line 40:

	== List of atlases ==		== List of atlases ==
	* <code>armor_trims</code>		* <code>armor_trims</code> {{until\|je 26.3}}
	* <code>banner_patterns</code>		* <code>banner_patterns</code>
	* <code>blocks</code>		* <code>blocks</code>
Line 70:		Line 70:
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
			\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-06-17T11:01:41Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:01, 17 June 2026
Line 41:		Line 41:
	== List of atlases ==		== List of atlases ==
	* <code>armor_trims</code>		* <code>armor_trims</code>
	* <code>beds</code> {{until\|je 26.2}}
	* <code>banner_patterns</code>		* <code>banner_patterns</code>
	* <code>blocks</code>		* <code>blocks</code>
Line 54:		Line 53:
	* <code>shield_patterns</code>		* <code>shield_patterns</code>
	* <code>shulker_boxes</code>		* <code>shulker_boxes</code>
	* <code>signs</code> {{until\|je 26.2}}

	== History ==		== History ==
Line 70:		Line 68:
	\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.		\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.
	\|Moved armour trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}		\|Moved armour trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}

SyncBot: Sync: updated from Minecraft

2026-05-23T11:01:57Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:01, 23 May 2026
Line 1:		Line 1:
			{{move\|Atlas definition\|reason=much like other technical pages like [[Minecraft:Enchantment definition]]. Contrary to what the beginning sentence insists, atlases are '''not''' configuration files, they are graphic files. This page discusses how the game handles them.}}
	{{Exclusive\|java}}		{{Exclusive\|java}}

SyncBot: Sync: updated from Minecraft

2026-05-20T11:02:10Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 20 May 2026
Line 67:		Line 67:
	\|{{HistoryLine\|\|1.21.6\|dev=25w19a\|The <code>mob_effects</code> atlas has been removed, all sprites that were previously stitched to this atlas are instead stitched to the <code>gui</code> atlas.}}		\|{{HistoryLine\|\|1.21.6\|dev=25w19a\|The <code>mob_effects</code> atlas has been removed, all sprites that were previously stitched to this atlas are instead stitched to the <code>gui</code> atlas.}}
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}
	\|{{HistoryLine\|\|~~1.21.11~~\|dev=25w45a\|Added the <code>items</code> atlas.\|~~Removed~~ paletted permutations from the <code>blocks</code> atlas.}}		\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.
			\|Moved armour trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}
	\|{{HistoryLine\|upcoming java}}		\|{{HistoryLine\|upcoming java}}
	\|{{HistoryLine\|\|26.2\|dev=~~26.2 Snapshot 4~~\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|~~26.2~~\|dev=~~26.2 Snapshot 7~~\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	}}		}}

← Older revision		Revision as of 11:06, 16 September 2026
Line 83:		Line 83:
	**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.		**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.
	**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.		**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.
	**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (~~relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}}~~ relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.		**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.
	**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (~~relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}}~~ relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.		**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.
	</div>		</div>

Line 182:		Line 182:
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	~~\|{{HistoryLine\|java upcoming}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.		\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.
	\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.		\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.

← Older revision		Revision as of 11:00, 8 September 2026
Line 11:		Line 11:
	It is not possible to define custom atlases simply by creating the JSON file for one as atlases must be registerred in the game code. Unknown atlas files are ignored by the game when loading resources.		It is not possible to define custom atlases simply by creating the JSON file for one as atlases must be registerred in the game code. Unknown atlas files are ignored by the game when loading resources.

	=== JSON format ===		== JSON format ==

	<div class="treeview">		<div class="treeview">
	*{{nbt\|compound}} The root tag.		*{{nbt\|compound}} The root tag.
	**{{nbt\|list\|sources}}: Contains a list of sprite sources. Every entry runs in during load, in order of definition, adding or removing new textures to the atlas.		**{{nbt\|list\|sources}}: Contains a list of sprite sources. Every entry runs in during load, in order of definition, adding or removing new textures to the atlas.
	***{{nbt\|compound}} ~~Source element~~.		***{{nbt\|compound}} A sprite source.
	****{{nbt\|string\|type}}: The ~~type~~ of ~~the~~ sprite source. ~~Can be one of the following:~~		****{{nbt\|string\|type}}: The [[Minecraft:Identifier]] of a sprite source. See {{slink\|\|Sprite source types}}
	*****''directory~~'':~~ Lists all files in a directory and its subdirectories, across all namespaces.		**** Additional fields depending on value of {{code\|type}}
	******{{nbt\|string\|source}}: Directory in pack to be listed (relative to {{code\|textures}} directory).		</div>
	~~**~~{{nbt\|string\|prefix}}: String to be prefixed to the sprite name when loaded.
	*****''single~~'':~~ Adds a single ~~file~~.		=== Sprite source types ===
	******{{nbt\|string\|resource}}: ~~Location~~ of a resource ~~within the pack~~ (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
	~~**~~{{nbt\|string\|sprite}}: ~~Sprite name~~ (optional, defaults to the value of {{code\|resource}}).		==== {{code\|minecraft:directory}} ====
	*****''filter~~'':~~ Removes sprites ~~matching~~ the given pattern (only works for entries ~~already~~ in the ~~list~~).
	~~~~{{nbt\|~~compound~~\|~~pattern~~}}		Lists all files in a directory and its subdirectories, across all namespaces.
	~~***~~{{nbt\|string\|namespace}}: ~~{{W\|~~Regular expression}} of the namespace ~~identificator~~ to be removed~~, if~~ omitted, any value is matched.
	~~***~~{{nbt\|string\|path}}: Regular expression of the path to be removed~~, if~~ omitted, any value is matched.		<div class="treeview">
	*****''unstitch~~'':~~ Copies rectangular regions from other images.		*{{nbt\|compound}} The root compound
	******{{nbt\|string\|resource}}: ~~Location~~ of a resource ~~within the pack~~ (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).		**{{nbt\|string\|type}}: {{code\|minecraft:directory}}
	~~**~~{{nbt\|double\|divisor_x}}: Used for determining the units used by in the {{code\|x}} coordinate of regions.		**{{nbt\|string\|source}}: Directory in pack to be listed (relative to {{code\|textures}} directory).
	~~**~~{{nbt\|double\|divisor_y}}: Used for determining the units used by in the {{code\|y}} coordinate of regions.		**{{nbt\|string\|prefix}}: String to be prefixed to the sprite name when loaded.
	~~**~~{{nbt\|list\|regions}}: List of regions to copy from the source image.		</div>
	~~**~~*{{nbt\|string\|sprite}}: ~~Specifies~~ the sprite ~~name~~.
	~~**~~*{{nbt\|double\|x}}: Specifies the {{code\|x}} coordinate of the top-left corner of the region.		==== {{code\|minecraft:single}} ====
	~~**~~*{{nbt\|double\|y}}: Specifies the {{code\|y}} coordinate of the top-left corner of the region.
	~~**~~*{{nbt\|double\|width}}: Specifies the width of the region.		Adds a single sprite to the atlas.
	~~**~~*{{nbt\|double\|height}}: Specifies the height of the region.
	*****''paletted_permutations~~'':~~ Dynamically generate ~~textures~~ in-memory ~~with~~ color ~~sets~~.		<div class="treeview">
	******{{nbt\|list\|textures}}: A list of ~~namespaced~~ [[Minecraft:~~resource location~~]]s of ~~base~~ textures. These textures are used to generate variants of them that have been modified by color palettes.		*{{nbt\|compound}} The root compound
	~~**~~{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.		**{{nbt\|string\|type}}: {{code\|minecraft:single}}
	~~**~~{{nbt\|string\|palette_key}}: ~~A namespaced resource location~~ of a color palette key ~~file~~. This is used to define the set of key pixel colors to swap out with the color palettes defined.		**{{nbt\|string\|resource}}: The [[Minecraft:Identifier\|identifier]] of a resource (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
	~~**~~{{nbt\|compound\|permutations}}: A map of permutations from suffix to ~~a namespaced resource location~~ of a color palette file. The suffix is appended to the ~~resource location~~ of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the palette_key defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the palette_key are copied over to the resulting texture as-is.		**{{nbt\|string\|sprite}}: Name (as an [[Minecraft:Identifier\|identifier]]) of the sprite that is added to the atlas (optional, defaults to the value of {{code\|resource}}).
			</div>

			==== {{code\|minecraft:filter}} ====

			Removes sprites whose [[Minecraft:Identifier\|identifier]] match the given {{Wikipedia\|Regular expression}} pattern (only works for entries in packs with a lower priority to the current one {{verify\|I'm pretty sure this is how it works, but need to verify it}}).

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:filter}}
			**{{nbt\|string\|namespace}}: Regular expression of the namespace to be removed. If omitted, any value is matched.
			**{{nbt\|string\|path}}: Regular expression of the path to be removed. If omitted, any value is matched.
			</div>

			==== {{code\|minecraft:unstitch}} ====

			Copies rectangular regions from other images and adds them to the atlas with the specified names.

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:unstitch}}
			**{{nbt\|string\|resource}}: The [[Minecraft:Identifier\|identifier]] of a resource (relative to {{code\|textures}} directory, implied {{code\|.png}} extension).
			**{{nbt\|double\|divisor_x}}: Used for determining the units used by in the {{code\|x}} coordinate of regions.
			**{{nbt\|double\|divisor_y}}: Used for determining the units used by in the {{code\|y}} coordinate of regions.
			**{{nbt\|list\|regions}}: List of regions to copy from the source image.
			***{{nbt\|string\|sprite}}: Name (as an [[Minecraft:Identifier\|identifier]]) of the sprite that is added to the atlas.
			***{{nbt\|double\|x}}: Specifies the {{code\|x}} coordinate of the top-left corner of the region.
			***{{nbt\|double\|y}}: Specifies the {{code\|y}} coordinate of the top-left corner of the region.
			***{{nbt\|double\|width}}: Specifies the width of the region.
			***{{nbt\|double\|height}}: Specifies the height of the region.
			</div>

			==== {{code\|minecraft:paletted_permutations}} ====

			Dynamically generate sprites in-memory from a set of color palettes and base textures.

			<div class="treeview">
			*{{nbt\|compound}} The root compound
			**{{nbt\|string\|type}}: {{code\|minecraft:paletted_permutations}}
			**{{nbt\|list\|textures}}: A list of [[Minecraft:Identifier\|identifiers]] of resources (relative to {{code\|textures}} directory, implied {{code\|.png}} extension). These textures are used to generate variants of them that have been modified by color palettes.
			**{{nbt\|string\|separator}}: A value that is used when joining texture and permutation names to produce sprite name. Defaults to {{cd\|_}}.
			**{{nbt\|string\|palette_key}}: An [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}} relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette key texture. This is used to define the set of key pixel colors to swap out with the color palettes defined.
			**{{nbt\|compound\|permutations}}: A map of permutations from suffix string to an [[Minecraft:Identifier\|identifier]] (relative to {{code\|textures}} directory{{until\|je 26.3}}. {{INUpcoming\|je 26.3}} relative to {{code\|textures/palettes}} directory. Implied {{code\|.png}} extension) of a color palette file. The suffix is appended to the identifier of the output variant textures, with the string specified in <code>separator</code> separating the suffix and the base texture name. The number of pixels in each color palette must be the same as that of the {{code\|palette_key}} defined for this source. Pixels are compared by RGB value. The alpha channel is ignored for key matching, but in the resulting texture the alpha channel is multiplied with the color palette's alpha channel. Pixels that do not match the {{code\|palette_key}} are copied over to the resulting texture as-is.
	</div>		</div>

Line 141:		Line 183:
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Removed the <code>armor_trims</code> atlas.
			\|For the {{code\|paletted_permutations}} sprite source, palette texture identifiers in the {{code\|palette_key}} and {{code\|permutations}} fields now resolve to {{code\|<namespace>:textures/palettes/<path>.png}} rather than {{code\|<namespace>:textures/<path>.png}}.
			}}
	}}		}}

← Older revision		Revision as of 11:15, 27 June 2026
Line 67:		Line 67:
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}
	\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.		\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.
	\|Moved ~~armour~~ trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}		\|Moved armor trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}
	\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}

← Older revision		Revision as of 11:02, 20 May 2026
Line 67:		Line 67:
	\|{{HistoryLine\|\|1.21.6\|dev=25w19a\|The <code>mob_effects</code> atlas has been removed, all sprites that were previously stitched to this atlas are instead stitched to the <code>gui</code> atlas.}}		\|{{HistoryLine\|\|1.21.6\|dev=25w19a\|The <code>mob_effects</code> atlas has been removed, all sprites that were previously stitched to this atlas are instead stitched to the <code>gui</code> atlas.}}
	\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w41a\|Added the <code>celestials</code> atlas which contains celestial bodies including the sun, moon phases, and end flash.}}
	\|{{HistoryLine\|\|~~1.21.11~~\|dev=25w45a\|Added the <code>items</code> atlas.\|~~Removed~~ paletted permutations from the <code>blocks</code> atlas.}}		\|{{HistoryLine\|\|\|dev=25w45a\|Added the <code>items</code> atlas.
			\|Moved armour trim item overlay paletted permutations from the <code>blocks</code> atlas to <code>items</code>.}}
	\|{{HistoryLine\|upcoming java}}		\|{{HistoryLine\|upcoming java}}
	\|{{HistoryLine\|\|26.2\|dev=~~26.2 Snapshot 4~~\|Removed the <code>beds</code> atlas.}}		\|{{HistoryLine\|\|26.2\|dev=snap4\|Removed the <code>beds</code> atlas.}}
	\|{{HistoryLine\|\|~~26.2~~\|dev=~~26.2 Snapshot 7~~\|Removed the <code>signs</code> atlas.}}		\|{{HistoryLine\|\|\|dev=snap7\|Removed the <code>signs</code> atlas.}}
	}}		}}