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.
In G1R:MP 0.1 this is the only supported setter for a complete player identity. The test command /identity <key> uses this API.
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 by setPlayerArmor; selecting an identity does not equip armor.
Gothic Remake character models and variants are authored with different armor support. Not every identity/armor combination exists or renders correctly, so test every combination used by a resource.
The reliable state is replayed during relevance entry and late join.
Accepted changes emit the existing compatibility events for the layers that changed: onPlayerFaceChange and onPlayerBodyChange for the face/body layer, and onPlayerHeadChange for the head layer.