CollectionService | Dokumentasi - Pusat Kreator Roblox

Kelas Engine

CollectionService

Tidak Dapat Dibuat

Layanan

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Rangkuman

Metode

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

GetAllTags():{any}

GetCollection(class: string):Instances

Tidak digunakan lagi

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):()

Acara

ItemAdded(instance: Instance):RBXScriptSignal

Tidak digunakan lagi

ItemRemoved(instance: Instance):RBXScriptSignal

Tidak digunakan lagi

TagAdded(tag: string):RBXScriptSignal

TagRemoved(tag: string):RBXScriptSignal

Anggota yang Diwariskan

57 yang diwarisi dari Instance

6 yang diwarisi dari Object

Referensi API

Metode

AddTag

Kemampuan: Basic

CollectionService:AddTag(

instance:Instance, tag:string

):()

Parameter

instance:Instance

tag:string

Memberikan nilai

()

GetAllTags

Tulis Paralel

Kemampuan: Basic

CollectionService:GetAllTags():{any}

Memberikan nilai

{any}

GetCollection

Tidak digunakan lagi

GetInstanceAddedSignal

Kemampuan: Basic

CollectionService:GetInstanceAddedSignal(tag:string):RBXScriptSignal

Parameter

tag:string

Memberikan nilai

RBXScriptSignal

Contoh Kode

Blok Mematikan menggunakan 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

-- Simpan koneksi sehingga bisa diputus ketika tag dihapus
local connections = {}

local function onInstanceAdded(object)
	-- Konfirmasi bahwa objek dengan tag ini adalah BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jika ada koneksi yang disimpan pada objek ini, putuskan/hapus
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Dengarkan untuk tag ini diterapkan pada objek
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Juga deteksi objek yang sudah memiliki tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetInstanceRemovedSignal

Kemampuan: Basic

CollectionService:GetInstanceRemovedSignal(tag:string):RBXScriptSignal

Parameter

tag:string

Memberikan nilai

RBXScriptSignal

Contoh Kode

Blok Mematikan menggunakan 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

-- Simpan koneksi sehingga bisa diputus ketika tag dihapus
local connections = {}

local function onInstanceAdded(object)
	-- Konfirmasi bahwa objek dengan tag ini adalah BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jika ada koneksi yang disimpan pada objek ini, putuskan/hapus
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Dengarkan untuk tag ini diterapkan pada objek
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Juga deteksi objek yang sudah memiliki tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTagged

Tulis Paralel

Kemampuan: Basic

CollectionService:GetTagged(tag:string):Instances

Parameter

tag:string

Memberikan nilai

Instances

Contoh Kode

Blok Mematikan menggunakan 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

-- Simpan koneksi sehingga bisa diputus ketika tag dihapus
local connections = {}

local function onInstanceAdded(object)
	-- Konfirmasi bahwa objek dengan tag ini adalah BasePart
	if object:IsA("BasePart") then
		connections[object] = object.Touched:Connect(onDeadlyPartTouched)
	end
end

local function onInstanceRemoved(object)
	-- Jika ada koneksi yang disimpan pada objek ini, putuskan/hapus
	if connections[object] then
		connections[object]:Disconnect()
		connections[object] = nil
	end
end

-- Dengarkan untuk tag ini diterapkan pada objek
CollectionService:GetInstanceAddedSignal(tag):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(tag):Connect(onInstanceRemoved)

-- Juga deteksi objek yang sudah memiliki tag
for _, object in pairs(CollectionService:GetTagged(tag)) do
	onInstanceAdded(object)
end

GetTags

Tulis Paralel

Kemampuan: Basic

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

Parameter

instance:Instance

Memberikan nilai

{any}

Contoh Kode

Menggunakan Tag dan CollectionService

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

local object = Workspace.Part

-- Tambahkan sebuah tag
CollectionService:AddTag(object, "Deadly")

-- Tanyakan untuk sebuah tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " adalah mematikan")
end

-- Daftar tag pada sebuah objek
local tags = CollectionService:GetTags(object)
print("Objek " .. object:GetFullName() .. " memiliki tag: " .. table.concat(tags, ", "))

-- Hapus sebuah tag
CollectionService:RemoveTag(object, "Deadly")

HasTag

Tulis Paralel

Kemampuan: Basic

CollectionService:HasTag(

instance:Instance, tag:string

):boolean

Parameter

instance:Instance

tag:string

Memberikan nilai

boolean

Contoh Kode

Menggunakan Tag dan CollectionService

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

local object = Workspace.Part

-- Tambahkan sebuah tag
CollectionService:AddTag(object, "Deadly")

-- Tanyakan untuk sebuah tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " adalah mematikan")
end

-- Daftar tag pada sebuah objek
local tags = CollectionService:GetTags(object)
print("Objek " .. object:GetFullName() .. " memiliki tag: " .. table.concat(tags, ", "))

-- Hapus sebuah tag
CollectionService:RemoveTag(object, "Deadly")

RemoveTag

Kemampuan: Basic

CollectionService:RemoveTag(

instance:Instance, tag:string

):()

Parameter

instance:Instance

tag:string

Memberikan nilai

()

Contoh Kode

Menggunakan Tag dan CollectionService

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

local object = Workspace.Part

-- Tambahkan sebuah tag
CollectionService:AddTag(object, "Deadly")

-- Tanyakan untuk sebuah tag
if CollectionService:HasTag(object, "Deadly") then
	print(object:GetFullName() .. " adalah mematikan")
end

-- Daftar tag pada sebuah objek
local tags = CollectionService:GetTags(object)
print("Objek " .. object:GetFullName() .. " memiliki tag: " .. table.concat(tags, ", "))

-- Hapus sebuah tag
CollectionService:RemoveTag(object, "Deadly")