---
name: "BIS_fnc_jukebox"
type: function
status: ok
groups: ["Sound"]
arma3_since: "1.08"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_jukebox
revid: 352108
updated: 2024-02-01T23:24:56Z
---

# BIS_fnc_jukebox

*Function · Sound · Arma 3 v1.08*

## Description

Plays music, depending on the player group status.

> [!NOTE]
> If no music classes are given, the function will get them from config automatically.

## Syntax

```sqf
[function, parameters] call BIS_fnc_jukebox
```

**Parameters:**

- `function`: [String](../topics/String.md) - (Optional, default "initialize") can be one of:
  - "initialize"
  - "terminate"
  - "readContainerFromConfig"
  - "isInitialized"
  - "forceBehaviour"
  - "status"
  - "randomMusic"
  - "selectMusic"
  - "playMusic"
  - "nearEnemies"
  - "hasContact"
  - "isContact"
  - "isStealth"
  - "isCombat"
  - "isSafe"
  - "onEachFrame"
- `parameters`: [Array](../topics/Array.md) - (Optional)

  - **"initialize"**: [stealthMusics, combatMusics, safeMusics, volume, transition, radius, executionRate, noRepeat]
    - stealthMusics: [Array](../topics/Array.md) of [String](../topics/String.md)s
    - combatMusics: [Array](../topics/Array.md) of [String](../topics/String.md)s
    - safeMusics: [Array](../topics/Array.md) of [String](../topics/String.md)s
    - volume: [Number](../topics/Number.md)
  - **"terminate"**: none
  - **"readContainerFromConfig"**: [wantedTheme]
  - **"isInitialized"**: none
  - **"forceBehaviour"**: [behaviour]
    - behaviour: [String](../topics/String.md) - can be "stealth", "combat" or "safe". Any other value will reset the forced behaviour.
  - **"status"**: none
  - **"randomMusic"**: [container]
    - container: [Array](../topics/Array.md) of [String](../topics/String.md)s - music list to choose from
  - **"selectMusic"**: none
  - **"playMusic"**: [musicName]
    - musicName: [String](../topics/String.md)
  - **"nearEnemies"**: none
  - **"hasContact"**: none
  - **"isContact"**: none
  - **"isStealth"**: none
  - **"isCombat"**: none
  - **"isSafe"**: none
  - **"onEachFrame"**: none

**Returns:** - [Array](../topics/Array.md) for:
  - "readContainerFromConfig"
  - "nearEnemies" - a list of enemies nearby

- [Boolean](../topics/Boolean.md) for:
  - "isInitialized"
  - "hasContact"
  - "isContact"
  - "isStealth"
  - "isCombat"
  - "isSafe"

- [String](../topics/String.md) for:
  - "status" - can be "stealth", "combat", "safe" or "error"
  - "randomMusic" - one of the available musics
  - "selectMusic"

- [Nothing](../topics/Nothing.md) for:
  - "initialize"
  - "terminate"
  - "forceBehaviour"
  - "playMusic"
  - "onEachFrame"

## Examples

### Example 1

```sqf
[] call BIS_fnc_jukebox;
```

## See also

[playMusic](../commands/playMusic.md) · [BIS_fnc_music](../functions/BIS_fnc_music.md)

<sub>Source: [BI Community Wiki — BIS fnc jukebox](https://community.bistudio.com/wiki/BIS_fnc_jukebox) (revision 352108).</sub>