> For the complete documentation index, see [llms.txt](https://docs.settlers-united.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.map/su.map.getmouseposition.md).

# SU.Map.GetMousePosition

## SU.Map.GetMousePosition()

Gibt die Position der Maus **des lokalen Spielers** auf der Karte zurück.

**Achtung**: funktioniert nur beim **lokalen Spieler**!\
⇒ **Desync-Gefahr** wenn im Folgenden mit **lokalen Funktionen** das Spiel beeinflusst wird (siehe [Lokale vs Netzwerk-Funktionen](/s4-lua-api-de/tutorials/advanced-tipps/lokale-vs-netzwerk-funktionen.md)).

#### Notiz

* Ist die Maus **außerhalb der Karte**, wird die letzte gültige Position zurückgegeben.
* Ist die Maus **außerhalb von S4** (z.B. mehrere Monitore oder Fenstermodus), wird die zuletzt von S4 registrierte Position innerhalb des Fensters zurückgegeben.

#### Rückgabewert

* `x,y`: Koordinaten auf der Karte
* `0,0` oder `-1,-1`: sonst / Fehler

#### Beispiel

```lua
local x, y = SU.Map.GetMousePosition()
```