# setPedOverlay (Compartilhado)

> Põe ou tira uma sobreposição no rosto de um ped, como barba, sobrancelha ou maquiagem.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Aparência
- **URL**: https://wiki.mymp.gg/pt/setPedOverlay

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `ped` | `ped` | O ped ou jogador. |
| `name` | `string` | Nome da sobreposição, como a cabeça do ped a declara. Maiúsculas e minúsculas não importam. |
| `variation` | `int\|bool` | Variante da sobreposição, de 0 a 255, ou `false` para tirá-la. *(padrão: `0`)* |
| `opacity` | `float` | Opacidade, de 0 a 1. Não se usa com `false`. *(padrão: `1`)* |

## Retorno

`true` se mudou, `false` se pediu para tirar uma sobreposição que o ped não usa. Dá erro se o nome passa de 32 caracteres, a variante sai de 0 a 255 ou a opacidade sai de 0 a 1.

No servidor, a mudança é enviada a todos os clientes. No cliente, vale só para este cliente.

## Exemplo

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

### Vindo do MTA

O MTA não tem esta função. Ela segue `SetPedHeadOverlay` do FiveM.

### Atenção

Um ped usa até 64 sobreposições. Passado esse limite, uma nova dá o mesmo erro de argumento inválido.

## Veja também

- [getPedOverlay (Compartilhado)](https://wiki.mymp.gg/pt/getPedOverlay.md): Diz qual variante de uma sobreposição um ped usa no rosto.
- [setPedOverlayColor (Compartilhado)](https://wiki.mymp.gg/pt/setPedOverlayColor.md): Tinge uma sobreposição que o ped usa no rosto, por uma linha da paleta ou por uma cor.
- [setPedHeadBlend (Compartilhado)](https://wiki.mymp.gg/pt/setPedHeadBlend.md): Monta o rosto de um ped misturando a cabeça e a pele de dois pais.