Content generated with AI — it may contain mistakes.

ExyliaArmorTrims/GuidesUpdated in v1.5.1

Set up patterns and materials

Patterns and materials: what trims.yml ships, how a trim is stored, and what happened to presets.

Page 4 of 215 min read

Choose which patterns and materials your players can combine, rename them, give them icons and put prices on them. A trim is one pattern plus one material, and both lists live in trims.yml.

Before you start#

ExyliaArmorTrims is installed and has started once, so trims.yml exists. See Install ExyliaArmorTrims.

Steps#

Open trims.yml

It sits in the plugin's folder and has two sections: patterns and materials. Eighteen patterns and eleven materials ship, which is 198 combinations.

Remove what you do not want to offer

Delete the entry. A pattern or material the file does not list is not offered, even if the game has it. A new Minecraft version never adds to your shop by accident.

Rename it and pick an icon

name is what players read in the menu. icon is the item it is drawn with. Both are covered in the table below.

Set its rarity and price

tier is the crate rarity it falls in. price is what it costs in the shop; leave it empty to use its rarity's price.

Reload

Run /armortrimsadmin reload. It re-reads trims.yml and redraws everybody online.

An entry looks like this. The key is the game's registry key, sentry or netherite; minecraft:sentry works too.

trims.yml
yaml
patterns:
  sentry:
    name: "{letters}Sentry"
    icon: "SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE"
    tier: common
    price: ""
 
materials:
  netherite:
    name: "{letters_black}Netherite"
    icon: "NETHERITE_INGOT"
    tier: epic
    price: ""
KeyWhat it does
nameWhat is shown. Takes palette tokens, MiniMessage and gradients.
iconThe item the entry is drawn with in the menu. BARRIER when left empty.
tierThe crate rarity it falls in: a key of crate.tiers in config.yml. Empty means common.
priceWhat it costs in the shop. Empty uses its rarity's price from shop.tier-prices. A number is the default currency; {amount: 50, currency: gems} names one.

Check that it works#

Run /armortrim as a player who holds a pattern and a material. The pattern you renamed shows its new name and icon, and the ones you deleted are gone. A locked entry with a price shows it, and clicking it asks to buy. See Set up the crate.

Going further#

Sell halves, not combinations#

Each pattern and each material is a crate prize and a permission of its own: exyliaarmortrims.pattern.<id> and exyliaarmortrims.material.<id>. A player wears a trim once they own both halves. Owning every pattern and one material gives eighteen trims. See Permissions and Set up the crate.

Trims from code#

Another plugin reads the catalogue and puts trims on armor through the API, always as pattern/material. See API.

Coming from presets#

Up to 1.4, trims.yml also had a presets: section: named combinations with an id, a node and a crate slot of their own. 1.5.0 removed them, and the first start converts what they left behind:

WhatWhat happens
The presets: sectionMoved out of trims.yml into legacy-presets.yml in the plugin folder, as id: pattern/material, and logged once.
A preset id on armor (trim items, item mode)Read as the look it stood for, so the piece keeps its engraving.
A preset id in a player's rowRewritten to its pattern/material the first time the row loads.
A crate unlock of a presetTurned into unlocks of its pattern and its material on the player's next join; the preset unlock is then dropped.
exyliaarmortrims.trim.<preset> and exyliaarmortrims.customNo longer read. Grant exyliaarmortrims.pattern.<id> and exyliaarmortrims.material.<id> instead.
A preset id in showcase.only (config.yml)Rewritten to its pattern/material (since 1.5.1), so the showcase does not stand empty. One with no look on record is removed with a console warning naming it.
A preset's price, pieces and iconGone: halves are priced by their own price or their rarity, and every trim fits every piece.

A preset id that is in neither legacy-presets.yml nor a pattern/material form is dropped from the row rather than left behind.

Ranks that sold presets

A player whose preset came from a permission, not a crate, keeps the look on their row but now needs both halves to wear it. With hide-without-permission on, their armor shows bare until the rank grants the pattern and the material nodes.

Technical details

The shipped rarities follow how hard each one is to find in vanilla:

RarityPatternsMaterials
CommonSentry, Wild, Coast, Dune, Wayfinder, Raiser, Shaper, HostQuartz, Iron, Copper, Lapis, Redstone
RareVex, Ward, Tide, SnoutGold, Diamond, Emerald, Resin
EpicRib, Eye, Spire, Flow, BoltAmethyst, Netherite
LegendarySilencenone

How a trim is stored. A trim has no id of its own: it is stored as pattern/material, such as sentry/netherite, on armor, in the player's row and in every command, placeholder and API call. It is named with the menu.custom-name template from messages.yml, which defaults to %pattern% » %material%.

Broken entries. An entry with no id is skipped; one with no name uses its id, and one with no icon is drawn as a BARRIER. The rest of the file loads regardless.

Something missing on this page? Tell us on Discord