# getGroundPosition (Cliente)

> Procura o chão logo abaixo de um ponto, até 1000 m para baixo. Só prédios e objetos contam.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Mundo e clima
- **URL**: https://wiki.mymp.gg/pt/getGroundPosition

## Sintaxe

```lua
float|false getGroundPosition(float x, y, z)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | O ponto de onde a busca desce. Também aceita um `vec3`. |

## Retorno

A altura `z` do chão, ou `false` se nada foi encontrado.

## Exemplo

```lua
local pos = getElementPosition(localPlayer)
local groundZ = getGroundPosition(pos.x, pos.y, pos.z + 2)
if groundZ then
    outputDebugString(("%.1f m acima do chão"):format(pos.z - groundZ))
end
```

## Veja também

- [processLineOfSight (Cliente)](https://wiki.mymp.gg/pt/processLineOfSight.md): Lança um raio entre dois pontos e devolve a primeira coisa que ele acerta.
- [isLineOfSightClear (Cliente)](https://wiki.mymp.gg/pt/isLineOfSightClear.md): Diz se nada bloqueia o segmento entre dois pontos. Só prédios e objetos bloqueiam; veículos e peds não.