# onElementAttach (Servidor)

> Disparado quando o servidor chama `attachElements`, antes de o elemento ser anexado. Cancelar o evento impede o anexo e faz `attachElements` devolver `false`.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Servidor
- **Categoria**: Anexos
- **Cancelável**: `cancelEvent`
- **URL**: https://wiki.mymp.gg/pt/onElementAttach

## Sintaxe

```lua
addEventHandler("onElementAttach", root, function(element attachedTo, float x, y, z, float rx, ry, rz) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `attachedTo` | `element` | O elemento em que ele vai ficar pendurado. |
| `x, y, z` | `float` | Deslocamento pedido em relação ao alvo. |
| `rx, ry, rz` | `float` | Rotação pedida em relação ao alvo. |

## Source

O elemento que vai ser anexado.

## Exemplo

```lua
addEventHandler("onElementAttach", root, function(attachedTo)
    if getElementType(source) == "player" and getElementType(attachedTo) == "vehicle" then
        cancelEvent()
    end
end)
```

## Veja também

- [attachElements (Compartilhado)](https://wiki.mymp.gg/pt/attachElements.md): Pendura um elemento em outro. A partir daí ele segue o alvo até ser solto.
- [onElementDetach (Servidor)](https://wiki.mymp.gg/pt/onElementDetach.md): Disparado antes de um elemento ser solto no servidor, por detachElements ou por attachElements levando-o para outro alvo. Cancelar o evento mantém o elemento anexado.
- [getElementAttachedOffsets (Compartilhado)](https://wiki.mymp.gg/pt/getElementAttachedOffsets.md): Lê o deslocamento, a rotação e o socket com que um elemento está anexado.