# getCursorPosition (Cliente)

> Lê onde o cursor está na tela e o ponto do mundo para onde ele aponta.

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

## Sintaxe

```lua
float|false getCursorPosition()
```

## Retorno

Cinco números: `x, y` relativos à tela, de 0 a 1, e `x, y, z` de um ponto do mundo 300 unidades à frente da câmera, na direção do cursor. `false` quando o cursor não está solto na tela.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    local x, y = getCursorPosition()
    if x then
        dxDrawText(("%.2f, %.2f"):format(x, y), 20, 20)
    end
end)
```

## Veja também

- [setCursorPosition (Cliente)](https://wiki.mymp.gg/pt/setCursorPosition.md): Move o cursor para um ponto da tela.
- [showCursor (Cliente)](https://wiki.mymp.gg/pt/showCursor.md): Mostra ou esconde o cursor do mouse para este recurso.
- [onClientCursorMove (Cliente)](https://wiki.mymp.gg/pt/onClientCursorMove.md): Disparado quando o mouse se move.