# setPedOverlay (Compartido)

> Pone o quita una superposición en el rostro de un ped, como barba, cejas o maquillaje.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Compartido
- **Categoría**: Apariencia
- **URL**: https://wiki.mymp.gg/es/setPedOverlay

## Sintaxis

```lua
bool setPedOverlay(ped ped, string name [, int|bool variation = 0, float opacity = 1])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `ped` | `ped` | El ped o jugador. |
| `name` | `string` | Nombre de la superposición, como la declara la cabeza del ped. Mayúsculas y minúsculas no importan. |
| `variation` | `int\|bool` | Variante de la superposición, de 0 a 255, o `false` para quitarla. *(por defecto: `0`)* |
| `opacity` | `float` | Opacidad, de 0 a 1. No se usa con `false`. *(por defecto: `1`)* |

## Retorno

`true` si cambió, `false` si se pidió quitar una superposición que el ped no lleva. Da error si el nombre pasa de 32 caracteres, la variante sale de 0 a 255 o la opacidad sale de 0 a 1.

En el servidor, el cambio se envía a todos los clientes. En el cliente, vale solo para este cliente.

## Ejemplo

```lua
addCommandHandler("barba", function(player, command, variation)
    if variation then
        setPedOverlay(player, "beard", tonumber(variation), 0.9)
    else
        setPedOverlay(player, "beard", false)
    end
end)
```

### Si vienes de MTA

MTA no tiene esta función. Sigue `SetPedHeadOverlay` de FiveM.

### Atención

Un ped lleva hasta 64 superposiciones. Pasado ese límite, una nueva da el mismo error de argumento inválido.

## Ver también

- [getPedOverlay (Compartido)](https://wiki.mymp.gg/es/getPedOverlay.md): Dice qué variante de una superposición lleva un ped en el rostro.
- [setPedOverlayColor (Compartido)](https://wiki.mymp.gg/es/setPedOverlayColor.md): Tiñe una superposición que el ped lleva en el rostro, con una fila de la paleta o con un color.
- [setPedHeadBlend (Compartido)](https://wiki.mymp.gg/es/setPedHeadBlend.md): Arma el rostro de un ped mezclando la cabeza y la piel de dos padres.