Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

SU.Goods.GetGoodsInArea

SU Library: ab Version 0.7.0

SU.Goods.GetGoodsInArea(goodIDs, playerID, goodType, x, y, radius)

Gibt die Entity-IDs der Waren im gegebenen Bereich zurück.

Ist eine auf Waren limitierte Version von SU.Entity.GetEntitiesInArea.

Parameter

  • goodIDs: Ziel-Tabelle: Eine vor dem Funktionsaufruf erstellte Tabelle (z. B. local goodIDs = {}, 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!

  • playerId: ID des Spielers (1-8), Index 0 ungültig, -1 wenn keine Spieler gefiltert werden sollen

  • goodType: Goods , -1 wenn keine Waren-Typen gefiltert werden sollen

  • x: x-Koordinate des Bereichs

  • y: y-Koordinate des Bereichs

  • radius [0-74]: Radius des Bereichs

Rückgabewert

  • number (Anzahl): Die Gesamtzahl der gefundenen Waren.

  • Hinweis: Die eigentlichen Entity-IDs werden nicht als Rückgabewert geliefert, sondern direkt in die als ersten Parameter übergebene Ziel-Tabelle geschrieben.

Beispiel

local goodIDs = {}    -- oder einmalig global definiert
local numGoods = SU.Entity.GetGoodsInArea(goodIDs, playerID, goodType, x, y, radius)

local goodIDs = {}    -- oder einmalig global definiert
local numGoods = SU.Entity.GetGoodsInArea(goodIDs, -1, -1, 115, 70, 10)
-- Alle Waren bei 115/70 im Radius von 10
if numGoods > 0 then
    dbg.stm(numGoods) -- Anzahl der Waren
    dbg.stm(goodIDs[1]) -- Erster Eintrag der Id Liste
end

Last updated