# playSound (Servidor)

> Cria um som sem posição no 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/playSound-server
- **Contraparte**: Também existe no cliente, com outra implementação: [playSound (Cliente)](https://wiki.mymp.gg/pt/playSound-client.md)

## Sintaxe

```lua
sound|false playSound(string path [, 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. |
| `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
addEventHandler("onResourceStart", resourceRoot, function()
    playSound("sounds/event_start.mp3")
end)
```

### Vindo do MTA

No MTA, `playSound` 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

- [playSound3D (Servidor)](https://wiki.mymp.gg/pt/playSound3D-server.md): Cria um som numa posição do 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.
- [playSound (Cliente)](https://wiki.mymp.gg/pt/playSound-client.md): Toca um som sem posição no mundo, só neste cliente. Dispara onClientSoundStarted com o motivo play.
- [setSoundPaused (Compartilhado)](https://wiki.mymp.gg/pt/setSoundPaused.md): Pausa ou continua um som. No servidor, a mudança é enviada a todos os clientes.