Content generated with AI — it may contain mistakes.

ExyliaArmorTrims/Getting startedUpdated in v1.5.1

Introduction

What ExyliaArmorTrims is: any pattern with any material, chosen in a 3D wardrobe or an inventory menu, or carried as an item, and drawn with packets.

Page 1 of 214 min read

ExyliaArmorTrims lets players put any armor pattern with any material on their armor, without a smithing table, a template or a material spent. They choose in a 3D wardrobe or an inventory menu, or drop a trim item onto a piece. Out of the box it works the day you install it.

The armor is never changed. The server keeps the exact same chestplate, with the same name, enchantments and data from other plugins. The trim is added only on the way to the client, so everybody sees it engraved.

What you will have in ten minutes#

A player runs /armortrim, picks a pattern and a material they own, and the trim appears on their armor for everyone to see. You decide how they get patterns and materials: a permission per rank, a crate, or the shop. Start with Your first trim.

What you need#

  • Paper 1.21.1 or newer, or Folia 1.21.4 or newer.
  • packetevents in plugins/. It is required.
  • ExyliaLib. The loader installs it on the first start if it is missing.
  • Optional: PlaceholderAPI, and an economy (ExyliaEconomy, or Vault with an economy plugin) if you want the shop.

Players on a client older than 1.21.4 can use everything except the 3D wardrobe and the 3D crate opening, which fall back to inventory screens. Steps are in Install ExyliaArmorTrims.

How players wear a trim#

A trim is a pattern plus a material, and the player owns each half separately. trims.yml ships 18 patterns and 11 materials, 198 combinations. The list is yours: a pattern the file does not list is not offered, and every one you keep can be renamed, given another icon and priced.

Way inHow it works
A permissionOne node per pattern and per material. See Permissions.
The crateA key is spent and the pattern or material it lands on is unlocked for good. See Set up the crate.
The shopA locked half is bought with currency, priced by its rarity or on its own.

Two places to choose: the 3D wardrobe, the menu standing in the world around the player (Place the 3D wardrobe), and the classic menu, one inventory window (Customise the trim menu). behaviour.menu-style decides which one /armortrim opens.

Where the trim is kept is the mode. In item mode the trim is written onto the armor and travels with it through chests, trades and deaths. In menu mode it belongs to the player and lands on whatever they equip. both, the default, does both. See Choose how trims are worn.

What each viewer sees
ViewerSees
Anyone tracking the wearerThe armor with its trim.
The wearer, in their inventory and on their dollThe same.
The wearer in creativeThe real armor, without the trim. A creative client sends its slots back to the server, so it has to be shown the truth.
Anyone looking at a trimmed piece in a chest, the hotbar or on the cursorThe real item, with the trim and the armor-lore lines added.
Anyone looking at an elytraThe elytra. It sits in the chest slot but is not armor, and dressing it as a chestplate would cost the wearer their flight.
Everyone, once the wearer no longer owns the trimBare armor, while hide-without-permission is on. The value stays stored and the look returns with the node or the unlock.

The visual is a copy of the real item with one component added, so material, name, enchantments, attributes, durability and custom model data are untouched. A client older than 1.21.4, or a player without exyliaarmortrims.wardrobe, always gets the classic menu.

The database is H2 by default, through ExyliaLib: crate keys and unlocks, items waiting for a join, and the menu's choices.

Presets are gone since 1.5.0

Earlier versions had named presets (SHOGUN, POLTERGEIST and so on). Custom is now the only system. What players wore keeps its look, and crate unlocks of a preset become unlocks of its two halves. See Coming from presets.

Showcases, spots in a lobby that show trims off on their own, are covered in Add trim showcases.

Something missing on this page? Tell us on Discord