getPlayerScores: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "\| *(arg|eff|mp|serverExec|gr[0-9]) *= *(.*) * *\|([^=0-9]{12})" to "|$1=$2 |descr=$3")
(Add side changing issue note)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command
|arma3
 
|1.56
|game1= arma3
|version1= 1.56


|gr1= Multiplayer
|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
|s1= [[getPlayerScores]] unitName


|p1= unitName: [[Object]]
|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]]
}}
}}

Latest revision as of 13:09, 26 February 2025

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 c[player] joinSilent createGroup east).
Groups:
Multiplayer

Syntax

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]

Examples

Example 1:
Copy
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 or on the Forums.
Only post proven facts here! Add Note