# SU.Entity.Delete

## SU.Entity.Delete(entityID)

Löscht/Zerstört die angegebene Entität (**beschränkt** auf: Gebäude, Siedler, Schiffe und Fahrzeuge) mit Sterbeanimation.

Eine **Entität** ist alles, was im Spiel als "physisches Objekt" vorkommt: d.h. **Objekte, Siedler, Gebäude, Fahrzeuge, Warenstapel, Tiere, etc.**, für Mapper also **quasi alles Auswählbare** (und noch mehr).

#### Welche Funktion genau brauche ich?

Ist die Entität mit der `entityID`:

* **generell** ein Gebäude, Siedler, Warenstapel, etc., **egal welches/r genau**\
  ⇒ [su.entity.getentitytype](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.getentitytype "mention") ([su.entity.getbasetype](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.getbasetype "mention"), [su.entity.getclass](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.getclass "mention"))
* **grob gruppiert** ein Nahrungsgebäude, eine Mine, ein Soldat\
  ⇒ [su.entity.getroleclass](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.getroleclass "mention")
* **spezifisch** eine Kaserne, ein Bogenschütze, ein Goldbarren, etc.\
  ⇒ [su.entity.gettype](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.gettype "mention")

#### Parameter

* `entityID`: ID der Entität

#### Rückgabewert

* 1: erfolgreich gelöscht/zerstört
* 0: Fehler: ungültige ID
* -1: Fehler: gültige ID, konnte aber nicht gelöscht/zerstört werden

#### Beispiel

```lua
local success = SU.Entity.Delete(entityID)
```