hasCustomFace: Difference between revisions

Latest revision as of 20:08, 6 August 2024

Hover & click on the images for description

⚠

Only available in Development branch(es) until its release with Arma 3 patch v2.18.

Description:: Get whether or not a player has an available custom face file.
ⓘ
To check if this custom face is currently being used, use face (returns "Custom" in that case).
Groups:: Unit Identity

Syntax:: hasCustomFace person
Parameters:: person: Object
Return Value:: Boolean - true if player has a face.paa/jpg file in their current profile and it is usable

Example 1:: if (isPlayer _thisUnit && hasCustomFace _thisUnit && face _thisUnit != "Custom") then { [_thisUnit, "Custom"] remoteExec ["setFace", 0, true]; };

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

@@ Line 3: / Line 3: @@
 |game1= arma3
 |version1= 2.18
-|branch1= dev
+|branch= dev
+|arg= global
 |gr1= Unit Identity
-|descr= Returns [[true]] if the player has custom face file available. If the player is using a custom face, [[face]] command will return "Custom".
+|descr= Get whether or not a player has an available custom face file.
+{{Feature|informative|To check if this custom face is currently being used, use [[face]] (returns "Custom" in that case).}}
 |s1= [[hasCustomFace]] person
 |p1= person: [[Object]]
-|r1= [[Boolean]] - [[true]] if player has 'face.paa' or 'face.jpg' file in their current profile and it is usable.
-|x1= <sqf>hasCustomFace player1;</sqf>
+|r1= [[Boolean]] - [[true]] if player has a {{hl|face.paa/jpg}} file in their current profile and it is usable
+|x1= <sqf>
+if (isPlayer _thisUnit && hasCustomFace _thisUnit && face _thisUnit != "Custom") then
+{
+	[_thisUnit, "Custom"] remoteExec ["setFace", 0, true];
+};
+</sqf>
 |seealso= [[face]] [[setFace]] [[setIdentity]] [[setSpeaker]]
 }}