Configuring

Skins

Every key in skins.yml, how a skin is resolved, and the twenty animated skins that ship.

A skin lives in skins.yml under the id the armour will store. Ids are matched trimmed and lowercased, so Galaxy and galaxy are the same skin.

skins.yml

skins:
  galaxy:
    name: '{primary}&lGALAXY'
    pieces: []
    color: '#4a1b8c'
    trim-pattern: eye
    trim-material: amethyst
    icon: GLOBE_BANNER_PATTERN
    animation: galaxy
    effects:
      on-equip:
        sound:
          name: BLOCK_PORTAL_TRIGGER
          volume: 0.8
          pitch: 1.2
      set:
        ambient:
          particle: 'END_ROD|2|0.5|0.01'
          interval: 0.4
          radius: 32.0

Keys

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.
`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.

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.

How the skin item looks

The skin item is built from skin-item in config.yml — name, lore, glow — 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 twenty 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	Base colour	Trim	Icon	Animation	Set particle
`rainbow`	`#ff0000`	flow / amethyst	`FLOW_BANNER_PATTERN`	`rainbow`	`NOTE`
`pastel`	`#ffb3d9`	shaper / quartz	`FLOW_POTTERY_SHERD`	`pastel`	`END_ROD`
`inferno`	`#c81d00`	raiser / gold	`BURN_POTTERY_SHERD`	`inferno`	`FLAME`
`ocean`	`#0a5c8c`	tide / lapis	`ANGLER_POTTERY_SHERD`	`ocean`	`BUBBLE_POP`
`heartbeat`	`#7a0010`	rib / redstone	`HEARTBREAK_POTTERY_SHERD`	`heartbeat`	`HEART`
`toxic`	`#0b1f0b`	ward / emerald	`CREEPER_BANNER_PATTERN`	`toxic`	`SNEEZE`
`galaxy`	`#4a1b8c`	eye / amethyst	`GLOBE_BANNER_PATTERN`	`galaxy`	`END_ROD`
`aurora`	`#1fd18a`	wayfinder / diamond	`GUSTER_BANNER_PATTERN`	`aurora`	`GLOW`
`ember`	`#2b0a00`	dune / copper	`ARMS_UP_POTTERY_SHERD`	`ember`	`SMALL_FLAME`
`voltage`	`#3ea8ff`	bolt / copper	`LIGHTNING_ROD`	`voltage`	`ELECTRIC_SPARK`
`tempest`	`#5b6b7d`	snout / iron	`WIND_CHARGE`	`tempest`	`CLOUD`
`sakura`	`#ffb7c5`	spire / resin	`FLOWER_BANNER_PATTERN`	`sakura`	`CHERRY_LEAVES`
`shogun`	`#c8102e`	sentry / netherite	`SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE`	`shogun`	`CRIT`
`dragonfire`	`#ff6a00`	spire / gold	`BLAZE_POWDER`	`dragonfire`	`LAVA`
`void_dragon`	`#7b2cbf`	silence / netherite	`DRAGON_BREATH`	`void_dragon`	`DRAGON_BREATH`
`frostbite`	`#bfe9ff`	coast / diamond	`BLUE_ICE`	`frostbite`	`SNOWFLAKE`
`neon`	`#ff2bd6`	flow / quartz	`GLOW_INK_SAC`	`neon`	`GLOW`
`verdant`	`#2e7d32`	wild / emerald	`SNORT_POTTERY_SHERD`	`verdant`	`FALLING_SPORE_BLOSSOM`
`bloodmoon`	`#a3001b`	host / redstone	`HOWL_POTTERY_SHERD`	`bloodmoon`	`CRIMSON_SPORE`
`celestial`	`#ffd700`	host / gold	`TOTEM_OF_UNDYING`	`celestial`	`WAX_ON`

None of them restricts pieces, so every shipped skin fits all four slots.

What happens to a skin you delete

The id stays on the armour. Nothing resolves it any more, so the piece shows its real look again, and a remover used on it answers unknown-skin rather than turning the skin into nothing. Put the entry back — same key — and every piece wearing it comes back too.

Reloading

/armorskinsadmin reload re-reads config.yml, animations.yml and skins.yml, drops the cached trims, rebuilds the lore lines and redraws every online player. File entries are replaced wholesale; skins another plugin registered through the API survive a reload untouched.

Something missing on this page? Tell us on Discord