getPlayerScores: Difference between revisions

Latest revision as of 09:04, 1 January 2026

1.56

Hover & click on the images for description

Description

Description:: Returns the unit's table of scores (infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score) in multiplayer or an empty array in singleplayer.
⚠
This command does not work (returns empty array) if the unit's side has been changed (e.g [player] joinSilent createGroup east).
Groups:: Multiplayer

Syntax

Syntax:

getPlayerScores unitName

Parameters:

unitName: Object

Return Value:

Array with [killsInfantry, killsSoft, killsArmor, killsAir, score]

killsInfantry: Number - number of infantry units killed
killsSoft: Number - number of soft vehicles killed
killsArmor: Number - number of armored vehicles killed
killsAir: Number - number of air vehicles killed
score: Number - total score

Examples

Example 1:: getPlayerScores BIS_player1; // e.g [4, 0, 3, 1, 2, 16] // or in SP: []

Additional Information

See also:: score addScore scoreSide addScoreSide addPlayerScores

Notes

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

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-|arma3|= Game name
-|1.56|= Game version
-| In MP: returns the unit's table of scores (infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score). In SP: empty array []  |= Description
-|  '''getPlayerScores''' unitName |= Syntax
-|p1= unitName: [[Object]] |= PARAMETER1
-|p2=  |= PARAMETER2
-| [[Array]] - the score of the given player in format [infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score] |= RETURNVALUE
-|x1= <code>[[getPlayerScores]] BIS_player1;</code>|= EXAMPLE1
- | [[score]], [[addScore]], [[scoreSide]], [[addScoreSide]] |= SEEALSO
+|game1= arma3
-}}
+|version1= 1.56
+|gr1= Multiplayer
+|descr= Returns the unit's table of scores (infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score) '''in multiplayer''' or an empty array in singleplayer.
+{{Feature|important|This command does not work (returns empty array) if the unit's side has been changed (e.g <sqf inline>[player] joinSilent createGroup east</sqf>).}}
+|s1= [[getPlayerScores]] unitName
+|p1= unitName: [[Object]]
-<h3 style='display:none'>Bottom Section</h3>
+|r1= [[Array]] with [killsInfantry, killsSoft, killsArmor, killsAir, score]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
+* killsInfantry: [[Number]] - number of infantry units killed
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
+* killsSoft: [[Number]] - number of soft vehicles killed
+* killsArmor: [[Number]] - number of armored vehicles killed
+* killsAir: [[Number]] - number of air vehicles killed
+* score: [[Number]] - total score
-<h3 style='display:none'>Notes</h3>
+|x1= <sqf>
-<dl class="command_description">
+getPlayerScores BIS_player1;	// e.g [4, 0, 3, 1, 2, 16]
-<!-- BEGIN Note Section -->
+								// or in SP: []
-<!-- END Note Section -->
+</sqf>
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[score]] [[addScore]] [[scoreSide]] [[addScoreSide]] [[addPlayerScores]]
-[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
+}}
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]