Set up patterns and materials
Patterns and materials: what trims.yml ships, how a trim is stored, and what happened to presets.
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.
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: ""| Key | What it does |
|---|---|
name | What is shown. Takes palette tokens, MiniMessage and gradients. |
icon | The item the entry is drawn with in the menu. BARRIER when left empty. |
tier | The crate rarity it falls in: a key of crate.tiers in config.yml. Empty means common. |
price | What 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:
| What | What happens |
|---|---|
The presets: section | Moved 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 row | Rewritten to its pattern/material the first time the row loads. |
| A crate unlock of a preset | Turned 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.custom | No 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 icon | Gone: 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.
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:
| Rarity | Patterns | Materials |
|---|---|---|
| Common | Sentry, Wild, Coast, Dune, Wayfinder, Raiser, Shaper, Host | Quartz, Iron, Copper, Lapis, Redstone |
| Rare | Vex, Ward, Tide, Snout | Gold, Diamond, Emerald, Resin |
| Epic | Rib, Eye, Spire, Flow, Bolt | Amethyst, Netherite |
| Legendary | Silence | none |
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