# Minecraft Armor Trim

> Minecraft Armor Trim 盔甲装饰定义：Trim Pattern 装饰图案（TRIM_PATTERN 注册表、data/<namespace>/trim_pattern/、description 文本组件、asset_id 资源 ID、decal 贴花模式）、Trim Material 装饰材料（TRIM_MATERIAL 注册表、data/<namespace>/trim_material/、asset_name 纹理路径后缀、palette_id 调色板 ID、override_armor_assets 资产覆盖）、Tooltips 提示信息（图案名称 + 材料名称显示）、Textures 纹理生成（minecraft:armor_trims 图集、assets/<ns>/textures/trims/entity/<equipment model layer>/<pattern>_<material>.png、paletted_permutations 调色板置换、UV 映射）、Smithing Trim Recipe 锻造装饰配方（provides_trim_material 组件、trim 组件）、Equipment Assets 装备资产（trim_palette_replacements 调色板替换）、服务器启动加载定义。

- Skill: `zmjjkk123-hub/minecraft-armor-trim` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmjjkk123-hub/minecraft-armor-trim`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmjjkk123-hub/minecraft-armor-trim/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ZMJJKK123-hub (https://skillmd.com/u/zmjjkk123-hub)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zmjjkk123-hub/minecraft-armor-trim

---


# Armor Trim Definition

Armor trims are decorative appearances added to armor/equipment models, combining a **trim pattern** and a **trim material**. Java Edition only.

## Trim Pattern

Registry `TRIM_PATTERN`, data pack path `trim_pattern` (files in `data/<namespace>/trim_pattern/`; tags in `tags/trim_pattern/`):

- `description` (required) — text component shown in tooltips.
- `asset_id` (required) — namespace ID affecting the trim texture.
- `decal` (default false) — render the trim only over the base armor texture's non-transparent pixels.

## Trim Material

Registry `TRIM_MATERIAL`, data pack path `trim_material` (files in `data/<namespace>/trim_material/`; tags in `tags/trim_material/`):

- `description` (required) — tooltip name.
- `asset_name` (required) — string suffix of the trim texture path.
- `palette_id` (required) — the palette used for trim texture tinting.
- `override_armor_assets` — per equipment asset: a string overriding `asset_name` for that asset.

Definitions load once at server startup (restart required). The smithing trim recipe defines the material inline in the addition's `provides_trim_material` component and names the pattern; applying it adds the `trim` component.

## Tooltips

Trimmed items show two tooltip lines: the pattern name, then the material name. Material name styles override the pattern's styles for the same properties.

## Textures

- **Pre-26.3**: trims render from the `minecraft:armor_trims` atlas; textures resolve to `assets/<ns>/textures/trims/entity/<equipment model layer>/<pattern path>_<material string>.png`. Trim textures share the armor model's UV mapping (any item can render trims). Vanilla defines base patterns and palettes and generates combinations via the `paletted_permutations` atlas source — non-vanilla trim textures aren't loaded without modifying the atlas.
- **From 26.3**: entity trims generate on demand; item trims pre-generate via `paletted_permutations`. For entities, the game combines the equipment asset, material, and pattern:
  1. Pattern texture → `assets/<ns>/textures/trim/entity/<layer>/<path>.png` (e.g. `humanoid/flow.png`).
  2. The pattern texture's metadata `palette.base_palette` → the base palette (`assets/<ns>/textures/palettes/<path>.png`, e.g. `trim_base`).
  3. The material's `palette_id` → the target palette (e.g. `trim/gold`).
  Then every base-texture pixel matching a base-palette color is replaced with the target palette's corresponding pixel, rendered over the armor via the layer's UV mapping. Missing/mismatched palettes render nothing. Equipment assets may define `trim_palette_replacements` to swap target palettes under conditions.