---
name: "setCustomSoundController"
type: command
status: ok
groups: ["Sounds"]
arma3_since: "1.86"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setCustomSoundController
revid: 309208
updated: 2022-05-03T22:18:23Z
---

# setCustomSoundController

*Command · Sounds · Arma 3 v1.86*

## Description

Sets value of the specified custom sound controller to be used in simple expressions in config. Returns [true](../commands/true.md) if value was set to the controller, [false](../commands/false.md) if command fails, for example if vehicle is not a transport or controller name is not recognised.

> [!IMPORTANT]
> Custom sound controller name is case sensitive and of the following format:
>
> ```sqf
> format ["CustomSoundController%1", _number];
> ```
>
> Where `_number` is a number from 1 to [getCustomSoundControllerCount](../commands/getCustomSoundControllerCount.md) (currently 32)

## Syntax

```sqf
setCustomSoundController [vehicle, controller, value]
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md) - a transport type vehicle. Does not work on characters or buildings
- `controller`: [String](../topics/String.md) - name of the custom sound controller - needs to be full string e.g "CustomSoundController1". It goes from "CustomSoundController1" to "CustomSoundController32"
- `value`: [Number](../topics/Number.md) - desired value

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) on success

## Examples

### Example 1

Change value of CustomSoundController1 to 12

```sqf
setCustomSoundController [vehicle player, "CustomSoundController1", 12];
```

## See also

Arma 3: Sound · [getCustomSoundController](../commands/getCustomSoundController.md) · [getCustomSoundControllerCount](../commands/getCustomSoundControllerCount.md) · [getSoundController](../commands/getSoundController.md) · [getSoundControllerResult](../commands/getSoundControllerResult.md) · [getAllSoundControllers](../commands/getAllSoundControllers.md) · [getEnvSoundController](../commands/getEnvSoundController.md) · [getAllEnvSoundControllers](../commands/getAllEnvSoundControllers.md)

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