---
name: "BIS_fnc_onPlayerConnected"
type: function
status: ok
groups: ["Multiplayer", "Event Handlers"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": true}
source: https://community.bistudio.com/wiki/BIS_fnc_onPlayerConnected
revid: 379590
updated: 2026-11-04T00:04:10Z
---

# BIS_fnc_onPlayerConnected

*Function · Multiplayer, Event Handlers · Arma 3 v1.00*

Locality: **server execution only**

## Description

Executes code on server every time a player joins the scenario (after unit selection).

## Syntax

```sqf
[code, params] call BIS_fnc_onPlayerConnected
```

**Parameters:**

- `code`: [Code](../topics/Code.md) or [String](../topics/String.md) - [code](../topics/Code.md) or name of the function to be executed. The following parameters are passed: [player, params], where:

  - player: [Object](../topics/Object.md) - the connected [player](../commands/player.md) unit
  - params: [Anything](../topics/Anything.md) - *params* (below)
- `params`: [Anything](../topics/Anything.md) - parameters passed to the code or function (usually an [Array](../topics/Array.md) or [HashMap](../topics/HashMap.md))

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

## Examples

### Example 1

```sqf
[
    {
        params ["_player", "_params"];
        systemChat name _player;
        systemChat _params;
    },
    "Parameter"
] call BIS_fnc_onPlayerConnected;
```

## See also

[onPlayerConnected](../commands/onPlayerConnected.md) · [BIS_fnc_addStackedEventHandler](../functions/BIS_fnc_addStackedEventHandler.md) · [Event Scripts](../topics/Event_Scripts.md)

<sub>Source: [BI Community Wiki — BIS fnc onPlayerConnected](https://community.bistudio.com/wiki/BIS_fnc_onPlayerConnected) (revision 379590).</sub>