Content generated with AI — it may contain mistakes.

ExyliaArmorTrims/HelpUpdated in v1.5.1

FAQ

The questions that come up most.

Page 16 of 213 min read

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#

CheckDetail
The modeitem ignores the menu choice; menu ignores what is engraved on the armor.
OwnershipWith hide-without-permission on, a trim you no longer own — no node, no unlock — stops being drawn.
CreativeA creative client sees its real armor. Everyone else still sees your trim.
The valueA 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