Aprenda
Tipo de dados do mecanismo
Collection

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Propriedades
Métodos
ForEach(callback: function)
Amostras de código
Ciclo de Vida e Eventos da Coleção
local CollectionService = game:GetService("CollectionService")
-- Uma coleção ativa de partes marcadas como "MapleLeaf" que são filhos diretos de um modelo marcado como "MapleTree"
local mapleLeaves: Collection = CollectionService:CreateCollection("Model.MapleTree > Part.MapleLeaf")
local function sway(leaf: Part, deltaTime: number)
leaf.CFrame *= CFrame.fromEulerAnglesXYZ(0, math.rad(20) * deltaTime, 0)
end
local function fall(leaf: Part)
leaf.Anchored = false
end
-- OnAdded é acionado uma vez para cada folha que já corresponde, e depois para cada nova correspondência
function mapleLeaves.OnAdded(leaf: Part)
leaf.Material = Enum.Material.Neon
end
-- OnRemoved é acionado quando uma folha para de corresponder (sem etiqueta, reparentada fora da árvore ou destruída)
function mapleLeaves.OnRemoved(leaf: Part)
leaf:Destroy()
end
-- Alias do RunService: Aciona uma vez por batimento cardíaco para cada folha na coleção
function mapleLeaves.OnHeartbeat(leaf: Part, deltaTime: number)
sway(leaf, deltaTime)
end
-- Wrapper de evento de instância: OnTouched envolve BasePart.Touched
-- Membros da coleção sem um evento Touched ignoram silenciosamente esta atribuição
function mapleLeaves.OnTouched(leaf: Part, other: BasePart)
fall(leaf)
end
-- Wrapper de mudança de propriedade: Reage quando uma folha fica marrom
function mapleLeaves.OnPropertyChanged.Color(leaf: Part)
if leaf.Color == Color3.fromRGB(124, 92, 70) then
fall(leaf)
end
end
-- Define imperativamente cada folha atualmente na coleção como verde
mapleLeaves:ForEach(function(leaf: Part)
leaf.Color = Color3.fromRGB(0, 255, 0)
end)

Referência API
Propriedades
Enabled
Collection.Enabled:boolean

Métodos
ForEach
Collection:ForEach(callback:function)
Parâmetros
callback:function

Destroy
Collection:Destroy()

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.