# onClientWorldSound (Cliente)

> Disparado quando o jogo vai tocar um som do mundo. Cancelar o evento impede o som de tocar.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Cliente
- **Categoria**: Som
- **Cancelável**: `cancelEvent`
- **URL**: https://wiki.mymp.gg/pt/onClientWorldSound

## Sintaxe

```lua
addEventHandler("onClientWorldSound", root, function(int group, int index, float x, y, z) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `group` | `int` | Grupo do som (o slot de banco do SA). |
| `index` | `int` | Índice do som dentro do grupo. |
| `x, y, z` | `float` | Onde o som toca. |

## Source

O elemento da entidade que faz o som (um ped, veículo ou objeto), ou o elemento raiz (`root`) se não há nenhum.

## Exemplo

```lua
addEventHandler("onClientWorldSound", localPlayer, function(group, index)
    if group == 5 then
        cancelEvent()
    end
end)
```

### Atenção

Os sons de colisão calculados pela física em paralelo e os de índice acima de 399 tocam sem disparar o evento. Um som desligado com `setWorldSoundEnabled` também não dispara.

## Veja também

- [setWorldSoundEnabled (Cliente)](https://wiki.mymp.gg/pt/setWorldSoundEnabled.md): Liga ou desliga sons do mundo do jogo (passos, tiros, colisões e outros) por grupo ou um a um.
- [showSound (Cliente)](https://wiki.mymp.gg/pt/showSound.md): Escreve no console de depuração o grupo e o índice de cada som do mundo que toca. Só funciona no modo de desenvolvimento.