Minecraft:Armor trim definition - Revision history

SyncBot: Sync: updated from Minecraft

2026-09-24T11:04:38Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 24 September 2026
Line 27:		Line 27:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root object.<section begin="json format material" />		* {{nbt\|compound}} The root object.<section begin="json format material" />
	** {{nbt\|string\|~~asset_name~~}}: ~~Suffix to be used in sprite names and~~ [[Minecraft:~~translation key~~]]s.		** {{nbt\|string\|palette_id}}: The [[Minecraft:Identifier\|resource location]] of the color palette to be used, at <code>assets/<namespace>/textures/palettes/<path>.png</code>.
	** {{nbt\|compound\|override_armor_assets}}: Asset name overrides for specific armor materials. Used in vanilla to select darker variants when the ~~trim and armor have the same material.~~
	*** {{nbt\|string\|{{ph\|equipment asset id}}}}: Suffix to be used ~~in sprite names and [[Minecraft:translation key]]s for armor items with the corresponding~~ <code>~~asset_id~~</code> ~~specified in the {{cd\|[[Minecraft:Data component format#equippable\|equippable]]}} data component~~.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].<section end="json format material" />		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].<section end="json format material" />
	</div>		</div>
Line 40:		Line 38:
	* {{nbt\|compound}} The root object.<section begin="json format pattern" />		* {{nbt\|compound}} The root object.<section begin="json format pattern" />
	** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.		** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.
	** {{nbt\|boolean\|decal}}: ~~False for all vanilla trim patterns~~.		** {{nbt\|boolean\|decal}}: Masks the pattern based on the underlying armor texture.<ref>{{Citation\|url=https://www.minecraft.net/en-us/article/minecraft-java-edition-1-20-2\|title=Minecraft Java Edition 1.20.2 Now Available\|date=September 21, 2023\|website=Minecraft.net}}</ref> This means that on armor with transparent pixels (such as [[Minecraft:Chainmail Armor]]) the corresponding pixels will also be transparent(not rendered) on the pattern texture. Defaults to false.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].<section end="json format pattern" />		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].<section end="json format pattern" />
	</div>		</div>

			== History ==
			{{HistoryTable\|
			{{HistoryLine\|java}}
			\|{{HistoryLine\|\|1.19.4\|dev=23w04a\|Added trim patterns with data fields <code>asset_id</code> <code>template_item</code> and <code>description</code>.\|Added trim materials with data fields <code>asset_name</code>, <code>ingredient</code>, <code>item_model_index</code>, <code>incompatible_armor_material</code>, and <code>description</code>.}}
			\|{{HistoryLine\|\|\|dev=23w05a\|Added <code>override_armor_materials</code> to trim material registry.\|Removed <code>incompatible_armor_material</code> from trim material registry.}}
			\|{{HistoryLine\|\|1.20.2\|dev=23w33a\|Added <code>decal</code> field to trim patterns.}}
			\|{{HistoryLine\|\|1.21.2\|dev=24w36a\|Split trim pattern textures from <code>textures/trims/models/armor</code> to <code>textures/trims/entity/humanoid</code> and <code>textures/trims/entity/humanoid_leggings</code> as part of moving entity textures.}}
			\|{{HistoryLine\|\|1.21.4\|dev=24w45a\|Removed <code>item_model_index</code> from trim material registry.}}
			\|{{HistoryLine\|\|1.21.5\|dev=25w04a\|Removed <code>template_item</code> field from trim pattern registry.\|Removed <code>ingredient</code> from trim material registry.\|Items for trim patterns and materials are now part of the <code>smithing_trim</code> and <code>smithing_transform</code> recipes, and <code>provides_trim_material</code> component.}}
			\|{{HistoryLine\|\|26.3\|dev=snapshot 1\|Replaced trim material <code>asset_name</code> with <code>palette_id</code>.\|Removed <code>override_armor_assets</code> from trim material registry. The same function is now applied using [[Minecraft:Equipment\|equipment assets]].\|The palette textures have been moved from <code>textures/trims/color_palettes</code> to <code>textures/palettes/trim</code>.}}
			}}
	== Navigation ==		== Navigation ==
	{{Navbox Java Edition technical\|datapack}}		{{Navbox Java Edition technical\|datapack}}

SyncBot: Sync: updated from Minecraft

2026-07-23T11:00:51Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:00, 23 July 2026
Line 26:		Line 26:

	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root object.		* {{nbt\|compound}} The root object.<section begin="json format material" />
	** {{nbt\|string\|asset_name}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s.		** {{nbt\|string\|asset_name}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s.
	** {{nbt\|compound\|override_armor_assets}}: Asset name overrides for specific armor materials. Used in vanilla to select darker variants when the trim and armor have the same material.		** {{nbt\|compound\|override_armor_assets}}: Asset name overrides for specific armor materials. Used in vanilla to select darker variants when the trim and armor have the same material.
	*** {{nbt\|string\|{{ph\|equipment asset id}}}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s for armor items with the corresponding <code>asset_id</code> specified in the {{cd\|[[Minecraft:Data component format#equippable\|equippable]]}} data component.		*** {{nbt\|string\|{{ph\|equipment asset id}}}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s for armor items with the corresponding <code>asset_id</code> specified in the {{cd\|[[Minecraft:Data component format#equippable\|equippable]]}} data component.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].<section end="json format material" />
	</div>		</div>

Line 38:		Line 38:

	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root object.		* {{nbt\|compound}} The root object.<section begin="json format pattern" />
	** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.		** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.
	** {{nbt\|boolean\|decal}}: False for all vanilla trim patterns.		** {{nbt\|boolean\|decal}}: False for all vanilla trim patterns.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].<section end="json format pattern" />
	</div>		</div>

SyncBot: Sync: new page from Minecraft

2026-05-24T11:02:45Z

Sync: new page from Minecraft

New page

{{Exclusive|java}}

'''Trim materials''' and '''trim patterns''' define the tooltip and appearance of [[Minecraft:trimming|trimmed]] armor items.

== Definition ==

Trim materials and patterns can be defined in [[Minecraft:data pack]]s, as part of the directory structure below, or inline in the {{cd|[[Minecraft:Data component format#trim|trim]]}} and {{cd|[[Minecraft:Data component format#provides_trim_material|provides_trim_material]]}} data components.

<div class="treeview">
*{{File|archive|''data pack name''.zip}} or {{File|directory|''data pack name''}}
**{{File|file|[[#pack.mcmeta|pack.mcmeta]]}}
**{{File|directory|data}}
***{{File|directory|''namespace''}}
****{{File|directory|'''trim_material'''}}
*****{{File|file|'''{{ph|name}}.json'''}}
****{{File|directory|'''trim_pattern'''}}
*****{{File|file|'''{{ph|name}}.json'''}}
****[[Minecraft:Data pack#Folder_structure|More directories…]]
</div>

== JSON format ==

=== Trim material ===

Trim materials have the following format:

<div class="treeview">
* {{nbt|compound}} The root object.
** {{nbt|string|asset_name}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s.
** {{nbt|compound|override_armor_assets}}: Asset name overrides for specific armor materials. Used in vanilla to select darker variants when the trim and armor have the same material.
*** {{nbt|string|{{ph|equipment asset id}}}}: Suffix to be used in sprite names and [[Minecraft:translation key]]s for armor items with the corresponding <code>asset_id</code> specified in the {{cd|[[Minecraft:Data component format#equippable|equippable]]}} data component.
** {{nbt|string}}{{nbt|list}}{{nbt|compound|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].
</div>

=== Trim pattern ===

Trim patterns have the following format:

<div class="treeview">
* {{nbt|compound}} The root object.
** {{nbt|string|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.
** {{nbt|boolean|decal}}: False for all vanilla trim patterns.
** {{nbt|string}}{{nbt|list}}{{nbt|compound|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].
</div>

== Navigation ==
{{Navbox Java Edition technical|datapack}}

[[Minecraft:de:Verzierungsdefinition]]
[[Minecraft:ja:カスタム防具装飾]]
[[Minecraft:pt:Definição de enfeite de armadura]]
[[Minecraft:zh:盔甲纹饰定义格式]]

← Older revision		Revision as of 11:04, 24 September 2026
Line 27:		Line 27:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}} The root object.<section begin="json format material" />		* {{nbt\|compound}} The root object.<section begin="json format material" />
	** {{nbt\|string\|~~asset_name~~}}: ~~Suffix to be used in sprite names and~~ [[Minecraft:~~translation key~~]]s.		** {{nbt\|string\|palette_id}}: The [[Minecraft:Identifier\|resource location]] of the color palette to be used, at <code>assets/<namespace>/textures/palettes/<path>.png</code>.
	** {{nbt\|compound\|override_armor_assets}}: Asset name overrides for specific armor materials. Used in vanilla to select darker variants when the ~~trim and armor have the same material.~~
	*** {{nbt\|string\|{{ph\|equipment asset id}}}}: Suffix to be used ~~in sprite names and [[Minecraft:translation key]]s for armor items with the corresponding~~ <code>~~asset_id~~</code> ~~specified in the {{cd\|[[Minecraft:Data component format#equippable\|equippable]]}} data component~~.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].<section end="json format material" />		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim material's name. See [[Minecraft:Text component format]].<section end="json format material" />
	</div>		</div>
Line 40:		Line 38:
	* {{nbt\|compound}} The root object.<section begin="json format pattern" />		* {{nbt\|compound}} The root object.<section begin="json format pattern" />
	** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.		** {{nbt\|string\|asset_id}}: A [[Minecraft:resource location]] used as a prefix in sprite names and [[Minecraft:translation key]]s.
	** {{nbt\|boolean\|decal}}: ~~False for all vanilla trim patterns~~.		** {{nbt\|boolean\|decal}}: Masks the pattern based on the underlying armor texture.<ref>{{Citation\|url=https://www.minecraft.net/en-us/article/minecraft-java-edition-1-20-2\|title=Minecraft Java Edition 1.20.2 Now Available\|date=September 21, 2023\|website=Minecraft.net}}</ref> This means that on armor with transparent pixels (such as [[Minecraft:Chainmail Armor]]) the corresponding pixels will also be transparent(not rendered) on the pattern texture. Defaults to false.
	** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].<section end="json format pattern" />		** {{nbt\|string}}{{nbt\|list}}{{nbt\|compound\|description}}: Text component to use as the trim pattern's name. See [[Minecraft:Text component format]].<section end="json format pattern" />
	</div>		</div>

			== History ==
			{{HistoryTable\|
			{{HistoryLine\|java}}
			\|{{HistoryLine\|\|1.19.4\|dev=23w04a\|Added trim patterns with data fields <code>asset_id</code> <code>template_item</code> and <code>description</code>.\|Added trim materials with data fields <code>asset_name</code>, <code>ingredient</code>, <code>item_model_index</code>, <code>incompatible_armor_material</code>, and <code>description</code>.}}
			\|{{HistoryLine\|\|\|dev=23w05a\|Added <code>override_armor_materials</code> to trim material registry.\|Removed <code>incompatible_armor_material</code> from trim material registry.}}
			\|{{HistoryLine\|\|1.20.2\|dev=23w33a\|Added <code>decal</code> field to trim patterns.}}
			\|{{HistoryLine\|\|1.21.2\|dev=24w36a\|Split trim pattern textures from <code>textures/trims/models/armor</code> to <code>textures/trims/entity/humanoid</code> and <code>textures/trims/entity/humanoid_leggings</code> as part of moving entity textures.}}
			\|{{HistoryLine\|\|1.21.4\|dev=24w45a\|Removed <code>item_model_index</code> from trim material registry.}}
			\|{{HistoryLine\|\|1.21.5\|dev=25w04a\|Removed <code>template_item</code> field from trim pattern registry.\|Removed <code>ingredient</code> from trim material registry.\|Items for trim patterns and materials are now part of the <code>smithing_trim</code> and <code>smithing_transform</code> recipes, and <code>provides_trim_material</code> component.}}
			\|{{HistoryLine\|\|26.3\|dev=snapshot 1\|Replaced trim material <code>asset_name</code> with <code>palette_id</code>.\|Removed <code>override_armor_assets</code> from trim material registry. The same function is now applied using [[Minecraft:Equipment\|equipment assets]].\|The palette textures have been moved from <code>textures/trims/color_palettes</code> to <code>textures/palettes/trim</code>.}}
			}}
	== Navigation ==		== Navigation ==
	{{Navbox Java Edition technical\|datapack}}		{{Navbox Java Edition technical\|datapack}}