# playSound3D (Servidor)

> Cria um som numa posição do mundo que todos os clientes tocam juntos. As mudanças feitas nele no servidor chegam a todos.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Servidor
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/playSound3D-server
- **Contraparte**: Também existe no cliente, com outra implementação: [playSound3D (Cliente)](https://wiki.mymp.gg/pt/playSound3D-client.md)

## Sintaxe

```lua
sound|false playSound3D(string path, float x, y, z [, bool looped = false, bool throttled = true])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `path` | `string` | Caminho de um arquivo que o recurso envia aos clientes (um `<file>` do `meta.xml`). `@outro/arquivo.mp3` aponta para outro recurso. |
| `x, y, z` | `float` | Posição do som no mundo, em três números ou um `vec3`. |
| `looped` | `bool` | Repetir o som quando ele chega ao fim. *(padrão: `false`)* |
| `throttled` | `bool` | Aceito por compatibilidade com o MTA e ignorado. *(padrão: `true`)* |

## Retorno

O elemento `sound` criado, ou `false` se o arquivo não pôde ser usado (o motivo vai para o log como aviso).

Quem entra depois ouve o som a partir de onde ele está. Um som que não repete é destruído pelo servidor quando termina.

## Exemplo

```lua
local alarm = playSound3D("sounds/alarm.ogg", 1481.0, -1771.3, 18.8, true)
setSoundMaxDistance(alarm, 60)
```

### Vindo do MTA

No MTA, `playSound3D` existe só no cliente.

### Atenção

O arquivo precisa ser um arquivo de cliente do recurso, senão a função devolve `false`.

## Veja também

- [playSound (Servidor)](https://wiki.mymp.gg/pt/playSound-server.md): Cria um som sem posição no mundo que todos os clientes tocam juntos. As mudanças feitas nele no servidor chegam a todos.
- [stopSound (Servidor)](https://wiki.mymp.gg/pt/stopSound-server.md): Para um som criado pelo servidor e destrói o elemento em todos os clientes.
- [setSoundMaxDistance (Compartilhado)](https://wiki.mymp.gg/pt/setSoundMaxDistance.md): Define a partir de que distância um som 3D fica mudo. O padrão é 20 m. No servidor, a mudança é enviada a todos os clientes.
- [playSound3D (Cliente)](https://wiki.mymp.gg/pt/playSound3D-client.md): Toca um som numa posição do mundo, só neste cliente. O volume cai com a distância entre setSoundMinDistance (5 m) e setSoundMaxDistance (20 m). Dispara onClientSoundStarted com play.