Eine `Class.Actor` ist ein Container für Code, der sicher in seinen eigenen
Thread unter Verwendung von `Library.task.desynchronize()` aufgeteilt werden kann. Sie sollte auch die
Instanzen enthalten, die von ihren Skripten verwendet werden.

Um mehr über die Verwendung mehrerer Schauspieler zur Optimierung der Skriptleistung zu erfahren, siehe
[Parallel Luau](/scripting/multithreading).

#### Hinweise

- Jeder `Actor` läuft in seiner eigenen Luau-VM. `Class.ModuleScript|ModuleScripts`
  die von einem `Actor` benötigt werden, werden **nicht** zwischen `Actors` oder mit
  dem Haupt-Thread geteilt oder zwischengespeichert. Jede VM führt ihre eigene Kopie des Moduls aus, sodass
  der Status auf Modulebene pro `Actor` isoliert ist. Entsprechend gestalten, wenn Ihre
  Module Zustand halten, den Sie teilen möchten.
- `script:GetActor()` gibt `nil` zurück, wenn es von einem `Class.ModuleScript`
  aufgerufen wird, es sei denn, das `ModuleScript` ist ein Nachkomme des `Actor`. `ModuleScripts`
  die an anderer Stelle gespeichert sind (zum Beispiel `Class.ReplicatedStorage`) und von einem
  `Actor` benötigt werden, gelten nicht als Nachkommen des `Actor`.


Diese Methode wird verwendet, um einen Luau-Callback an eine Nachricht mit dem
angegebenen Thema zu binden. Wenn eine Nachricht (unter Verwendung von
`Class.Actor:SendMessage()|SendMessage()`) an das angegebene Thema gesendet wird, wird der
bereitgestellte Callback in einem _seriellen_ Ausführungskontext aufgerufen.

Mehrere Luau-Callbacks können an einen einzelnen Actor und sogar an ein
einzelnes Nachrichtenthema gebunden werden.

Hinweis: Nur die Skripte, die Nachkommen eines Actors sind, dürfen an seinen
Nachrichten binden.

```lua
local actor = script:GetActor()

-- Geben Sie eine Nachricht aus, wenn eine Begrüßungsnachricht an den Actor
-- gesendet wird, von dem dieses Skript ein Nachkomme ist.
local connection = actor:BindToMessage("Greeting", function(message)
  print("Begrüßungsnachricht empfangen:", message)
end)
```

Actor:BindToMessage

topic

Das Thema, das verwendet wird, um die Art der Nachricht zu identifizieren.

function

Dieses Verbindungsobjekt kann verwendet werden, um den Luau-Callback
vom Empfang von Nachrichten zu trennen.

Bindet einen Luau-Callback an eine Nachricht mit dem angegebenen Thema.

Diese Methode wird verwendet, um einen Luau-Callback an eine Nachricht mit dem
angegebenen Thema zu binden. Wenn eine Nachricht gesendet wird (unter Verwendung von
`Class.Actor:SendMessage()|SendMessage()`) an das angegebene Thema, wird der
bereitgestellte Callback in einem _parallelen_ Ausführungskontext aufgerufen.

Mehrere Luau-Callbacks können an einen einzelnen Actor und sogar an ein
einzelnes Nachrichtenthema gebunden werden.

Hinweis: Nur die Skripte, die Nachkommen eines Actors sind, dürfen an seinen
Nachrichten binden.

```lua
local actor = script:GetActor()

-- Geben Sie eine Nachricht aus, wenn eine Begrüßungsnachricht an den Actor
-- gesendet wird, von dem dieses Skript ein Nachkomme ist.
local connection = actor:BindToMessageParallel("Greeting", function(message)
  print("Begrüßungsnachricht empfangen:", message)
end)
```

Actor:BindToMessageParallel

Sendet eine Nachricht an einen Actor. Nachrichten werden asynchron gesendet, sodass der
Absender beim Aufruf der
`Class.Actor:SendMessage()|SendMessage()`-Methode nicht blockiert oder das 
Yielding aussetzt.

Da ein einzelner Actor verschiedene Arten von Nachrichten empfangen kann, wird ein `topic`
Parameter verwendet, um zwischen den verschiedenen Arten von Nachrichten zu unterscheiden.

Siehe `Class.Actor:BindToMessage()|BindToMessage()` für Details zum Empfangen
einer Nachricht, die mit `Class.Actor:SendMessage()|SendMessage()` gesendet wurde.

Beachten Sie, dass Nachricht argumente **per Kopie** über die Luau-VM-Grenzen
übergeben werden, nicht per Referenz. Das Senden großer Tabellen verursacht bei
jedem Aufruf eine vollständige Kopie. Funktionen sind an eine bestimmte VM gebunden und können nicht in
Nachrichten übergeben werden.

```lua
-- Angenommen, `actor` ist eine lokale Variable, die auf eine Actor-Instanz verweist
actor:SendMessage("Greeting", "Hello World")
```


Actor:SendMessage

Das Thema, das verwendet wird, um die gesendete Nachricht zu identifizieren.

message

Der Inhalt der Nachricht, die an den Actor gesendet werden soll.

Actor

Ein `Class.Actor` ist ein Container für Code, der sicher in seinen eigenen
Thread aufgeteilt werden kann.

Das folgende Beispiel enthält eine grundlegende Funktion, die eine Tabelle von Objekten
entgegennimmt und sie in ein neues Modell einfügt, wobei dieses Modell zurückgegeben wird.

Modelle sind Containerobjekte, was bedeutet, dass sie Objekte zusammenfassen. Sie sind
am besten geeignet, um Sammlungen von `Class.BasePart|BaseParts` zu halten und verfügen über eine Reihe
von Funktionen, die ihre Funktionalität erweitern.

Modelle sollen **geometrische** Gruppierungen darstellen. Wenn Ihre Gruppierung keine geometrische
Interpretation hat, zum Beispiel eine Sammlung von `Class.Script|Scripts`, verwenden Sie stattdessen einen
`Class.Folder`.

Modelle, deren Bestandteile durch Gelenke verbunden sind (sodass sie sich bewegen oder durch
Physiksimulation zerstört werden können), haben normalerweise eine `Class.Model.PrimaryPart|PrimaryPart`
festgelegt, da dies angibt, welches Teil innerhalb des Modells der Pivot und die
Umrandungsbox während der Bewegung des Modells "folgen" wird. Statische
Modelle, die an einem Ort bleiben, profitieren nicht von der Festlegung eines primären Teils.

Modelle haben eine Vielzahl von Anwendungen, einschließlich Roblox-Spielercharaktere.
Sie haben auch eine Reihe von einzigartigen Verhaltensweisen, die wichtig sind zu beachten:

- Wenn ein `Class.Humanoid` und ein `Class.Part` mit dem Namen **Head** unter
  einem Modell übergeordnet sind, wird eine Name/Gesundheits-GUI über dem Modell angezeigt; siehe
  [Charaktername/Gesundheitsanzeige](/characters/name-health-display)
  für Einzelheiten.
- Wenn die Position eines Teils auf der **Y**-Achse den Wert von
  `Class.Workspace.FallenPartsDestroyHeight` erreicht und es das letzte Objekt
  innerhalb eines `Class.Model` war, wird das Modell ebenfalls zerstört.
- Wenn es an einem Ort mit `Class.Workspace.StreamingEnabled` verwendet wird,
  kontrolliert der Wert von `Class.Model.ModelStreamingMode|ModelStreamingMode`
  verschiedene Verhaltensweisen hinsichtlich der Replikation und/oder der Entfernung des Modells
  und aller Nachkommen von Clients. Darüber hinaus beeinflusst der Wert von
  `Class.Model.LevelOfDetail|LevelOfDetail` die Darstellung des Modells.

Wie bei allen `Class.Instance`-Typen garantiert die Tatsache, dass ein übergeordnetes `Class.Model`
zu einem Client repliziert wird, nicht, dass alle seine Kinder ebenfalls repliziert werden.
Dies ist besonders wichtig, wenn auf diese Instanzen von Code zugegriffen wird, der auf dem Client
ausgeführt wird, wie in einem `Class.LocalScript`.
Die Verwendung von `Class.Model.ModelStreamingMode|ModelStreamingMode` mit Werten wie
`Enum.ModelStreamingMode|Atomic` kann sicherstellen, dass das gesamte Modell und alle
seiner Nachkommen vorhanden sind, wenn das übergeordnete Modell auf dem Client existiert, oder Sie
können `Class.Instance:WaitForChild()|WaitForChild()` verwenden, wenn Atomizität nicht gewünscht ist.

Setzt dieses Modell für den angegebenen Spieler persistent. Persistente
Modelle bleiben für den Spieler vorhanden, unabhängig von Streaming-Einstellungen oder
bedingungen.

`Class.Model.ModelStreamingMode|ModelStreamingMode` muss auf
`Enum.ModelStreamingMode|PersistentPerPlayer` eingestellt sein,
um jede Verhaltensänderung als Folge der Hinzufügung zu bewirken.

Model:AddPersistentPlayer

playerInstance

Der `Class.Player`, für den dieses Modell persistent gemacht werden soll.

Setzt dieses Modell für den angegebenen Spieler persistent.
`Class.Model.ModelStreamingMode|ModelStreamingMode` muss auf
`Enum.ModelStreamingMode|PersistentPerPlayer` eingestellt sein,
um Verhaltensänderungen als Folge der Hinzufügung zu bewirken.

In diesem Beispiel werden die Gelenke in jedem hinzugefügten Spielercharaktermodell
3 Sekunden nach dem Spawn gebrochen. Das Brechen dieser Gelenke führt dazu, dass der Humanoid
tot ist.

Dieses Codebeispiel demonstriert die manuelle Erstellung von Gelenken auf zwei Teilen, die
Geschwister des Skripts sind (PartA und PartB). Es erstellt Gelenke auf zwei berührenden
Teilen mit kompatiblen Oberflächentypen (Stifte und Einlass).

Bricht Verbindungen zwischen `BaseParts`, einschließlich Oberflächenverbindungen mit
irgendwelchen benachbarten Teilen, `Class.WeldConstraint|WeldConstraints` und allen
`Class.Weld|Welds` und anderen `Class.JointInstance|JointInstances`.

Wenn BreakJoints bei einem Spielercharakter `Class.Model` verwendet wird, wird
`Class.Humanoid` des Charakters sterben, da es auf dem Nacken-Gelenk basiert.

Beachten Sie, dass, obwohl Gelenke, die durch Oberflächenverbindungen mit benachbarten
Teilen erzeugt werden, technisch mit `Class.Model:MakeJoints()` wiederhergestellt werden können,
werden nur Gelenke wiederhergestellt, die durch Oberflächen erzeugt werden. Entwickler sollten
sich darauf nicht verlassen, da nach dem Brechen der Gelenke die Teile möglicherweise nicht
mehr miteinander in Kontakt stehen.

Model:BreakJoints

Bricht Verbindungen zwischen `BaseParts`, einschließlich Oberflächenverbindungen mit
irgendwelchen benachbarten Teilen, `Class.WeldConstraint|WeldConstraints` und allen
`Class.Weld|Welds` und anderen `Class.JointInstance|JointInstances`.

Model:breakJoints

Diese Funktion gibt eine Beschreibung eines Volumens zurück, das alle
`Class.BasePart`-Kinder innerhalb eines `Class.Model` enthält. Die Orientierung des Volumens
beruht auf der Orientierung des `Class.Model.PrimaryPart|PrimaryPart` und entspricht dem
Auswahlfeld, das im Studio gerendert wird, wenn das Modell ausgewählt ist. In Übereinstimmung mit dem Verhalten von
`Class.Terrain:FillBlock()` gibt es ein `Datatype.CFrame`, das das Zentrum dieser Umrandungsbox
repräsentiert, und ein `Datatype.Vector3`, das dessen Größe darstellt. Die Größe kann zur Laufzeit
ungenau sein, wenn physikalische Einschränkungen auf die Teile innerhalb des `Class.Model`
wirken.

Die Orientierung der Umrandungsbox entspricht der Orientierung des
`Class.PVInstance.GetPivot|Pivot` - entweder dem Pivot des
`Class.Model.PrimaryPart|PrimaryPart` (falls vorhanden) oder dem
`Class.Model.WorldPivot|WorldPivot` des Modells.

```lua
local Workspace = game:GetService("Workspace")

local model = Workspace.Model
local part = Workspace.Part
local orientation, size = model:GetBoundingBox()

-- Größe und Position des Teils gleich der Umrandungsbox des Modells anpassen
part.Size = size
part.CFrame = orientation
```

Model:GetBoundingBox

Ein `Datatype.CFrame`, das die Orientierung des Volumens darstellt,
gefolgt von einem `Datatype.Vector3`, das die Größe des Volumens darstellt.

Gibt eine Beschreibung eines Volumens zurück, das alle Teile eines Modells enthält.

Das folgende Codebeispiel zeigt, wie Model.GetExtentsSize verwendet werden kann, um
die Größe des Begrenzungsrahmens zu erhalten, der die Teile enthält.

Gibt die Größe der kleinsten Umrandungsbox zurück, die alle
`Class.BasePart|BaseParts` im `Class.Model` enthält. Die Orientierung entspricht
der Orientierung des `Class.PVInstance.GetPivot|Pivot` - entweder dem
Pivot des `Class.Model.PrimaryPart|PrimaryPart` (falls vorhanden) oder dem
`Class.Model.WorldPivot|WorldPivot` des Modells.

Beachten Sie, dass diese Funktion nur die Größe der kleinsten Umrandungsbox zurückgibt, und
dass der Entwickler seine eigene Methode verwenden muss, um die Position der
Umrandungsbox zu ermitteln.

Model:GetExtentsSize

Die Größe der `Datatype.Vector3`-Extents des `Class.Model`.

Gibt die Größe der kleinsten Umrandungsbox zurück, die alle
`Class.BasePart|BaseParts` im `Class.Model` enthält, ausgerichtet mit der
`Class.Model.PrimaryPart`, sofern festgelegt.

Dieser Wert gab historisch das CFrame einer zentralen Position im
Modell zurück.

Model:GetModelCFrame

Dieser Code würde ein Modell erstellen, einige Teile hineinlegen, sie zufällig positionieren,
und dann die Größe ausgeben:


Die GetModelSize-Funktion gibt die `Datatype.Vector3`-Größe des
`Class.Model` zurück.

Model:GetModelSize

Gibt die Vector3-Größe des Modells zurück.

Wenn diese Methode von einem `Class.Script` aufgerufen wird, gibt sie alle
`Class.Player`-Objekte zurück, für die dieses Modell persistent ist. Wenn sie von
einem `Class.LocalScript` aufgerufen wird, prüft diese Methode nur, ob dieses Modell
persistent für den `Class.Players.LocalPlayer|LocalPlayer` ist.

Model:GetPersistentPlayers

Eine Tabelle mit allen `Class.Player`-Objekten, für die dieses Modell-Objekt
persistent ist.

Gibt alle `Class.Player`-Objekte zurück, für die dieses Modell-Objekt
persistent ist. Das Verhalten variiert je nachdem, ob diese Methode von einem
`Class.Script` oder einem `Class.LocalScript` aufgerufen wird.

Der folgende Code demonstriert, wie GetPrimaryPartCFrame und
SetPrimaryPartCFrame verwendet werden können, um ein Modell zu drehen.

Ein einfaches Modell wird im Workspace erstellt und eine Schleife wird gestartet, die das Modell
alle 0,2 Sekunden um 10 Grad um die Y-Achse dreht.

Diese Funktion wurde durch `Class.PVInstance:GetPivot()` ersetzt, die
als Ersatz dient und das Verhalten Ihres Codes nicht ändert. Verwenden Sie
`Class.PVInstance:GetPivot()` für neue Arbeiten und migrieren Sie Ihre vorhandenen
`Class.Model:GetPrimaryPartCFrame()`-Aufrufe, wenn es Ihnen passt.

Gibt das `Datatype.CFrame` des `Class.Model.PrimaryPart` des Modells zurück.

Diese Funktion ist äquivalent zu:

    Model.PrimaryPart.CFrame

Beachten Sie, dass diese Funktion einen Fehler auslöst, wenn kein primärer Teil für das
`Class.Model` vorhanden ist. Dieses Verhalten kann Probleme verursachen, wenn z. B.
der primäre Teil niemals festgelegt wurde oder zerstört wurde.

Model:GetPrimaryPartCFrame

Gibt das `Datatype.CFrame` des `Class.Model.PrimaryPart` des Modells zurück.
Diese Funktion wirft einen Fehler, wenn kein primärer Teil für das
`Class.Model` vorhanden ist.

Dieses Codebeispiel demonstriert, wie man einen Ersatz für alle Kopien
 eines Baummodells mit `Class.Model:PivotTo()` und `Class.Model:ScaleTo()` einspringt. Der
Pivot und die Größe der Modelle werden als Referenz verwendet, um sicherzustellen, dass die
relativen Größen und Positionen der Ersatzmodelle mit denen der
Originale übereinstimmen.


Modelle enthalten einen persistierenden kanonischen Skalierungsfaktor, der für neu
erstellte Modelle bei 1 beginnt und sich ändert, während das Modell durch
Aufrufen von `Class.Model:ScaleTo()` skaliert wird. Diese Funktion gibt den aktuellen
kanonischen Skalierungsfaktor des Modells zurück.

Der aktuelle Skalierungsfaktor wirkt sich _direkt_ nicht auf die Größe von Instanzen
unter dem Modell aus. Er wird für die Inhaltserstellung und Skriptingzwecke verwendet,
um zu speichern, wie das Modell relativ zu seiner ursprünglichen Größe skaliert wurde.

Innerhalb einer bestimmten Sitzung speichert das Modell die präzisen Informationen der ursprünglichen
Größe der Nachkomme-Instanzen nach dem ersten Aufruf von
`Class.Model:ScaleTo()`. Das bedeutet, dass das Aufrufen von
`Class.Model:ScaleTo()|ScaleTo(x)` gefolgt von
`Class.Model:ScaleTo()|ScaleTo(1)` Sie _genau_ zur ursprünglichen Konfiguration des Modells
mit keinem Gleitfehler zurückbringt. Das Vermeiden von Gleitfehler ist der Grund, warum
es eine Scale**To**-Funktion und keine Scale**By**-Funktion gibt.

Der Skalierungsfaktor beeinflusst das Verhalten der Engine in einem Punkt:
Der Skalierungsfaktor eines Modells wird auf Gelenkversätze von `Class.Animation|Animations`
angewendet, die auf einem `Class.AnimationController` unter diesem Modell abgespielt werden,
so dass animierte Rigs Animationen korrekt wiedergeben, selbst wenn sie skaliert sind.

Model:GetScale

Der aktuelle kanonische Skalierungsfaktor des Modells.

Gibt die kanonische Skalierung des Modells zurück, die standardmäßig für neu
erstellte Modelle 1 beträgt und sich ändert, während es über
`Class.Model:ScaleTo()` skaliert wird.

Dieses Codebeispiel zeigt, wie Verbindungen mit der
Model:MakeJoints-Funktion erstellt werden können.

Ein Modell wird instanziiert, mit zwei Teilen übereinander. Der obere Teil ist
verankert und der untere Teil nicht. Normalerweise würde der untere Teil, wenn er im Workspace verankert ist,
auf die Basisplatte fallen.

Da die TopSurface-Eigenschaft des unteren Teils auf
Enum.SurfaceType.Weld gesetzt ist, bedeutet dies, dass bei der Ausführung von Model:MakeJoints eine
Verbindung zwischen ihnen hergestellt wird.

Daher fällt der untere Teil nicht, bis die Verbindungen im Modell
gebrochen werden. Dies geschieht oft mit Model:BreakJoints, aber in diesem Beispiel wird die
Verbindung mit einer Explosion zerbrochen.

Dieses Codebeispiel demonstriert die Erstellung von Gelenken an zwei Teilen, die
Geschwister des Skripts sind (PartA und PartB). Es verwendet MakeJoints auf zwei berührenden
Teilen mit kompakten Oberflächentypen (Studs und Inlet).

Das Zusammenfügen basierend auf SurfaceType ist veraltet. Verwenden Sie nicht MakeJoints für neue
Projekte. Verwenden Sie stattdessen `Class.WeldConstraint|WeldConstraints` und
`Class.HingeConstraint|HingeConstraints`.

Durchläuft alle `Class.BasePart|Parts` im `Class.Model` und erstellt
Gelenke zwischen den angegebenen Teilen und allen planaren Berührungsoberflächen,
abhängig von den Oberflächen der Teile.

- Glatte Oberflächen erstellen keine Gelenke
- Klebeoberflächen erstellen ein `Class.Glue`-Gelenk
- Schweißen erstellt ein `Class.Weld`-Gelenk mit jeder Oberfläche außer
  Unjoinable
- Noppen, Einlass oder Universal erzeugen jeweils ein `Class.Snap`-Gelenk mit
  den anderen beiden Oberflächen (z. B. Noppen mit Einlass und
  Universal)
- Hinge- und Motoroberflächen erstellen `Class.Rotate`- und `Class.RotateV`-Gelenkinstanzen

Diese Funktion funktioniert nicht, wenn das Teil nicht ein Nachkomme von
`Class.Workspace` ist. Daher müssen Sie zunächst sicherstellen, dass das Modell auf dem
Workspace verankert ist, bevor Sie MakeJoints verwenden.

Model:MakeJoints

Durchläuft alle `Class.BasePart|BaseParts` im `Class.Model`. Wenn eine Seite eines Teils eine SurfaceType hat, die ein Gelenk erstellen kann,
wird ein Gelenk mit irgendwelchen benachbarten Teilen erstellt.

Model:makeJoints

Model:move

location

Dieses Beispiel zeigt, wie `Class.Model:MoveTo()` Kollisionen vermeidet.

Ein einfaches zwei-teiliges `Class.Model` wird erstellt, und sein `Class.Model.PrimaryPart`
wird festgelegt. Ein großes Hindernis wird daneben platziert.

Nach 5 Sekunden wird `Class.Model:MoveTo()` verwendet, um das Modell zu bewegen
innerhalb des Hindernisses. Da MoveTo jedoch ein Modell nicht in ein
Hindernis bewegen kann, wird das `Class.Model` auf der Y-Achse nach oben verschoben und über
das Hindernis platziert.


Bewegt das `Class.Model.PrimaryPart|PrimaryPart` an die angegebene Position. Wenn
kein primärer Teil angegeben wurde, wird der Wurzelteil des Modells verwendet, aber der Wurzelteil
ist nicht deterministisch und es wird empfohlen, immer einen primären Teil festzulegen, wenn Sie
`Class.Model:MoveTo()|MoveTo()` verwenden.

Wenn es irgendwelche Hindernisse gibt, wo das Modell bewegt werden soll, wie `Class.Terrain`
oder andere `Class.BasePart|BaseParts`, wird das Modell vertikal nach oben bewegt, bis
es keine Hindernisse mehr gibt. Wenn dieses Verhalten nicht gewünscht ist, sollte stattdessen
`Class.PVInstance:PivotTo()` verwendet werden.

Beachten Sie, dass die Drehung beim Bewegen eines Modells mit
`Class.Model:MoveTo()|MoveTo()` nicht beibehalten wird. Es wird empfohlen, entweder
`Class.Model:TranslateBy()|TranslateBy()` oder `Class.PVInstance:PivotTo()` zu verwenden,
wenn die aktuelle Drehung des Modells beibehalten werden muss.

Model:MoveTo

position

Der `Datatype.Vector3`, auf den das `Class.Model` bewegt wird.

Bewegt das `Class.Model.PrimaryPart|PrimaryPart` an die angegebene Position. Wenn
kein primärer Teil angegeben wurde, wird der Wurzelteil des Modells verwendet.

Model:moveTo

Macht dieses Modell für den angegebenen Spieler nicht mehr persistent. Dies garantiert nicht,
dass das Modell sofort für den Spieler entfernt wird; nach dem Aufrufen dieser Methode wird das
Modell als `Enum.ModelStreamingMode|Atomic` für diesen Spieler behandelt und bleibt vorhanden,
während es sich innerhalb des Ziel-Streaming-Radius befindet.

`Class.Model.ModelStreamingMode|ModelStreamingMode` muss auf
`Enum.ModelStreamingMode|PersistentPerPlayer` eingestellt sein,
um Verhaltensänderungen als Folge der Entfernung zu bewirken.

Model:RemovePersistentPlayer

Der `Class.Player`, für den dieses Modell nicht mehr persistent gemacht werden soll.

Macht dieses Modell für den angegebenen Spieler nicht mehr persistent.
`Class.Model.ModelStreamingMode|ModelStreamingMode` muss auf
`Enum.ModelStreamingMode|PersistentPerPlayer` eingestellt sein,
um Verhaltensänderungen als Folge der Entfernung zu bewirken.

Setzt die Drehung der Teile des Modells auf die zuvor festgelegte Identitätsdrehung,
was über die Methode `Class.Model:SetIdentityOrientation()` erfolgt.

Model:ResetOrientationToIdentity

Modelle enthalten einen persistierenden kanonischen Skalierungsfaktor, der für neu
erstellte Modelle bei 1 beginnt. Diese Funktion skaliert das Modell um den Pivot-Standort,
relativ dazu, wie es bei einem Skalierungsfaktor von 1 aussehen würde. Um dies zu erreichen,
tut es zwei Dinge:

- Setzt den aktuellen Skalierungsfaktor des Modells auf den angegebenen Wert
- Ändert die Größe und die Position aller Nachkommen-Instanzen entsprechend

Die Skalierung der Standorte erfolgt um den Pivot-Standort herum.

Alle "geometrischen" Eigenschaften von Nachkommen-Instanzen werden skaliert. Das
umfasst offensichtlich die Größen von Teilen, aber hier sind einige andere Beispiele für
Eigenschaften, die skaliert werden:

- Die Länge von Gelenken wie `Class.WeldConstraint|WeldConstraints` und
  `Class.RopeConstraint`
- Physikalische Geschwindigkeiten und Kräfte wie `Class.HingeConstraint`
- Visuelle Eigenschaften wie Größen von Partikelemittern
- Andere Längen-Eigenschaften wie `Class.Sound.RollOffMinDistance`

Model:ScaleTo

newScaleFactor

Setzt den Skalierungsfaktor des Modells, passt die Größe und den Standort aller
Nachkommen-Instanzen so an, dass sie diesen Skalierungsfaktor relativ zu ihren
ursprünglichen Größen und Standorten haben, wenn der Skalierungsfaktor 1 war.

Setzt die Identitätsdrehung des angegebenen Modells, sodass Sie später die
Drehung des gesamten Modells über die Verwendung der Methode
`ResetOrientationToIdentity` zurücksetzen können.

Model:SetIdentityOrientation

Diese Funktion wurde durch `Class.PVInstance:PivotTo()` ersetzt, die
als leistungsfähigerer Ersatz dient und das Verhalten Ihres Codes nicht ändert. Verwenden Sie
`Class.PVInstance:PivotTo()` für neue Arbeiten und migrieren Sie Ihre vorhandenen
`Class.Model:SetPrimaryPartCFrame()`-Aufrufe, wenn es Ihnen passt.

Setzt das `Class.BasePart.CFrame` des primären Teils des Modells.
Alle anderen Teile im Modell werden ebenfalls bewegt und behalten ihre
Orientierung und Versatz in Bezug auf das `Class.Model.PrimaryPart`.

Beachten Sie, diese Funktion wirft einen Fehler, wenn kein `Class.Model.PrimaryPart`
für das Modell vorhanden ist. Dies kann Probleme verursachen, wenn z. B.
der primäre Teil nie festgelegt wurde oder zerstört wurde.

Model:SetPrimaryPartCFrame

cframe

Das `Datatype.CFrame`, das festgelegt werden soll.

Setzt das `Class.BasePart.CFrame` des primären Teils des Modells.
Alle anderen Teile im Modell werden ebenfalls bewegt und behalten ihre
Orientierung und Versatz in Bezug auf das `Class.Model.PrimaryPart`.

Dieses Beispiel zeigt, wie `Class.Model:TranslateBy()` Kollisionen ignoriert
und die Ausrichtung des Modells respektiert.

Ein einfaches zwei-teiliges `Class.Model` wird erstellt, um 45 Grad um die Y-Achse gedreht,
und sein `Class.Model.PrimaryPart` wird festgelegt. Ein großes Hindernis-Teil wird daneben platziert.

Nach 5 Sekunden wird `Class.Model:TranslateBy()` verwendet, um das Modell zu
lenken, damit es sich im Hindernis-Teil bewegt. Das Modell wird sich innerhalb des
Hindernisses bewegen und seine aktuelle Ausrichtung beibehalten.


Verschiebt ein `Class.Model` um den angegebenen `Datatype.Vector3`-Versatz und
bewahrt die Orientierung des Modells. Wenn ein weiteres `Class.BasePart` oder
`Class.Terrain` bereits an der neuen Position vorhanden ist, wird das
`Class.Model` mit diesem Objekt überlappen.

Die Verschiebung wird im Weltbereich und nicht im Objektbereich angewendet,
was bedeutet, dass sich das Modell auch dann entlang der Standardachse bewegt,
wenn die Teile des Modells unterschiedlich orientiert sind.

Model:TranslateBy

delta

Der `Datatype.Vector3`, um den das `Class.Model` verschoben wird.

Verschiebt ein `Class.Model` um den angegebenen `Datatype.Vector3`-Versatz und
bewahrt die Orientierung des Modells. Wenn ein weiteres `Class.BasePart` oder
`Class.Terrain` bereits an der neuen Position vorhanden ist, wird das
`Class.Model` mit diesem Objekt überlappen.

Model

Legt das Detailniveau des Modells für Erfahrungen mit aktivierter
[Streaming](/workspace/streaming) fest. Composite- oder
Imposter-Meshes unterstützen keine Physik, Kollisionserkennung oder
Raycasting.

Wenn auf `Enum.ModelLevelOfDetail|StreamingMesh` eingestellt, wird ein
Mesh mit niedrigerer Auflösung, das als "Imposter" bezeichnet wird (farbiges,
grobes Mesh, das alle Kindteile des Modells umschließt), außerhalb des
Streaming-Radius gerendert. Unterstützt keine Texturen.

Wenn auf `Enum.ModelLevelOfDetail|SLIM` eingestellt, wird ein **SLIM**
Modell (Skalierbares Leichtgewichtiges Interaktives Modell) gerendert,
eine Zusammenstellung aller Kindteile in progressiv niedrigeren
Auflösungen je nach Entfernung basierend auf dem Streaming-Radius.
Dies verbessert die visuelle Qualität erheblich im Vergleich zu
`Enum.ModelLevelOfDetail|StreamingMesh`.

Wenn auf `Enum.ModelLevelOfDetail|Disabled` oder
`Enum.ModelLevelOfDetail|Automatic` eingestellt, werden Meshes mit
niedrigerer Auflösung nicht angezeigt.


Model.LevelOfDetail

Legt die Detailstufe des Modells für Erlebnisse mit aktivem Instanz-Streaming fest.

Steuert, wie `Class.Model|Models` gestreamt werden, wenn das Instanz-
[Streaming](/workspace/streaming) aktiviert ist. Das Verhalten hängt von der
ausgewählten Enumeration ab. Hat keine Auswirkungen, wenn das Streaming nicht aktiviert ist.

Diese Eigenschaft sollte nur im Studio über das Fenster
[Eigenschaften](/studio/properties) geändert werden, wenn das Streaming aktiviert ist, oder in
`Class.Script|Scripts`, aber niemals in `Class.LocalScript|LocalScripts` (das kann zu undefiniertem
Verhalten führen).

Model.ModelStreamingMode

Steuert das Streaming-Verhalten von `Class.Model|Models`, wenn das Instanz-Streaming aktiviert ist.

Dieses Codesample erstellt ein Würfelmodell und wirft es, dann gibt es aus, ob es
mit der blauen Seite nach oben gelandet ist. Wenn `Class.Model.PrimaryPart` nicht gesetzt war,
würde sich der Pivot / die Begrenzungsbox des Würfels drehen, da die Teile darin
physikalisch simuliert werden während des Wurfs.

Verweist auf den primären Teil des `Class.Model`. Der primäre Teil ist der
`Class.BasePart`, der als physischer Bezug für den Pivot des Modells dient. Das bedeutet, dass sich der
Pivot mit dem primären Teil synchron bewegt, wenn Teile innerhalb des Modells aufgrund von physikalischer
Simulation oder anderen Gründen bewegt werden.

Beachten Sie, dass `Class.Model|Models` standardmäßig kein `PrimaryPart` festgelegt haben.
Wenn Sie ein Modell erstellen, das von der Physik beeinflusst werden muss, sollten Sie diese
Eigenschaft manuell im Studio oder innerhalb eines Skripts festlegen. Wenn der primäre Teil **nicht**
eingestellt ist, bleibt der Pivot an derselben Position im Weltbereich, selbst wenn Teile innerhalb des Modells
bewegt werden.

Beachten Sie auch, dass bei der Festlegung dieser Eigenschaft ein `Class.BasePart`
verwendet werden muss, das ein Nachkomme des Modells ist. Wenn Sie versuchen, den
`Class.Model.PrimaryPart` auf ein `Class.BasePart` festzulegen, das **nicht** ein
Nachkomme des Modells ist, wird er auf dieses Teil gesetzt, aber während des nächsten
Simulationsschrittes auf `nil` zurückgesetzt &mdash; dies ist ein veraltetes Verhalten, um
Skripte zu unterstützen, die davon ausgehen, dass sie den primären Teil vorübergehend auf ein
`Class.BasePart` setzen können, das kein Nachkomme des Modells ist.

Die allgemeine Regel für Modelle ist:

- Modelle, deren Teile durch physische Gelenke wie
  `Class.WeldConstraint|WeldConstraints` oder `Class.Motor6D|Motor6Ds`
  verbunden sind, sollten einen primären Teil zugewiesen bekommen. Zum Beispiel, Roblox-Charakter-
  modelle haben ihren `Class.Model.PrimaryPart` standardmäßig auf den
  **HumanoidRootPart** gesetzt.
- Statische (normalerweise `Class.BasePart.Anchored|Anchored`) Modelle, die an einem
  Ort bleiben, es sei denn, ein Skript bewegt sie ausdrücklich, benötigen kein
  `Class.Model.PrimaryPart` und profitieren meist nicht von der Festlegung eines.

Model.PrimaryPart

Der primäre Teil des `Class.Model`, oder `nil`, wenn nicht explizit festgelegt.

Das Festlegen dieser Eigenschaft im Eigenschaftenfenster skaliert das Modell, als
ob `Class.Model:ScaleTo()` aufgerufen würde, und skaliert alle Nachkommen
drinben, wie Materialien, Bilder und die 3D-Geometrie von Teilen, sodass das Modell den
angegebenen Skalierungsfaktor relativ zu seiner ursprünglichen Größe hat.

Diese Eigenschaft ist nur im Studio verfügbar und wirft einen Fehler, wenn sie
in einem `Class.Script` oder `Class.LocalScript` verwendet wird. `Class.Model:ScaleTo()` und
`Class.Model:GetScale()` sollten aus Skripten verwendet werden.

Model.Scale

Editor-exklusive Eigenschaft, die das Modell um seinen Pivot skaliert. Das Festlegen
    dieser Eigenschaft bewegt die Skala, als ob `Class.Model:ScaleTo()` aufgerufen
    würde.

Dieses Codebeispiel zeigt eine benutzerdefinierte Funktion zum Zurücksetzen des Pivots eines Modells
zurück zum Mittelpunkt des umgebenden Rechtecks dieses Modells.

Diese Eigenschaft bestimmt, wo sich der Pivot eines `Class.Model` befindet, wenn
kein `Class.Model.PrimaryPart` festgelegt ist. Wenn das `Class.Model`
**doch** einen `Class.Model.PrimaryPart|PrimaryPart` hat, ist der Pivot des
`Class.Model` gleich dem Pivot dieses primären Teils, und diese
`Class.Model.WorldPivot|WorldPivot`-Eigenschaft wird ignoriert.

Für ein neu erstelltes `Class.Model` wird sein Pivot als das Zentrum
der Umrandungsbox seiner Inhalte behandelt, bis zum **ersten Mal**, dass
seine `Class.Model.WorldPivot`-Eigenschaft festgelegt wird. Sobald der
Weltpivot für das erste Mal festgelegt wird, ist es unmöglich, dieses
ursprüngliche Verhalten wiederherzustellen.

Am häufigsten wird das Modell mit den Studio-Tools oder mit Modellbewegungsfunktionen wie
`Class.PVInstance:PivotTo()` und `Class.Model:MoveTo()` bewegt, was den Weltpivot festlegt und damit
dieses neue Modellverhalten beendet.

Der Zweck dieses Verhaltens ist es, Luau-Code zu ermöglichen, einen
sinnvollen Pivot zu erhalten, indem einfach ein neues Modell erstellt und Objekte daran
gegliedert werden, um zu vermeiden, dass `Class.Model.WorldPivot` jedes Mal explizit
festgelegt werden muss, wenn Sie ein Modell in Code erstellen.

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

local model = Instance.new("Model")
Workspace.BluePart.Parent = model
Workspace.RedPart.Parent = model
model.Parent = Workspace

print(model:GetPivot())  -- Momentan gleich dem Zentrum der Umrandungsbox, die "BluePart" und "RedPart" enthält

model:PivotTo(CFrame.new(0, 10, 0))  -- Das funktioniert, ohne "model.WorldPivot" explizit festzulegen
```

Model.WorldPivot

Bestimmt, wo sich der Pivot eines `Class.Model` befindet, wenn kein
festgelegter `Class.Model.PrimaryPart` vorhanden ist.

Modelle sind Containerobjekte, was bedeutet, dass sie Objekte zusammenfassen. Sie sind
am besten geeignet, um Sammlungen von `Class.BasePart|BaseParts` zu halten und verfügen über eine Reihe
von Funktionen, die ihre Funktionalität erweitern.

Eine `Class.PVInstance` ist eine abstrakte Klasse, die nicht erstellt werden kann. Sie ist die
Basis für alle Objekte, die einen physischen Standort in der Welt haben.


Dieses Codebeispiel ist ein einfaches Teleport-Skript, das deinen Charakter
10&nbsp;Studs in die Richtung bewegt, in die du gerade schaust, wenn du die
<kbd>F</kbd>-Taste drückst. Es geschieht, indem der aktuelle Pivot mit
`Class.PVInstance:GetPivot()` abgerufen und `PVInstance|PivotTo` aufgerufen wird, um
das
Charakter vorwärts zu bewegen.

Diese Funktion erhält den Pivot einer `Class.PVInstance`. Dies wird oft
mit `Class.PVInstance:PivotTo()` verwendet, um ein Modell zu bewegen.

`Class.Model|Models` und `Class.BasePart|BaseParts` sind beide
`Class.PVInstance|PVInstances` ("Positionsgeschwindigkeitsinstanzen") und daher haben beide
 diese Funktion.


PVInstance:GetPivot

Erhält den Pivot einer `Class.PVInstance`.


Transformiert die `Class.PVInstance` zusammen mit allen ihren Nachkommen
`Class.PVInstance|PVInstances`, sodass der Pivot jetzt an dem
angegebenen `Datatype.CFrame` liegt. Dies ist die Hauptfunktion, die verwendet werden sollte,
um `Class.Model|Models` über Skripting zu bewegen.

`Class.BasePart|BaseParts` werden auf diese Weise bewegt, indem ihr
`Datatype.CFrame` durch den erforderlichen Offset transformiert wird.
`Class.Model|Models` werden auf diese Weise bewegt, indem ihr
`Class.Model.WorldPivot` durch den erforderlichen Offset transformiert wird.

Beachten Sie, dass aus Effizienzgründen die `Class.Object.Changed`-Ereignisse nicht
für `Class.BasePart.Position|Position` und
`Class.BasePart.Orientation|Orientation` von `Class.BasePart|BaseParts`
, die auf diese Weise bewegt werden, ausgelöst werden; sie werden nur für `Datatype.CFrame` ausgelöst.

Beim Aufrufen von `Class.PVInstance:PivotTo()|PivotTo` auf `Class.Model|Models`
werden die Offsets der nachfolgenden Teile und Modelle zwischengespeichert, sodass
nachfolgende Aufrufe von `Class.PVInstance:PivotTo()|PivotTo` auf demselben Modell
ein Drift der Gleitkommazahlen zwischen den Teilen, die das Modell ausmachen, nicht akkumulieren.

`Class.Model|Models` und `Class.BasePart|BaseParts` sind beide
`Class.PVInstance|PVInstances` ("Positionsgeschwindigkeitsinstanzen") und daher haben beide
 diese Funktion.


PVInstance:PivotTo

targetCFrame

Der `Datatype.CFrame`, dem der Pivot der `Class.PVInstance` nach der Bewegung entsprechen sollte.


Transformiert die `Class.PVInstance` zusammen mit allen ihren Nachkommen
`Class.PVInstance|PVInstances`, sodass der Pivot jetzt an dem
angegebenen `Datatype.CFrame` liegt.


PVInstance

PVInstance.Origin

PVInstance.Pivot Offset

Abstrakte Klasse für alle Objekte, die einen physischen Standort in der Welt haben.


`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie, die Teil des `Class.DataModel`-Baumes sein können.

Es ist nicht möglich, direkt Root-`Instance`-Objekte zu erstellen, aber der spezielle `Datatype.Instance.new()`-Konstruktor erstellt Objekte über Code, indem er den Namen der Klasse als Parameter entgegennimmt und das erstellte Objekt zurückgibt.

Demonstriert das Erkennen von Änderungen an der Abstammung einer Instanz, indem man sich mit dem
`Class.Instance.AncestryChanged` Ereignis verbindet.

Der Parent des ChangingPart wird im Laufe der Zeit auf verschiedene Werte gesetzt. Der Parent des
Teils ist der Vorfahr des Teils, sodass das `Class.Instance.AncestryChanged` Ereignis
ausgelöst wird, wann immer es sich ändert.


Wird ausgelöst, wenn diese Instanz umgegliedert wird oder wenn einer ihrer Vorfahren
umgegliedert wird.

Sie können dieses Ereignis verwenden, um das Löschen einer Instanz im Studio zu verfolgen,
wie z.B. das manuelle Löschen im Explorer oder über ein Plugin. Wenn Sie erkennen müssen,
wann eine Instanz mit `Class.Instance:Destroy()` gelöscht wird, verwenden Sie stattdessen das
event `Class.Instance.Destroying`.

Instance.AncestryChanged

child

Die Instanz, deren `Class.Instance.Parent|Parent`-Eigenschaft sich geändert hat,
was diese Instanz oder einen weiter entfernten Vorfahren sein kann, **nicht**
unbedingt die Instanz, an die der Handler verbunden ist.

parent

Der neue Elternteil des `child`-Parameters.

Wird ausgelöst, wenn die `Class.Instance.Parent`-Eigenschaft dieses Objekts oder einer
seiner Vorfahren geändert wird.

Dieses Ereignis wird ausgelöst, wenn ein beliebiges Attribut auf der Instanz geändert wird,
auch wenn ein Attribut auf `nil` gesetzt wird. Der Name des geänderten Attributs wird an die
verbundene Funktion übergeben.

Zum Beispiel verbindet der folgende Code-Schnipsel die Funktion `attributeChanged()`
musikalisch, um zu feuern, wenn sich eines der Attribute des Parts ändert:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "geändert")
end

part.AttributeChanged:Connect(attributeChanged)
```
Siehe auch `Class.Instance:GetAttributeChangedSignal()`, das ein Ereignis zurückgibt,
das ausgelöst wird, wenn ein bestimmtes angegebenes Attribut geändert wird.

Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.

Wird ausgelöst, wenn ein Attribut auf der `Class.Instance` geändert wird.

Dieses Snippet druckt die Namen von Objekten aus, während sie zum Workspace hinzugefügt werden:

Wird ausgelöst, nachdem ein Objekt zu dieser `Class.Instance` hinzugefügt wurde.

Hinweis, beim Verwenden dieser Methode auf einem Client, um Objekte zu erkennen, die vom
Server erstellt wurden, ist es notwendig, `Class.Instance:WaitForChild()` zu verwenden, wenn
man auf die Nachkommen dieses Objekts zugreift. Dies liegt daran, dass das Objekt und seine
Nachkommen nicht garantiert gleichzeitig vom Server zum Client repliziert werden. Zum Beispiel:

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

Workspace.ChildAdded:Connect(function(child)
	-- Verwenden Sie WaitForChild(), da Nachkommen möglicherweise noch nicht repliziert wurden
	local head = child:WaitForChild("Head")
end)
```
Hinweis, dieses Ereignis funktioniert nur für unmittelbare Kinder der `Class.Instance`.
Für ein Ereignis, das alle Nachkommen erfasst, verwenden Sie `Class.Instance.DescendantAdded`.

Siehe auch `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Die `Class.Instance`, die hinzugefügt wurde.

Wird ausgelöst, nachdem ein Objekt zu dieser `Class.Instance` hinzugefügt wurde.

Instance.childAdded

Dieser Ausschnitt druckt die Namen von Objekten, während sie aus dem
Workspace entfernt werden:

Wird ausgelöst, nachdem ein Kind aus dieser `Class.Instance` entfernt wurde.

Entfernt bezieht sich darauf, wenn der Elternteil eines Objekts von dieser
`Class.Instance` auf etwas anderes als diese `Class.Instance` geändert wird. Hinweis, diese
Ereignis wird auch ausgelöst, wenn ein Kind gelöscht wird (unter Verwendung von
`Class.Instance:Destroy()`), da die Löschfunktion den Elternteil eines Objekts auf `nil`
setzt.

Dieses Ereignis funktioniert nur für unmittelbare Kinder der `Class.Instance`.
Für ein Ereignis, das alle Nachkommen erfasst, verwenden Sie
`Class.Instance.DescendantRemoving`.

Siehe auch `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Die `Class.Instance`, die entfernt wurde.

Wird ausgelöst, nachdem ein Kind aus dieser `Class.Instance` entfernt wurde.

Das folgende Beispiel gibt den Namen jedes Objekts aus, das zum
Arbeitsbereich hinzugefügt wird:

Dieses Ereignis wird ausgelöst, nachdem ein Nachkomme zur `Class.Instance` hinzugefügt wurde.

Da es für jeden Nachkommen ausgelöst wird, wird durch das Hinzufügen eines Objekts zur
`Class.Instance` das Ereignis für dieses Objekt und alle seine Nachkommen individuell ausgelöst.

Wenn Sie sich nur um die **direkten Kinder** der `Class.Instance` kümmern,
verwenden Sie stattdessen `Class.Instance.ChildAdded`.

Siehe auch `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Wird ausgelöst, nachdem ein Nachkomme zur `Class.Instance` hinzugefügt wurde.

Das folgende Beispiel gibt den Namen eines Nachkommens aus, während er entfernt wird
aus dem Workspace:

Dieses Ereignis wird **sofort bevor** der Elternteil `Class.Instance`
so geändert wird, dass eine **Nachkomme**-Instanz nicht mehr eine
Nachkomme ist. `Class.Instance:Destroy()|Destroy()` ändert den `Class.Instance.Parent|Parent`
 in `nil`, sodass der Aufruf dieser Methode auf einen Nachkommen des Elternteils dazu
führt, dass dieses Ereignis ausgelöst wird.

Da dieses Ereignis **vor** der Entfernung des Nachkommens ausgelöst wird, wird
zu diesem Zeitpunkt der Elternteil des Nachkommens unverändert bleiben. Wenn der
Nachkomme auch ein **direktes Kind** des Elternteils ist, wird dieses Ereignis vor
`Class.Instance.ChildRemoved` ausgelöst.

Wenn ein Nachkomme Kinder hat, wird dieses Ereignis zuerst mit dem Nachkommen ausgelöst,
gefolgt von seinen Nachkommen.

#### Warnung

Dieses Ereignis wird mit dem Nachkommenobjekt ausgelöst, das entfernt wird.
Der Versuch, den `Class.Instance.Parent|Parent` des Nachkommens auf
irgendetwas anderes zu setzen, wird fehlschlagen. Unten finden Sie ein Beispiel, das dies demonstriert:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipulieren Sie den Elternteil des Nachkommens in dieser Funktion nicht!
	-- Dieses Ereignis wird AUSGELÖST, WEIL der Elternteil manipuliert wurde, und die Änderung hat noch nicht stattgefunden
	-- Daher ist es problematisch, den Elternteil so zu ändern:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Siehe auch `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Wird sofort ausgelöst, bevor ein Nachkomme der `Class.Instance` entfernt wird.

Dieses Beispiel zeigt, wie ein Instanz, wenn das Immediate-Signalverhalten verwendet wird,
bei der Zerstörung an Ort und Stelle bleibt, bis die verbundene Funktion anhalten muss.


In diesem Beispiel wird demonstriert, wie eine Instanz zerstört wird, bevor das Signal ausgelöst wird, wenn das Deferred-Signalverhalten verwendet wird.


Die `Class.Instance` wird niemals aus dem Speicher gelöscht, während eine verbundene
Funktion sie noch verwendet. Wenn die Funktion jedoch zu irgendeinem Zeitpunkt ausgibt,
werden die `Class.Instance` und ihre Nachkommen auf `nil` umgegliedert.

Wenn die Eigenschaft `Class.Workspace.SignalBehavior` auf
`Enum.SignalBehavior.Immediate` gesetzt ist, wird dieses Ereignis sofort ausgelöst,
bevor die `Class.Instance` oder einer ihrer Vorfahren mit `Class.Instance:Destroy()` zerstört wird.

Wenn die Eigenschaft `Class.Workspace.SignalBehavior` auf
`Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis am nächsten Wiederaufnahme-
Punkt ausgelöst, was nach der Zerstörung von `Class.Instance` oder einem ihrer Vorfahren mit
`Class.Instance:Destroy()` sein wird.

Mit dem Verhalten `Enum.SignalBehavior.Deferred|Deferred` ist es problematisch,
ein Skript mit seinem eigenen `Class.Instance.Destroying`-Ereignis zu verbinden, da das
Skript zerstört wird, bevor der Callback aufgerufen werden kann (was bedeutet, dass es nicht ausgeführt wird).

Beim Löschen einer `Class.Instance` im Studio, wie z.B. beim manuellen Löschen über den
[Explorer](/studio/explorer) oder über ein Plugin, wird die `Class.Instance`
nicht gelöscht. Stattdessen wird der Elternteil auf `nil` gesetzt,
wobei Sie dies mit `Class.Instance.AncestryChanged` verfolgen können.

Instance.Destroying

Wird sofort ausgelöst, bevor (oder wird auf nachher verschoben) die Instanz
über `Class.Instance:Destroy()` zerstört wird.

Dieses Ereignis wird ausgelöst, wenn eine beliebige Stil-Eigenschaft auf der Instanz geändert wird,
auch wenn eine Eigenschaft auf `nil` gesetzt wird.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Gestylte Eigenschaften geändert")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Wird ausgelöst, wenn eine beliebige Stil-Eigenschaft auf der Instanz geändert wird,
auch wenn eine Eigenschaft auf `nil` gesetzt wird.

Diese Methode wendet ein Tag auf die Instanz an, ohne Wirkung, wenn das Tag bereits angewendet wurde. Das erfolgreiche Hinzufügen eines Tags löst ein Signal aus, das von `Class.CollectionService:GetInstanceAddedSignal()` mit dem angegebenen Tag erstellt wurde.

#### Warnungen

- Die Tags einer Instanz, die clientseitig hinzugefügt wurden, werden verworfen, wenn der Server später ein Tag auf dieser Instanz hinzufügt oder entfernt, da der Server alle Tags zusammen repliziert und vorherige Tags überschreibt.

- Wenn Sie eine Instanz taggen, ist es üblich, dass einige Ressourcen verwendet werden, um dem Tag seine Funktionalität zu verleihen, zum Beispiel Ereignisverbindungen oder Tabellen. Um Speicherverluste zu vermeiden, ist es eine gute Idee, diese aufzuräumen (trennen, auf `nil` setzen usw.), wenn sie für ein Tag nicht mehr benötigt werden. Tun Sie dies beim Aufruf von `Class.Instance:RemoveTag()`, beim Aufruf von `Class.Instance:Destroy()` oder in einer Funktion, die mit einem Signal verbunden ist, das von `Class.CollectionService:GetInstanceRemovedSignal()` zurückgegeben wurde.

Instance:AddTag

Die Kinderfunktion gibt ein Array der Kinder des Objekts zurück.

Instance:children

Gibt ein Array der Kinder des Objekts zurück.

Diese Methode zerstört alle Kinder und Nachkommen einer Instanz.

```
local part = Instance.new("Part")

-- Füge ein paar Funkeln hinzu
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Wenn Sie **alle** Kinder und Nachkommen nicht zerstören möchten, verwenden Sie entweder `Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um durch diese Kinder/Nachkommen zu iterieren und auszuwählen, was zerstört werden soll. Zum Beispiel wird das folgende Codesample alle `Class.BasePart|BaseParts`, die von einem `Class.Model` abgeleitet sind, zerstören:

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

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Diese Methode zerstört alle Kinder einer Instanz.

Demonstriert das Klonen eines Modells mit `Class.Instance:Clone()`.

`Clone()` erstellt eine Kopie einer Instanz und aller ihrer Nachkommen und ignoriert alle Instanzen, die **nicht** `Class.Instance.Archivable|Archivable` sind. Die Kopie der Root-Instanz wird durch diese Methode zurückgegeben, und ihr `Class.Instance.Parent|Parent` wird auf `nil` gesetzt. Beachten Sie, dass, wenn die Instanz selbst auf `Class.Instance.Archivable|Archivable` auf `false` gesetzt ist, diese Methode `nil` zurückgibt.

Wenn eine Referenzeigenschaft wie `Class.ObjectValue.Value` in einer kopierten Instanz gesetzt wird, hängt der Wert der Eigenschaftn der Kopie vom Wert des Originals ab:

- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **auch** kopiert wurde, verweist die Kopie auf die Kopie.
- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **nicht** kopiert wurde, bleibt derselbe Wert in der Kopie erhalten.

Instance:Clone

Erstellt eine Kopie einer Instanz und aller ihrer Nachkommen und ignoriert Instanzen, die **nicht** `Class.Instance.Archivable|Archivable` sind.

Instance:clone

Demonstriert das Zerstören eines Parts mit der `Class.Instance:Destroy()`-Funktion.

Diese Funktion ist der richtige Weg, um Objekte zu entsorgen, die nicht mehr
benötigt werden.


Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die `Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft `Destroy()` für alle Kinder auf. Diese Methode ist der richtige Weg, um Objekte loszuwerden, die nicht mehr benötigt werden.

Das Entsorgen von nicht mehr benötigten Objekten ist wichtig, da unnötige Objekte und Verbindungen in einem Ort Speicher belegen können, was im Laufe der Zeit zu ernsthaften Leistungsproblemen führen kann.

Als Best Practice sollte nach dem Aufruf von `Destroy()` für ein Objekt jede Variable, die auf das Objekt (oder seine Nachkommen) verweist, auf `nil` gesetzt werden. Dies verhindert, dass Ihr Code auf etwas zugreift, das mit dem Objekt zu tun hat.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Das nicht tun:
print(part.Name)  --> "Hello, world"
-- Dies tun, um die obige Zeile zu verhindern:
part = nil
```
Sobald ein `Class.Instance` durch diese Methode zerstört wurde, kann es nicht wiederverwendet werden, da die `Class.Instance.Parent`-Eigenschaft gesperrt ist. Um ein Objekt **vorübergehend** zu entfernen, anstatt es zu zerstören, setzen Sie `Class.Instance.Parent|Parent` auf `nil`. Zum Beispiel:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Um ein Objekt nach einer bestimmten Zeit zu zerstören, verwenden Sie `Class.Debris:AddItem()`.

Instance:Destroy

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die `Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft `Destroy()` für alle Kinder auf.

Instance:destroy

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Instance.Name` gleich dem angegebenen Namen ist.

Diese Methode funktioniert aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

Der folgende Codeausschnitt würde den ersten Vorfahren des Objekts mit dem Namen `Car` finden.

```
local car = object:FindFirstAncestor("Car")
```
Für Varianten dieser Methode, die Vorfahren einer bestimmten Klasse finden, siehe `Class.Instance:FindFirstAncestorOfClass()` und `Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Der `Class.Instance.Name`, nach dem gesucht werden soll.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Instance.Name` gleich dem angegebenen Namen ist.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Object.ClassName` gleich dem angegebenen className ist.

Diese Methode funktioniert aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

Ein häufiges Anwendungsbeispiel dieser Methode ist das Finden des `Class.Model`, zu dem ein `Class.BasePart` gehört. Zum Beispiel:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Diese Methode ist eine Variante von `Class.Instance:FindFirstAncestor()`, die die `Class.Object.ClassName`-Eigenschaft anstelle von `Class.Instance.Name` überprüft. `Class.Instance:FindFirstAncestorWhichIsA()` existiert ebenfalls und verwendet die `Class.Object:IsA()`-Methode, um die Klassenerbschaft zu berücksichtigen.

Instance:FindFirstAncestorOfClass

className

Der `Class.Object.ClassName`, nach dem gesucht werden soll.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Object.ClassName` gleich dem angegebenen className ist.

Gibt den ersten Vorfahren der `Class.Instance` zurück, für den `Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Diese Methode funktioniert aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

Im Gegensatz zu `Class.Instance:FindFirstAncestorOfClass()` verwendet diese Methode `Class.Object:IsA()`, die die Klassenerbschaft berücksichtigt. Zum Beispiel:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Deshalb gibt das folgende Codesample den ersten `Class.BasePart`-Vorfahren zurück, unabhängig davon, ob es sich um ein `Class.WedgePart`, `Class.MeshPart` oder `Class.Part` handelt.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Siehe auch `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren der `Class.Instance` zurück, für den `Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Instance

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie, die Teil des `Class.DataModel`-Baumes sein können.