SU.Settlers.AddSettlersIfNeeded
SU Library: erst ab Version 0.3.0 verfügbar!
SU.Settlers.AddSettlersIfNeeded(x, y, playerID, settlerType, amount[, radius=20[, checkLandOwnedRadius=1[, withBeds=0]]])
Erzeugt Siedler an den angegebenen Koordinaten, wenn im Radius nicht genügend vorhanden sind. Zusätzlich können gleich entsprechende Betten hinzugefügt werden, damit diese neuen Siedler nicht zu Streikenden führen können.
Der hauptsächliche Nutzen dieser Funktion ist es, (KI-)Spielern "unendlich" Träger geben zu können, ohne dass tausende herumstehen, sich gegenseitig blockieren und dadurch zu Leistungseinfällen zu führen.
Z.B. kann diese Funktion jede Minute aufgerufen werden und im angegebenen Bereich auf 50 Träger "auffüllen". Wählt man einen Ort, wo sich normalerweise keine Träger aufhalten, kann die KI dadurch unendlich lange Soldaten produzieren.
Notiz
der Spieler darf noch nicht verloren haben
wie die anderen Funktionen auch, sollte gerade diese Funktion nicht zu häufig aufgerufen werden (nicht alle paar Ticks), sondern lieber seltener (z.B. jede Minute), das reicht in den allermeisten Fällen aus
der Radius muss mit Bedacht gewählt werden. Ist er zu klein, sodass
amount
viele gar keinen Platz darin hätten, werden unendlich lange Siedler hinzugefügt und das Spiel wird früher oder später daran abstürzen!wird die Funktion dauerhaft ausgeführt, sollte
withBeds
nicht aktiviert sein, da dies endlos Betten hinzufügt. Besser wäre es, die Bettenanzahl einmalig zu einem hohen Wert zu setzen ⇒ SU.Game.SetBeds bzw. SU.Game.AddBeds
Parameter
x, y
: KoordinatenplayerID [1-8]
: Spieler-ID, Index 0 ist ungültig!settlerType
: Settlersamount
: Anzahl der hinzuzufügenden Siedler (inkl. Betten)radius
(optional): Radius, in dem nach vorhandenen Siedlern gesucht wird. Um nicht endlos Siedler hinzuzufügen, muss der Radius der Siedlermenge entsprechend groß genug gesetzt werden!checkLandOwnedRadius
(optional): Radius, in dem das Land dem Spieler gehören muss, um Siedler hinzuzufügenwithBeds
(optional): 1: Betten werden hinzugefügt, 0: ohne Betten
Rückgabewert
Anzahl an hinzugefügten Siedlern
-1: Fehler: das Land gehört dem Spieler nicht mehr oder er ist nicht mehr am Leben ⇒ folglich sollte diese Funktion nicht mehr aufgerufen werden
Beispiel
Last updated