{"name":"setFace","operator":null,"title":"setFace","type":"command","url":"https://community.bistudio.com/wiki/setFace","revid":369847,"updated":"2024-10-16T13:51:59Z","groups":["Unit Identity"],"status":"ok","replaced_by":[],"games":[{"game":"ofp","name":"Operation Flashpoint","version":"1.00"},{"game":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"ofp","name":"Operation Flashpoint","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"global","effect":"local","server_exec":false},"exec":null,"description":"Set person's face. For a list of available faces, check CfgIdentities 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","since":null,"effect":null,"exec":null,"params":[{"name":"person","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"person: Object"},{"name":"face","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"face: String"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"person","types":["Object"]},"right":{"text":"face","types":["String"]}}],"examples":[{"text":"```sqf\nsoldier1 setFace \"WhiteHead_02\";\n```","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."]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["face","setIdentity","setSpeaker","hasCustomFace"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Unit Identity","Introduced with Operation Flashpoint version 1.00","Operation Flashpoint: Elite: Scripting Commands","Operation Flashpoint: New Scripting Commands","Operation Flashpoint: Scripting Commands","Scripting Commands","Scripting Commands: Local Effect","Take On Helicopters: Scripting Commands"]}