Content generated with AI — it may contain mistakes.

ExyliaArmorSkin/HelpUpdated in v1.4.1

Common problems

Fixes for the usual ExyliaArmorSkin problems: a skin that does not show, a wardrobe that will not open, crate and shop that do nothing, and 3D screens that fall back.

Page 15 of 213 min read

Find your symptom, then follow the fix.

The plugin does not start#

ExyliaArmorSkin needs packetevents (hard requirement) and ExyliaLib in plugins/. The server refuses to enable it without packetevents, and nothing works without ExyliaLib. Needs Paper 1.21.1 or newer (Folia 1.21.4 or newer) and Java 21. See Installation.

A player does not see the skin they applied#

By default a player who owns the skin neither by permission nor by unlock is shown their real armour. Grant exyliaarmorskin.skin.<id> (or exyliaarmorskin.skin.*), hand an unlock with /armorskinsadmin unlocks grant <player> <skin>, or set behaviour.hide-without-permission: false. Then run /armorskinsadmin refresh <player>. See Permissions.

Nobody sees any skin in one world#

behaviour.disabled-worlds in config.yml lists worlds where skins are hidden. Remove the world and run /armorskinsadmin reload.

I see my real armour in creative#

This is on purpose. A creative client sends its inventory back to the server, so it is always shown the real items. Other players still see the skin.

An elytra shows no skin#

An elytra sits in the chest slot but is not armour, and dressing it as a chestplate would cost the wearer their flight. It is never skinned.

/wardrobe says it is disabled or locked#

  • wardrobe-disabled: behaviour.mode is item. Set it to wardrobe or both and run /armorskinsadmin reload.
  • feature-locked: the player lacks exyliaarmorskin.wardrobe. Everybody has it by default, so a permission plugin is denying it.

A skin item does nothing when I drag it#

Skin items are read only inside your own inventory window, onto a piece of armour. Dropping one onto armour in a chest does nothing. The chat message tells you why: not-armor, unsupported-piece (the skin does not include that piece), already-skinned (use a remover first).

A skin disappeared after I edited skins.yml#

The id changed. The armour keeps the id it was given, so renaming an entry orphans every piece wearing it: they show their real look, and a remover says unknown-skin. Restore the key and the look comes back.

The shop shows no prices, or players cannot buy#

  • shop.enabled must be true, and the skin needs a price: its own price, or one from shop.tier-prices for its rarity.
  • A currency is needed: ExyliaEconomy or Vault. With neither, nothing is for sale.
  • The player needs exyliaarmorskin.buy; without it a locked skin never shows its price.

The crate says I have no keys, or does not open#

Keys live on the account: check with /armorskinsadmin keys check <player> and add with /armorskinsadmin keys give <player> 1. Other messages: crate.disabled means crate.enabled is off, crate.busy means the last opening is still falling, feature-locked means the rank lacks exyliaarmorskin.crate. See Set up the crate.

A crate winner is not worn#

With crate.reward: UNLOCK (default) the skin is unlocked on the account, and the player wears it from the wardrobe. On an item server there is no wardrobe, so set crate.reward to ITEM or BOTH.

The 3D wardrobe or crate shows the inventory one#

Drawing 3D needs a 1.21.4 client or newer; older clients always get the inventory screens. If you want it for everybody, ask players to update.

A change in skins.yml or a menu does not show#

Run /armorskinsadmin reload. It re-reads every file and redraws everyone online.

Something missing on this page? Tell us on Discord