CollectionService | Dokumentation

Engine-Klasse

CollectionService

Nicht erstellbar

Dienst

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Zusammenfassung

Methoden

AddTag(instance: Instance,tag: string):()

GetAllTags():{any}

GetCollection(class: string):Instances

Veraltet

GetInstanceAddedSignal(tag: string):RBXScriptSignal

GetInstanceRemovedSignal(tag: string):RBXScriptSignal

GetTagged(tag: string):Instances

GetTags(instance: Instance):{any}

HasTag(instance: Instance,tag: string):boolean

RemoveTag(instance: Instance,tag: string):()

Events

ItemAdded(instance: Instance):RBXScriptSignal

Veraltet

ItemRemoved(instance: Instance):RBXScriptSignal

Veraltet

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Geerbte Mitglieder

57 von Instance geerbt

6 von Object geerbt

API-Referenz

Methoden

AddTag

Funktionen: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Parameter

instance:Instance

tag:string

Rückgaben

()

GetAllTags

Parallel schreiben

Funktionen: Basic

CollectionService:GetAllTags():{any}

Rückgaben

{any}

GetCollection

Veraltet

GetInstanceAddedSignal

Funktionen: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Parameter

tag:string

Rückgaben

RBXScriptSignal

Code-Beispiele

Tödliche Blöcke mit CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Speicher die Verbindungen, damit sie getrennt werden können, wenn der Tag entfernt wird
local connections = {}

local function onInstanceAdded(object)
	-- Bestätige, dass das Objekt mit diesem Tag ein BasePart ist
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Wenn es eine gespeicherte Verbindung für dieses Objekt gibt, trenne/entferne sie
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Höre auf, wenn dieser Tag auf Objekte angewendet wird
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Erkenne auch alle Objekte, die bereits den Tag haben
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Funktionen: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Parameter

tag:string

Rückgaben

RBXScriptSignal

Code-Beispiele

Tödliche Blöcke mit CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Speicher die Verbindungen, damit sie getrennt werden können, wenn der Tag entfernt wird
local connections = {}

local function onInstanceAdded(object)
	-- Bestätige, dass das Objekt mit diesem Tag ein BasePart ist
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Wenn es eine gespeicherte Verbindung für dieses Objekt gibt, trenne/entferne sie
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Höre auf, wenn dieser Tag auf Objekte angewendet wird
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Erkenne auch alle Objekte, die bereits den Tag haben
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Parallel schreiben

Funktionen: Basic

CollectionService:GetTagged(tag:string):Instances

Parameter

tag:string

Rückgaben

Instances

Code-Beispiele

Tödliche Blöcke mit CollectionService

local CollectionService = game:GetService("CollectionService")

local tag = "Deadly"

local function onDeadlyPartTouched(otherPart)
	if not otherPart.Parent then
		return
	end
	local humanoid = otherPart.Parent:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end

-- Speicher die Verbindungen, damit sie getrennt werden können, wenn der Tag entfernt wird
local connections = {}

local function onInstanceAdded(object)
	-- Bestätige, dass das Objekt mit diesem Tag ein BasePart ist
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Wenn es eine gespeicherte Verbindung für dieses Objekt gibt, trenne/entferne sie
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Höre auf, wenn dieser Tag auf Objekte angewendet wird
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Erkenne auch alle Objekte, die bereits den Tag haben
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Parallel schreiben

Funktionen: Basic

CollectionService:GetTags(instance:Instance):{any}

Parameter

instance:Instance

Rückgaben

{any}

Code-Beispiele

Verwendung von Tags und CollectionService

local CollectionService = game:GetService("CollectionService")
local Workspace = game:GetService("Workspace")

local object = Workspace.Part

-- Tag hinzufügen
CollectionService:AddTag(object, "Deadly")

-- Nach einem Tag abfragen
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " ist tödlich")
end

-- Tags eines Objekts auflisten
local tags = CollectionService:GetTags(object)
print("Das Objekt " .. object:GetFullName() .. " hat Tags: " .. table.concat(tags, ", "))

-- Tag entfernen
CollectionService:RemoveTag(object, "Deadly")

HasTag

Parallel schreiben

Funktionen: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Parameter

instance:Instance

tag:string

Rückgaben

boolean

Code-Beispiele

Verwendung von Tags und CollectionService

local CollectionService = game:GetService("CollectionService")
local Workspace = game:GetService("Workspace")

local object = Workspace.Part

-- Tag hinzufügen
CollectionService:AddTag(object, "Deadly")

-- Nach einem Tag abfragen
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " ist tödlich")
end

-- Tags eines Objekts auflisten
local tags = CollectionService:GetTags(object)
print("Das Objekt " .. object:GetFullName() .. " hat Tags: " .. table.concat(tags, ", "))

-- Tag entfernen
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

Funktionen: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Parameter

instance:Instance

tag:string

Rückgaben

()

Code-Beispiele

Verwendung von Tags und CollectionService

local CollectionService = game:GetService("CollectionService")
local Workspace = game:GetService("Workspace")

local object = Workspace.Part

-- Tag hinzufügen
CollectionService:AddTag(object, "Deadly")

-- Nach einem Tag abfragen
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " ist tödlich")
end

-- Tags eines Objekts auflisten
local tags = CollectionService:GetTags(object)
print("Das Objekt " .. object:GetFullName() .. " hat Tags: " .. table.concat(tags, ", "))

-- Tag entfernen
CollectionService:RemoveTag(object, "Deadly")