Arma 3 Scripting

Command in Unit Identity

setFace

Also available as Markdown and JSON, or read the original wiki page.

Description

Set person's face. For a list of available faces, check CfgIdentities or CfgFaces config. If the face is non-existent, the face is set to 'Default' and the error is logged in the .rpt file.

Syntax

person setFace face

Parameters:

Returns: Nothing

Examples

Example 1

soldier1 setFace "WhiteHead_02";

Example 2

Set persistent face for a unit in multiplayer:

this setFace "AsianHead_A3_02"; // in the init field if the unit already exists in Eden Editor
if (isServer) then { [_unit, "AsianHead_A3_02"] remoteExec ["setFace", 0, _unit] }; 
// if the unit is created later in the game.
// This only works with stock faces; when a player joins with a custom face into this unit, 
// all current players need to be force-updated to the desired face as custom face overwrites current face.
// Use [[BIS_fnc_setIdentity]] for persistent identity.

See also

face · setIdentity · setSpeaker · hasCustomFace