{"name":"setFace","title":"setFace","type":"command","url":"https://community.bistudio.com/wiki/setFace","revid":369847,"updated":"2024-10-16T13:51:59Z","groups":["Unit Identity"],"status":"ok","games":{"ofp":"1.00","ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofp 1.00","arma3_since":"0.50","locality":{"argument":"global","effect":"local"},"description":"Set person's face. For a list of available faces, check CfgIdentities Category or `CfgFaces` config.\nIf the face is non-existent, the face is set to 'Default' and the error is logged in the .rpt file.\n\n- Operation Flashpoint faces\n- Armed Assault faces\n- Arma 2 faces\n- Arma 3 faces\n- Take On Helicopters faces","syntaxes":[{"syntax":"person setFace face","params":[{"name":"person","type":"Object","type_expr":"Object"},{"name":"face","type":"String","type_expr":"String"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"person"},"right":{"text":"face"}}],"examples":[{"code":["soldier1 setFace \"WhiteHead_02\";"]},{"text":"Set persistent face for a unit in multiplayer:\n\n```sqf\nthis setFace \"AsianHead_A3_02\"; // in the init field if the unit already exists in Eden Editor\n```\n\n```sqf\nif (isServer) then { [_unit, \"AsianHead_A3_02\"] remoteExec [\"setFace\", 0, _unit] };\n// if the unit is created later in the game.\n// This only works with stock faces; when a player joins with a custom face into this unit,\n// all current players need to be force-updated to the desired face as custom face overwrites current face.\n// Use BIS_fnc_setIdentity for persistent identity.\n```","code":["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] }; \n// if the unit is created later in the game.\n// This only works with stock faces; when a player joins with a custom face into this unit, \n// all current players need to be force-updated to the desired face as custom face overwrites current face.\n// Use BIS_fnc_setIdentity for persistent identity."]}],"see_also":["face","setIdentity","setSpeaker","hasCustomFace"]}