---
name: "getPlayerScores"
type: command
status: ok
groups: ["Multiplayer"]
arma3_since: "1.56"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getPlayerScores
revid: 376996
updated: 2026-01-01T08:04:57Z
---

# getPlayerScores

*Command · Multiplayer · Arma 3 v1.56*

## 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.

> [!IMPORTANT]
> This command does not work (returns empty array) if the unit's side has been changed (e.g `[player] joinSilent createGroup east`).

## Syntax

```sqf
getPlayerScores unitName
```

**Parameters:**

- `unitName`: [Object](../topics/Object.md)

**Returns:** [Array](../topics/Array.md) with [killsInfantry, killsSoft, killsArmor, killsAir, score]
- killsInfantry: [Number](../topics/Number.md) - number of infantry units killed
- killsSoft: [Number](../topics/Number.md) - number of soft vehicles killed
- killsArmor: [Number](../topics/Number.md) - number of armored vehicles killed
- killsAir: [Number](../topics/Number.md) - number of air vehicles killed
- score: [Number](../topics/Number.md) - total score

## Examples

### Example 1

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

## See also

[score](../commands/score.md) · [addScore](../commands/addScore.md) · [scoreSide](../commands/scoreSide.md) · [addScoreSide](../commands/addScoreSide.md) · [addPlayerScores](../commands/addPlayerScores.md)

<sub>Source: [BI Community Wiki — getPlayerScores](https://community.bistudio.com/wiki/getPlayerScores) (revision 376996).</sub>