# onColShapeHit (Server)

> Fired when a player, ped, vehicle or object enters a collision shape.

- **Platform**: MY Multiplayer (MYMP)
- **Kind**: Lua Event
- **Side**: Server
- **Category**: Collision shapes
- **URL**: https://wiki.mymp.gg/en/onColShapeHit

## Syntax

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

## Handler parameters

| Name | Type | Description |
| --- | --- | --- |
| `hitElement` | `element` | The element that entered. |
| `matchingDimension` | `bool` | Whether the element is in the same dimension as the shape. |

## Source

The collision shape (`colshape`).

## Example

```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)
```

### Note

The event fires in any dimension; check `matchingDimension`.

## See also

- [onColShapeLeave (Server)](https://wiki.mymp.gg/en/onColShapeLeave.md): Fired when a player, ped, vehicle or object leaves a collision shape.
- [onElementColShapeHit (Server)](https://wiki.mymp.gg/en/onElementColShapeHit.md): Fired on a player, ped, vehicle or object when it enters a collision shape.
- [createColSphere (Shared)](https://wiki.mymp.gg/en/createColSphere.md): Creates a spherical collision shape.