# playSound3D (Servidor)

> Crea un sonido en una posición del mundo que todos los clientes reproducen a la vez. Los cambios que se le hacen en el servidor llegan a todos.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Servidor
- **Categoría**: Sonido
- **URL**: https://wiki.mymp.gg/es/playSound3D-server
- **Contraparte**: También existe en el cliente, con otra implementación: [playSound3D (Cliente)](https://wiki.mymp.gg/es/playSound3D-client.md)

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `path` | `string` | Ruta de un archivo que el recurso envía a los clientes (un `<file>` del `meta.xml`). `@otro/archivo.mp3` apunta a otro recurso. |
| `x, y, z` | `float` | Posición del sonido en el mundo, en tres números o un `vec3`. |
| `looped` | `bool` | Repetir el sonido cuando llega al final. *(por defecto: `false`)* |
| `throttled` | `bool` | Se acepta por compatibilidad con MTA y se ignora. *(por defecto: `true`)* |

## Retorno

El elemento `sound` creado, o `false` si no se pudo usar el archivo (el motivo se registra como aviso).

Quien entra después oye el sonido desde donde va. Un sonido que no se repite lo destruye el servidor cuando termina.

## Ejemplo

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

### Si vienes de MTA

En MTA, `playSound3D` solo existe en el cliente.

### Atención

El archivo tiene que ser un archivo de cliente del recurso; si no, la función devuelve `false`.

## Ver también

- [playSound (Servidor)](https://wiki.mymp.gg/es/playSound-server.md): Crea un sonido sin posición en el mundo que todos los clientes reproducen a la vez. Los cambios que se le hacen en el servidor llegan a todos.
- [stopSound (Servidor)](https://wiki.mymp.gg/es/stopSound-server.md): Detiene un sonido creado por el servidor y destruye el elemento en todos los clientes.
- [setSoundMaxDistance (Compartido)](https://wiki.mymp.gg/es/setSoundMaxDistance.md): Define a partir de qué distancia un sonido 3D queda en silencio. Por defecto son 20 m. En el servidor, el cambio se envía a todos los clientes.
- [playSound3D (Cliente)](https://wiki.mymp.gg/es/playSound3D-client.md): Reproduce un sonido en una posición del mundo, solo en este cliente. El volumen baja con la distancia entre setSoundMinDistance (5 m) y setSoundMaxDistance (20 m). Dispara onClientSoundStarted con play.