Content generated with AI — it may contain mistakes.

ExyliaArmorSkin/GuidesUpdated in v1.4.1

Create and edit skins

Add a skin to skins.yml, give it a colour, trim, price and rarity, and see it in game.

Page 4 of 218 min read

A skin is one entry in skins.yml: a name, a colour, an optional trim and an optional animation. You end with a new skin that players can wear from the wardrobe, and you know where the forty skins that ship are defined.

Before you start#

ExyliaArmorSkin is installed, see Installation. If you have not yet worn a skin, do Your first skin first.

Create a skin#

Open skins.yml

It is in plugins/ExyliaArmorSkin/. Each skin is a key under skins:; the key is its id. Ids are matched trimmed and lowercased, so Galaxy and galaxy are the same skin.

Add your skin

Copy this under skins: and change it:

skins.yml
yaml
    skins:
      mycolor:
        name: '{primary}&lMY COLOUR'
        tier: rare
        color: '#4a1b8c'
        trim-pattern: eye
        trim-material: amethyst
        animation: galaxy

Reload

Run /armorskinsadmin reload. It re-reads config.yml, animations.yml and skins.yml and redraws every online player.

Get it

Run /armorskinsadmin give <you> mycolor, or open /wardrobe: operators own every skin.

Check that it works#

The skin item shows in your inventory with its name. Drag it onto armour: the piece takes the colour and the trim, in third person (F5) and for other players. If nothing changes, see Common problems. Errors in skins.yml are reported in the console as skins.yml <where>: <problem>.

Going further#

Limit a skin to some pieces#

Add pieces: [helmet, boots]. Empty (the default) means all four: helmet, chestplate, leggings, boots. A skin that does not list a piece is refused on it.

Give it a price or a rarity#

tier is its crate rarity, a key under crate.tiers in config.yml (empty is common). price is what it costs in the wardrobe shop: 2500 in the default currency, or {amount: 50, currency: gems}. Empty uses the price of its tier. See Set up the crate and Buying with currency.

Make it move or sparkle#

Set animation to one of the presets of animations.yml, see Animate a skin. Add sounds, titles and particles under effects, see Add effects to a skin.

Delete a skin#

The id stays on the armour that wears it. The piece shows its real look again, and a remover used on it answers that the skin is unknown. Put the entry back under the same key and every piece wearing it comes back too.

Every key of a skin#

Every key of a skin
KeyTypeWhat it does
nametextShown on the skin item and in every message that names the skin. Takes palette tokens like {info} and & codes. Blank falls back to the id.
tieridIts crate rarity: a key under crate.tiers in config.yml. Empty is common; one that no longer exists counts as the first rarity. See The crate.
pricenumber or sectionWhat it costs in the wardrobe shop: 2500 in the default currency, or {amount: 50, currency: gems}. Empty uses its tier's price from shop.tier-prices. See Buying with currency.
pieceslisthelmet, chestplate, leggings, boots. Empty means all four. A skin that does not list a piece is refused on it with unsupported-piece.
colorhexThe leather colour, #0066ff. Empty keeps leather brown. Anything unparseable is reported in the console and treated as empty.
trim-patternkeyA trim pattern such as vex or minecraft:vex.
trim-materialkeyA trim material such as diamond.
iconmaterialThe material the skin item is made of. Empty uses skin-item.material from config.yml.
animationnameA preset from animations.yml, or a bare type (rainbow, pulse, frames). Empty for a still colour.
effectssectionSounds, titles and particles: on-equip, on-unequip, the per-piece ambient and the set bonus for wearing every piece the skin fits. See Effects.
A trim needs both halves

trim-pattern and trim-material are only used together. Writing one without the other logs a trim needs both trim-pattern and trim-material; ignoring the trim and the skin is drawn with its colour alone.

The skin item#

The skin item is built from skin-item: its name and lore in messages.yml, its glow in config.yml, with two substitutions: %skin% is the skin's name and %pieces% is the list of pieces it fits. Its material is the skin's icon, or skin-item.material when the skin sets none.

The skin's colour and trim are then painted onto that item, which only shows if the material can carry them: point icon at a leather piece and the item previews the skin exactly. A pottery sherd or a banner pattern simply keeps its own texture.

The forty that ship#

The forty skins that ship

Every shipped skin animates, and every one of them carries a set bonus: particles around the body while all four pieces match, an action bar line when the set closes and a quieter one when it breaks.

IdTierBase colourTrimIconAnimationSet particle
rainbowrare#ff0000flow / amethystFLOW_BANNER_PATTERNrainbowNOTE
pastelcommon#ffb3d9shaper / quartzFLOW_POTTERY_SHERDpastelEND_ROD
infernorare#c81d00raiser / goldBURN_POTTERY_SHERDinfernoFLAME
oceancommon#0a5c8ctide / lapisANGLER_POTTERY_SHERDoceanBUBBLE_POP
heartbeatcommon#7a0010rib / redstoneHEARTBREAK_POTTERY_SHERDheartbeatHEART
toxiccommon#0b1f0bward / emeraldCREEPER_BANNER_PATTERNtoxicSNEEZE
galaxyepic#4a1b8ceye / amethystGLOBE_BANNER_PATTERNgalaxyEND_ROD
aurorarare#1fd18awayfinder / diamondGUSTER_BANNER_PATTERNauroraGLOW
embercommon#2b0a00dune / copperARMS_UP_POTTERY_SHERDemberSMALL_FLAME
voltagerare#3ea8ffbolt / copperLIGHTNING_RODvoltageELECTRIC_SPARK
tempestcommon#5b6b7dsnout / ironWIND_CHARGEtempestCLOUD
sakuracommon#ffb7c5spire / resinFLOWER_BANNER_PATTERNsakuraCHERRY_LEAVES
shogunrare#c8102esentry / netheriteSENTRY_ARMOR_TRIM_SMITHING_TEMPLATEshogunCRIT
dragonfireepic#ff6a00spire / goldBLAZE_POWDERdragonfireLAVA
void_dragonlegendary#7b2cbfsilence / netheriteDRAGON_BREATHvoid_dragonDRAGON_BREATH
frostbitecommon#bfe9ffcoast / diamondBLUE_ICEfrostbiteSNOWFLAKE
neoncommon#ff2bd6flow / quartzGLOW_INK_SACneonGLOW
verdantcommon#2e7d32wild / emeraldSNORT_POTTERY_SHERDverdantFALLING_SPORE_BLOSSOM
bloodmoonrare#a3001bhost / redstoneHOWL_POTTERY_SHERDbloodmoonCRIMSON_SPORE
celestialepic#ffd700host / goldTOTEM_OF_UNDYINGcelestialWAX_ON
thunderlordlegendary#dbeaffbolt / ironTRIDENTthunderlordFIREWORK
phoenixepic#ff7a00raiser / goldFIRE_CHARGEphoenixFALLING_LAVA
tidecallerrare#1aa3c9tide / lapisHEART_OF_THE_SEAtidecallerNAUTILUS
starfalllegendary#fff6cfspire / quartzNETHER_STARstarfallENCHANTED_HIT
magmacorerare#ff5714raiser / copperMAGMA_CREAMmagmacoreLANDING_LAVA
glaciercommon#8fd8ffcoast / diamondPACKED_ICEglacierITEM_SNOWBALL
spectrerare#b8fff6silence / quartzPHANTOM_MEMBRANEspectreSOUL
midasepic#ffd76ahost / goldGOLD_INGOTmidasWAX_OFF
prismaticlegendary#ff2bd6flow / amethystPRISMARINE_CRYSTALSprismaticENCHANT
nebulaepic#a23bd6eye / amethystENDER_EYEnebulaREVERSE_PORTAL
venomcommon#5dff3award / emeraldSPIDER_EYEvenomWARPED_SPORE
solarflareepic#ffe680sentry / goldBLAZE_RODsolarflareFLAME
abyssepic#2b6cb0tide / netheriteECHO_SHARDabyssSQUID_INK
runeforgedrare#ff3b30rib / netheriteNETHERITE_SCRAPruneforgedSOUL_FIRE_FLAME
blossomfallrare#ffb7c5flow / resinPINK_PETALSblossomfallSPORE_BLOSSOM_AIR
wardenepic#1fd6c9silence / ironSCULK_SHRIEKERwardenSCULK_SOUL
chromecommon#dfe7efshaper / ironIRON_BLOCKchromeDUST_PLUME
wildfirecommon#ff8c1adune / copperCAMPFIREwildfireASH
eclipselegendary#ffd700host / goldCRYING_OBSIDIANeclipseOMINOUS_SPAWNING
arcanerare#7b2cbfwayfinder / lapisENCHANTED_BOOKarcanePORTAL

None of them restricts pieces, so every shipped skin fits all four slots. By rarity: 14 common, 12 rare, 9 epic and 5 legendary.

Reloading#

Skins registered by other plugins through the API survive a reload untouched; file entries are replaced wholesale.

Something missing on this page? Tell us on Discord