FAQ
The questions that come up most.
The plugin will not start#
packetevents is required. ExyliaLib is a soft depend: if it is missing, the loader installs it on
the first start.
The menu opens but everything is locked#
A trim needs both halves — the pattern and the material — each by its node or its unlock. See Permissions. With the shop on and an economy installed, locked entries show a price instead and can be bought.
/armortrim says the menu is off#
You are on mode: item. In that mode there is no per-player choice and no screen: trims travel as
items. Switch to menu or both and reload.
The trim does not show#
| Check | Detail |
|---|---|
| The mode | item ignores the menu choice; menu ignores what is engraved on the armor. |
| Ownership | With hide-without-permission on, a trim you no longer own — no node, no unlock — stops being drawn. |
| Creative | A creative client sees its real armor. Everyone else still sees your trim. |
| The value | A pattern or a material deleted from trims.yml is not drawn until the entry comes back. |
If it still does not show, /armortrimsadmin refresh <player> recomputes and re-sends.
Can armor be dropped and the trim lost?#
It depends on the mode. An item trim lives on the piece, so it travels with it and is lost with it. A menu trim belongs to the player and is applied again to whatever they put on next.
Is the armor touched?#
In menu mode, no: the engraving is drawn on the way to the client and the real item never carries it.
In item mode one value is written — exyliaarmortrims:trim — and nothing else: enchantments,
attributes, durability, custom model data and other plugins' data are untouched.
Does it overwrite a hand-forged trim?#
It does not erase it: the vanilla armor keeps its own on the server. What gets drawn is this plugin's trim, and vanilla's upgrade line is hidden on the visual.
Can I add my own patterns?#
You can offer any the game has by listing them in trims.yml, and rename and draw them however you
like. What you cannot do is invent a pattern the server's registry does not have.
Can I translate it?#
It ships in English, Spanish, Portuguese, French, Russian and Turkish: set language in config.yml, or leave
it on default to follow ExyliaLib. Every file under lang/<language>/ is yours to edit —
messages.yml holds the messages, item words and menu wording, menus/ every line on the screens —
and trims.yml holds pattern and material names.
Where did the presets go?#
They were removed in 1.5.0: every trim is now a pattern and a material the player combines. Armor and rows that carried a preset keep its look, and crate unlocks of a preset become unlocks of its halves. Preset nodes are no longer read — see Trims.
/armortrim opens the inventory menu, not the 3D wardrobe#
behaviour.menu-style is classic, the default: set it to spatial, or use /armortrim wardrobe.
A player on a client older than 1.21.4, or without exyliaarmortrims.wardrobe, always gets the
inventory menu.
Why do the shop entries show as locked?#
A price only shows when the shop is on (shop.enabled), the entry has a price — its own, or its
rarity's in shop.tier-prices — an economy serves its currency, and the player holds
exyliaarmortrims.buy. Without ExyliaEconomy or a Vault
economy nothing can be bought, and every locked entry stays locked.
Does it use up smithing templates?#
No, and there is no smithing table involved. If you want the look to cost something, leave
consume-trim-item on and sell the trim items.
Which versions does it run on?#
Paper 1.21.1 or newer, and Folia 1.21.4 or newer.
Where do I get support?#
On the Exylia Discord.
Something missing on this page? Tell us on Discord