SU.Settlers.GetSelection
SU Library: ab Version 0.7.0
SU.Settlers.GetSelection(vehicleIDs)
Gibt die Sielder-IDs der aktuell ausgewählten Entitäten zurück. ⇒ ist eine auf Siedler limitierte Version von SU.Entity.GetSelection.
Achtung: funktioniert nur beim lokalen Spieler! ⇒ Desync-Gefahr wenn im Folgenden mit lokalen Funktionen das Spiel beeinflusst wird (siehe Lokale vs Netzwerk-Funktionen).
Parameter
settlerIDs: Ziel-Tabelle: Eine vor dem Funktionsaufruf erstellte Tabelle (z. B.local settlerIDs = {}, siehe Beispiel unten), die dann von dieser Funktion mit den gefundenen Entity-IDs befüllt wird. Achtung: Bereits enthaltene Daten in dieser Tabelle werden dabei überschrieben!
Rückgabewert
number(Anzahl): Die Gesamtzahl der gefundenen Entitäten.Hinweis: Die eigentlichen Entity-IDs werden nicht als Rückgabewert geliefert, sondern direkt in die als ersten Parameter übergebene Ziel-Tabelle geschrieben.
Beispiel
local entityIDs = {} -- oder einmalig global definiert
local numEntities = SU.Settlers.GetSelection(entityIDs)
local entityIDs = {} -- oder einmalig global definiert
local numEntities = SU.Settlers.GetSelection(entityIDs)
-- Alle Entitäten bei 115/70 im Radius von 10
if numEntities > 0 then
dbg.stm(numEntities) -- Anzahl der Entitäten
dbg.stm(entityIDs[1]) -- Erster Eintrag der Id Liste
endLast updated