Latest revision as of 06:13, 24 August 2026

setPlayerSkin

Changes a player's authoritative legacy skin-surface preset.

bool setPlayerSkin(int playerId, string skinKey)

Name	Type	Required	Description
`playerId`	`int`	yes	The connected player identifier.
`skinKey`	`string`	yes	A stable key returned by `getPlayerSkinNames`.

Returns true when the validated preset is accepted and replicated; otherwise returns false.

Apply a validated skin-surface preset:

if not setPlayerSkin(playerId, "cor_kalom") then
    outputChatBox("The selected skin is unavailable.", playerId)
end

Available only in server-side resource scripts.
This is the compatibility channel for Mutable skin, tattoo and scar data. It is separate from the identity and armor state.
The reliable state is sent immediately to relevant players and replayed during late join and relevance entry.
This emits onPlayerSkinChange when accepted.
See Player skin catalog for every currently supported key.

@@ Line 30: / Line 30: @@
 == Notes ==
 * Available only in server-side resource scripts.
-* This is the compatibility channel for Mutable skin, tattoo and scar data. It is separate from the full-body and head state.
+* This is the compatibility channel for Mutable skin, tattoo and scar data. It is separate from the identity and armor state.
-* A selected named full-body preset takes visual precedence until the player returns to <code>body = default</code>.
 * The reliable state is sent immediately to relevant players and replayed during late join and relevance entry.
 * This emits <code>onPlayerSkinChange</code> when accepted.