Minecraft:Model - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-10T11:10:51Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 10 October 2026
Line 39:		Line 39:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}.{{info needed\|How much shading do each of these apply?}} This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.

SyncBot: Sync: updated from Minecraft

2026-09-17T11:18:05Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:18, 17 September 2026
Line 39:		Line 39:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
Line 76:		Line 75:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.

SyncBot: Sync: updated from Minecraft

2026-09-16T11:28:45Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-09-08T11:09:00Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 8 September 2026
Line 3:		Line 3:
	{{exclusive\|java}}		{{exclusive\|java}}
	{{split\|Model/Before 14w07a\|Model/Before 14w25a\|reason=These two iterations are quite different from the modern general format and should be covered accordingly (when they do get covered, that is)}}		{{split\|Model/Before 14w07a\|Model/Before 14w25a\|reason=These two iterations are quite different from the modern general format and should be covered accordingly (when they do get covered, that is)}}
			{{split\|Model/Before 24w45a\|reason=As of this version, the game makes no distinction between block models and item models internally. This page could be significantly simplified and document the singular model format, while documenting the slight differences between models used in a terrain rendering context or an item rendering context. [[User:Ioblackshaw/draft/Model]] is a rough example of what this could look like for the current Model page}}

	'''Models''' are three-dimensional shapes used in ''Minecraft'' that are used to display objects encountered in the game.		'''Models''' are three-dimensional shapes used in ''Minecraft'' that are used to display objects encountered in the game.

SyncBot: Sync: updated from Minecraft

2026-08-26T11:17:22Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-07-23T11:08:09Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 23 July 2026
Line 82:		Line 82:
	****** {{nbt\|int\|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).		****** {{nbt\|int\|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).
	****** {{nbt\|int\|tintindex}}: Tints the texture on that face using a tint value referenced from the [[Minecraft:Items model definition#model\|Items model definition]]. If no tint color (or the color white) is provided, the texture isn't tinted.		****** {{nbt\|int\|tintindex}}: Tints the texture on that face using a tint value referenced from the [[Minecraft:Items model definition#model\|Items model definition]]. If no tint color (or the color white) is provided, the texture isn't tinted.
	** {{nbt\|list\|overrides}}: As of [[Minecraft:24w45a\| 24w45a]]/[[Minecraft:1.21.4\| 1.21.4]]+, overrides have been removed & replaced with a ~~new system~~. ~~Documentation for it can~~ be ~~found~~ [[Minecraft:~~Items_model_definition~~\| ~~here~~]].		** {{nbt\|list\|overrides}}<span style="color:red;">*</span>: As of [[Minecraft:24w45a\| 24w45a]]/[[Minecraft:1.21.4\| 1.21.4]]+, overrides have been removed and replaced with [[Minecraft:Items_model_definition\| Item model definitions]]. Before this change, this field was a list of cases that could change the model when its predicates passed. If the predicates of more than one case passed, only the last case took effect.
			*** {{nbt\|compound\|}} A case.
			**** {{nbt\|compound\|predicate}}: Holds one or more predicates that have to be met, see [[Minecraft:Tutorial:Models#Item predicates\|item predicates]].
			**** {{nbt\|string\|model}}: The [[Minecraft:Identifier\|resource location]] of the model used if the predicates are met.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-07-09T11:10:49Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-07-08T11:13:26Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:13, 8 July 2026
Line 281:		Line 281:
	\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}
	\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the <code>textures</code> map has been updated.}}		\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the <code>textures</code> map has been updated.}}
			\|{{HistoryLine\|\|26.3\|dev=snap3\|Added an optional <code>shade_direction_override</code> property to block model elements.\|Removed the <code>shade</code> property from block model elements.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-06-12T11:09:35Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 12 June 2026
Line 207:		Line 207:

	== Limitations ==		== Limitations ==
			{{Hatnote\| For block limitations see [[Minecraft:non-model-dependent block elements]]}}
	=== Objects that cannot be remodelled ===		=== Objects that cannot be remodelled ===
	{{info needed section\|Objects needing testing:		{{info needed section\|Objects needing testing:

SyncBot: Sync: updated from Minecraft

2026-05-26T11:09:50Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 26 May 2026
Line 211:		Line 211:
	{{info needed section\|Objects needing testing:		{{info needed section\|Objects needing testing:
	* Trident		* Trident
	* Is the shield model hardcoded and non-customizable, even if the shield item definition isn't required to point to it?		* Is the shield model hardcoded and non-customizable, even if the shield item definition isn't required to point to it?}}
	* Non-customizable elements of customizable block models (e.g. sign text, bell, items on shelves and campfires, books on enchanting tables and lecterns, beacon beam, small mob spawner entity, conduit, head, chest, shulker box, banner, decorated pot, item in vault, item coming out of suspicious sand/gravel, copper golem statue), and possibly also emitted particles}}
	While most blocks and items can have their model changed, there are a multitude of things that cannot.		While most blocks and items can have their model changed, there are a multitude of things that cannot.

← Older revision		Revision as of 11:10, 10 October 2026
Line 39:		Line 39:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}.{{info needed\|How much shading do each of these apply?}} This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.

← Older revision		Revision as of 11:18, 17 September 2026
Line 39:		Line 39:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
Line 76:		Line 75:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.

← Older revision		Revision as of 11:08, 23 July 2026
Line 82:		Line 82:
	****** {{nbt\|int\|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).		****** {{nbt\|int\|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).
	****** {{nbt\|int\|tintindex}}: Tints the texture on that face using a tint value referenced from the [[Minecraft:Items model definition#model\|Items model definition]]. If no tint color (or the color white) is provided, the texture isn't tinted.		****** {{nbt\|int\|tintindex}}: Tints the texture on that face using a tint value referenced from the [[Minecraft:Items model definition#model\|Items model definition]]. If no tint color (or the color white) is provided, the texture isn't tinted.
	** {{nbt\|list\|overrides}}: As of [[Minecraft:24w45a\| 24w45a]]/[[Minecraft:1.21.4\| 1.21.4]]+, overrides have been removed & replaced with a ~~new system~~. ~~Documentation for it can~~ be ~~found~~ [[Minecraft:~~Items_model_definition~~\| ~~here~~]].		** {{nbt\|list\|overrides}}<span style="color:red;">*</span>: As of [[Minecraft:24w45a\| 24w45a]]/[[Minecraft:1.21.4\| 1.21.4]]+, overrides have been removed and replaced with [[Minecraft:Items_model_definition\| Item model definitions]]. Before this change, this field was a list of cases that could change the model when its predicates passed. If the predicates of more than one case passed, only the last case took effect.
			*** {{nbt\|compound\|}} A case.
			**** {{nbt\|compound\|predicate}}: Holds one or more predicates that have to be met, see [[Minecraft:Tutorial:Models#Item predicates\|item predicates]].
			**** {{nbt\|string\|model}}: The [[Minecraft:Identifier\|resource location]] of the model used if the predicates are met.
	</div>		</div>

← Older revision		Revision as of 11:28, 16 September 2026
Line 40:		Line 40:
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override~~}}{{upcoming\|je 26.3~~}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
Line 77:		Line 77:
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override~~}}{{upcoming\|je 26.3~~}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.		**** {{nbt\|bool\|shade_direction_override}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
Line 289:		Line 289:
	\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}
	\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the {{cd\|textures}} map has been updated.}}		\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the {{cd\|textures}} map has been updated.}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap3\|Added the optional {{cd\|shade_direction_override}} property to block model elements.\|Removed the {{cd\|shade}} property from block model elements.}}		\|{{HistoryLine\|\|26.3\|dev=snap3\|Added the optional {{cd\|shade_direction_override}} property to block model elements.\|Removed the {{cd\|shade}} property from block model elements.}}
	}}		}}

← Older revision		Revision as of 11:17, 26 August 2026
Line 7:		Line 7:

	The models pertaining to the vast majority of [[Minecraft:block]]s and [[Minecraft:item]]s can be configured, as well as those of a small selection of [[Minecraft:entities]]. Models are stored as [[Minecraft:JSON]] files in a [[Minecraft:resource pack]] in the <code>assets/''<namespace>''/models</code> folder.		The models pertaining to the vast majority of [[Minecraft:block]]s and [[Minecraft:item]]s can be configured, as well as those of a small selection of [[Minecraft:entities]]. Models are stored as [[Minecraft:JSON]] files in a [[Minecraft:resource pack]] in the <code>assets/''<namespace>''/models</code> folder.

			As of [[Minecraft:24w45a\|24w45a]] / [[Minecraft:1.21.4\|1.21.4]]+, the game makes no distinction between block models and item models. The {{cd\|assets/minecraft/models/item}} and {{cd\|assets/minecraft/models/block}} folders in the vanilla resource pack are purely for organization, and any model can be used for either purpose. With that said, some model properties only affect block rendering or item rendering specifically, so a model might look slightly different in different contexts.

	== Block models ==		== Block models ==
Line 36:		Line 38:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by <code>1 / cos(angle)</code>. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}: Defines if the faces of ~~the~~ element should be shaded according to their orientation (~~<code>~~true~~</code> - default~~) or not (~~<code>false</code>~~). This does not affect ambient occlusion or shading based on light level.		**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
			**** {{nbt\|bool\|shade_direction_override}}{{upcoming\|je 26.3}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
Line 72:		Line 75:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Defines if the faces of ~~the~~ element should be shaded according to their orientation (~~<code>~~true~~</code> - default~~) or ~~not~~ (~~<code>~~false~~</code>~~). This does not affect ambient occlusion or shading based on light level.		**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Optional, defaults to {{cd\|true}}. Defines whether the faces of this element should be shaded according to their orientation ({{cd\|true}}), or should always be shaded as if they were oriented straight up ({{cd\|false}}). This does not affect ambient occlusion or shading based on light level. Setting this to {{cd\|false}} will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|bool\|shade_direction_override}}{{upcoming\|je 26.3}}: Optional. Defines the ~~direction~~ of ~~the light source~~ to ~~cast a shading effect on~~ the ~~faces~~. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}~~. If not specified, no shading will be applied~~. This does not affect ambient occlusion or shading based on light level.		**** {{nbt\|bool\|shade_direction_override}}{{upcoming\|je 26.3}}: Optional. Defines whether the faces of this element should be shaded according to their orientation (default), or should always be shaded as if they had the specified orientation. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. This does not affect ambient occlusion or shading based on light level. Setting this will only affect block terrain rendering, and does not affect uses of this model in items or [[Minecraft:block display]]s.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.

← Older revision		Revision as of 11:10, 9 July 2026
Line 72:		Line 72:
	***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.		***** {{nbt\|float\|angle}}: Specifies the angle of rotation. Can be 45 through -45 degrees.
	***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.		***** {{nbt\|bool\|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
	**** {{nbt\|bool\|shade}}: Defines if the faces of the element should be shaded according to their orientation (<code>true</code> - default) or not (<code>false</code>). This does not affect ambient occlusion or shading based on light level.		**** {{nbt\|bool\|shade}}{{until\|je 26.3}}: Defines if the faces of the element should be shaded according to their orientation (<code>true</code> - default) or not (<code>false</code>). This does not affect ambient occlusion or shading based on light level.
			**** {{nbt\|bool\|shade_direction_override}}{{upcoming\|je 26.3}}: Optional. Defines the direction of the light source to cast a shading effect on the faces. The accepted values are {{cd\|d=and\|down\|up\|north\|south\|west\|east}}. If not specified, no shading will be applied. This does not affect ambient occlusion or shading based on light level.
	**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.		**** {{nbt\|int\|light_emission}}: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
	**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.		**** {{nbt\|compound\|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
Line 240:		Line 241:
	\|[[Minecraft:Ryan Holtz\|TheMogMiner]] posts about upcoming changes to the model format.}}		\|[[Minecraft:Ryan Holtz\|TheMogMiner]] posts about upcoming changes to the model format.}}
	\|{{HistoryLine\|\|\|dev=14w17a\|Converted most of the remaining static blocks to the model format.		\|{{HistoryLine\|\|\|dev=14w17a\|Converted most of the remaining static blocks to the model format.
	\|Added ~~<code>~~"rotateVariantTextures"~~</code>~~ to preserve uv details through rotation.}}		\|Added {{cd\|"rotateVariantTextures"}} to preserve uv details through rotation.}}
	\|{{HistoryLine\|\|\|dev=14w25a\|The directional attribute from the uv definition has now been removed and replaced it with explicit texture references. ~~<code>~~"textureFacing"~~</code>~~ has been replaced with ~~<code>~~"texture"~~</code>~~ parameter, which is now prepended with the hash symbol (#).		\|{{HistoryLine\|\|\|dev=14w25a\|The directional attribute from the uv definition has now been removed and replaced it with explicit texture references. {{cd\|"textureFacing"}} has been replaced with {{cd\|"texture"}} parameter, which is now prepended with the hash symbol (#).
	\|"useAmbientOcclusion" has now been renamed to "ambientocclusion".		\|"useAmbientOcclusion" has now been renamed to "ambientocclusion".
	\|"rotateVariantTextures" has now been renamed to "UV lock".		\|"rotateVariantTextures" has now been renamed to "UV lock".
	\|"cull" has now been renamed to "cullface", specifies the opposite of which neighboring face causes culling to occur.		\|"cull" has now been renamed to "cullface", specifies the opposite of which neighboring face causes culling to occur.
	\|Rotation has now been made more verbose, it is now more clear that it can occur only on a single axis. Example, the rotation for one of the two faces of the ~~<code>~~"cross"~~</code>~~ model is now: ~~<code>~~"rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },~~</code>~~.		\|Rotation has now been made more verbose, it is now more clear that it can occur only on a single axis. Example, the rotation for one of the two faces of the {{cd\|"cross"}} model is now: {{cd\|"rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },}}.
	\|The folder ~~<code>~~models/blocks/meshes~~</code>~~ has now been removed and model files are now stored in ~~<code>~~models/block~~</code>~~.		\|The folder {{cd\|models/blocks/meshes}} has now been removed and model files are now stored in {{cd\|models/block}}.
	\|The folder blockstates has now been added and stores the model selection files previously found in ~~<code>~~models/block~~</code>~~.		\|The folder blockstates has now been added and stores the model selection files previously found in {{cd\|models/block}}.
	\|The model format now supports custom [[Minecraft:item]] models.}}		\|The model format now supports custom [[Minecraft:item]] models.}}
	\|{{HistoryLine\|\|\|dev=14w27a\|[[Minecraft:Block]] state names have now been replaced with data that better reflects the internal data. This does not yet reflect all data for some blocks and switches to using the actual stored data in a future version when numerical data values are completely dropped in favor of block states.}}		\|{{HistoryLine\|\|\|dev=14w27a\|[[Minecraft:Block]] state names have now been replaced with data that better reflects the internal data. This does not yet reflect all data for some blocks and switches to using the actual stored data in a future version when numerical data values are completely dropped in favor of block states.}}
	\|{{HistoryLine\|\|\|dev=14w27b\|The block state files now support an array of models allowing for random models.}}		\|{{HistoryLine\|\|\|dev=14w27b\|The block state files now support an array of models allowing for random models.}}
	\|{{HistoryLine\|\|\|dev=14w30a\|Added the item model ~~<code>~~"builtin/entity"~~</code>~~.}}		\|{{HistoryLine\|\|\|dev=14w30a\|Added the item model {{cd\|"builtin/entity"}}.}}
	\|{{HistoryLine\|\|1.8.2\|dev=pre5\|slink=1.8.2-pre5\|The tag "translation" is now limited to the range of -24 to 24.		\|{{HistoryLine\|\|1.8.2\|dev=pre5\|slink=1.8.2-pre5\|The tag "translation" is now limited to the range of -24 to 24.
	\|The tag "scale" is now limited to 4 or less.}}		\|The tag "scale" is now limited to 4 or less.}}
Line 259:		Line 260:
	\|Models can now be put together based on block state attributes, such as [[Minecraft:fence]]s. As a result, the vanilla set of [[Minecraft:block]] models was reduced by almost 300 models.		\|Models can now be put together based on block state attributes, such as [[Minecraft:fence]]s. As a result, the vanilla set of [[Minecraft:block]] models was reduced by almost 300 models.
	\|Block model JSON is now strict, comments and quoteless identifiers are now not allowed.		\|Block model JSON is now strict, comments and quoteless identifiers are now not allowed.
	\|"display" tag defaults have now been changed, and the ~~<code>~~"thirdperson"~~</code> and <code>~~"firstperson"~~</code>~~ tags have now been replaced with ~~<code>~~"thirdperson_righthand"~~</code>, <code>~~"thirdperson_lefthand"~~</code>, <code>~~"firstperson_righthand"~~</code>, and <code>~~"firstperson_lefthand"~~</code>~~.		\|"display" tag defaults have now been changed, and the {{cd\|d=and\|"thirdperson"\|"firstperson"}} tags have now been replaced with {{cd\|d=and\|"thirdperson_righthand"\|"thirdperson_lefthand"\|"firstperson_righthand"\|"firstperson_lefthand"}}.
	\|"parent" and "elements" tags can now coexist, though the top level elements tag overwrites all former ones.		\|"parent" and "elements" tags can now coexist, though the top level elements tag overwrites all former ones.
	\|The option to disable alternate [[Minecraft:block]] models has now been removed.		\|The option to disable alternate [[Minecraft:block]] models has now been removed.
Line 266:		Line 267:
	\|Known bug in this version caused many/all items to be shifted down/positioned wrongly compared to prior versions. [https://bugs.mojang.com/browse/MC-82928 MC-82928]}}		\|Known bug in this version caused many/all items to be shifted down/positioned wrongly compared to prior versions. [https://bugs.mojang.com/browse/MC-82928 MC-82928]}}
	\|{{HistoryLine\|\|\|dev=15w31c\|Item positions have been fixed to match how they were prior to 15w31a. Although the fishing rod is still different and still is to this day.}}		\|{{HistoryLine\|\|\|dev=15w31c\|Item positions have been fixed to match how they were prior to 15w31a. Although the fishing rod is still different and still is to this day.}}
	\|{{HistoryLine\|\|1.14\|dev=18w43a\|Added the item model property ~~<code>~~"custom_model_data"~~</code>~~.}}		\|{{HistoryLine\|\|1.14\|dev=18w43a\|Added the item model property {{cd\|"custom_model_data"}}.}}
	\|{{HistoryLine\|\|1.15.2\|dev=Pre-Release 1\|The gui_light parameter for item models has been added.}}		\|{{HistoryLine\|\|1.15.2\|dev=Pre-Release 1\|The gui_light parameter for item models has been added.}}
	\|{{HistoryLine\|\|?\|Blocks that render as entities, such as chests, will now display block model data alongside their block entity (much like how enchanting tables and lecterns did previously), rather than refusing to render any model data and only using it for particle definitions.}}		\|{{HistoryLine\|\|?\|Blocks that render as entities, such as chests, will now display block model data alongside their block entity (much like how enchanting tables and lecterns did previously), rather than refusing to render any model data and only using it for particle definitions.}}
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|The "light_emission" field for models has been added.}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|The "light_emission" field for models has been added.}}
	\|{{HistoryLine\|\|\|dev=24w36a\|All item models can now use the ~~<code>~~broken~~</code>~~ property in model overrides that was previously limited to just [[Minecraft:elytra]].		\|{{HistoryLine\|\|\|dev=24w36a\|All item models can now use the {{cd\|broken}} property in model overrides that was previously limited to just [[Minecraft:elytra]].
	\|The model of an item is selected based on the {{cd\|minecraft:item_model}} component, following the format ~~<code>~~/assets/<namespace>/models/item/<id>~~</code>~~.}}		\|The model of an item is selected based on the {{cd\|minecraft:item_model}} component, following the format {{cd\|/assets/<namespace>/models/item/<id>}}.}}
	\|{{HistoryLine\|\|1.21.4\|dev=24w45a\|New format has been introduced for describing item models. See [[Minecraft:Items model definition]].		\|{{HistoryLine\|\|1.21.4\|dev=24w45a\|New format has been introduced for describing item models. See [[Minecraft:Items model definition]].
	\|The {{cd\|minecraft:item_model}} component now reference an Items model definition.		\|The {{cd\|minecraft:item_model}} component now reference an Items model definition.
Line 278:		Line 279:
	\|Models in {{cd\|models/item}} that only redirect to a block model have been removed.}}		\|Models in {{cd\|models/item}} that only redirect to a block model have been removed.}}
	\|{{HistoryLine\|\|1.21.6\|dev=25w16a\|Block model rotations are no longer limited to multiples of {{cd\|22.5}}.}}		\|{{HistoryLine\|\|1.21.6\|dev=25w16a\|Block model rotations are no longer limited to multiples of {{cd\|22.5}}.}}
	\|{{HistoryLine\|\|1.21.9\|dev=25w33a\|New item display transform ~~<code>~~on_shelf~~</code>~~. It is ignored by [[Minecraft:shelf]] with the ~~<code>~~align_items_to_bottom~~</code>~~ block state.}}		\|{{HistoryLine\|\|1.21.9\|dev=25w33a\|New item display transform {{cd\|on_shelf}}. It is ignored by [[Minecraft:shelf]] with the {{cd\|align_items_to_bottom}} block state.}}
	\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w46a\|Block model elements can now be rotated around multiple axes.\|Existing restriction for angle value limiting them to {{cd\|[-45, 45]}} has been removed.}}
	\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the ~~<code>~~textures~~</code>~~ map has been updated.}}		\|{{HistoryLine\|\|26.1\|dev=snap7\|Any block model can now support cutout or translucent (partially transparent pixels) textures.\|The format of the {{cd\|textures}} map has been updated.}}
	\|{{HistoryLine\|\|26.3\|dev=snap3\|Added an optional ~~<code>~~shade_direction_override~~</code>~~ property to block model elements.\|Removed the ~~<code>~~shade~~</code>~~ property from block model elements.}}		\|{{HistoryLine\|upcoming java}}
			\|{{HistoryLine\|\|26.3\|dev=snap3\|Added the optional {{cd\|shade_direction_override}} property to block model elements.\|Removed the {{cd\|shade}} property from block model elements.}}
	}}		}}