# onColShapeHit (Servidor)

> Disparado quando um jogador, ped, veículo ou objeto entra numa área de colisão.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Servidor
- **Categoria**: Áreas de colisão
- **URL**: https://wiki.mymp.gg/pt/onColShapeHit

## Sintaxe

```lua
addEventHandler("onColShapeHit", root, function(element hitElement, bool matchingDimension) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `hitElement` | `element` | O elemento que entrou. |
| `matchingDimension` | `bool` | Se o elemento está na mesma dimensão que a área. |

## Source

A área de colisão (`colshape`).

## Exemplo

```lua
local zone = createColSphere(2488.0, -1666.0, 13.3, 5)

addEventHandler("onColShapeHit", zone, function(hitElement, matchingDimension)
    if matchingDimension and getElementType(hitElement) == "player" then
        setElementHealth(hitElement, 100)
    end
end)
```

### Atenção

O evento dispara em qualquer dimensão; confira `matchingDimension`.

## Veja também

- [onColShapeLeave (Servidor)](https://wiki.mymp.gg/pt/onColShapeLeave.md): Disparado quando um jogador, ped, veículo ou objeto sai de uma área de colisão.
- [onElementColShapeHit (Servidor)](https://wiki.mymp.gg/pt/onElementColShapeHit.md): Disparado num jogador, ped, veículo ou objeto quando ele entra numa área de colisão.
- [createColSphere (Compartilhado)](https://wiki.mymp.gg/pt/createColSphere.md): Cria uma área de colisão esférica.