PLUGIN Skins

Skins

NpcPlugin provides multiple ways to set NPC skins through the in-game editor GUI.

Setting a skin via the GUI

1. Open the NPC editor by right-clicking an NPC while edit-mode is enabled (/npc edit)
2. Click the Skin option in the GUI
3. Enter one of the following in the dialog:

Player name or UUID

Enter a player's username or UUID to fetch their skin from Mojang:

• Notch - Fetches Notch's skin by name
• 069a79f4-44e9-4726-a5be-fca90e38aaf5 - Fetches skin by UUID

The plugin will attempt to fetch the skin asynchronously with a 10-second timeout.

Local .png file

Enter a path to a local PNG file (relative to server root):

• plugins/NpcPlugin/skins/custom.png

The file must exist and be a valid skin texture.

Local .yml file

Enter a path to a YAML file containing texture data:

• plugins/NpcPlugin/skins/custom.yml

The YAML file must contain:

texture: <texture_string>
signature: <signature_string>

Both fields are required. This is useful for pre-fetched skin data.

PlaceholderAPI (dynamic skins)

If PlaceholderAPI is installed, you can use placeholders for dynamic per-player skins:

• %player_name% - Uses each viewer's own skin
• %some_placeholder% - Uses any PlaceholderAPI placeholder that resolves to a player name/UUID

Example: %player_name% will make the NPC appear with each player's own skin.

"Use Player Skin" option

Instead of setting a specific skin, you can enable the "Use Player Skin" option in the GUI. This makes the NPC appear with the skin of whoever is viewing it (per-player skin).