# createColPolygon (Compartilhado)

> Cria uma área de colisão com a forma de um polígono no plano, sem limite de altura até `setColPolygonHeight` dar um.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Áreas de colisão
- **URL**: https://wiki.mymp.gg/pt/createColPolygon

## Sintaxe

```lua
element|false createColPolygon(float centerX, centerY, float x1, y1, x2, y2, x3, y3, ...)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `centerX, centerY` | `float` | Um ponto de referência, usado só numa checagem rápida de distância antes do teste do polígono. Também aceita um `vec2`. |
| `x1, y1, x2, y2, x3, y3, ...` | `float` | Os vértices, em coordenadas do mundo e em ordem ao redor do polígono: pelo menos 3 e no máximo 256. Cada um pode ser dois números ou um vetor. |

## Retorno

O elemento `colshape` criado, ou `false` se não pôde ser criado.

Uma área de colisão detecta jogadores, peds, veículos e objetos pela posição de cada um e dispara `onColShapeHit` e `onColShapeLeave` (`onClientColShapeHit` e `onClientColShapeLeave` no cliente). Ela some quando o recurso que a criou para.

## Exemplo

```lua
local lot = createColPolygon(1500, -1700, 1480, -1720, 1520, -1720, 1530, -1690, 1475, -1680)
setColPolygonHeight(lot, 10, 25)
```

## Veja também

- [setColPolygonHeight (Compartilhado)](https://wiki.mymp.gg/pt/setColPolygonHeight.md): Limita entre que alturas um polígono de colisão detecta elementos.
- [getColPolygonHeight (Compartilhado)](https://wiki.mymp.gg/pt/getColPolygonHeight.md): Devolve entre que alturas um polígono de colisão detecta elementos.
- [createColRectangle (Compartilhado)](https://wiki.mymp.gg/pt/createColRectangle.md): Cria uma área de colisão retangular, alinhada aos eixos do mundo e sem limite de altura.