SU.Settlers.SetHealthInArea

SU Library: erst ab Version 0.6.0 verfügbar!

SU.Settlers.SetHealthInArea(playerId, settlerType, x, y, radius, newHealth)

Setzt die Lebenspunkte der angegebenen Siedler im gegebenen Bereich.

Notiz

• Haben Siedler keine Lebenspunkte (=0), werden sie ignoriert

• Der gegebene Absolutwert (newHealth) wird auf die maximalen Lebenspunkte der Entität beschränkt

• newHealth=0 setzt die Lebenspunkte zwar auf 0, löst aber nicht die Kill-Funktion aus (Siedler ist danach quasi 1-Hit)

• x, y, radius oder newHealth im negativen Bereich (<0) wird ignoriert und die Funktion nicht ausgeführt (siehe Rückgabewert)

Parameter

• playerId: ID des Spielers (1-8), Index 0 ungültig, -1 für alle Spieler

• settlerType: Settlers , -1 für alle Siedler

• x: x-Koordinate des Bereichs

• y: y-Koordinate des Bereichs

• radius: Radius des Bereichs

• newHealth: neue absoluten Lebenspunkte (siehe Notizen)

Rückgabewert

• Anzahl an Entitäten, deren Lebenspunkte verändert wurden

• -1: sonst / Fehler

Beispiel

 local amount = SU.Settlers.SetHealthInArea(playerID, settlerType, x, y, radius, newHealth)

 local amount = SU.Settlers.SetHealthInArea(-1, -1, 217, 125, 20, 90)
 -- Alle Siedler aller Spieler werden in den Bereich auf 90 HP gesetzt
 if amount > 0 then
	dbg.stm(amount) -- Anzahl der betroffenen Siedler
 end