setPlayerIdentity

Atomically changes a player's complete recognizable appearance without changing armor.

Syntax

bool setPlayerIdentity(int playerId, string identityKey)

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

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

Apply Milten's armor-free identity:

if not setPlayerIdentity(playerId, "milten") then
    outputChatBox("The identity could not be applied.", playerId)
end

Available only in server-side resource scripts.
This is the recommended appearance setter for normal resources.
The face profile and identity surface/hair layer are committed in one authoritative update, so clients never observe a half-applied identity.
Equipped armor remains controlled exclusively by setPlayerArmor.
Some identity profiles still have compatibility issues with specific armor assets. Test intended identity and armor combinations before deployment.
The reliable state is replayed during relevance entry and late join.
Accepted changes emit the existing onPlayerFaceChange, onPlayerBodyChange and onPlayerHeadChange events for compatibility.