Features / Skins

Skins

Skins only apply to player-type NPCs (the default when you don't specify a type in /npc create).

Setting a skin

/npc skin <name> <username>

This looks up the real skin belonging to that Minecraft username, the same way the server itself looks up skins for real players logging in — so it works correctly whether your server is in online or offline mode, and it's cached so repeat lookups are instant.

Special skin values

ValueWhat it does
@noneRemoves the skin, back to a default appearance
@mirrorCopies whoever is currently looking at the NPC — each viewer sees the NPC wearing their own skin

Automatic skin matching

If you name an NPC exactly after a player your server already knows about (someone who has joined before, or is online right now), creating it will automatically apply that player's real skin — no /npc skin command needed.

Skin layers

Player skins have optional outer layers — a cape, jacket, separate sleeves, separate pant legs, and a hat layer. You can show or hide each independently:

/npc skinlayers <name> <layer> <true|false>
/npc skinlayers <name> reset

Valid layers: CAPE, JACKET, LEFT_SLEEVE, RIGHT_SLEEVE, LEFT_PANTS, RIGHT_PANTS, HAT. All layers are shown by default; reset puts them all back.

Text formatting

Anywhere this plugin shows text — display names, hologram lines, chat messages from actions — it accepts several different formatting styles and figures out which one you used automatically:

  • MiniMessage tags, like <red><bold>Hello
  • Legacy ampersand codes, like &c&lHello
  • Legacy section codes, like the ones older plugins (including Citizens) store internally
  • Plain text with no formatting at all

This means an NPC name copied over from Citizens with its original color codes intact will display correctly without you having to retype it in a different format.