Impara
Classe motore
Instance
Non costruibile
Non Navigabile

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.


Sommario
Membri ereditati

Riferimento API
Proprietà
Archivable
Lettura Parallela
Instance.Archivable:boolean

archivable
Obsoleto

Capabilities
Lettura Parallela
Capacità: CapabilityControl
Instance.Capabilities:SecurityCapabilities

Name
Lettura Parallela
Instance.Name:string

Parent
Non Replicato
Lettura Parallela
Instance.Parent:Instance

PredictionMode
Sola Lettura
Non Replicato
Non programmabile
Lettura Parallela
Instance.PredictionMode:Enum.PredictionMode

RobloxLocked
Obsoleto

Sandboxed
Non Replicato
Lettura Parallela
Capacità: CapabilityControl
Instance.Sandboxed:boolean

UniqueId
Non Replicato
Sicurezza Script Roblox
Sicurezza Roblox
Lettura Parallela
Instance.UniqueId:UniqueId

Metodi
AddTag
Instance:AddTag(tag:string):()
Parametri
tag:string
Restituzioni
()

children
Obsoleto

ClearAllChildren
Instance:ClearAllChildren():()
Restituzioni
()

Clone
Capacità: CreateInstances
Accesso alla simulazione
Instance:Clone():Instance
Restituzioni
Campioni di codice
Clonazione di un'istanza
local Workspace = game:GetService("Workspace")
-- Ottieni un riferimento a un oggetto esistente
local model = script.Parent.Model
-- Crea un clone del modello
local clone = model:Clone()
-- Sposta il clone in modo che non si sovrapponga al modello originale
clone:PivotTo(model.PrimaryPart.CFrame - (Vector3.xAxis * 10))
-- Aggiungi il clone allo Workspace
clone.Parent = Workspace

clone
Obsoleto

Destroy
Instance:Destroy():()
Restituzioni
()
Campioni di codice
Istanza:Destroy()
local part = script.Parent.Part
part:Destroy()

destroy
Obsoleto

FindFirstAncestor
Scrivi Parallelo
Instance:FindFirstAncestor(name:string):Instance?
Parametri
name:string
Restituzioni

FindFirstAncestorOfClass
Scrivi Parallelo
Instance:FindFirstAncestorOfClass(className:string):Instance?
Parametri
className:string
Restituzioni

FindFirstAncestorWhichIsA
Scrivi Parallelo
Instance:FindFirstAncestorWhichIsA(className:string):Instance?
Parametri
className:string
Restituzioni

FindFirstChild
Scrivi Parallelo
Accesso alla simulazione
Instance:FindFirstChild(
name:string, recursive:boolean
Parametri
name:string
recursive:boolean
Valore predefinito: false
Restituzioni
Campioni di codice
Istanza:TrovaPrimoFiglio
local found = workspace:FindFirstChild("Brick")
if found then
found.Name = "Foo"
end

findFirstChild
Obsoleto

FindFirstChildOfClass
Scrivi Parallelo
Instance:FindFirstChildOfClass(className:string):Instance?
Parametri
className:string
Restituzioni
Campioni di codice
Istanza:TrovaPrimoFiglioDiClasse
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid
while not humanoid do
humanoid = character:FindFirstChildOfClass("Humanoid")
if not humanoid then
character.ChildAdded:Wait()
end
end

FindFirstChildWhichIsA
Scrivi Parallelo
Accesso alla simulazione
Instance:FindFirstChildWhichIsA(
className:string, recursive:boolean
Parametri
className:string
recursive:boolean
Valore predefinito: false
Restituzioni

FindFirstDescendant
Scrivi Parallelo
Instance:FindFirstDescendant(name:string):Instance?
Parametri
name:string
Restituzioni

GetActor
Scrivi Parallelo
Instance:GetActor():Actor?
Restituzioni

GetAttribute
Scrivi Parallelo
Accesso alla simulazione
Instance:GetAttribute(attribute:string):Variant
Parametri
attribute:string
Restituzioni
Variant

GetAttributeChangedSignal
Instance:GetAttributeChangedSignal(attribute:string):RBXScriptSignal
Parametri
attribute:string
Restituzioni

GetAttributes
Scrivi Parallelo
Accesso alla simulazione
Instance:GetAttributes():Dictionary
Restituzioni

GetChildren
Scrivi Parallelo
Accesso alla simulazione
Instance:GetChildren():Instances
Restituzioni
Instances
Campioni di codice
Instance:GetChildren
local children = workspace:GetChildren()
for i = 1, #children do
print(i, children[i].Name)
end

getChildren
Obsoleto

GetDebugId
Non Navigabile
Sicurezza Plugin
Instance:GetDebugId(scopeLength:number):string
Parametri
scopeLength:number
Valore predefinito: 4
Restituzioni
Campioni di codice
Instance:GetDebugId
print(workspace:GetDebugId()) --> 39FA_12
print(workspace:GetDebugId(10)) --> 39FA2FEF4D_12
print(workspace:GetDebugId(math.huge)) --> 12

GetDescendants
Scrivi Parallelo
Accesso alla simulazione
Instance:GetDescendants():Instances
Restituzioni
Instances
Campioni di codice
Istanza:GetDescendants
local descendants = workspace:GetDescendants()
-- Scorri attraverso tutti i discendenti dello spazio di lavoro. Se viene
-- trovata una BasePart, il codice cambia il colore di quella parte in verde
for _, descendant in pairs(descendants) do
if descendant:IsA("BasePart") then
descendant.BrickColor = BrickColor.Green()
end
end

GetFullName
Scrivi Parallelo
Accesso alla simulazione
Instance:GetFullName():string
Restituzioni
Campioni di codice
Istanza:GetFullName
-- Crea una gerarchia semplice
local model = Instance.new("Model")
local part = Instance.new("Part")
part.Parent = model
local fire = Instance.new("Fire")
fire.Parent = part
print(fire:GetFullName()) --> Model.Part.Fire
model.Parent = workspace
print(fire:GetFullName()) --> Workspace.Model.Part.Fire
part.Name = "Ciao, mondo"
print(fire:GetFullName()) --> Workspace.Model.Ciao, mondo.Fire
Implementazione Lua di Instance:GetFullName
local function getFullName(object)
local result = object.Name
object = object.Parent
while object and object ~= game do
-- Prepend parent name
result = object.Name .. "." .. result
-- Go up the hierarchy
object = object.Parent
end
return result
end
print(getFullName(workspace.Camera)) --> Workspace.Camera

GetStyled
Instance:GetStyled(
name:string, selector:string?
):Variant
Parametri
name:string
selector:string?
Restituzioni
Variant

GetStyledPropertyChangedSignal
Instance:GetStyledPropertyChangedSignal(property:string):RBXScriptSignal
Parametri
property:string
Restituzioni

GetTags
Scrivi Parallelo
Accesso alla simulazione
Instance:GetTags():{any}
Restituzioni

HasTag
Scrivi Parallelo
Accesso alla simulazione
Instance:HasTag(tag:string):boolean
Parametri
tag:string
Restituzioni

IsAncestorOf
Scrivi Parallelo
Accesso alla simulazione
Instance:IsAncestorOf(descendant:Instance):boolean
Parametri
descendant:Instance
Restituzioni
Campioni di codice
Instance:IsAncestorOf()
local Workspace = game:GetService("Workspace")
local spawnLocation = Workspace.SpawnLocation
local decal = spawnLocation.Decal
-- Queste affermazioni sono vere
print(Workspace:IsAncestorOf(spawnLocation))
print(Workspace:IsAncestorOf(decal))
print(spawnLocation:IsAncestorOf(decal))
-- Queste affermazioni sono false
print(spawnLocation:IsAncestorOf(Workspace))
print(decal:IsAncestorOf(Workspace))
print(decal:IsAncestorOf(spawnLocation))

IsDescendantOf
Scrivi Parallelo
Accesso alla simulazione
Instance:IsDescendantOf(ancestor:Instance):boolean
Parametri
ancestor:Instance
Restituzioni
Campioni di codice
Instance:IsDescendantOf
local part = Instance.new("Part")
print(part:IsDescendantOf(game))
--> falso
part.Parent = workspace
print(part:IsDescendantOf(game))
--> vero
part.Parent = game
print(part:IsDescendantOf(game))
--> vero

isDescendantOf
Obsoleto

IsPropertyModified
Accesso alla simulazione
Instance:IsPropertyModified(property:string):boolean
Parametri
property:string
Restituzioni

QueryDescendants
Accesso alla simulazione
Instance:QueryDescendants(selector:string):Instances
Parametri
selector:string
Restituzioni
Instances

Remove
Obsoleto

remove
Obsoleto

RemoveTag
Instance:RemoveTag(tag:string):()
Parametri
tag:string
Restituzioni
()

ResetPropertyToDefault
Instance:ResetPropertyToDefault(property:string):()
Parametri
property:string
Restituzioni
()

SetAttribute
Accesso alla simulazione
Instance:SetAttribute(
attribute:string, value:Variant
):()
Parametri
attribute:string
value:Variant
Restituzioni
()

WaitForChild
Può Rendere
Instance:WaitForChild(
childName:string, timeOut:number
Parametri
childName:string
timeOut:number
Restituzioni
Campioni di codice
Istanza:AspettaPerFiglio
local part = workspace:WaitForChild("Part")
print(part.Name .. " è stata aggiunta a Workspace")

Eventi
AncestryChanged
Instance.AncestryChanged(
child:Instance, parent:Instance
Parametri
child:Instance
parent:Instance
Campioni di codice
Instance.AncestryChanged
local Workspace = game:GetService("Workspace")
local redPart = script.Parent.RedPart
local bluePart = script.Parent.BluePart
local changingPart = script.Parent.ChangingPart
-- Cambia il colore di changingPart in base al suo Parent
local function onAncestryChanged(part: Part, parent: Instance)
if parent == redPart then
changingPart.Color = Color3.new(1, 0, 0)
elseif parent == bluePart then
changingPart.Color = Color3.new(0, 0, 1)
else
changingPart.Color = Color3.new(1, 1, 1)
end
print(`{part.Name} è ora genitore di {parent.Name}`)
end
changingPart.AncestryChanged:Connect(onAncestryChanged)
-- Imposta la proprietà Parent di changingPart su diverse istanze nel tempo
while true do
task.wait(2)
changingPart.Parent = redPart
task.wait(2)
changingPart.Parent = bluePart
task.wait(2)
changingPart.Parent = Workspace
end

AttributeChanged
Instance.AttributeChanged(attribute:string):RBXScriptSignal
Parametri
attribute:string

ChildAdded
Instance.ChildAdded(child:Instance):RBXScriptSignal
Parametri
child:Instance
Campioni di codice
Instance.ChildAdded
local function onChildAdded(instance)
print(instance.Name .. " aggiunto allo spazio di lavoro")
end
workspace.ChildAdded:Connect(onChildAdded)
local part = Instance.new("Part")
part.Parent = workspace --> Parte aggiunta allo Spazio di lavoro

childAdded
Obsoleto

ChildRemoved
Instance.ChildRemoved(child:Instance):RBXScriptSignal
Parametri
child:Instance
Campioni di codice
Istanza.ChildRemoved
local function onChildRemoved(instance)
print(instance.Name .. " rimosso dal workspace")
end
workspace.ChildRemoved:Connect(onChildRemoved)
local part = Instance.new("Part")
part.Parent = workspace
task.wait(2)
part:Destroy()

DescendantAdded
Instance.DescendantAdded(descendant:Instance):RBXScriptSignal
Parametri
descendant:Instance
Campioni di codice
Instance.DescendantAdded
local function onDescendantAdded(descendant)
print(descendant)
end
workspace.DescendantAdded:Connect(onDescendantAdded)
local part = Instance.new("Part")
part.Parent = workspace

DescendantRemoving
Instance.DescendantRemoving(descendant:Instance):RBXScriptSignal
Parametri
descendant:Instance
Campioni di codice
Instance.DescendantRemoving
workspace.DescendantRemoving:Connect(function(descendant)
print(descendant.Name .. " è attualmente genitore di " .. tostring(descendant.Parent))
end)
local part = Instance.new("Part")
part.Parent = workspace
part.Parent = nil
--> La parte è attualmente genitore di Workspace
print(part.Parent)
--> nil

Destroying
Instance.Destroying():RBXScriptSignal
Campioni di codice
Utilizzo dell'evento di distruzione (segnali immediati)
local part = Instance.new("Part", workspace)
local function onPartDestroying()
print("Prima di aspettare:", part:GetFullName(), #part:GetChildren())
task.wait()
print("Dopo aver aspettato:", part:GetFullName(), #part:GetChildren())
end
part.Destroying:Connect(onPartDestroying)
part:Destroy()
Utilizzo dell'evento Destroying (segnali differiti)
local part = Instance.new("Part", workspace)
local function onPartDestroying()
print("Nel segnale:", part:GetFullName(), #part:GetChildren())
end
part.Destroying:Connect(onPartDestroying)
print("Prima di distruggere:", part:GetFullName(), #part:GetChildren())
part:Destroy()
print("Dopo aver distrutto:", part:GetFullName(), #part:GetChildren())

StyledPropertiesChanged
Instance.StyledPropertiesChanged():RBXScriptSignal

© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.