getPlayerScores: Difference between revisions

Latest revision as of 13:09, 26 February 2025

Hover & click on the images for 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 c[player] joinSilent createGroup east).
Groups:: Multiplayer

Syntax:: getPlayerScores unitName
Parameters:: unitName: Object
Return Value:: Array of Numbers - the score of the given player in format [infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score]

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

: 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 1: / Line 1: @@
 {{RV|type=command
 |game1= arma3
 |version1= 1.56
@@ Line 5: / Line 6: @@
 |gr1= Multiplayer
-|descr=
+|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.
-* In MP: Returns the unit's table of scores (infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score).
+{{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>).}}
-* In SP: Empty array []
 |s1= [[getPlayerScores]] unitName
 |p1= unitName: [[Object]]
-|p2=
-|r1= [[Array]] - the score of the given player in format [infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score]
-|x1= <code>[[getPlayerScores]] BIS_player1;</code>
+|r1= [[Array]] of [[Number]]s - the score of the given player in format [infantry kills, soft vehicle kills, armor kills, air kills, deaths, total score]
+|x1= <sqf>
+getPlayerScores BIS_player1;	// e.g [4, 0, 3, 1, 2, 16]
+								// or in SP: []
+</sqf>
- |seealso= [[score]] [[addScore]], [[scoreSide]], [[addScoreSide]], [[addPlayerScores]]
+|seealso= [[score]] [[addScore]] [[scoreSide]] [[addScoreSide]] [[addPlayerScores]]
 }}