---
name: "player"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/player
revid: 363907
updated: 2024-04-24T21:56:05Z
---

# player

*Command · Object Manipulation · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

## Description

A person object controlled by user. In Intros and Outros this isn't set by default and must be assigned.

## Syntax

```sqf
player
```

**Returns:** [Object](../topics/Object.md)

## Examples

### Example 1

```sqf
player addRating 500;
```

## Multiplayer

In MP [player](../commands/player.md) is different on each computer and on dedicated server it is [objNull](../commands/objNull.md) by default ([unless scripted](https://www.youtube.com/watch?v=JzgJe9sXAiU)).
When user is joining a dedicated server mission, at the moment of [onPlayerConnected](../commands/onPlayerConnected.md) the [player](../commands/player.md) object is remote to the joining client, as the [player](../commands/player.md) unit is created on the server, but once control of the unit is passed to the user moments later, the [player](../commands/player.md) objects becomes and remains [local](../topics/Multiplayer_Scripting.md#locality) to the client.

See [Multiplayer Scripting's player topic](../topics/Multiplayer_Scripting.md#general-information-about-locality) for additional helpful information.

## Problems

In multiplayer, the command is not initialised in functions called by initline or init eventhandlers.

## See also

[Multiplayer Scripting](../topics/Multiplayer_Scripting.md) · [isPlayer](../commands/isPlayer.md) · [playableUnits](../commands/playableUnits.md) · [selectPlayer](../commands/selectPlayer.md)

## Community notes

**Galzohar** — 2010-06-20

Before you use the **player** object in init scripts, to avoid JIP issues all you need is to run:

```sqf
waitUntil { not isNull player };
```

Anything else you see in other scripts is equivalent and/or redundant. (but you may need to add other conditions too, such as checking [hasInterface](../commands/hasInterface.md) before initiating that loop)

Of course JIP players may need more than just the player to point at the actual JIP player unit, but that's script/mission-specific.

---

**Killzone_Kid** — 2014-06-26

[player](../commands/player.md) can actually be REMOTE object on player's PC: <http://www.youtube.com/watch?v=m6IILtfa3cQ>

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