Wenn es an ein `Class.ViewportFrame` angehängt ist, erweitert `WorldModel` die begrenzte Physik
für seine Kinder auf dieses `Class.ViewportFrame`. Zum Beispiel können `Class.BasePart|BaseParts`,
die an das `WorldModel` angehängt sind, animiert und räumlich abgefragt werden (zum Beispiel durch Raycasts),
aber diese Teile werden **nicht** simuliert. Darüber hinaus können Sie `Class.Humanoid`-Charaktere in das
`WorldModel` setzen, und ihre Gelenke werden korrekt für die Animation eingerichtet.

`WorldModel` stellt auch die
`Class.WorldModel.UseWorkspaceCollisionGroups|UseWorkspaceCollisionGroups`
Eigenschaft zur Verfügung, um zu bestimmen, ob es `Class.Workspace`-Kollisionsgruppen oder
seine eigenen unabhängigen Kollisionsgruppen für Abfragen verwendet.

Um mögliche Leistungsprobleme zu vermeiden, stellen Sie sicher, dass Sie `WorldModels`
nur erstellen, wenn Sie sie anzeigen möchten, und löschen Sie `WorldModels`, die derzeit nicht
in Gebrauch sind.


WorldModel

Wenn `false` (Standard), verwendet dieses `WorldModel` seine eigenen Kollisionsgruppen
für alle kollisionsbezogenen Verhaltensweisen.

Wenn `true`, verwendet dieses `WorldModel` `Class.Workspace`-Kollisionsgruppen.
Zusätzlich kann der Kollisionsgruppenstatus dieses `WorldModel` weiterhin geändert werden.


WorldModel.UseWorkspaceCollisionGroups

Bestimmt, ob dieses `WorldModel` `Class.Workspace`-Kollisionsgruppen oder seine eigenen
unabhängigen Kollisionsgruppen für Abfragen verwendet.


Erweitert die begrenzte Physik auf seine Kinder.


Diese Basis-Klasse stellt eine API für jede Instanz zur Verfügung, die für die Handhabung von 3D-Raumabfragen und Simulationen gedacht ist, wie zum Beispiel `Class.Workspace` und `Class.WorldModel`.

Der folgende Codeblock zeigt, wie man
`Class.WorldRoot:ArePartsTouchingOthers()` verwendet, um zu überprüfen, ob Teile in einer Liste
irgendwelchen Teilen im Arbeitsbereich, die nicht in der Liste sind, berühren.

Zuerst erstellt das Skript zwei quadratische Teile, die sich um 1 Stud überlappen, `Part1` und
`Part2`. Dann wird der Wert, der von ArePartsTouchingOthers() zurückgegeben wird, wenn
Part1 in `partList` bei drei verschiedenen Überlappungswerten übergeben wird: `0`, `0.999`
und `1`, ausgegeben. Die ersten beiden Aufrufe von ArePartsTouchingOthers() geben `false` zurück,
weil die Überlappungswerte kleiner sind als der Abstand, den Part1 und Part2
überlappen. Der dritte Aufruf gibt `true` zurück, weil der Überlappungswert gleich
dem Abstand ist, den die Teile überlappen.

**ArePartsTouchingOthers** gibt true zurück, wenn mindestens eines der gegebenen `Class.BasePart` eine andere Teile berührt. Zwei Teile gelten als "berührend", wenn sie innerhalb des Abstandsschwellenwertes `overlapIgnored` sind.

Wenn keine Teile angegeben werden, wird false zurückgegeben.

WorldRoot:ArePartsTouchingOthers

partList

Eine Liste von Teilen, um zu überprüfen, ob Teile in der Liste andere Teile außerhalb der Liste berühren.

overlapIgnored

Der Überlappungsschwellenwert der Teile in Studs, der ignoriert wird, bevor Teile als berührend betrachtet werden.

True, wenn und nur wenn eines der `Class.Part|parts` in `partList` andere Teile berührt (Teile, die nicht in der partList sind). False, wenn keine Teile übergeben werden.

Gibt true zurück, wenn ein beliebiges `Class.BasePart` eine andere Teile berührt.

Wirft einen Block und gibt die erste Kollision mit einem `Class.BasePart` oder
`Class.Terrain` zurück. Gibt die Eigenschaften des RaycastResult aus, wenn ein Ergebnis
getroffen wurde.


Wirft eine Blockform in eine gegebene Richtung und gibt die erste Kollision mit einem `Class.BasePart` oder einer `Class.Terrain`-Zelle zurück. Dies ist analog dazu, wie `Class.WorldRoot:Raycast()` einen linearen Strahl in eine Richtung wirft, um eine Kollision zu finden, verwendet jedoch eine 3D-Form anstelle eines Strahls.

Im Gegensatz zu `Class.WorldRoot:GetPartsInPart()` erkennt diese Methode keine `Class.BasePart|BaseParts`, die **zunächst** die Form schneiden.

Wenn ein Treffer erkannt wird, wird ein `Datatype.RaycastResult` zurückgegeben, das die Trefferinformationen enthält. Die `Datatype.RaycastResult.Distance|Distance`-Eigenschaft repräsentiert die Entfernung, die die Form zurücklegen muss, um einen Treffer zu landen, und die `Datatype.RaycastResult.Position|Position`-Eigenschaft repräsentiert den Punkt der Schnittstelle, der den Treffer verursacht.

Diese Methode wirft einen Fehler, wenn ungültige `Datatype.CFrame`, Größe oder Richtungswerte übergeben werden.

WorldRoot:Blockcast

cframe

Die Anfangsposition und Drehung der geworfenen Blockform.

size

Die Größe der geworfenen Blockform in Studs. Die maximale Größe beträgt 512 Studs.

direction

Richtung des Shapecasts, wobei die Magnitude die maximale Entfernung darstellt, die die Form zurücklegen kann. Die maximale Entfernung beträgt 1024 Studs.

params

Ein Objekt, das verwendet wird, um die Trefferberechtigung in der Shapecast-Operation anzugeben.
Wenn nicht angegeben, werden Standardwerte verwendet, bei denen alle Teile
berücksichtigt werden und `Class.Terrain` Wasser nicht ignoriert wird.

Enthält das Ergebnis der Shapecast-Operation oder `nil`, wenn keine geeignete `Class.BasePart` oder `Class.Terrain`-Zelle getroffen wurde.

Wirft eine Blockform in eine gegebene Richtung und gibt ein `Datatype.RaycastResult` zurück, wenn die Form ein `Class.BasePart` oder eine `Class.Terrain`-Zelle trifft.

Diese Funktion bewegt ein Array von `Class.BasePart|BaseParts` zu einem Array von
`Datatype.CFrame|CFrames`, ohne notwendigerweise die Standard-Eigenschaft
`Class.Object.Changed|Changed`-Ereignisse auszulösen. Dies bietet eine sehr schnelle Möglichkeit,
 große Mengen von Teilen zu bewegen, da Sie nicht die Kosten für separate
Eigenschaftsänderungen für jedes einzelne Teil tragen müssen.

Sowohl `partList` als auch `cframeList` sind sequentielle Arrays (Luau-Tabellen mit
ganzzahligen Indizes, die bei 1 beginnen), keine Wörterbücher. Jedes Teil an Index `i`
in `partList` wird zum `Datatype.CFrame|CFrame` an Index `i` in
`cframeList` verschoben. Die Arrays müssen die gleiche Anzahl von Einträgen enthalten.

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

local partList = { Workspace.Part1, Workspace.Part2 }
local cframeList = { CFrame.new(0, 5, 0), CFrame.new(10, 5, 0) }
Workspace:BulkMoveTo(partList, cframeList, Enum.BulkMoveMode.FireCFrameChanged)
```
Das dritte Argument ermöglicht es Ihnen, den Bewegungsprozess weiter zu optimieren.
Standardmäßig wird das `Class.Object.Changed|Changed`-Ereignis jedes Teils für
`Class.BasePart.Position|Position`,
`Class.BasePart.Orientation|Orientation` und
`Class.BasePart.CFrame|CFrame` ausgelöst. Wenn Sie jedoch
`Enum.BulkMoveMode|FireCFrameChanged` als drittes Argument angeben, wird nur das
`Class.Object.Changed|Changed`-Ereignis für die
`Class.BasePart.CFrame|CFrame`-Eigenschaft ausgelöst.

Beachten Sie, dass Sie diese Funktion nur verwenden sollten, wenn Sie sicher sind, dass die
Teilmobilität ein Engpass in Ihrem Code ist. Das einfache Setzen der
`Class.BasePart.CFrame|CFrame`-Eigenschaft einzelner Teile und geschweißter
Modelle ist in den meisten Fällen schnell genug.

WorldRoot:BulkMoveTo

Ein Array von `Class.BasePart|BaseParts`, die bewegt werden sollen. Jeder Eintrag ist
indizesmäßig dem entsprechenden Eintrag in `cframeList` zugeordnet.

cframeList

Ein Array von `Datatype.CFrame|CFrames`, zu denen die Teile bewegt werden,
indizesmäßig zu `partList` zugeordnet. Beide Arrays müssen die gleiche Länge haben.

eventMode

Ein `Enum.BulkMoveMode`-Enum, das angibt, welche
`Class.Object.Changed|Changed`-Ereignisse während der Bewegung ausgelöst werden. Standard ist
`Enum.BulkMoveMode|FireAllEvents`.

Bewegt ein Array von `Class.BasePart|BaseParts` zu einem Array von
`Datatype.CFrame|CFrames`.

Gibt zurück, ob die beiden angegebenen Kollisionsgruppen in dieser
Welt kollidieren werden. Diese Methode gibt auch `true` zurück, wenn eine der Gruppen
in dieser Welt nicht registriert ist, da die Standard-Kollisionsmaske mit
allen Gruppen kollidiert.


WorldRoot:CollisionGroupsAreCollidable

name1

name2

Gibt zurück, ob die beiden Gruppen in dieser Welt kollidieren werden.


Setzt den Kollisionsstatus zwischen zwei Gruppen in dieser Welt. Diese Methode
wirft einen Fehler, wenn eine der Gruppen in dieser Welt nicht registriert ist,
weshalb empfohlen wird, die Registrierung jeder Gruppe über
`Class.WorldRoot:IsCollisionGroupRegistered()` zu bestätigen, bevor dieser Aufruf erfolgt.


WorldRoot:CollisionGroupSetCollidable

collidable

Setzt den Kollisionsstatus zwischen zwei Gruppen in dieser Welt.


**FindPartOnRay** verwendet [Raycasting](/workspace/raycasting), um
 die erste `Class.BasePart` oder `Class.Terrain` Zelle zu finden, die mit
einem gegebenen `Datatype.Ray` schneidet. Diese Funktion gibt die `Class.BasePart` oder
Terrain-Zelle zurück, die getroffen wurde, den Schnittpunkt, die Oberflächen-Normalen am
Schnittpunkt und das zugehörige `Enum.Material` zurück.

Wenn der Parameter `ignoreDescendantsInstance` angegeben ist, ignoriert die Raycasting-
Berechnung das angegebene Objekt und alle seine Nachkommen. Es
verhält sich ähnlich wie die `Class.Mouse.TargetFilter`-Eigenschaft.

Die Parameter `terrainCellsAreCubes` und `ignoreWater` bestimmen, ob
`Class.Terrain` Zellen als Würfel behandelt werden sollen oder nicht, und ob Wasser
ignoriert werden soll oder nicht.

Um mehrere Objekte und deren Nachkommen einzuschließen oder auszuschließen, verwenden
Sie die Varianten `Class.WorldRoot:FindPartOnRayWithWhitelist()` und
`Class.WorldRoot:FindPartOnRayWithIgnoreList()`.

#### Hinweise

- Theoretisch erstreckt sich ein Strahl unendlich in eine Richtung. Die
  maximale Länge des Richtungsvektors in Roblox beträgt jedoch 15000 Studs.
- Die Länge (Betrag) des Richtungsvektors ist wichtig, da Teile,
  die weiter entfernt sind als seine Länge, nicht getestet werden.
- Wenn der Strahl nichts schneidet, sind die Rückgabewerte `nil`
  und der Punkt am Ende des Strahls.
- Teile, die sich in einer
  [Kollisionsgruppe](/workspace/collisions#collision-filtering)
  befinden, die nicht mit der "Standard"-Kollisionsgruppe kollidiert, werden
  implizit ignoriert.


WorldRoot:FindPartOnRay

Ein `Datatype.Ray`, dessen Ursprung und Richtung den Raycast definieren.

ignoreDescendantsInstance

Eine `Class.Instance`, deren Nachkommen im Raycast ignoriert werden.


terrainCellsAreCubes

Ob `Class.Terrain`-Zellen als volle Würfel behandelt werden, wenn
Schnitte berechnet werden. Standard ist falsch.

ignoreWater

Ob `Class.Terrain`-Wasserzellen vom Ray ignoriert werden. Standard ist
falsch.

Das `Class.BasePart` oder die `Class.Terrain`-Zelle, die getroffen wurde, der `Datatype.Vector3` Schnittpunkt, die `Datatype.Vector3` Oberflächennormalen an dem Schnittpunkt und das `Enum.Material` des `Class.BasePart` oder der Terrain-Zelle, die getroffen wurde.

Gibt die erste `Class.BasePart` oder `Class.Terrain` Zelle zurück, die mit
dem gegebenen `Datatype.Ray` schneidet.


WorldRoot:findPartOnRay

Diese Funktion ist eine Variante von `Class.WorldRoot:FindPartOnRay()` mit der
Ergänzung einer Ignorierliste. Dies ermöglicht es Ihnen, bestimmte Teile oder
`Class.Model|Models` zu ignorieren.

Wer eine bestimmte Gruppe von Objekten **einbeziehen** möchte, sollte stattdessen
`Class.WorldRoot:FindPartOnRayWithWhitelist()` verwenden.


WorldRoot:FindPartOnRayWithIgnoreList

Ein `Datatype.Ray`, dessen Ursprung und Richtung den Raycast definieren.


ignoreDescendantsTable

Ein Array von Objekten, deren Nachkommen vom Raycast ausgeschlossen werden.


Ob `Class.Terrain` Zellen als volle Würfel behandelt werden, wenn
Schnitte berechnet werden. Standard ist falsch.


Ob `Class.Terrain` Wasserzellen vom Strahl ignoriert werden. Standard ist
falsch.


Die `Class.BasePart` oder `Class.Terrain` Zelle, die getroffen wurde, der
`Datatype.Vector3` Schnittpunkt, die `Datatype.Vector3`
Oberflächen-Normalen am Schnittpunkt und das `Enum.Material`
 der `Class.BasePart` oder Terrain-Zelle, die getroffen wurde.


Gibt die erste `Class.BasePart` oder `Class.Terrain` Zelle zurück, die mit
dem gegebenen `Datatype.Ray` schneidet und nicht in der angegebenen Ignorierliste ist,
noch ein Nachkomme eines Objekts in der Ignorierliste ist.


Diese Funktion ist eine Variante von `Class.WorldRoot:FindPartOnRay()` mit der
Ergänzung einer Einschlussliste. Dies ermöglicht es Ihnen, nur bestimmte Teile oder
`Class.Model|Models` zu erkennen und ist besonders nützlich, wenn Sie beispielsweise
nach Schnittpunkten zwischen einem Strahl und einem einzelnen Teil suchen.

Wenn ein `nil` Wert in der Einschlussliste angegeben wird, werden Instanzen nach
ihm ignoriert.

Wer eine bestimmte Gruppe von Objekten **ausschließen** möchte, sollte stattdessen
`Class.WorldRoot:FindPartOnRayWithIgnoreList()` verwenden.


WorldRoot:FindPartOnRayWithWhitelist

whitelistDescendantsTable

Ein Array von Objekten, deren Nachkommen die einzigen Kandidaten sind,
 die im Raycast berücksichtigt werden.


Gibt die erste `Class.BasePart` oder `Class.Terrain` Zelle zurück, die mit
dem gegebenen `Datatype.Ray` schneidet und in der angegebenen Einschlussliste ist,
oder ein Nachkomme eines Objekts in der Einschlussliste ist.


Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück.

Diese Funktion nimmt einen optionalen maxParts-Parameter (Standard 20) an, der
 die Anzahl der `Class.BasePart|BaseParts` begrenzt, die zurückgegeben werden können. Sobald
 diese Zahl erreicht ist, wird die Suche nach `Class.BasePart|BaseParts`
 gestoppt. Das bedeutet, dass einige `Class.BasePart|BaseParts` möglicherweise nicht zurückgegeben werden,
 selbst wenn sie sich innerhalb der `Datatype.Region3` befinden.

Der optionale Parameter `ignoreDescendantsInstance` kann verwendet werden, um
eine bestimmte Instanz anzugeben, deren Nachkommen von dieser Funktion ignoriert werden
sollten. Dies kann nützlich sein, wenn Sie beispielsweise überprüfen möchten,
ob sich Teile innerhalb eines `Class.BasePart` befinden, das nicht das `Class.BasePart`
selbst ist.

```
local min = part.Position - (0.5 * part.Size)
local max = part.Position + (0.5 * part.Size)
local region = Region3.new(min, max)
local parts = worldroot:FindPartsInRegion3(region, part)  -- Ignoriere Teil
```
Die Varianten `Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` und
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()` dieser Methode existieren, um
spezifische Ausschluss- und Einschlussfunktionen bereitzustellen.

Wenn keine `Class.BasePart|BaseParts` gefunden werden, wird ein leeres Array zurückgegeben.


WorldRoot:FindPartsInRegion3

region

Die `Datatype.Region3`, die überprüft werden soll.

Eine `Class.Instance`, die ignoriert werden soll.


maxParts

Die maximale Anzahl von `Class.BasePart|BaseParts`, die zurückgegeben werden sollen.


Ein Array von `Class.BasePart|BaseParts`, die sich innerhalb der `Datatype.Region3` befinden.


Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück.


WorldRoot:findPartsInRegion3

Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück, die sich nicht in der angegebenen Ignorierliste befinden,
oder ein Nachkomme eines Eintrags in der Ignorierliste sind.

Wenn ein `nil` Wert in der Ignorierliste angegeben wird, werden Instanzen nach diesem Wert
nicht ignoriert. Wenn keine `Class.BasePart|BaseParts` gefunden werden, wird ein leeres
Array zurückgegeben.

Diese Funktion ist eine Variante von `Class.WorldRoot:FindPartsInRegion3()` mit
 der Ergänzung einer Ignorierliste. Dies ermöglicht es dem Entwickler, bestimmte
 `Class.BasePart|BaseParts` oder `Class.Model|Models` von der
Suche auszuschließen. Wer `Class.BasePart|BaseParts` in einer
`Datatype.Region3` mit einer Einschlussliste finden möchte, sollte
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()` verwenden.


WorldRoot:FindPartsInRegion3WithIgnoreList

Die `Datatype.Region3`, die überprüft werden soll.


Ein Array von Objekten, die ignoriert werden sollen.


Ein Array von `Class.BasePart|BaseParts`, die innerhalb der
`Datatype.Region3` gefunden wurden.


Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück, die sich nicht in der angegebenen Ignorierliste befinden,
oder ein Nachkomme eines Eintrags in der Ignorierliste sind.


Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück, die sich in der angegebenen Einschlussliste befinden,
oder ein Nachkomme eines Eintrags in der Einschlussliste sind.

Wenn ein `nil` Wert in der Einschlussliste angegeben wird, werden Instanzen nach diesem
Wert nicht ignoriert. Wenn keine `Class.BasePart|BaseParts` gefunden werden, wird ein
leeres Array zurückgegeben.

Diese Funktion ist eine Variante von `Class.WorldRoot:FindPartsInRegion3()` mit
 der Ergänzung einer Einschlussliste. Dies ermöglicht es dem Entwickler, nur bestimmte
 `Class.BasePart|BaseParts` oder `Class.Model|Models` in der
Suche einzuschließen. Wer `Class.BasePart|BaseParts` in einer
`Datatype.Region3` mit einer Ausschlussliste finden möchte, sollte
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` verwenden.


WorldRoot:FindPartsInRegion3WithWhiteList

Ein Array von Objekten, die überprüft werden sollen.


Gibt ein Array von `Class.BasePart|BaseParts` in der gegebenen
`Datatype.Region3` zurück, die sich in der angegebenen Einschlussliste befinden,
oder ein Nachkomme eines Eintrags in der Einschlussliste sind.


Gibt die maximale Anzahl von Kollisionsgruppen zurück, die die Engine pro
Welt unterstützt. Dieser Wert beträgt derzeit 32.


WorldRoot:GetMaxCollisionGroups

Gibt die maximale Anzahl von Kollisionsgruppen in dieser Welt zurück.


`Class.WorldRoot:GetPartBoundsInBox()` gibt ein Array von Teilen zurück, deren
**Umrandungsboxen** mit einer Box überlappen, deren Volumen mit dem gegebenen
Zentrum (`Datatype.CFrame`) und der Größe (`Datatype.Vector3`) beschrieben wird.

Wie betont, berücksichtigt diese räumliche Abfrage-Methode effizient das Volumen
 der Umrandungsboxen der Teile anstelle ihres tatsächlichen belegten Volumens. Dies
 kann wichtig sein, wenn Zylinder, Kugeln, Vereinigungen und
`Class.MeshPart|MeshParts` mit nicht-blockförmigen Formen berücksichtigt werden. Für Fälle, in denen
Genauigkeit besonders wichtig ist, verwenden Sie stattdessen `Class.WorldRoot:GetPartsInPart()`
 oder filtern Sie die Ergebnisse dieser Methode selbst weiter.

Diese Methode verwendet ein `Datatype.OverlapParams`-Objekt, um wiederverwendbare
Teile der räumlichen Abfrage zu beschreiben, wie eine Einschluss- oder Ausschlussliste, die
maximale Anzahl von Teilen, die abgefragt werden sollen, welche
[Kollisionsgruppe](/workspace/collisions#collision-filtering) verwendet werden soll,
und ob die Abfrage den Wert `Class.BasePart.CanCollide` eines
überlappenden Teils über den Wert `Class.BasePart.CanQuery`
bevorzugt.


WorldRoot:GetPartBoundsInBox

Der Standort des Zentrums des gegebenen Boxvolumens, das abgefragt werden soll.


Die Größe des gegebenen Boxvolumens, das abgefragt werden soll.


overlapParams

Enthält wiederverwendbare Teile der räumlichen Abfrageparameter.


Ein Array von `Class.BasePart|BaseParts`, die der räumlichen
Abfrage entsprechen.


Gibt ein Array von Teilen zurück, deren **Umrandungsboxen** mit einer gegebenen Box
überlappen.


`Class.WorldRoot:GetPartBoundsInRadius()` gibt ein Array von Teilen zurück, deren
**Umrandungsboxen** mit einer Kugel überlappen, deren Volumen mit dem gegebenen
Zentrum (`Datatype.Vector3`) und dem Radius (Zahl) beschrieben wird.

Wie betont, berücksichtigt diese räumliche Abfrage-Methode effizient das Volumen
 der Umrandungsboxen der Teile anstelle ihres tatsächlichen belegten Volumens. Dies
 kann wichtig sein, wenn Zylinder, Kugeln, Vereinigungen und
`Class.MeshPart|MeshParts` mit nicht-blockförmigen Formen berücksichtigt werden. Für Fälle, in denen
Genauigkeit besonders wichtig ist, verwenden Sie stattdessen `Class.WorldRoot:GetPartsInPart()`
 oder filtern Sie die Ergebnisse dieser Methode selbst weiter.

Diese Methode verwendet ein `Datatype.OverlapParams`-Objekt, um wiederverwendbare
Teile der räumlichen Abfrage zu beschreiben, wie eine Einschluss- oder Ausschlussliste, die
maximale Anzahl von Teilen, die abgefragt werden sollen, welche
[Kollisionsgruppe](/workspace/collisions#collision-filtering) verwendet werden soll,
und ob die Abfrage den Wert `Class.BasePart.CanCollide` eines
überlappenden Teils über den Wert `Class.BasePart.CanQuery`
bevorzugt.


WorldRoot:GetPartBoundsInRadius

position

Der Standort des Zentrums des gegebenen Kugelvolumens, das abgefragt werden soll.


radius

Der Radius des gegebenen Kugelvolumens, das abgefragt werden soll.


Gibt ein Array von Teilen zurück, deren **Umrandungsboxen** mit einer gegebenen Kugel
überlappen.


`Class.WorldRoot:GetPartsInPart()` gibt ein Array von Teilen zurück, deren
belegter Raum mit dem gegebenen Teil (der sich im selben
`Class.WorldRoot` wie die Teile, die abgefragt werden sollen, befinden muss) geteilt wird. Diese Methode kann anstelle von `Class.BasePart:GetTouchingParts()` verwendet werden und ist im Allgemeinen die bessere Wahl.

Wie erwähnt, berücksichtigt diese räumliche Abfrage-Methode das **exakte Volumen**
, das vom gegebenen Teil belegt wird, indem eine vollständige geometrische Kollisionsprüfung durchgeführt wird. Zum Beispiel wird ein konkaver/hohler Teil keine abgefragten Teile innerhalb von ihm erkennen, es sei denn, sie überlappen/touchieren tatsächlich einen solchen Teil. Für einfachere Volumen sollten Sie `Class.WorldRoot:GetPartBoundsInBox()` oder
`Class.WorldRoot:GetPartBoundsInRadius()` verwenden, da sie weniger genau, aber effizienter sind.

Diese Methode verwendet ein `Datatype.OverlapParams`-Objekt, um wiederverwendbare
Teile der räumlichen Abfrage zu beschreiben, wie eine Einschluss- oder Ausschlussliste, die
maximale Anzahl von Teilen, die abgefragt werden sollen, welche
[Kollisionsgruppe](/workspace/collisions#collision-filtering) verwendet werden soll,
und ob die Abfrage den Wert `Class.BasePart.CanCollide` eines
überlappenden Teils über den Wert `Class.BasePart.CanQuery`
bevorzugt.


WorldRoot:GetPartsInPart

part

Das Teil, dessen Volumen gegen andere Teile überprüft werden soll.


Gibt ein Array von Teilen zurück, deren belegter Raum mit dem gegebenen
Teil geteilt wird.


Gibt eine Tabelle mit Informationen zu allen Kollisionsgruppen dieser Welt zurück. Jeder
Wert in der zurückgegebenen Tabelle ist selbst eine Tabelle und enthält zwei Mitglieder:

<table>
  <thead>
    <tr>
      <th>Mitglied</th>
      <th>Typ</th>
      <th>Beschreibung</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>Die Kollisionsmaske der Gruppe; nur für interne Verwendung.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Name der Kollisionsgruppe.</td>
    </tr>
  </tbody>
</table>


WorldRoot:GetRegisteredCollisionGroups

Gibt eine Tabelle mit Informationen zu allen Kollisionsgruppen dieser Welt zurück.


Diese Funktion bewegt das angegebene Teil an den angegebenen Ort über
[inverse Kinematik](https://en.wikipedia.org/wiki/Inverse_kinematics),
statt es direkt dorthin zu bewegen, um sicherzustellen, dass alle Gelenke,
`Class.Constraint|constraints` oder Kollisionen, an denen das Teil beteiligt ist,
physikalisch erfüllt bleiben. Derzeit ist diese Funktion nur im Studio für `Class.Plugin|plugins`
verfügbar, da sie derzeit mit der Physik eines laufenden Spiels in Konflikt steht.

**Translate stiffness** ist eine Zahl zwischen 0 und 1, die angibt, wie
aggressiv die Position des Teils an die Position des Ziel-CFrame angepasst werden soll. **Rotate stiffness** ist eine Zahl zwischen 0 und 1, die angibt,
wie aggressiv die Rotation des Teils an die Rotation des Ziel-CFrame angepasst werden soll.

Zum Beispiel:

- Wenn die Translate stiffness und die Rotate stiffness beide gleich 1 sind, wird
  das Teil genau zum Ziel-CFrame bewegt, unabhängig von den physikalischen
  Einschränkungen, die darauf liegen.
- Wenn die Translate stiffness und die Rotate stiffness beide gleich 0.5 sind, wird
  das Teil versuchen, genau zum Ziel-CFrame zu bewegen, kann aber von
  physikalischen Einschränkungen, die darauf liegen, weggeschoben werden.
- Wenn die Translate stiffness und die Rotate stiffness beide gleich 0 sind, wird
  der Ziel-CFrame ignoriert und physikalische Einschränkungen werden für das Objekt an
  der Position, an der es war, gelöst.


WorldRoot:IKMoveTo

target

Der Ort, an den das angegebene Teil bewegt werden soll.


translateStiffness

Eine Zahl zwischen 0 und 1, die angibt, wie aggressiv die
Position des Teils an die Position des Ziel-`Datatype.CFrame` angepasst werden soll.


rotateStiffness

Eine Zahl zwischen 0 und 1, die angibt, wie aggressiv die
Rotation des Teils an die Rotation des Ziel-`Datatype.CFrame` angepasst werden soll.


collisionsMode

Ermöglicht es Ihnen, anzugeben, welche Objekte von der physikalischen
Auflösung betroffen sein sollen.


Bewegt das angegebene Teil an den angegebenen Ort über inverse Kinematik,
statt es direkt dorthin zu bewegen, um sicherzustellen, dass alle Gelenke,
Einschränkungen oder Kollisionen, an denen das Teil beteiligt ist, physikalisch
erfüllt bleiben.


Überprüft, ob eine Kollisionsgruppe in dieser Welt registriert ist. Es wird empfohlen,
diese Methode aufzurufen, bevor Sie Methoden aufrufen, die Fehler für
nicht registrierte Kollisionsgruppen auslösen, wie z. B.
`Class.WorldRoot:CollisionGroupSetCollidable()`.


WorldRoot:IsCollisionGroupRegistered

name

Überprüft, ob eine Kollisionsgruppe in dieser Welt registriert ist.


**IsRegion3Empty** gibt einen Bool zurück, der angibt, ob es keine
`Class.BasePart|BaseParts` innerhalb der gegebenen `Datatype.Region3` gibt.

Der optionale Parameter `ignoreDescendantsInstance` kann verwendet werden, um
eine bestimmte Instanz anzugeben, deren Nachkommen von dieser Funktion ignoriert werden
sollten. Dies kann nützlich sein, wenn Sie beispielsweise überprüfen möchten,
ob sich Teile innerhalb eines `Class.BasePart` befinden, das nicht das `Class.BasePart`
selbst ist.

```
local min = part.Position - (0.5 * part.Size)
local max = part.Position + (0.5 * part.Size)
local region = Region3.new(min, max)
local isPartEmpty = worldroot:IsRegion3Empty(region, part)  -- Ignoriere Teil
```
Wenn mehr als ein Objekt und dessen Nachkommen von der
Suche ausgeschlossen werden müssen, sollten Entwickler
`Class.WorldRoot:IsRegion3EmptyWithIgnoreList()` verwenden.

Diese Funktion gibt nur zurück, ob eine Region leer ist oder nicht. Entwickler, die
`Class.BasePart|BaseParts` in einer Region finden möchten, sollten
`Class.WorldRoot:FindPartsInRegion3()` verwenden.

#### Wie funktionieren Region3-Überprüfungen?

Zu überprüfen, ob ein Teil mit einer `Datatype.Region3` überlappt, ist kein einfacher Prozess.
Es ist tatsächlich zeitaufwendig und kompliziert. Stattdessen wird überprüft, ob Teile
ungefähr im selben Bereich sind. Wenn diese Funktion aufgerufen wird, ermittelt sie,
welche Voxel die `Datatype.Region3` enthalten. Dann ermittelt sie, welche
Teile sich möglicherweise in diesen Voxeln befinden. Dies geschieht, indem die achsenausgerichtete
Umrandungsbox (manchmal als AABB bezeichnet) des Teils mit den Voxeln verglichen wird. Die
achsenausgerichtete Umrandungsbox kann in Roblox Studio gesehen werden, wenn ein Teil
ausgewählt ist.

Das bedeutet, dass der Bereich, der von der Funktion überprüft wird, größer sein kann
als die `Datatype.Region3`. Aus diesem Grund wird empfohlen, sicherzustellen,
dass die `Datatype.Region3` im Voxelraster liegt. Der beste Weg, dies zu tun, besteht darin,
die Koordinaten der `Datatype.Region3` auf Vielfache von 4 zu setzen (da Voxel 4 x 4 x 4 Studs sind).

Diese Methode ist eine recht schnelle und einfache Möglichkeit, um zu sehen, ob Teile sich in einem
allgemeinen Bereich befinden. Wenn ein Spiel wissen muss, ob Teile sich genau in einem Bereich befinden,
 sollte `Class.BasePart:GetTouchingParts()` verwendet werden. Es gibt höhere
Kosten bei der Verwendung von `Class.BasePart:GetTouchingParts()`, da ein Teil benötigt wird
im `Class.WorldRoot` und die Funktion mehr Zeit in Anspruch nimmt.


WorldRoot:IsRegion3Empty

ignoreDescendentsInstance

Wahr, wenn die `Datatype.Region3` leer ist.


Gibt einen Bool zurück, der angibt, ob es keine `Class.BasePart|BaseParts`
 innerhalb der gegebenen `Datatype.Region3` gibt.


Gibt einen Bool zurück, der angibt, ob es keine
`Class.BasePart|BaseParts` innerhalb der gegebenen `Datatype.Region3` gibt, wobei
alle `Class.BasePart|BaseParts` ignoriert werden, die Nachkommen der Objekte in der
gegebenen Ignorierliste sind. Wenn ein `nil` Wert in der Ignorierliste angegeben wird,
werden Instanzen nach diesem Wert nicht ignoriert.

Diese Funktion gibt nur zurück, ob eine Region leer ist oder nicht. Entwickler, die
spezifische `Class.BasePart|BaseParts` in einer Region finden möchten, sollten
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` verwenden.

Diese Funktion ist eine Variante von `Class.WorldRoot:IsRegion3Empty()` mit der
Ergänzung einer Ignorierliste. In Fällen, in denen stattdessen eine Einschlussliste erforderlich ist,
sollten Entwickler überprüfen, ob Teile von
`Class.WorldRoot:FindPartsinRegion3WithWhitelist()` zurückgegeben werden.


WorldRoot:IsRegion3EmptyWithIgnoreList

ignoreDescendentsTable

Gibt einen Bool zurück, der angibt, ob es keine
`Class.BasePart|BaseParts` innerhalb der gegebenen `Datatype.Region3` gibt, wobei
alle `Class.BasePart|BaseParts` ignoriert werden, die Nachkommen der Objekte in der
gegebenen Ignorierliste sind.


Wirft einen Strahl und gibt die erste Kollision mit einem `Class.BasePart` oder
`Class.Terrain` zurück. Gibt die Eigenschaften des RaycastResult aus, wenn ein Ergebnis
getroffen wurde.


Wirft einen Strahl mit einem Ursprung, einer Richtung und optionalen
`Datatype.RaycastParams`. Wenn er ein berechtigtes `Class.BasePart` oder
`Class.Terrain` Zelle findet, wird ein `Datatype.RaycastResult` zurückgegeben, das
die Ergebnisse der Operation enthält. Wenn kein `Datatype.RaycastParams`-Objekt
bereitgestellt wird, werden die Standardwerte verwendet (alle Teile werden berücksichtigt und
`Class.Terrain` Wasser wird nicht ignoriert).

Beachten Sie, dass die Länge (Betrag) des Richtungsvektors wichtig ist,
 da Objekte/Terrain, die weiter entfernt sind als seine Länge, nicht getestet werden. Wenn
Sie ein `Datatype.CFrame` verwenden, um die Strahlkomponenten zu erstellen,
ziehen Sie in Betracht, `Datatype.CFrame.LookVector` als Richtungsvektor zu verwenden und
multiplizieren Sie ihn mit der gewünschten Länge, wie im folgenden Beispiel gezeigt. Die
maximale Länge des Richtungsvektors beträgt 15.000 Studs.

Diese Methode verwendet **kein** `Datatype.Ray`-Objekt, aber seine Ursprung- und
Richtungsbestandteile können von `Datatype.Ray.Origin` und
`Datatype.Ray.Direction` entliehen werden.


WorldRoot:Raycast

origin

Der Richtungsvektor des Strahls. Beachten Sie, dass die Länge dieses Vektors
wichtig ist, da Teile/Terrain, die weiter entfernt sind als seine Länge, nicht getestet werden.


raycastParams

Ein Objekt, das verwendet wird, um die Berechtigung für Treffer in der Raycast-Operation anzugeben. Wenn
nicht bereitgestellt, werden Standardwerte verwendet, bei denen alle Teile berücksichtigt werden
und `Class.Terrain` Wasser nicht ignoriert wird.


Enthält die Ergebnisse einer Raycast-Operation oder `nil`, wenn kein berechtigtes
`Class.BasePart` oder `Class.Terrain` Zelle getroffen wurde.


Wirft einen Strahl mit einem Ursprung, einer Richtung und optionalen
`Datatype.RaycastParams` und gibt ein `Datatype.RaycastResult` zurück, wenn ein
berechtigtes Objekt oder Terrain den Strahl schneidet.


Registriert eine neue Kollisionsgruppe in dieser Welt mit dem angegebenen Namen. Der
Name kann nicht `"Default"` sein.

Beachten Sie, dass diese Methode einen leichten Leistungsaufwand basierend auf der
Anzahl der `Class.BasePart|BaseParts` in der Welt hat, daher wird empfohlen,
dass Sie alle Kollisionsgruppen zur Bearbeitungszeit über den Studio-
[Editor](/workspace/collisions#collision-groups) registrieren und
`Class.WorldRoot:UnregisterCollisionGroup()|UnregisterCollisionGroup()`
und `Class.WorldRoot:RenameCollisionGroup()|RenameCollisionGroup()` so selten wie möglich aufrufen.


WorldRoot:RegisterCollisionGroup

Registriert eine neue Kollisionsgruppe in dieser Welt mit dem angegebenen Namen.


Benennt die angegebene registrierte Kollisionsgruppe in dieser Welt um, ändert jedoch
**nicht** die `Class.BasePart.CollisionGroup|CollisionGroup`-Eigenschaft
 von Teilen, die die Gruppe verwenden. Das erste Argument dieser Methode ist der
Name der Gruppe, die umbenannt werden soll, das zweite Argument ist der neue Name für die
Gruppe. Wenn die angegebene Gruppe nicht existiert, wird diese Methode nichts tun.
Die Benennungsrichtlinien für den neuen Namen folgen denselben Regeln, als ob die Gruppe
mit `Class.WorldRoot:RegisterCollisionGroup()|RegisterCollisionGroup()` erstellt würde.

Diese Methode wirft einen Laufzeitfehler in den folgenden Umständen:

- Ungültiger oder leerer Name für eines der Argumente angegeben.
- Die Methode wird von einem Client aufgerufen.

Beachten Sie, dass diese Methode einen leichten Leistungsaufwand basierend auf der
Anzahl der `Class.BasePart|BaseParts` in der Welt hat, daher wird empfohlen,
dass Sie alle Kollisionsgruppen zur Bearbeitungszeit über den Studio-
[Editor](/workspace/collisions#collision-groups) registrieren und
sie so selten wie möglich umbenennen.


WorldRoot:RenameCollisionGroup

from

Benennt die angegebene Kollisionsgruppe in dieser Welt um.


Wirft die Form des gegebenen `Class.BasePart` in eine gegebene Richtung und
gibt die erste Kollision mit einem `Class.BasePart` oder `Class.Terrain`
Zelle zurück. Dies ist analog dazu, wie `Class.WorldRoot:Raycast()` einen linearen
Strahl in eine Richtung wirft, um eine Kollision zu finden, aber es verwendet eine 3D-Form anstelle von
 einem Strahl. Im Gegensatz zu `Class.WorldRoot:Blockcast()` und
`Class.WorldRoot:Spherecast()`, die eine einfache Box oder Kugel verwenden, wirft diese
Methode die tatsächliche Geometrie des bereitgestellten Teils.

Im Gegensatz zu `Class.WorldRoot:GetPartsInPart()` erkennt diese Methode keine
`Class.BasePart|BaseParts`, die **anfänglich** die Form überlappen.

Wenn ein Treffer erkannt wird, wird ein `Datatype.RaycastResult` zurückgegeben, das
 die Trefferinformationen enthält. Die `Datatype.RaycastResult.Distance|Distance`
Eigenschaft repräsentiert die Entfernung, die die Form zurücklegen muss, um einen Treffer zu finden,
und die `Datatype.RaycastResult.Position|Position`-Eigenschaft repräsentiert den
Schnittpunkt, der den Treffer verursacht.

Diese Methode wirft einen Fehler, wenn ihr ein nicht existierendes Teil, eine
ungültige Richtung oder ein Teil mit `Class.Terrain` Geometrie übergeben wird.


WorldRoot:Shapecast

Das Teil, dessen Form geworfen wird. Der Wurf verwendet die Geometrie dieses Teils
(Block, Ball, Mesh usw.) und die Größe; übermäßig große Teile werden möglicherweise
nicht unterstützt, und es kann kein `Class.Terrain` Teil sein.


Richtung des Formwurfs, wobei die Größe die maximale Entfernung darstellt, die die Form
 zurücklegen kann. Die maximale Entfernung beträgt 1024 Studs.


Ein Objekt, das verwendet wird, um die Berechtigung für Treffer in der Formwurf-Operation anzugeben.
Wenn nicht bereitgestellt, werden Standardwerte verwendet, bei denen alle anderen Teile
berücksichtigt werden und `Class.Terrain` Wasser nicht ignoriert wird. Das Teil, das
geworfen wird, wird immer von den Ergebnissen ausgeschlossen.


Enthält das Ergebnis der Formwurf-Operation oder `nil`, wenn kein berechtigtes
`Class.BasePart` oder `Class.Terrain` Zelle getroffen wurde.


Wirft die Form eines gegebenen `Class.BasePart` in eine Richtung und gibt ein
`Datatype.RaycastResult` zurück, wenn die Form einen `Class.BasePart` oder
`Class.Terrain` Zelle trifft.


Gibt eine Kugel aus und gibt die erste Kollision mit einem `Class.BasePart` oder
`Class.Terrain` zurück. Gibt die Eigenschaften des RaycastResult aus, wenn ein Ergebnis
getroffen wurde.

Wirft eine sphärische Form in eine gegebene Richtung und gibt die erste
Kollision mit einem `Class.BasePart` oder `Class.Terrain` Zelle zurück. Dies ist
analog dazu, wie `Class.WorldRoot:Raycast()` einen linearen Strahl in eine
Richtung wirft, um eine Kollision zu finden, aber es verwendet eine 3D-Form anstelle von
 einem Strahl.

Im Gegensatz zu `Class.WorldRoot:GetPartsInPart()` erkennt diese Methode keine
`Class.BasePart|BaseParts`, die **anfänglich** die Form überlappen.

Wenn ein Treffer erkannt wird, wird ein `Datatype.RaycastResult` zurückgegeben, das
 die Trefferinformationen enthält. Die `Datatype.RaycastResult.Distance|Distance`
Eigenschaft repräsentiert die Entfernung, die die Form zurücklegen muss, um einen Treffer zu finden,
und die `Datatype.RaycastResult.Position|Position`-Eigenschaft repräsentiert den
Schnittpunkt, der den Treffer verursacht.

Diese Methode wirft einen Fehler, wenn ihr ungültige Radius- oder Richtungswerte übergeben werden.


WorldRoot:Spherecast

Die Anfangsposition der geworfenen sphärischen Form.


Der Radius der geworfenen sphärischen Form in Studs. Der maximale Radius beträgt
256 Studs.


Ein Objekt, das verwendet wird, um die Berechtigung für Treffer in der Formwurf-Operation anzugeben.
Wenn nicht bereitgestellt, werden Standardwerte verwendet, bei denen alle Teile berücksichtigt werden
und `Class.Terrain` Wasser nicht ignoriert wird.


Wirft eine sphärische Form in eine gegebene Richtung und gibt ein
`Datatype.RaycastResult` zurück, wenn die Form einen `Class.BasePart` oder
`Class.Terrain` Zelle trifft.


Simuliert die Teile im Arbeitsbereich für einen festen Zeitraum, indem die
StepPhysics-Funktion einmal pro Frame aufgerufen wird, bis eine bestimmte Zeit vergangen ist.

Bewegt die Simulation für Teile in der Welt vorwärts basierend auf einem
spezifizierten Zeitinkrement und einer optionalen Menge von `Class.BasePart`. Wenn eine
Menge von Teilen angegeben wird, werden nur diese Teile simuliert und alle
anderen Teile in der Welt werden als verankert behandelt. Wenn dieses Argument
weggelassen wird, werden alle Teile in der Welt in die Simulation einbezogen.
Das angegebene Zeitinkrement kann jede positive Zahl sein, wobei größere
Werte die Laufzeit der Funktion erhöhen. Abhängig vom Wert des Zeitinkrements kann das
Physiksystem es in mehrere einzelne Schritte unterteilen, um die Genauigkeit und Stabilität der Simulation
aufrechtzuerhalten. Selbst wenn die Funktion mehrere Unterteilungen durchführt, werden die Ergebnisse der
Simulation erst sichtbar, wenn die Funktion abgeschlossen ist. Um die einzelnen Schritte einer Simulation zu visualisieren,
kann die Funktion einmal pro RenderStep über das `Class.RunService.RenderStepped`-Ereignis aufgerufen werden.


WorldRoot:StepPhysics

Die Menge an Zeit, die simuliert wird. Dieses Argument muss eine
positive Zahl sein. Größere Werte erhöhen die Laufzeit dieser
Funktion.


parts

Optionales Array von Teilen, die simuliert werden. Diese Menge muss Instanzen enthalten,
die vom Typ `Class.BasePart` sind; alle anderen Typen werden ignoriert.


Bewegt die Simulation für Teile in der Welt vorwärts basierend auf einem
spezifizierten Zeitinkrement und einer optionalen Menge von
`Class.BasePart|BaseParts`.


Registriert die Kollisionsgruppe für den angegebenen Namen in dieser Welt ab, mit den
folgenden Verhaltensweisen:

- Wenn ein ungültiger Name angegeben wird, wird die Methode nichts tun.
- Wenn der reservierte Name `"Default"` angegeben wird **oder** wenn die Methode
  von einem Client aufgerufen wird, wird ein Fehler ausgelöst.
- Wenn sich Teile in der Kollisionsgruppe befinden, wenn sie entfernt wird, behalten diese
  Teile weiterhin denselben Namen der Kollisionsgruppe. Das physikalische Verhalten von Teilen in einer entfernten Gruppe ist undefiniert, daher wird empfohlen,
  alle Teile in einer entfernten Gruppe in eine andere Gruppe zu verschieben, wie z. B. die
  Gruppe `"Default"`.

Beachten Sie, dass diese Methode einen leichten Leistungsaufwand basierend auf der
Anzahl der `Class.BasePart|BaseParts` in der Welt hat, daher wird empfohlen,
dass Sie alle Kollisionsgruppen zur Bearbeitungszeit über den Studio-
[Editor](/workspace/collisions#collision-groups) registrieren und diese
Methode so selten wie möglich aufrufen.


WorldRoot:UnregisterCollisionGroup

Registriert die Kollisionsgruppe für den angegebenen Namen in dieser Welt ab.


WorldRoot

Basis-Klasse zur Handhabung von Physiksimulation und 3D-Raumabfragen.

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 an zwei Teilen, die
Geschwister des Skripts sind (PartA und PartB). Es erstellt Gelenke an zwei berührenden
Teilen mit kompatiblen Oberflächentypen (Studs und Inlet).


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

Demonstriert `Class.Model:GetBoundingBox()`.


Diese Funktion gibt eine Beschreibung eines Volumens zurück, das alle `Class.BasePart`-Kinder innerhalb eines `Class.Model` enthält. Die Orientierung des Volumens basiert auf der Orientierung des `Class.Model.PrimaryPart|PrimaryPart` und entspricht der Auswahlbox, die im Studio gerendert wird, wenn das Modell ausgewählt ist. In Übereinstimmung mit dem Verhalten von `Class.Terrain:FillBlock()` gibt es ein `Datatype.CFrame` zurück, das das Zentrum dieser Begrenzungsbox darstellt, und ein `Datatype.Vector3`, das ihre 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 Begrenzungsbox 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.

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.

Model

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.

/reference/engine/classes/WorldModel.yaml