Gebruikt als opslag voor aangepaste Humanoid-statussen. Dit object zou officieel
gebruikt zijn in de RbxStatus-bibliotheek, maar blijft onafgemaakt.


Status

Een onafgemaakt object dat geen functionaliteit biedt aan ontwikkelaars.


Het volgende voorbeeld bevat een basisfunctie die een tabel van objecten neemt
en deze in een nieuw Model plaatst, waarbij dat Model wordt geretourneerd.


Modellen zijn containerobjecten, wat betekent dat ze objecten samenvoegen. Ze worden
het beste gebruikt om verzamelingen van `Class.BasePart|BaseParts` vast te houden en hebben een aantal
functies die hun functionaliteit uitbreiden.

Modellen zijn bedoeld om **geometrische** groeperingen weer te geven. Als je groepering geen
geometrische interpretatie heeft, bijvoorbeeld een verzameling van
`Class.Script|Scripts`, gebruik dan in plaats daarvan een `Class.Folder`.

Modellen waarvan de samenstellende delen met gewrichten aan elkaar zijn verbonden (zodat ze
kunnen bewegen of via fysicasimulatie kunnen worden vernietigd) hebben meestal een
`Class.Model.PrimaryPart|PrimaryPart` ingesteld, omdat dit aangeeft welk deel binnen
the model de pivot en de begrenzingsdoos zal "volgen" terwijl het model beweegt. Statische
modellen die op één plek blijven, profiteren niet van het instellen van een primaire part.

Modellen hebben een breed scala aan toepassingen, waaronder Roblox-spelerpersonages.
Ze hebben ook een aantal unieke gedragingen die belangrijk zijn om in gedachten te houden:

- Wanneer een `Class.Humanoid` en een `Class.Part` genaamd **Head** onder
  een model zijn geparent, verschijnt er een naam/gezondheids-GUI boven het model; zie
  [Karakter Naam/Gezondheid Weergave](/characters/name-health-display)
  voor details.
- Als de positie van een deel op de **Y**-as de
  `Class.Workspace.FallenPartsDestroyHeight` waarde bereikt, en het was het laatste object
  binnen een `Class.Model`, zal het model ook worden vernietigd.
- Wanneer gebruikt in een plaats met `Class.Workspace.StreamingEnabled` ingesteld op true,
  controleert de waarde van `Class.Model.ModelStreamingMode|ModelStreamingMode`
  verschillende gedragingen rond hoe het model en eventuele afstammelingen worden gerepliceerd
  en/of verwijderd van clients. Bovendien heeft de waarde van
  `Class.Model.LevelOfDetail|LevelOfDetail` invloed op de rendering van het model.

Zoals bij alle `Class.Instance`-typen, garandeert het feit dat een ouder `Class.Model` is
gerepliceerd naar een client niet dat al zijn kinderen zijn
gerepliceerd. Dit is bijzonder belangrijk als deze instanties worden
benaderd door code die op de client draait, zoals in een `Class.LocalScript`.
Het gebruik van `Class.Model.ModelStreamingMode|ModelStreamingMode` met waarden zoals
`Enum.ModelStreamingMode|Atomic` kan ervoor zorgen dat het hele model en al zijn
afstammelingen aanwezig zijn als het oudermodel op de client bestaat, of je
kunt `Class.Instance:WaitForChild()|WaitForChild()` gebruiken wanneer atomiciteit niet
gewenst is.


Stelt dit model in om persistent te zijn voor de opgegeven speler. Persistente
modellen blijven aanwezig voor de speler, ongeacht streaminginstellingen of
voorwaarden.

`Class.Model.ModelStreamingMode|ModelStreamingMode` moet worden ingesteld op
`Enum.ModelStreamingMode|PersistentPerPlayer` om het gedrag te wijzigen
als gevolg van toevoeging.


Model:AddPersistentPlayer

playerInstance

De `Class.Player` waarvoor dit model persistent moet zijn.


Stelt dit model in om persistent te zijn voor de opgegeven speler.
`Class.Model.ModelStreamingMode|ModelStreamingMode` moet worden ingesteld op
`Enum.ModelStreamingMode|PersistentPerPlayer` om het gedrag te wijzigen
als gevolg van toevoeging.


In dit voorbeeld zullen de gewrichten in elk Player karaktermodel worden gebroken
3 seconden na het spawnen. Het breken van deze gewrichten zal ervoor zorgen dat de Humanoid
doodgaat.


Dit codevoorbeeld demonstreert de handmatige creatie van joints op twee onderdelen die
broers van het script zijn (PartA en PartB). Het creëert een joint op twee aangrenzende
onderdelen met compatibele oppervlaktetypes (Studs en Inlet).


Breekt verbindingen tussen `BaseParts`, inclusief oppervlakteverbindingen met
alle aangrenzende delen, `Class.WeldConstraint|WeldConstraints`, en alle
`Class.Weld|Welds` en andere `Class.JointInstance|JointInstances`.

Wanneer BreakJoints wordt gebruikt op een spelerkarakter `Class.Model`, zal de
`Class.Humanoid` van het karakter sterven omdat deze afhankelijk is van het nekgewricht.

Let op dat hoewel gewrichten die door oppervlakteverbindingen met aangrenzende
Delen zijn geproduceerd technisch opnieuw kunnen worden aangemaakt met `Class.Model:MakeJoints()`, dit
zal alleen gewrichten recreëren die door oppervlakken zijn geproduceerd. Ontwikkelaars moeten hier niet op vertrouwen
omdat de delen die worden gebroken mogelijk niet meer in contact zijn met elkaar.


Model:BreakJoints

Breekt verbindingen tussen `BaseParts`, inclusief oppervlakteverbindingen met
alle aangrenzende delen, `Class.WeldConstraint|WeldConstraints` en alle
`Class.Weld|Welds` en andere `Class.JointInstance|JointInstances`.


Model:breakJoints

Demonstrates `Class.Model:GetBoundingBox()`.


Deze functie geeft een beschrijving van een volume dat alle
`Class.BasePart`-kinderen binnen een `Class.Model` bevat. De oriëntatie van het volume
is gebaseerd op de oriëntatie van de `Class.Model.PrimaryPart|PrimaryPart`,
en komt overeen met de selectiebox die in Studio wordt weergegeven wanneer het model is
geselecteerd. Het spiegelt het gedrag van `Class.Terrain:FillBlock()`, het
geeft een `Datatype.CFrame` terug die het centrum van die begrenzingsdoos vertegenwoordigt
en een `Datatype.Vector3` die de grootte vertegenwoordigt. De grootte kan onnauwkeurig zijn
bij runtime als fysica-beperkingen van invloed zijn op de delen binnen de
`Class.Model`.

De oriëntatie van de begrenzingsdoos komt overeen met de oriëntatie van de
`Class.PVInstance.GetPivot|Pivot` - ofwel de pivot van de
`Class.Model.PrimaryPart|PrimaryPart` (indien aanwezig) of de
`Class.Model.WorldPivot|WorldPivot` van het model.


Model:GetBoundingBox

Een `Datatype.CFrame` die de oriëntatie van het volume vertegenwoordigt
gevolgd door een `Datatype.Vector3` die de grootte van het volume vertegenwoordigt.


Geeft een beschrijving van een volume dat alle delen van een Model bevat.


De onderstaande codevoorbeeld toont aan hoe Model.GetExtentsSize kan worden gebruikt om
de grootte van de omhullende doos die de onderdelen bevat te krijgen.


Geeft de grootte van de kleinste begrenzingsdoos terug die alle
`Class.BasePart|BaseParts` in de `Class.Model` bevat. De oriëntatie komt overeen
met de oriëntatie van de `Class.PVInstance.GetPivot|Pivot` - ofwel de
pivot van de `Class.Model.PrimaryPart|PrimaryPart` (indien aanwezig) of de
`Class.Model.WorldPivot|WorldPivot` van het model.

Let op dat deze functie alleen de grootte van de kleinste begrenzingsdoos retourneert, en
de ontwikkelaar zijn eigen methode moet gebruiken om de positie van de
begrenzingsdoos te verkrijgen.


Model:GetExtentsSize

De `Datatype.Vector3` extentsgrootte van de `Class.Model`.


Geeft de grootte van de kleinste begrenzingsdoos terug die alle
`Class.BasePart|BaseParts` in de `Class.Model` bevat, uitgelijnd met de
`Class.Model.PrimaryPart` als deze is ingesteld.


Deze waarde gaf historisch gezien de CFrame van een centrale positie in het
model terug.


Model:GetModelCFrame

Een `Datatype.CFrame` die een centrale positie in het model vertegenwoordigt.


Deze code zou een model creëren, er enkele onderdelen in plaatsen, ze willekeurig positioneren,
en vervolgens de grootte afdrukken:


De GetModelSize-functie geeft de `Datatype.Vector3`-grootte van de
`Class.Model` terug.


Model:GetModelSize

De `Datatype.Vector3`-grootte van de `Class.Model`.


Geeft de Vector3-grootte van het Model terug.


Wanneer deze methode wordt aangeroepen vanuit een `Class.Script`, geeft deze alle
`Class.Player`-objecten terug waarvoor dit model persistent is. Wanneer aangeroepen vanuit
een `Class.LocalScript`, controleert deze methode alleen of dit model persistent is
voor de `Class.Players.LocalPlayer|LocalPlayer`.


Model:GetPersistentPlayers

Een tabel met alle `Class.Player`-objecten waarvoor dit modelobject
persistent is.


Geeft alle `Class.Player`-objecten terug waarvoor dit modelobject
persistent is. Gedrag varieert afhankelijk van of deze methode wordt aangeroepen
uit een `Class.Script` of een `Class.LocalScript`.


De volgende code demonstreert hoe GetPrimaryPartCFrame en
SetPrimaryPartCFrame kunnen worden gebruikt om een model te draaien.

Een eenvoudig model wordt gemaakt in de Workspace en er wordt een lus gestart die het model
10 graden rond de Y-as draait elke 0,2 seconden.


Deze functie is vervangen door `Class.PVInstance:GetPivot()` die
fungeert als een vervangende en de gedrag van je code niet verandert. Gebruik
`Class.PVInstance:GetPivot()` voor nieuw werk en migreer je bestaande
`Class.Model:GetPrimaryPartCFrame()` aanroepen wanneer het uitkomt.

Geeft de `Datatype.CFrame` van het `Class.Model.PrimaryPart` van het model terug.

Deze functie is gelijk aan het volgende.

    Model.PrimaryPart.CFrame

Let op dat deze functie een fout genereert als er geen primaire part bestaat voor de
`Class.Model`. Als dit gedrag niet gewenst is, kunnen ontwikkelaars het volgende doen,
wat gelijk zal zijn aan `nil` als er geen primaire part is.

    local cFrame = Model.PrimaryPart en Model.PrimaryPart.CFrame


Model:GetPrimaryPartCFrame

De `Datatype.CFrame` van het `Class.Model.PrimaryPart` van het model.


Geeft de `Datatype.CFrame` van het `Class.Model.PrimaryPart` van het model terug.
Deze functie genereert een fout als er geen primaire part bestaat voor de
`Class.Model`.


Dit codevoorbeeld demonstreert het substitueren van een vervanging voor alle kopieën
van een boommodel met behulp van `Class.Model:PivotTo()` en `Class.Model:ScaleTo()`. De
pivot en schaal van de modellen worden gebruikt als referentie om ervoor te zorgen dat de
relatieve maten en locaties van de vervangmodellen overeenkomen met die van de
originele modellen.


Modellen bevatten een persistente canonieke schaalfactor, die begint bij 1
voor nieuw gecreëerde modellen en verandert naarmate het model wordt geschaald door
`Class.Model:ScaleTo()` aan te roepen. Deze functie geeft de huidige canonieke schaal
factor van het model terug.

De huidige schaalfactor heeft geen _directe_ invloed op de grootte van instanties
onder het model. Het wordt gebruikt voor contentcreatie en scriptingdoeleinden
om te onthouden hoe het model is geschaald ten opzichte van zijn originele grootte.

Binnen een gegeven sessie zal het model de precieze originele grootte-informatie van de afstammelingen
instanties cachen na de eerste
`Class.Model:ScaleTo()` aanroep. Dit betekent dat het aanroepen van
`Class.Model:ScaleTo()|ScaleTo(x)` gevolgd door
`Class.Model:ScaleTo()|ScaleTo(1)` je precies terug zal krijgen naar de
originele configuratie van het model zonder drijvende puntafwijking. Het vermijden van
drijvende puntafwijking is de motivatie voor het hebben van een Scale**To** functie
in plaats van een Scale**By** functie.

De schaalfactor heeft op één manier invloed op het gedrag van de engine: De schaalfactor
van een model zal worden toegepast op gewrichtsafstanden van
`Class.Animation|Animations` die worden afgespeeld op een `Class.AnimationController`
onder dat model, zodat geanimeerde rigs correct animaties kunnen afspelen, zelfs wanneer ze zijn geschaald.


Model:GetScale

De huidige canonieke schaalfactor van het model.


Geeft de canonieke schaal van het model terug, die standaard 1 is voor nieuw
gecreëerde modellen en zal veranderen naarmate het wordt geschaald via
`Class.Model:ScaleTo()`.


Dit codevoorbeeld demonstreert hoe gewrichten kunnen worden gemaakt met de
Model:MakeJoints functie.

Een model wordt aangemaakt, met twee delen bovenop elkaar. Het bovenste deel is
geankerd en het onderste deel niet. Normaal gesproken zou het onderste deel vallen
naar de Basisplaat wanneer het aan de Workspace is gekoppeld.

Echter, omdat de TopSurface-eigenschap van het onderste deel is ingesteld op
Enum.SurfaceType.Weld, betekent dit dat wanneer Model:MakeJoints wordt uitgevoerd,
een verbinding tussen hen wordt gemaakt.

Daarom valt het onderste deel niet totdat de gewrichten in het model zijn
gebroken. Dit wordt vaak gedaan met Model:BreakJoints, maar in dit voorbeeld wordt de
verbinding verbroken met een explosie.


Dit codevoorbeeld demonstreert de creatie van joints op twee onderdelen die
broers van het script zijn (PartA en PartB). Het gebruikt MakeJoints op twee
aanrakende onderdelen met compatibele oppervlaktypes (Studs en Inlet).


Op basis van SurfaceType verbinden is verouderd. Gebruik MakeJoints niet voor nieuwe
projecten. Gebruik in plaats daarvan `Class.WeldConstraint|WeldConstraints` en
`Class.HingeConstraint|HingeConstraints`.

Doorloopt alle `Class.BasePart|Parts` in de `Class.Model` en creëert
verbindingen tussen de opgegeven delen en alle vlakke aanrakende oppervlakken,
afhankelijk van de oppervlakken van de delen.

- Gladde oppervlakken zullen geen gewrichten creëren
- Lijmoppervlakken zullen een `Class.Glue`-gewricht creëren
- Lassen zullen een `Class.Weld`-gewricht creëren met elk oppervlak behalve voor
  Unjoinable
- Studs, Inlaat of Universeel zullen elk een `Class.Snap`-gewricht creëren met
  een van de andere twee oppervlakken (bijv. Studs met Inlaat en
  Universeel)
- Scharnier- en motoroppervlakken creëren `Class.Rotate` en `Class.RotateV`-gewricht
  instanties

Deze functie werkt niet als het deel geen afstammeling is van
`Class.Workspace`. Daarom moet je eerst ervoor zorgen dat het model aan
Workspace is geparent voordat je MakeJoints gebruikt.


Model:MakeJoints

Doorloopt alle `Class.BasePart|BaseParts` in de `Class.Model`. Als de zijde van een
deel een SurfaceType heeft dat een gewricht kan maken, zal het een gewricht
creëren met alle aangrenzende delen.


Model:makeJoints

Model:move

location

Dit voorbeeld demonstreert hoe `Class.Model:MoveTo()` botsingen voorkomt.

Een eenvoudig twee-delig `Class.Model` wordt gemaakt, en zijn `Class.Model.PrimaryPart`
wordt ingesteld. Een grote obstructie deel wordt ernaast geplaatst.

Na 5 seconden wordt `Class.Model:MoveTo()` gebruikt om het model te sturen om te bewegen
binnen de obstructie deel. Echter, omdat MoveTo een model niet binnen
van een obstructie zal verplaatsen, wordt het `Class.Model` omhoog verplaatst op de Y-as en boven
de obstructie geplaatst.


Verplaatst de `Class.Model.PrimaryPart|PrimaryPart` naar de opgegeven positie. Als
er geen primaire part is opgegeven, wordt het rootdeel van het model gebruikt,
maar het rootdeel is niet deterministisch en het wordt aanbevolen dat
je altijd een primaire part instelt bij het gebruik van `Class.Model:MoveTo()|MoveTo()`.

Als er obstakels zijn waar het model naartoe moet worden verplaatst, zoals
`Class.Terrain` of andere `Class.BasePart|BaseParts`, zal het model
verticaal omhoog worden verplaatst totdat er niets in de weg staat. Als dit
gedrag niet gewenst is, moet `Class.PVInstance:PivotTo()` in plaats daarvan worden gebruikt.

Let op dat de rotatie niet behouden blijft bij het verplaatsen van een model met
`Class.Model:MoveTo()|MoveTo()`. Het wordt aanbevolen om ofwel
`Class.Model:TranslateBy()|TranslateBy()` of `Class.PVInstance:PivotTo()` te gebruiken
als de huidige rotatie van het model moet worden behouden.


Model:MoveTo

position

De `Datatype.Vector3` waarheen het `Class.Model` wordt verplaatst.


Verplaatst de `Class.Model.PrimaryPart|PrimaryPart` naar de opgegeven positie. Als
er geen primaire part is opgegeven, wordt het rootdeel van het model gebruikt.


Model:moveTo

Maakt dit model niet langer persistent voor de opgegeven speler. Dit garandeert
niet dat het model onmiddellijk voor de speler zal worden verwijderd; na
het aanroepen van deze methode, zal het model worden behandeld als
`Enum.ModelStreamingMode|Atomic` voor die speler en zal het aanwezig blijven
zolang het binnen de doelstreamingradius is.

`Class.Model.ModelStreamingMode|ModelStreamingMode` moet worden ingesteld op
`Enum.ModelStreamingMode|PersistentPerPlayer` om het gedrag te wijzigen
als gevolg van verwijdering.


Model:RemovePersistentPlayer

De `Class.Player` waarvoor dit model niet langer persistent moet zijn.


Maakt dit model niet langer persistent voor de opgegeven speler.
`Class.Model.ModelStreamingMode|ModelStreamingMode` moet worden ingesteld op
`Enum.ModelStreamingMode|PersistentPerPlayer` om het gedrag te wijzigen
als gevolg van verwijdering.


Reset de rotatie van de delen van het model naar de eerder ingestelde identiteit
rotatie, wat gebeurt via de `Class.Model:SetIdentityOrientation()`
functie.


Model:ResetOrientationToIdentity

Modellen bevatten een persistente canonieke schaalfactor, die begint bij 1
voor nieuw gecreëerde modellen. Deze functie schaalt het model, rond de pivot
locatie, ten opzichte van hoe het eruit zou zien bij een schaalfactor van 1. Om
dit te bereiken doet het twee dingen:

- Stelt de huidige schaalfactor van het model in op de opgegeven waarde
- Wijzigt de grootte en positie van alle afstammelingen instanties dienovereenkomstig

De schaling van locaties gebeurt rond de pivot locatie.

Alle "geometrische" eigenschappen van afstammelingen instanties zullen worden geschaald. Dat
omvat uiteraard de groottes van delen, maar hier zijn enkele andere voorbeelden van
eigenschappen die worden geschaald:

- De lengte van gewrichten zoals `Class.WeldConstraint|WeldConstraints`, en
  `Class.RopeConstraint`
- Fysieke snelheden en krachten zoals `Class.HingeConstraint`
- Visuele eigenschappen zoals groottes van deeltjesemitteren
- Andere lengteeigenschappen zoals `Class.Sound.RollOffMinDistance`


Model:ScaleTo

newScaleFactor

De nieuwe schaalfactor voor het model, die een positieve niet-nul
getal moet zijn. Een waarde van 1 vertegenwoordigt de oorspronkelijke grootte van het model.


Stelt de schaalfactor van het model in, waarbij de grootte en locatie van
alle afstammelingen instanties worden aangepast zodat ze die schaalfactor hebben ten opzichte van
hun oorspronkelijke grootte en locaties toen de schaalfactor 1 was.


Stelt de identiteitrotatie van het gegeven model in, zodat je later de
rotatie van het gehele model kunt resetten, via het gebruik van de
`ResetOrientationToIdentity` functie.


Model:SetIdentityOrientation

Deze functie is vervangen door `Class.PVInstance:PivotTo()` die
fungeert als een meer prestatiegerichte vervanging en de gedrag van je code niet verandert. Gebruik
`Class.PVInstance:PivotTo()` voor nieuw werk en migreer je
bestaande `Class.Model:SetPrimaryPartCFrame()` aanroepen wanneer het uitkomt.

Stelt de `Class.BasePart.CFrame` van het primaire deel van het model in.
Alle andere delen in het model zullen ook worden verplaatst en zullen hun
oriëntatie en offset ten opzichte van de `Class.Model.PrimaryPart` behouden.

Let op, deze functie genereert een fout als er geen `Class.Model.PrimaryPart`
bestaat voor het model. Dit kan problemen veroorzaken als, bijvoorbeeld, de primaire
part nooit is ingesteld of is vernietigd.


Model:SetPrimaryPartCFrame

cframe

De `Datatype.CFrame` die moet worden ingesteld.


Stelt de `Class.BasePart.CFrame` van het primaire deel van het model in.
Alle andere delen in het model zullen ook worden verplaatst en zullen hun
oriëntatie en offset ten opzichte van de `Class.Model.PrimaryPart` behouden.


Dit voorbeeld demonstreert hoe `Class.Model:TranslateBy()` botsingen negeert
en de oriëntatie van het model respecteert.

Een eenvoudig twee-delig `Class.Model` wordt gemaakt, 45 graden gedraaid op de Y-as,
en zijn `Class.Model.PrimaryPart` wordt ingesteld. Een grote obstructie deel wordt geplaatst
naast het model.

Na 5 seconden wordt `Class.Model:TranslateBy()` gebruikt om het model te
sturen om binnen het obstructie deel te bewegen. Het model zal binnen de
obstructie bewegen en zijn huidige oriëntatie behouden.


Verschuift een `Class.Model` met de gegeven `Datatype.Vector3` offset, waarbij
de oriëntatie van het model behouden blijft. Als er al een andere `Class.BasePart` of `Class.Terrain`
bestaat op de nieuwe positie, dan zal de `Class.Model` dat object overlappen.

De vertaling wordt toegepast in wereldruimte in plaats van objectruimte,
wat betekent dat zelfs als de delen van het model anders zijn georiënteerd, het nog steeds
langs de standaardassen zal bewegen.


Model:TranslateBy

delta

De `Datatype.Vector3` waarmee het `Class.Model` wordt verplaatst.


Verschuift een `Class.Model` met de gegeven `Datatype.Vector3` offset, waarbij
de oriëntatie van het model behouden blijft. Als er al een andere `Class.BasePart` of `Class.Terrain`
bestaat op de nieuwe positie, dan zal de `Class.Model` dat object overlappen.


Model

Stelt het detailniveau van het model in voor ervaringen met instanties
[streaming](/workspace/streaming) ingeschakeld. Composiet- of
imposter-meshes ondersteunen geen fysica, botsingsdetectie of
raycasting.

Wanneer ingesteld op `Enum.ModelLevelOfDetail|StreamingMesh`, wordt een lagere resolutie
"imposter" mesh (gekleurd, grof mesh dat om alle kinddelen van
the model wikkelt) gerenderd buiten de streamingradius. Ondersteunt geen
texturen.

Wanneer ingesteld op `Enum.ModelLevelOfDetail|SLIM`, wordt een **SLIM** model (Schaalbare
Lichte Interactieve Model) een samenstelling van alle kinddelen gerenderd op
progressief lagere resoluties op afstanden op basis van de streamingradius. Dit verbetert de visuele kwaliteit aanzienlijk ten opzichte van
`Enum.ModelLevelOfDetail|StreamingMesh`.

Wanneer ingesteld op `Enum.ModelLevelOfDetail|Disabled` of
`Enum.ModelLevelOfDetail|Automatic`, worden lagere resolutie meshes niet weergegeven.


Model.LevelOfDetail

Stelt het detailniveau van het model in voor ervaringen met instanties
streaming ingeschakeld.


Beheert hoe `Class.Model|Models` worden gestreamd in en uit wanneer instanties
[streaming](/workspace/streaming) is ingeschakeld. Gedrag
hangt af van de geselecteerde enum. Heeft geen effect wanneer streaming niet is ingeschakeld.

Deze eigenschap mag alleen in Studio worden gewijzigd via het
[Properties](/studio/properties) venster wanneer streaming is
ingeschakeld, of in `Class.Script|Scripts`, maar nooit in
`Class.LocalScript|LocalScripts` (dit kan resulteren in ongedefinieerd
gedrag).


Model.ModelStreamingMode

Beheert het model streaminggedrag op `Class.Model|Models` wanneer
instanties streaming is ingeschakeld.


Dit codevoorbeeld maakt en gooit een dobbelsteenmodel, en geeft vervolgens aan of het
met de blauwe kant naar boven is geland. Als `Class.Model.PrimaryPart` niet was ingesteld,
zou de pivot / bounding box van de dobbelsteen draaien, omdat de onderdelen erin
fysiek worden gesimuleerd tijdens de worp.


Verwijst naar het primaire deel van de `Class.Model`. Het primaire deel is de
`Class.BasePart` die fungeert als de fysieke referentie voor de pivot van het
model. Dat wil zeggen, wanneer delen binnen het model worden verplaatst door fysicasimulatie of andere middelen, zal de pivot synchroon bewegen met het primaire
deel.

Let op dat `Class.Model|Models` standaard geen `PrimaryPart` ingesteld hebben.
Als je een model maakt dat door fysica moet worden beïnvloed, moet je
handmatig deze eigenschap instellen in Studio of binnen een script. Als het
primaire deel **niet** is ingesteld, blijft de pivot op dezelfde locatie in
wereldruimte, zelfs als delen binnen het model worden verplaatst.

Let ook op dat bij het instellen van deze eigenschap, het een `Class.BasePart`
moet zijn dat een afstammeling van het model is. Als je probeert om
`Class.Model.PrimaryPart` in te stellen op een `Class.BasePart` die **niet** een
afstammeling van het model is, wordt het op dat deel ingesteld maar opnieuw op `nil`
gezet tijdens de volgende simulatiestap &mdash; dit is legacygedrag om
scripts te ondersteunen die aannemen dat ze tijdelijk het primaire deel kunnen instellen op een
`Class.BasePart` dat geen afstammeling van het model is.

De algemene regel voor modellen is dat:

- Modellen waarvan de delen via fysieke gewrichten zoals
  `Class.WeldConstraint|WeldConstraints` of `Class.Motor6D|Motor6Ds`
  aan elkaar zijn verbonden, een primaire part toegewezen moeten hebben. Bijvoorbeeld, Roblox-personagemodellen hebben hun `Class.Model.PrimaryPart` standaard ingesteld op de
  **HumanoidRootPart**.
- Statische (meestal `Class.BasePart.Anchored|Anchored`) modellen die op
  één plek blijven, tenzij een script ze expliciet verplaatst, hebben geen
  `Class.Model.PrimaryPart` nodig en profiteren meestal niet van het instellen van een.


Model.PrimaryPart

Het primaire deel van de `Class.Model`, of `nil` als niet expliciet ingesteld.


Het instellen van deze eigenschap in het Properties-venster zal het model schalen alsof
`Class.Model:ScaleTo()` op het model is opgeroepen, waarbij alle afstammelingen
instanties in het model, zoals materialen, afbeeldingen en de 3D-geometrie van
delen, worden geschaald zodat het model de opgegeven schaalfactor heeft ten opzichte van zijn
originele grootte.

Deze eigenschap is alleen beschikbaar in Studio en zal een fout genereren als deze
wordt gebruikt in een `Class.Script` of `Class.LocalScript`. `Class.Model:ScaleTo()` en
`Class.Model:GetScale()` moeten vanuit scripts worden gebruikt.


Model.Scale

Editor-only eigenschap die wordt gebruikt om het model rond zijn pivot te schalen. Het instellen
van deze eigenschap zal de schaal verplaatsen alsof `Class.Model:ScaleTo()` op het model is
opgeroepen.


Dit codevoorbeeld toont een aangepaste functie voor het resetten van de pivot van een model
terug naar het midden van de begrenzingsdoos van dat model.


Deze eigenschap bepaalt waar de pivot van een `Class.Model` die
**niet** een ingevoerde `Class.Model.PrimaryPart` heeft, zich bevindt. Als de
`Class.Model` **wel** een `Class.Model.PrimaryPart|PrimaryPart` heeft, is de
pivot van de `Class.Model` gelijk aan de pivot van dat primaire deel
in plaats daarvan, en deze `Class.Model.WorldPivot|WorldPivot` eigenschap wordt genegeerd.

Voor een nieuw aangemaakt `Class.Model` wordt de pivot behandeld als het centrum
van de begrenzingsdoos van zijn inhoud totdat de **eerste keer** zijn
`Class.Model.WorldPivot` eigenschap is ingesteld. Zodra de wereldpivot voor
de eerste keer is ingesteld, is het onmogelijk om dit initiële gedrag te herstellen.

Meestal zal het verplaatsen van het model met de Studio-tools, of met model
verplaatsingsfuncties zoals `Class.PVInstance:PivotTo()` en
`Class.Model:MoveTo()`, de wereldpivot instellen en dus dit nieuwe
modelgedrag beëindigen.

Het doel van dit gedrag is om Luau-code in staat te stellen een zinvolle pivot te krijgen
simply door een nieuw model te maken en objecten eraan te parenten, waardoor de
noodzaak om elke keer dat je een model in code maakt `Class.Model.WorldPivot`
expliciet in te stellen, wordt vermeden.


Model.WorldPivot

Bepaalt waar de pivot van een `Class.Model` die **niet** een
ingevoerde `Class.Model.PrimaryPart` heeft, zich bevindt.


Modellen zijn containerobjecten, wat betekent dat ze objecten samenvoegen. Ze worden
het beste gebruikt om verzamelingen van `Class.BasePart|BaseParts` vast te houden en hebben een aantal
functies die hun functionaliteit uitbreiden.


Een `Class.PVInstance` is een abstracte klasse die niet kan worden aangemaakt. Het is de
basis voor alle objecten die een fysieke locatie in de wereld hebben.


Dit codevoorbeeld is een eenvoudig teleportatiescript dat je personage
10&nbsp;studs vooruit verplaatst in de richting waarin je momenteel kijkt wanneer je de
<kbd>F</kbd> toets indrukt. Dit gebeurt door de huidige pivot te verkrijgen met
`Class.PVInstance:GetPivot()` en `PVInstance|PivotTo` aan te roepen om het
personage vooruit te verplaatsen.


Deze functie krijgt de pivot van een `Class.PVInstance`. Dit wordt vaak gebruikt
met `Class.PVInstance:PivotTo()` om een model te verplaatsen.

`Class.Model|Models` en `Class.BasePart|BaseParts` zijn beide
`Class.PVInstance|PVInstances` ("Position Velocity Instances") en hebben dus beide
deze functie.


PVInstance:GetPivot

De wereldruimte `Datatype.CFrame` van de pivot van de instantie.


Krijgt de pivot van een `Class.PVInstance`.


Transformeert de `Class.PVInstance` samen met al zijn afgeleide
`Class.PVInstance|PVInstances` zodat de pivot nu is gelegen op de
opgegeven `Datatype.CFrame`. Dit is de primaire functie die moet worden
gebruikt om `Class.Model|Models` via scripting te verplaatsen.

`Class.BasePart|BaseParts` worden op deze manier verplaatst door hun
`Datatype.CFrame` te transformeren met de benodigde offset.
`Class.Model|Models` worden op deze manier verplaatst door hun
`Class.Model.WorldPivot` te transformeren met de benodigde offset.

Let op dat om efficiëntie redenen, `Class.Object.Changed`-evenementen niet
worden geactiveerd voor `Class.BasePart.Position|Position` en
`Class.BasePart.Orientation|Orientation` van `Class.BasePart|BaseParts`
die op deze manier zijn verplaatst; ze worden alleen geactiveerd voor `Datatype.CFrame`.

Bij het aanroepen van `Class.PVInstance:PivotTo()|PivotTo` op `Class.Model|Models`,
worden de offsets van de afgeleide onderdelen en modellen gecached, zodat
volgende aanroepen naar `Class.PVInstance:PivotTo()|PivotTo` op hetzelfde model
geen drijving van de floating point accumuleren tussen de onderdelen die het
model vormen.

`Class.Model|Models` en `Class.BasePart|BaseParts` zijn beide
`Class.PVInstance|PVInstances` ("Position Velocity Instances") en hebben dus beide
deze functie.


PVInstance:PivotTo

targetCFrame

De `Datatype.CFrame` die de pivot van de `Class.PVInstance` moet gelijk zijn
na het verplaatsen ervan.


Transformeert de `Class.PVInstance` samen met al zijn afgeleide
`Class.PVInstance|PVInstances` zodat de pivot nu is gelegen op de
opgegeven `Datatype.CFrame`.


PVInstance

Alleen voor de editor; eigenschap, weergegeven in het Studio Properties-venster als **Oorsprong
Positie** en **Oorsprong Oriëntatie** onder **Transform**. De waarde is
de wereldruimte `Datatype.CFrame` van de pivot van de instantie; het lezen ervan
geeft dezelfde `Datatype.CFrame` terug als `Class.PVInstance:GetPivot()`. Het
heeft geen opgeslagen waarde en weerspiegelt altijd de huidige pivot.

Het instellen vanuit het Properties-venster verplaatst de hele instantie zodat de
pivot op de nieuwe `Datatype.CFrame` komt, net als
`Class.PVInstance:PivotTo()`. Bewerken via het Properties-venster
deactiveert tijdelijk `Class.WeldConstraint|WeldConstraints` naar andere
objecten voor de verplaatsing; `PivotTo` wijzigt geen gewrichten.

Niet beschikbaar voor scripts; gebruik `Class.PVInstance:GetPivot()` en
`Class.PVInstance:PivotTo()` tijdens runtime in plaats daarvan.


PVInstance.Origin

Alleen voor de editor; eigenschap die de wereld `Datatype.CFrame` van de
pivot van de `Class.PVInstance` leest en instelt, waarbij de hele instantie wordt verplaatst
wanneer deze vanuit het Studio Properties-venster wordt gewijzigd.


Alleen voor de editor; eigenschap, weergegeven in het Studio Properties-venster als **Pivot
Positie** en **Pivot Oriëntatie** onder **Pivot**. Het is de
`Datatype.CFrame` van de pivot ten opzichte van het eigen frame van de instantie.

Het wijzigen vanuit het Properties-venster verplaatst de pivot ten opzichte van de
instantie terwijl de instantie op zijn plaats blijft, in tegenstelling tot `Oorsprong`, dat
de hele instantie verplaatst. Voor een `Class.BasePart` is de offset standaard de
identiteit `Datatype.CFrame`, zodat de pivot samenvalt met het midden van het onderdeel.
Voor een `Class.Model` verschijnt deze eigenschap alleen wanneer het model een
`Class.Model.PrimaryPart|PrimaryPart` heeft; het weerspiegelt en bewerkt dan de
`Class.BasePart.PivotOffset|PivotOffset` van dat onderdeel, en
`Class.Model:GetPivot()` is een alias voor de pivot van het primaire onderdeel.

Niet beschikbaar voor scripts; scripts lezen en schrijven de equivalente waarde via
de concrete klasse, zoals `Class.BasePart.PivotOffset`.


PVInstance.Pivot Offset

Alleen voor de editor; eigenschap die de `Datatype.CFrame` van de pivot
weergeeft en bewerkt ten opzichte van de instantie, waarbij alleen de pivot wordt verplaatst
en de instantie op zijn plaats blijft.


Abstracte klasse voor alle objecten die een fysieke locatie in de wereld hebben.


`Instance` is de basis klasse voor alle klassen in de Roblox klasse hiërarchie
waarvan de onderdelen deel kunnen uitmaken van de `Class.DataModel` boom.

Het is niet mogelijk om direct root `Instance` objecten te creëren, maar de speciale
`Datatype.Instance.new()` constructor creëert objecten via code, waarbij de
naam van de klasse als parameter wordt genomen en het gemaakte object wordt
teruggegeven.


Toont aan hoe veranderingen in de afstamming van een instantie kunnen worden gedetecteerd door verbinding te maken met het
`Class.Instance.AncestryChanged`-evenement.

De Parent van de ChangingPart wordt in de loop van de tijd op verschillende waarden ingesteld. De ouder van
de part is de voorouder van de part, dus het `Class.Instance.AncestryChanged`-evenement
zal worden geactiveerd telkens wanneer het verandert.


Wordt geactiveerd wanneer deze instantie opnieuw wordt gepaard of wanneer een van zijn voorouders wordt
gepaard.

Je kunt dit evenement gebruiken om de verwijdering van een instantie in Studio bij te houden,
zoals handmatige verwijdering in de Explorer of via een plugin. Als je moet
detecteren wanneer een instantie wordt vernietigd met `Class.Instance:Destroy()`,
gebruik dan in plaats daarvan het `Class.Instance.Destroying` evenement.


Instance.AncestryChanged

child

De instantie wiens `Class.Instance.Parent|Parent` eigenschap is gewijzigd,
wat deze instantie of een meer verre voorouder kan zijn, **niet**
per se de instantie waarmee de handler is verbonden.


parent

De nieuwe ouder van de `child` parameter.


Wordt geactiveerd wanneer de `Class.Instance.Parent` eigenschap van dit object of een van
zijn voorouders wordt gewijzigd.


Dit evenement wordt geactiveerd wanneer een eigenschap wordt gewijzigd op de instantie,
waaronder wanneer een eigenschap wordt ingesteld op `nil`. De naam van de gewijzigde
eigenschap wordt doorgegeven aan de verbonden functie.

Bijvoorbeeld, de volgende codefragment verbindt de `attributeChanged()`
funtie om te activeren wanneer een van de eigenschappen van het onderdeel verandert:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "veranderd")
end

part.AttributeChanged:Connect(attributeChanged)
```
Zie ook `Class.Instance:GetAttributeChangedSignal()` die een
evenement retourneert dat wordt geactiveerd wanneer een specifieke gegeven eigenschap verandert.


Instance.AttributeChanged

attribute

De naam van de eigenschap die is gewijzigd.


Wordt geactiveerd wanneer een eigenschap wordt gewijzigd op de `Class.Instance`.


Dit fragment drukt de namen van objecten af wanneer ze aan de Workspace worden toegevoegd:


Wordt geactiveerd nadat een object aan deze `Class.Instance` is gepaard.

Let op, wanneer je deze methode op een client gebruikt om objecten te detecteren die door de
server zijn gemaakt, is het noodzakelijk om `Class.Instance:WaitForChild()` te gebruiken bij
het indexeren van de afstammelingen van deze objecten. Dit komt omdat het object en zijn
afstammelingen niet gegarandeerd gelijktijdig van de server naar de client worden gerepliceerd. Bijvoorbeeld:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gebruik WaitForChild() aangezien afstammelingen mogelijk nog niet zijn gerepliceerd
	local head = child:WaitForChild("Head")
end)
```
Let op, dit evenement werkt alleen voor directe kinderen van de
`Class.Instance`. Voor een evenement dat alle afstammelingen vastlegt, gebruik
`Class.Instance.DescendantAdded`.

Zie ook `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Wordt geactiveerd nadat een object aan deze `Class.Instance` is gepaard.


Instance.childAdded

Dit fragment drukt de namen van objecten af terwijl ze worden verwijderd uit de
Workspace:


Wordt geactiveerd nadat een kind is verwijderd uit deze `Class.Instance`.

Verwijderd verwijst naar wanneer de ouder van een object wordt gewijzigd van deze
`Class.Instance` naar iets anders dan deze `Class.Instance`. Let op, dit
evenement wordt ook geactiveerd wanneer een kind wordt vernietigd (met
`Class.Instance:Destroy()`) omdat de vernietigingsfunctie de ouder van een object
op `nil` instelt.

Dit evenement werkt alleen voor directe kinderen van de `Class.Instance`.
Voor een evenement dat alle afstammelingen vastlegt, gebruik
`Class.Instance.DescendantRemoving`.

Zie ook `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Wordt geactiveerd nadat een kind is verwijderd uit deze `Class.Instance`.


Dit volgende voorbeeld zal de naam van elk object afdrukken dat wordt toegevoegd aan de
Workspace:


Dit evenement wordt geactiveerd nadat een afstammeling is toegevoegd aan de `Class.Instance`.

Aangezien het wordt geactiveerd voor elke afstammeling, zal het aanroepen van een object naar de
`Class.Instance` het evenement activeren voor dit object en al zijn
afstammelingen afzonderlijk.

Als je alleen geïnteresseerd bent in de **directe kinderen** van de
`Class.Instance`, gebruik dan in plaats daarvan `Class.Instance.ChildAdded`.

Zie ook `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wordt geactiveerd nadat een afstammeling is toegevoegd aan de `Class.Instance`.


Het volgende voorbeeld drukt de naam van elke afstammeling af terwijl deze wordt verwijderd
uit de Workspace:


Dit evenement wordt geactiveerd **onmiddellijk voordat** de ouder `Class.Instance`
verandert zodat een **afstammeling** instantie niet langer een
afstammeling zal zijn. `Class.Instance:Destroy()|Destroy()` verandert de ouder van een instantie naar
`nil`, dus het aanroepen van die methode op een afstammeling van de ouder zal dit evenement activeren.

Aangezien dit evenement wordt geactiveerd **voordat** de verwijdering van de afstammeling plaatsvindt, zal de ouder van
de afstammeling ongewijzigd blijven op het moment van het activeren van dit evenement. Als de
afstammeling ook een **direct kind** van de ouder is, zal dit evenement worden geactiveerd
voordat `Class.Instance.ChildRemoved`.

Als een afstammeling kinderen heeft, wordt dit evenement geactiveerd met de afstammeling eerst,
gevolgd door zijn afstammelingen.

#### Waarschuwing

Dit evenement wordt geactiveerd met het afstammelingobject dat wordt verwijderd.
Proberen de `Class.Instance.Parent|Parent` van de afstammeling naar iets anders in te stellen zal mislukken. Hieronder staat een voorbeeld dat dit aantoont:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipuleer de ouder van de afstammeling niet in deze functie!
	-- Dit evenement wordt geactiveerd OMDAT de ouder is gemanipuleerd, en de wijziging is nog niet gebeurd
	-- Daarom is het problematisch om de ouder op deze manier te veranderen:
	descendant.Parent = game
end)

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


Instance.DescendantRemoving

De `Class.Instance` die wordt verwijderd.


Wordt geactiveerd onmiddellijk voordat een afstammeling van de `Class.Instance` wordt verwijderd.


Dit voorbeeld demonstreert hoe, bij het gebruik van onmiddellijke signaalgedrag, een
Instance die wordt vernietigd op zijn plaats blijft totdat de verbonden functie yieldt.


Dit voorbeeld demonstreert hoe, bij het gebruik van uitgesteld signaalgedrag, een Instance
wordt vernietigd voordat het signaal wordt verzonden.


De `Class.Instance` zal nooit uit het geheugen worden verwijderd terwijl een verbonden
functie deze nog gebruikt. Echter, als de functie op enig moment onderbreekt,
zullen de `Class.Instance` en zijn afstammelingen naar `nil` worden gepaard.

Als de `Class.Workspace.SignalBehavior` eigenschap is ingesteld op
`Enum.SignalBehavior.Immediate`, wordt dit evenement onmiddellijk geactiveerd voordat de
`Class.Instance` of een van zijn voorouders wordt vernietigd met
`Class.Instance:Destroy()`.

Als de `Class.Workspace.SignalBehavior` eigenschap is ingesteld op
`Enum.SignalBehavior.Deferred`, wordt dit evenement geactiveerd op het volgende hervattingspunt,
wat zal zijn na de `Class.Instance` of een van zijn voorouders is vernietigd met `Class.Instance:Destroy()`.

Met `Enum.SignalBehavior.Deferred|Deferred` gedrag, is het problematisch om een script
te verbinden met zijn eigen `Class.Instance.Destroying` evenement, aangezien het script
zal worden vernietigd voordat de callback kan worden aangeroepen (wat betekent dat het niet
zal worden uitgevoerd).

Bij het verwijderen van een `Class.Instance` in Studio, zoals handmatig verwijderen
via de [Explorer](/studio/explorer) of via een plugin,
wordt de `Class.Instance` niet vernietigd. In plaats daarvan wordt de ouder ingesteld op `nil`
wat je kunt bijhouden met `Class.Instance.AncestryChanged`.


Instance.Destroying

Wordt geactiveerd onmiddellijk voordat (of wordt uitgesteld tot na) de instantie wordt
vernietigd via `Class.Instance:Destroy()`.


Toont `Class.Instance.StyledPropertiesChanged`.


Dit evenement wordt geactiveerd wanneer een stijl-eigenschap wordt gewijzigd op de instantie,
waaronder wanneer een eigenschap wordt ingesteld op `nil`.


Instance.StyledPropertiesChanged

Wordt geactiveerd wanneer een stijl-eigenschap wordt gewijzigd op de instantie, inclusief
wanneer een eigenschap wordt ingesteld op `nil`.


Deze methode past een tag toe op de instantie, zonder effect als de tag
al is toegepast. Het succesvol toevoegen van een tag zal een signaal activeren dat is
gemaakt door `Class.CollectionService:GetInstanceAddedSignal()` met de gegeven tag.

#### Waarschuwingen

- De tags van een instantie die client-side zijn toegevoegd, zullen worden verwijderd als de
  server later een tag aan die instantie toevoegt of verwijdert omdat de server
  alle tags samen repliceert en eerdere tags overschrijft.

- Bij het taggen van een instantie is het gebruikelijk dat er enkele middelen worden gebruikt om
  de tag zijn functionaliteit te geven, bijvoorbeeld gebeurteniskoppelingen of tabellen.
  Om geheugenlekken te voorkomen, is het een goed idee om deze op te ruimen (ontkoppelen,
  instellen op `nil`, enz.) wanneer ze niet langer nodig zijn voor een tag. Doe dit bij
  het aanroepen van `Class.Instance:RemoveTag()`, het aanroepen van
  `Class.Instance:Destroy()`, of in een functie die is verbonden met een signaal
  dat is geretourneerd door `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

De tag die op de instantie moet worden toegepast.


De kinderen functie retourneert een array van de kinderen van het object.


Instance:children

Retourneert een array van de kinderen van het object.


Deze methode vernietigt alle kinderen en afstammelingen van een instantie.

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

-- Voeg wat vonkels toe
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Kinderen:", #part:GetChildren())  --> Kinderen: 0
```
Als je niet alle kinderen en afstammelingen wilt vernietigen, gebruik dan ofwel
`Class.Instance:GetChildren()` of `Class.Instance:GetDescendants()` om
door die kinderen/afstammelingen te lopen en te selecteren wat te vernietigen. Voor
voorbeeld, de volgende codevoorbeeld zal alle
`Class.BasePart|BaseParts` vernietigen die afstammen van een `Class.Model`:

```
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

Deze methode vernietigt alle kinderen van een instantie.


Toont het klonen van een model met `Class.Instance:Clone()`.


`Clone()` maakt een kopie van een instantie en al zijn afstammelingen,
negerend alle instanties die niet
`Class.Instance.Archivable|Archivable` zijn. De kopie van de root instantie wordt
teruggegeven door deze methode en zijn `Class.Instance.Parent|Parent` wordt ingesteld op
`nil`. Let op dat als de instantie zelf
`Class.Instance.Archivable|Archivable` is ingesteld op `false`, deze methode
`nil` zal retourneren.

Als een referentie-eigenschap zoals `Class.ObjectValue.Value` is ingesteld in een
gekloneerde instantie, hangt de waarde van de eigenschap van de kopie af van de
waarde van het origineel:

- Als een referentie-eigenschap verwijst naar een instantie die **ook** is gekloond,
  zal de kopie naar de kopie verwijzen.
- Als een referentie-eigenschap verwijst naar een instantie die **niet** is gekloond,
  wordt dezelfde waarde behouden in de kopie.


Instance:Clone

Een kopie van de instantie, of `nil` als de instantie niet
`Class.Instance.Archivable|Archivable` is.


Maak een kopie van een instantie en al zijn afstammelingen, negerend instanties
die niet `Class.Instance.Archivable|Archivable` zijn.


Instance:clone

Toont het vernietigen van een Deel met de `Class.Instance:Destroy()` functie.

Deze functie is de juiste manier om objecten weg te gooien die niet langer
vereist zijn.


Stelt de `Class.Instance.Parent` eigenschap in op `nil`, vergrendelt de
`Class.Instance.Parent` eigenschap, ontkoppelt alle verbindingen, en roept
`Destroy()` aan op alle kinderen. Deze methode is de juiste manier om objecten die
niet langer nodig zijn te verwijderen.

Het verwijderen van onnodige objecten is belangrijk, aangezien onnodige objecten en
verbindingen in een plaats geheugen gebruiken wat kan leiden tot ernstige prestatieproblemen
in de loop van de tijd.

Als beste praktijk na het aanroepen van `Destroy()` op een object, stel je alle
variabelen die naar het object (of zijn afstammelingen) verwijzen in op `nil`. Dit
voorkomt dat je code toegang heeft tot iets dat met het object te maken heeft.

```lua
local part = Instance.new("Part")
part.Name = "Hallo, wereld"
part:Destroy()
-- Doe dit niet:
print(part.Name)  --> "Hallo, wereld"
-- Doe dit om te voorkomen dat de bovenstaande regel werkt:
part = nil
```
Zodra een `Class.Instance` door deze methode is vernietigd, kan deze niet meer
worden hergebruikt omdat de `Class.Instance.Parent` eigenschap is vergrendeld. Om
**tijdelijk** een object te verwijderen in plaats van het te vernietigen, stel je
`Class.Instance.Parent|Parent` in op `nil`. Bijvoorbeeld:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Om een object na een bepaalde tijd te vernietigen, gebruik
`Class.Debris:AddItem()`.


Instance:Destroy

Stelt de `Class.Instance.Parent` eigenschap in op `nil`, vergrendelt de
`Class.Instance.Parent` eigenschap, ontkoppelt alle verbindingen, en roept
`Destroy()` aan op alle kinderen.


Instance:destroy

Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Instance.Name` gelijk is aan de gegeven naam.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

De volgende codefragment zou de eerste voorouder van het object
met de naam `Car` vinden.

```
local car = object:FindFirstAncestor("Car")
```
Voor varianten van deze methode die voorouders van een specifieke klasse vinden,
zie `Class.Instance:FindFirstAncestorOfClass()` en
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

De `Class.Instance.Name` die moet worden gezocht.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Instance.Name` gelijk is aan de gegeven naam.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Object.ClassName` gelijk is aan de gegeven className.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

Een veelgebruikte toepassing van deze methode is het vinden van de `Class.Model` waartoe
een `Class.BasePart` behoort. Bijvoorbeeld:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Deze methode is een variant van `Class.Instance:FindFirstAncestor()` die
de `Class.Object.ClassName` eigenschap controleert in plaats van
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` bestaat ook,
met gebruik van de `Class.Object:IsA()` methode in plaats daarvan om de klasse
overerving te respecteren.


Instance:FindFirstAncestorOfClass

className

De `Class.Object.ClassName` die moet worden gezocht.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Object.ClassName` gelijk is aan de gegeven className.


Retourneert de eerste voorouder van de `Class.Instance` voor wie
`Class.Object:IsA()` waar retourneert voor de gegeven className.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

In tegenstelling tot `Class.Instance:FindFirstAncestorOfClass()`, gebruikt deze methode
`Class.Object:IsA()` die de klasse overerving respecteert. Bijvoorbeeld:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Daarom zal de volgende codevoorbeeld de eerste
`Class.BasePart` voorouder retourneren, ongeacht of het een `Class.WedgePart`,
`Class.MeshPart` of `Class.Part` is.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Zie ook `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Retourneert de eerste voorouder van de `Class.Instance` voor wie
`Class.Object:IsA()` waar retourneert voor de gegeven className.


Het onderstaande zou in Workspace zoeken naar een object met de naam "Brick". Als het gevonden wordt, 
zult het de naam van het object veranderen in "Foo".


Retourneert het eerste kind van de `Class.Instance` met de gegeven naam, of
`nil` als er geen dergelijk kind bestaat. Als de optionele `recursief` argument is
`true`, zoekt deze methode door alle afstammelingen in plaats van alleen de
directe kinderen van de `Class.Instance`.

#### Controleren of een Object Bestaat

`FindFirstChild()` is noodzakelijk als je moet verifiëren of een object bestaat
voordat je verder gaat. Proberen om een kind op naam te indexeren met de punt
operator genereert een fout als het kind niet bestaat.

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

-- De volgende regel genereert een fout als het onderdeel niet bestaat in de workspace
Workspace.Part.Transparency = 0.5
```
Een betere aanpak is om `FindFirstChild()` te gebruiken om eerst te controleren op `Part`,
vervolgens een `if`-verklaring te gebruiken om code uit te voeren die het nodig heeft.

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

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Een Kind Vinden Wiens Naam Een Eigenschap Overeenkomt

Soms is de `Class.Instance.Name|Name` van een object hetzelfde als dat van een
eigenschap van zijn `Class.Instance.Parent|Parent`. Bij gebruik van de punt
operator hebben eigenschappen voorrang boven kinderen als ze dezelfde naam delen.

In het volgende voorbeeld wordt een `Class.Folder` genaamd `Color` toegevoegd aan een
`Class.Part`, die ook de `Class.Part.Color` eigenschap heeft. Merk op dat
`part.Color` verwijst naar de `Datatype.Color3` eigenschapswaarde, niet de kind
`Class.Folder` instantie. Een voordeel van het gebruik van
`Class.Instance:FindFirstChild()|FindFirstChild()` is dat de introductie van nieuwe
 eigenschappen geen risico voor je code met zich meebrengt.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- De eigenschap
local c2 = part:FindFirstChild("Color")  -- De kindmap
```

#### Prestatie Opmerkingen

`Class.Instance:FindFirstChild()|FindFirstChild()` duurt ongeveer 20% langer
 dan het gebruik van de punt operator en bijna 8 keer langer dan simpelweg het opslaan
 van een referentie naar een object. Daarom moet je het vermijden om het aan te roepen in
 prestatie-afhankelijke code zoals in strakke lussen of functies die zijn verbonden
 met `Class.RunService.Heartbeat` en `Class.RunService.PreRender`. In plaats daarvan,
 sla het resultaat op in een variabele, of overweeg om
 `Class.Instance.ChildAdded|ChildAdded` of
 `Class.Instance:WaitForChild()|WaitForChild()` te gebruiken om te detecteren wanneer een kind van een
gegeven naam beschikbaar wordt.


Instance:FindFirstChild

Retourneert het eerste kind van de `Class.Instance` gevonden met de gegeven naam.


Instance

`Instance` is de basis klasse voor alle klassen in de Roblox klasse hiërarchie
waarvan de onderdelen deel kunnen uitmaken van de `Class.DataModel` boom.


Samenvatting