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
| Value | What it does |
|---|---|
@none | Removes the skin, back to a default appearance |
@mirror | Copies 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.