Datapack Codex

Armor trim definition

Minecraft Wiki article. Categories: Java_Edition, Data_packs

📌 Mirrored from Minecraft Wiki

This article is reproduced from Armor trim definition on the Minecraft Wiki. Mirrored from revision 3685723. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

On this page
This feature is exclusive to Java Edition.
 

Trim materials and trim patterns define the tooltip and appearance of trimmed armor items.

Definition

Trim materials and patterns can be defined in data packs, as part of the directory structure below, or inline in the trim and provides_trim_material data components.

  • File archive.png: Sprite image for archive in Minecraft data pack name.zip or File directory.png: Sprite image for directory in Minecraft data pack name
    • File file.png: Sprite image for file in Minecraft pack.mcmeta
    • File directory.png: Sprite image for directory in Minecraft data

JSON format

Trim material

Trim materials have the following format:

  • [NBT Compound / JSON Object] The root object.
    • [String] asset_name: Suffix to be used in sprite names and translation keys.
    • [NBT Compound / JSON Object] 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.
      • [String] <equipment asset id>: Suffix to be used in sprite names and translation keys for armor items with the corresponding asset_id specified in the equippable data component.
    • [String][NBT List / JSON Array][NBT Compound / JSON Object] description: Text component to use as the trim material's name. See Text component format.

Trim pattern

Trim patterns have the following format:

  • [NBT Compound / JSON Object] The root object.
    • [String] asset_id: A resource location used as a prefix in sprite names and translation keys.
    • [Boolean] decal: False for all vanilla trim patterns.
    • [String][NBT List / JSON Array][NBT Compound / JSON Object] description: Text component to use as the trim pattern's name. See Text component format.

Sources