Minecraft:Armor trim definition: Difference between revisions
From SAS Gaming Wiki
More actions
Sync: updated from Minecraft |
Sync: updated from Minecraft |
||
| 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| | ** {{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|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}}: | ** {{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}} | ||
Latest revision as of 11:04, 24 September 2026
Trim materials and trim patterns define the tooltip and appearance of trimmed armor items.
Definition
Trim materials and patterns can be defined in Minecraft:data packs, as part of the directory structure below, or inline in the Template:Cd and Template:Cd data components.
JSON format
Trim material
Trim materials have the following format:
- Template:Nbt The root object.<section begin="json format material" />
- Template:Nbt: The resource location of the color palette to be used, at
assets/<namespace>/textures/palettes/<path>.png. - Template:NbtTemplate:NbtTemplate:Nbt: Text component to use as the trim material's name. See Minecraft:Text component format.<section end="json format material" />
- Template:Nbt: The resource location of the color palette to be used, at
Trim pattern
Trim patterns have the following format:
- Template:Nbt The root object.<section begin="json format pattern" />
- Template:Nbt: A Minecraft:resource location used as a prefix in sprite names and Minecraft:translation keys.
- Template:Nbt: Masks the pattern based on the underlying armor texture.<ref>Template:Citation</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.
- Template:NbtTemplate:NbtTemplate:Nbt: Text component to use as the trim pattern's name. See Minecraft:Text component format.<section end="json format pattern" />
History
Template:Navbox Java Edition technical
Minecraft:de:Verzierungsdefinition Minecraft:ja:カスタム防具装飾 Minecraft:pt:Definição de enfeite de armadura Minecraft:zh:盔甲纹饰定义格式