Create and edit skins
Add a skin to skins.yml, give it a colour, trim, price and rarity, and see it in game.
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:
mycolor:
name: '{primary}&lMY COLOUR'
tier: rare
color: '#4a1b8c'
trim-pattern: eye
trim-material: amethyst
animation: galaxyReload
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
| Key | Type | What it does |
|---|---|---|
name | text | Shown 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. |
tier | id | Its 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. |
price | number or section | What 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. |
pieces | list | helmet, chestplate, leggings, boots. Empty means all four. A skin that does not list a piece is refused on it with unsupported-piece. |
color | hex | The leather colour, #0066ff. Empty keeps leather brown. Anything unparseable is reported in the console and treated as empty. |
trim-pattern | key | A trim pattern such as vex or minecraft:vex. |
trim-material | key | A trim material such as diamond. |
icon | material | The material the skin item is made of. Empty uses skin-item.material from config.yml. |
animation | name | A preset from animations.yml, or a bare type (rainbow, pulse, frames). Empty for a still colour. |
effects | section | Sounds, titles and particles: on-equip, on-unequip, the per-piece ambient and the set bonus for wearing every piece the skin fits. See Effects. |
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.
| Id | Tier | Base colour | Trim | Icon | Animation | Set particle |
|---|---|---|---|---|---|---|
rainbow | rare | #ff0000 | flow / amethyst | FLOW_BANNER_PATTERN | rainbow | NOTE |
pastel | common | #ffb3d9 | shaper / quartz | FLOW_POTTERY_SHERD | pastel | END_ROD |
inferno | rare | #c81d00 | raiser / gold | BURN_POTTERY_SHERD | inferno | FLAME |
ocean | common | #0a5c8c | tide / lapis | ANGLER_POTTERY_SHERD | ocean | BUBBLE_POP |
heartbeat | common | #7a0010 | rib / redstone | HEARTBREAK_POTTERY_SHERD | heartbeat | HEART |
toxic | common | #0b1f0b | ward / emerald | CREEPER_BANNER_PATTERN | toxic | SNEEZE |
galaxy | epic | #4a1b8c | eye / amethyst | GLOBE_BANNER_PATTERN | galaxy | END_ROD |
aurora | rare | #1fd18a | wayfinder / diamond | GUSTER_BANNER_PATTERN | aurora | GLOW |
ember | common | #2b0a00 | dune / copper | ARMS_UP_POTTERY_SHERD | ember | SMALL_FLAME |
voltage | rare | #3ea8ff | bolt / copper | LIGHTNING_ROD | voltage | ELECTRIC_SPARK |
tempest | common | #5b6b7d | snout / iron | WIND_CHARGE | tempest | CLOUD |
sakura | common | #ffb7c5 | spire / resin | FLOWER_BANNER_PATTERN | sakura | CHERRY_LEAVES |
shogun | rare | #c8102e | sentry / netherite | SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE | shogun | CRIT |
dragonfire | epic | #ff6a00 | spire / gold | BLAZE_POWDER | dragonfire | LAVA |
void_dragon | legendary | #7b2cbf | silence / netherite | DRAGON_BREATH | void_dragon | DRAGON_BREATH |
frostbite | common | #bfe9ff | coast / diamond | BLUE_ICE | frostbite | SNOWFLAKE |
neon | common | #ff2bd6 | flow / quartz | GLOW_INK_SAC | neon | GLOW |
verdant | common | #2e7d32 | wild / emerald | SNORT_POTTERY_SHERD | verdant | FALLING_SPORE_BLOSSOM |
bloodmoon | rare | #a3001b | host / redstone | HOWL_POTTERY_SHERD | bloodmoon | CRIMSON_SPORE |
celestial | epic | #ffd700 | host / gold | TOTEM_OF_UNDYING | celestial | WAX_ON |
thunderlord | legendary | #dbeaff | bolt / iron | TRIDENT | thunderlord | FIREWORK |
phoenix | epic | #ff7a00 | raiser / gold | FIRE_CHARGE | phoenix | FALLING_LAVA |
tidecaller | rare | #1aa3c9 | tide / lapis | HEART_OF_THE_SEA | tidecaller | NAUTILUS |
starfall | legendary | #fff6cf | spire / quartz | NETHER_STAR | starfall | ENCHANTED_HIT |
magmacore | rare | #ff5714 | raiser / copper | MAGMA_CREAM | magmacore | LANDING_LAVA |
glacier | common | #8fd8ff | coast / diamond | PACKED_ICE | glacier | ITEM_SNOWBALL |
spectre | rare | #b8fff6 | silence / quartz | PHANTOM_MEMBRANE | spectre | SOUL |
midas | epic | #ffd76a | host / gold | GOLD_INGOT | midas | WAX_OFF |
prismatic | legendary | #ff2bd6 | flow / amethyst | PRISMARINE_CRYSTALS | prismatic | ENCHANT |
nebula | epic | #a23bd6 | eye / amethyst | ENDER_EYE | nebula | REVERSE_PORTAL |
venom | common | #5dff3a | ward / emerald | SPIDER_EYE | venom | WARPED_SPORE |
solarflare | epic | #ffe680 | sentry / gold | BLAZE_ROD | solarflare | FLAME |
abyss | epic | #2b6cb0 | tide / netherite | ECHO_SHARD | abyss | SQUID_INK |
runeforged | rare | #ff3b30 | rib / netherite | NETHERITE_SCRAP | runeforged | SOUL_FIRE_FLAME |
blossomfall | rare | #ffb7c5 | flow / resin | PINK_PETALS | blossomfall | SPORE_BLOSSOM_AIR |
warden | epic | #1fd6c9 | silence / iron | SCULK_SHRIEKER | warden | SCULK_SOUL |
chrome | common | #dfe7ef | shaper / iron | IRON_BLOCK | chrome | DUST_PLUME |
wildfire | common | #ff8c1a | dune / copper | CAMPFIRE | wildfire | ASH |
eclipse | legendary | #ffd700 | host / gold | CRYING_OBSIDIAN | eclipse | OMINOUS_SPAWNING |
arcane | rare | #7b2cbf | wayfinder / lapis | ENCHANTED_BOOK | arcane | PORTAL |
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