SetNpcSkin
setNpcSkin
Changes the authoritative skin of a resource-owned scripted NPC.
Syntax
bool setNpcSkin(int npcId, string itemKey)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
npcId |
int |
yes | The server-assigned NPC identifier returned by spawnNpc or getNpcs.
|
itemKey |
string |
yes | A validated key returned by getPlayerSkinNames; armor and weapon accept none to clear the slot.
|
Returns
Returns true when the validated change is accepted and replicated; otherwise returns false.
Examples
Change an NPC's skin:
setNpcSkin(npcId, "milten")
Notes
- Available only in server-side resource scripts.
- The state is sent reliably to current viewers and replayed on relevance entry and late join.
- Raw Unreal object paths are never accepted from Lua.
- Skin keys are listed in Player skin catalog.
Appearance API since 0.1.5
Legacy surface preset, not an alias for setNpcIdentity. NPCs without an explicit identity retain the existing behaviour. From 0.1.5 use setNpcIdentity for a matched head/profile and setNpcSkinColor / setNpcTattoo for independent overrides. Once explicitly selected, identity takes precedence over legacy skin fallback.