> 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.buildings/su.buildings.togglehalt.md).

# SU.Buildings.ToggleHalt

## SU.Buildings.ToggleHalt(buildingID)

Verändert die Pausierung des durch die ID angegebenen Gebäudes von ein auf aus und umgekehrt.

Um den Status direkt zu setzen, verwende [SU.Buildings.SetHaltedState](/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.sethaltedstate.md).

#### Parameter

* `buildingID`: ID des Gebäudes

#### Rückgabewert

* Pausierungs-Status des Gebäudes (0 pausiert)
* -1: sonst / Fehler

#### Beispiel

```lua
local newHaltState = SU.Buildings.ToggleHalt(buildingID)
```