Trims

Armor trims are a customization system that allows players to add decorative patterns to their armor pieces. Trims consist of two components: materials (which determine the color/texture) and patterns (which determine the shape/design). Kore provides type-safe DSL builders for creating custom trim materials and patterns.

Trim Materials

Trim materials define the color palette and appearance when a trim is applied to armor. Each material specifies:

• Palette ID: The palette texture coloring the trim, minecraft:trim/amethyst reads textures/palettes/trim/amethyst.png from the resource pack
• Description: The text shown in-game when hovering over trimmed armor

Basic Usage

trimMaterial("ruby", Textures.Palettes.Trim.AMETHYST) {
	description("Ruby", Color.RED)
}

This creates a trim material file at data/<namespace>/trim_material/ruby.json:

{
	"description": {
		"text": "Ruby",
		"color": "red"
	},
	"palette_id": "minecraft:trim/amethyst"
}

A custom palette takes its path relative to textures/palettes/:

// Reads assets/my_pack/textures/palettes/trim/ruby.png
trimMaterial("ruby", TrimColorPaletteArgument("trim/ruby", "my_pack")) {
	description("Ruby", Color.RED)
}

The darker palette vanilla uses on armor of the same color as the trim, like gold_darker on gold armor, isn't set by the trim material: the resource pack's equipment asset swaps it through trim_palette_replacements.

Trim Patterns

Trim patterns define the visual design applied to armor. Each pattern specifies:

• Asset ID: The id the game builds the texture paths from, minecraft:coast reads textures/trims/entity/humanoid/coast.png and textures/trims/entity/humanoid_leggings/coast.png from the resource pack. It defaults to the pattern's own id
• Description: The text shown in-game when hovering over trimmed armor
• Decal: Whether the pattern should render as a decal overlay (like netherite patterns)

Basic Usage

// Reuses the vanilla coast textures
trimPattern("stripes", TrimPatterns.COAST, textComponent("Stripes")) {
	description("Striped Pattern", Color.GRAY)
}

// Asset id <namespace>:custom, textures in assets/<namespace>/textures/trims/entity/humanoid/custom.png
trimPattern("custom") {
	description("Custom Pattern")
}

This creates trim pattern files at data/<namespace>/trim_pattern/stripes.json and custom.json.

Pattern as Decal

Setting decal = true makes the pattern render as an overlay, which is useful for patterns that should appear on top of the base armor texture without replacing it (similar to how netherite trim patterns work):

trimPattern("overlay", TrimPatterns.SENTRY, textComponent("Overlay"), decal = true) {
	description("Overlay Pattern")
}

Generated JSON

A trim pattern generates JSON like this:

{
	"asset_id": "minecraft:coast",
	"description": {
		"text": "Striped Pattern",
		"color": "gray"
	},
	"decal": false
}

With decal enabled:

{
	"asset_id": "minecraft:sentry",
	"description": {
		"text": "Overlay Pattern"
	},
	"decal": true
}

See Also

• Chat Components - For trim description text formatting
• Tags - Organize trim materials and patterns into groups

External Resources

• Minecraft Wiki: Tutorial - Adding custom trims - Official guide for creating custom trims
• Minecraft Wiki: Armor - Trimming - Information about armor trimming mechanics