Digunakan sebagai penyimpanan untuk status Humanoid kustom. Objek ini seharusnya telah
resmi digunakan dalam pustaka RbxStatus, tetapi masih belum selesai.


Status

Sebuah objek yang belum selesai yang tidak menawarkan fungsionalitas kepada pengembang.


Contoh berikut mencakup fungsi dasar yang mengambil tabel objek
 dan menjadikannya sebagai induk dalam Model baru, mengembalikan Model tersebut.

Model adalah objek kontainer, yang berarti mereka mengelompokkan objek bersama. Mereka
lebih baik digunakan untuk menyimpan koleksi dari `Class.BasePart|BaseParts` dan memiliki sejumlah
fungsi yang memperluas fungsionalitas mereka.

Model dimaksudkan untuk merepresentasikan kelompok **geometrik**. Jika pengelompokan Anda tidak
memiliki interpretasi geometrik, misalnya kumpulan dari
`Class.Script|Scripts`, gunakan `Class.Folder` sebagai gantinya.

Model yang bagian-bagiannya dihubungkan dengan sambungan (sehingga mereka
bisa bergerak atau dihancurkan melalui simulasi fisika) biasanya memiliki
`Class.Model.PrimaryPart|PrimaryPart` yang disetel, karena ini menentukan bagian mana dalam
model yang pivot dan bounding box akan "mengikuti" saat model bergerak. Model statis
yang tetap di satu tempat tidak mendapat manfaat dari memiliki bagian utama yang disetel.

Model memiliki berbagai aplikasi, termasuk karakter pemain Roblox.
Mereka juga memiliki sejumlah perilaku unik yang penting untuk diingat:

- Ketika `Class.Humanoid` dan `Class.Part` bernama **Head** dipasang di bawah
  model, GUI nama/kesehatan akan muncul di atas model; lihat
  [Tampilan Nama/Kesehatan Karakter](/characters/name-health-display)
  untuk detail.
- Jika posisi suatu bagian di sumbu **Y** mencapai
  nilai `Class.Workspace.FallenPartsDestroyHeight`, dan itu adalah objek terakhir
  di dalam `Class.Model`, model tersebut juga akan dihancurkan.
- Ketika digunakan di tempat dengan `Class.Workspace.StreamingEnabled` disetel ke true,
  nilai dari `Class.Model.ModelStreamingMode|ModelStreamingMode` mengontrol
  berbagai perilaku tentang bagaimana model dan keturunan apapun direplikasi
  dan/atau dihapus dari klien. Selain itu, nilai dari
  `Class.Model.LevelOfDetail|LevelOfDetail` berdampak pada rendering model.

Seperti semua tipe `Class.Instance`, fakta bahwa `Class.Model` induk
direplikasi ke klien tidak menjamin bahwa semua anaknya juga direplikasi. Hal ini
sangat penting jika instansi ini diakses oleh kode yang berjalan di klien, seperti
pada `Class.LocalScript`.
Menggunakan `Class.Model.ModelStreamingMode|ModelStreamingMode` dengan nilai seperti
`Enum.ModelStreamingMode|Atomic` dapat memastikan bahwa seluruh model dan semua
keturunannya hadir jika model induk ada di klien, atau Anda
bisa menggunakan `Class.Instance:WaitForChild()|WaitForChild()` ketika atomisitas tidak
diharapkan.

Menetapkan model ini menjadi persisten untuk pemain yang ditentukan. Model persisten
akan tetap ada untuk pemain terlepas dari pengaturan atau kondisi streaming.

`Class.Model.ModelStreamingMode|ModelStreamingMode` harus disetel ke
`Enum.ModelStreamingMode|PersistentPerPlayer` agar perilaku berubah
sebagai akibat dari penambahan.

Model:AddPersistentPlayer

playerInstance

`Class.Player` untuk menjadikan model ini persisten.

Menetapkan model ini menjadi persisten untuk pemain yang ditentukan.
`Class.Model.ModelStreamingMode|ModelStreamingMode` harus disetel ke
`Enum.ModelStreamingMode|PersistentPerPlayer` agar perilaku berubah
sebagai akibat dari penambahan.

Dalam contoh ini, sendi pada setiap Model karakter Pemain yang ditambahkan akan dihancurkan
3 detik setelah muncul. Menghancurkan sendi ini akan menyebabkan Humanoid
tidak dapat hidup.

Contoh kode ini menunjukkan pembuatan sendi secara manual pada dua bagian yang
berada di tingkat yang sama dengan skrip (PartA dan PartB). Ini menciptakan sendi pada dua bagian yang saling bersentuhan
 dengan jenis permukaan yang kompatibel (Studs dan Inlet).

Memutuskan sambungan antara `BaseParts`, termasuk sambungan permukaan dengan
bagian yang berdekatan, `Class.WeldConstraint|WeldConstraints`, dan semua
`Class.Weld|Welds` serta `Class.JointInstance|JointInstances` lainnya.

Ketika BreakJoints digunakan pada karakter Pemain `Class.Model`,
`Class.Humanoid` karakter akan mati karena bergantung pada sambungan Leher.

Perlu dicatat bahwa meskipun sambungan yang dihasilkan oleh sambungan permukaan dengan bagian
berdekatan dapat secara teknis direkonstruksi menggunakan `Class.Model:MakeJoints()`, ini
hanya akan merekonstruksi sambungan yang dihasilkan oleh permukaan. Developer tidak boleh mengandalkannya
saat sambungan yang diputus mungkin tidak lagi saling kontak.

Model:BreakJoints

Memutuskan sambungan antara `BaseParts`, termasuk sambungan permukaan dengan
bagian yang berdekatan, `Class.WeldConstraint|WeldConstraints` dan semua
`Class.Weld|Welds` serta `Class.JointInstance|JointInstances` lainnya.

Model:breakJoints

Fungsi ini mengembalikan deskripsi volume yang mengandung semua
`Class.BasePart` anak di dalam `Class.Model`. Orientasi volume
berdasarkan pada orientasi `Class.Model.PrimaryPart|PrimaryPart`,
dan mencocokkan kotak pilihan yang dirender di Studio saat model dipilih. Menggambarkan perilaku
`Class.Terrain:FillBlock()`, ini mengembalikan `Datatype.CFrame` yang mewakili pusat dari
bounding box tersebut dan `Datatype.Vector3` yang mewakili ukurannya. Ukuran mungkin tidak akurat
di waktu berjalan jika kendala fisika berpengaruh pada bagian dalam
`Class.Model`.

Orientasi bounding box cocok dengan orientasi
`Class.PVInstance.GetPivot|Pivot` - baik pivot dari `Class.Model.PrimaryPart|PrimaryPart`
(jika tersedia) atau `Class.Model.WorldPivot|WorldPivot` dari model.

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

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

-- Mengubah ukuran dan posisi bagian sama dengan bounding box model
part.Size = size
part.CFrame = orientation
```

Model:GetBoundingBox

Sebuah `Datatype.CFrame` yang mewakili orientasi volume
diikuti oleh sebuah `Datatype.Vector3` yang mewakili ukuran volume.

Mengembalikan deskripsi volume yang mengandung semua bagian dari suatu Model.

Contoh kode di bawah ini menunjukkan bagaimana Model.GetExtentsSize dapat digunakan untuk mendapatkan
ukuran kotak batas yang mengandung bagian-bagian.


Mengembalikan ukuran dari bounding box terkecil yang mengandung semua dari
`Class.BasePart|BaseParts` di dalam `Class.Model`. Orientasinya cocok
dengan orientasi dari `Class.PVInstance.GetPivot|Pivot` - baik pivot dari
`Class.Model.PrimaryPart|PrimaryPart` (jika ada) atau
`Class.Model.WorldPivot|WorldPivot` dari model.

Perhatikan fungsi ini hanya mengembalikan ukuran dari bounding box terkecil, dan
dev harus menggunakan metode mereka sendiri untuk mendapatkan posisi dari
bounding box.

Model:GetExtentsSize

Ukuran `Datatype.Vector3` dari `Class.Model`.

Mengembalikan ukuran dari bounding box terkecil yang mengandung semua
`Class.BasePart|BaseParts` dalam `Class.Model`, sejajar dengan
`Class.Model.PrimaryPart` jika sudah disetel.

Nilai ini secara historis mengembalikan CFrame dari posisi pusat dalam model.

Model:GetModelCFrame

Kode ini akan membuat sebuah model, menempatkan beberapa bagian di dalamnya, memposisikannya secara acak,
dan kemudian mencetak ukurannya:

Fungsi GetModelSize mengembalikan ukuran `Datatype.Vector3` dari
`Class.Model`.

Model:GetModelSize

Ketika metode ini dipanggil dari `Class.Script`, ini mengembalikan semua
`Class.Player` objek yang model ini persisten. Ketika dipanggil dari
`Class.LocalScript`, metode ini hanya memeriksa apakah model ini persisten
untuk `Class.Players.LocalPlayer|LocalPlayer`.

Model:GetPersistentPlayers

Sebuah tabel dengan semua objek `Class.Player` yang model objek ini
persisten.

Mengembalikan semua objek `Class.Player` yang model objek ini
persisten. Perilaku bervariasi tergantung pada apakah metode ini dipanggil
dari `Class.Script` atau `Class.LocalScript`.

Kode berikut menunjukkan cara menggunakan GetPrimaryPartCFrame dan
SetPrimaryPartCFrame untuk memutar sebuah model.

Sebuah model sederhana dibuat di Workspace dan sebuah loop dimulai yang akan
memutar model 10 derajat di sekitar sumbu Y setiap 0,2 detik.

Fungsi ini telah digantikan oleh `Class.PVInstance:GetPivot()` yang
bertindak sebagai pengganti dan tidak mengubah perilaku kode Anda. Gunakan
`Class.PVInstance:GetPivot()` untuk pekerjaan baru dan migrasikan panggilan
`Class.Model:GetPrimaryPartCFrame()` yang ada saat nyaman.

Mengembalikan `Datatype.CFrame` dari `Class.Model.PrimaryPart` model.

Fungsi ini setara dengan yang berikut.

    Model.PrimaryPart.CFrame

Perhatikan fungsi ini akan melempar kesalahan jika tidak ada `Class.Model.PrimaryPart`
yang ada untuk model. Ini dapat menyebabkan masalah jika, misalnya, bagian utama
tidak pernah disetel atau telah dihancurkan.

Model:GetPrimaryPartCFrame

Mengembalikan `Datatype.CFrame` dari `Class.Model.PrimaryPart` model.
Fungsi ini akan melempar kesalahan jika tidak ada bagian utama yang ada untuk
`Class.Model`.

Contoh kode ini menunjukkan cara menggantikan semua salinan
model pohon menggunakan `Class.Model:PivotTo()` dan `Class.Model:ScaleTo()`. 
Pivot dan skala model digunakan sebagai referensi untuk memastikan bahwa
ukuran dan lokasi relatif model pengganti sesuai dengan model aslinya.


Model memiliki faktor skala kanonik yang persisten, yang dimulai dari 1
untuk model yang baru dibuat dan berubah saat model diskalakan dengan memanggil
`Class.Model:ScaleTo()`. Fungsi ini mengembalikan faktor skala kanonik yang saat ini
untuk model.

Faktor skala saat ini tidak _secara langsung_ mempengaruhi ukuran Instansi
di bawah model. Ini digunakan untuk tujuan penulis konten dan pemrograman
untuk mengingat bagaimana model telah diskalakan relatif terhadap ukuran aslinya.

Dalam sesi tertentu, model akan menyimpan informasi ukuran asli
instansi keturunan setelah panggilan pertama
`Class.Model:ScaleTo()`. Ini berarti bahwa memanggil
`Class.Model:ScaleTo()|ScaleTo(x)` diikuti oleh
`Class.Model:ScaleTo()|ScaleTo(1)` akan mengembalikan _tepatnya_ konfigurasi
asli model tanpa titik mengambang. Menghindari titik mengambang adalah motivasi untuk
memiliki fungsi Scale**To** dibandingkan fungsi Scale**By**.

Faktor skala memang mempengaruhi perilaku engine dalam satu cara: Faktor skala
model akan diterapkan pada offset sendi dalam
`Class.Animation|Animations` yang diputar pada `Class.AnimationController`
 di bawah model tersebut, sehingga rig animasi akan memutar
animasi dengan benar bahkan ketika diskalakan.

Model:GetScale

Faktor skala kanonik saat ini dari model.

Mengembalikan skala kanonik model, yang defaultnya adalah 1 untuk model yang baru
dibuat dan akan berubah seiring perubahan skala melalui
`Class.Model:ScaleTo()`.

Contoh kode ini menunjukkan bagaimana sambungan bisa dibuat menggunakan
fungsi Model:MakeJoints.

Sebuah model dibuat, dengan dua bagian di atas satu sama lain. Bagian atas
terikat dan bagian bawah tidak. Biasanya, ketika dipasang ke Workspace
bagian bawah akan jatuh ke Baseplate.

Namun, karena properti TopSurface dari bagian bawah diatur ke
Enum.SurfaceType.Weld, ini berarti bahwa ketika Model:MakeJoints dijalankan,
sambungan dibuat di antara mereka.

Oleh karena itu, bagian bawah tidak jatuh sampai sambungan di model
dibongkar. Ini sering dilakukan menggunakan Model:BreakJoints, tetapi dalam contoh ini,
sambungan dibongkar menggunakan sebuah ledakan.

Contoh kode ini menunjukkan pembuatan joint pada dua bagian yang merupakan
saudara dari skrip (PartA dan PartB). Ini menggunakan MakeJoints pada dua bagian yang saling
sentuh dengan tipe permukaan yang kompatibel (Studs dan Inlet).

Penggabungan berdasarkan SurfaceType telah dinyatakan usang. Jangan gunakan MakeJoints untuk proyek baru.
Gunakan `Class.WeldConstraint|WeldConstraints` dan
`Class.HingeConstraint|HingeConstraints` sebagai gantinya.

Melalui semua `Class.BasePart|Parts` dalam `Class.Model` dan menciptakan
sambungan antara bagian yang ditentukan dan setiap permukaan planar yang bersentuhan,
tergantung pada permukaan bagian.

- Permukaan halus tidak akan membuat sambungan
- Permukaan lem akan membuat sambungan `Class.Glue`
- Las akan membuat sambungan `Class.Weld` dengan permukaan kecuali untuk
  Unjoinable
- Studs, Inlet, atau Universal akan masing-masing membuat sambungan `Class.Snap` dengan
  salah satu dari dua permukaan lainnya (misalnya Studs dengan Inlet dan
  Universal)
- Permukaan Hinge dan Motor membuat instansi sambungan `Class.Rotate` dan `Class.RotateV`

Fungsi ini tidak bekerja jika Bagian bukan merupakan keturunan dari
`Class.Workspace`. Oleh karena itu, Anda harus terlebih dahulu memastikan Model dipasang
ke Workspace sebelum menggunakan MakeJoints.

Model:MakeJoints

Melalui semua `Class.BasePart|BaseParts` dalam `Class.Model`. Jika sisi bagian
apa pun memiliki SurfaceType yang dapat membuat sambungan, itu akan membuat sambungan
dengan bagian yang berdekatan.

Model:makeJoints

Model:move

location

Sampel ini menunjukkan bagaimana `Class.Model:MoveTo()` menghindari bentrokan.

Sebuah `Class.Model` sederhana yang terdiri dari dua bagian dibuat, dan `Class.Model.PrimaryPart`
ditetapkan. Sebuah bagian penghalang besar ditempatkan di sampingnya.

Setelah 5 detik, `Class.Model:MoveTo()` digunakan untuk mengarahkan model agar bergerak
ke dalam bagian penghalang. Namun, karena MoveTo tidak akan memindahkan model ke dalam
penghalang, `Class.Model` dipindahkan ke atas sumbu Y dan ditempatkan di atas
penghalang.


Memindahkan `Class.Model.PrimaryPart|PrimaryPart` ke posisi yang diberikan. Jika
bagian utama belum ditentukan, bagian akar model akan digunakan,
tetapi bagian akar tidak deterministik dan disarankan agar
you selalu menyetel bagian utama ketika menggunakan `Class.Model:MoveTo()|MoveTo()`.

Jika ada halangan di mana model akan dipindahkan, seperti
`Class.Terrain` atau `Class.BasePart|BaseParts`, model akan dipindahkan ke atas hingga tidak ada lagi yang menghalangi. Jika perilaku ini tidak diharapkan, `Class.PVInstance:PivotTo()` harus digunakan
sebagai gantinya.

Perhatikan bahwa rotasi tidak dipertahankan saat memindahkan model dengan
`Class.Model:MoveTo()|MoveTo()`. Sangat disarankan untuk menggunakan either
`Class.Model:TranslateBy()|TranslateBy()` atau `Class.PVInstance:PivotTo()`
jika rotasi saat ini dari model perlu dipertahankan.

Model:MoveTo

position

`Datatype.Vector3` yang dipindahkan `Class.Model`.

Memindahkan `Class.Model.PrimaryPart|PrimaryPart` ke posisi yang diberikan. Jika
bagian utama belum ditentukan, bagian akar model akan digunakan.

Model:moveTo

Membuat model ini tidak lagi persisten untuk pemain yang ditentukan. Ini tidak
menjamin model akan segera dihapus untuk pemain; setelah
memanggil metode ini, model akan diperlakukan sebagai
`Enum.ModelStreamingMode|Atomic` untuk pemain tersebut dan akan tetap ada
selama masih dalam jari-jari streaming target.

`Class.Model.ModelStreamingMode|ModelStreamingMode` harus disetel ke
`Enum.ModelStreamingMode|PersistentPerPlayer` agar perilaku berubah
sebagai akibat dari penghapusan.

Model:RemovePersistentPlayer

`Class.Player` yang membuat model ini tidak lagi persisten.

Membuat model ini tidak lagi persisten untuk pemain yang ditentukan.
`Class.Model.ModelStreamingMode|ModelStreamingMode` harus disetel ke
`Enum.ModelStreamingMode|PersistentPerPlayer` agar perilaku berubah
sebagai akibat dari penghapusan.

Mengatur rotasi bagian model kembali ke rotasi identitas yang disetel sebelumnya,
yang dilakukan melalui metode `Class.Model:SetIdentityOrientation()`.

Model:ResetOrientationToIdentity

Model memiliki faktor skala kanonik yang persisten, yang dimulai dari 1
bagi model yang baru dibuat. Fungsi ini mengubah skala model, di sekitar lokasi pivot,
relatif terhadap tampilannya pada faktor skala 1. Untuk
mencapainya, ia melakukan dua hal:

- Menetapkan faktor skala saat ini dari model ke nilai yang ditentukan
- Mengubah ukuran dan memposisikan semua Instansi keturunan sesuai

Skala lokasi dilakukan di sekitar lokasi pivot.

Semua properti "geometrik" dari Instansi keturunan akan diskalakan. Itu
jelas mencakup ukuran bagian, tetapi berikut adalah beberapa contoh properti lain yang
diskalakan:

- Panjang sambungan seperti `Class.WeldConstraint|WeldConstraints`, dan
  `Class.RopeConstraint`
- Kecepatan dan gaya fisik seperti `Class.HingeConstraint`
- Properti visual seperti ukuran pemancar partikel
- Properti panjang lainnya seperti `Class.Sound.RollOffMinDistance`

Model:ScaleTo

newScaleFactor

Menentukan faktor skala model, menyesuaikan ukuran dan lokasi dari
semua Instansi keturunan sehingga mereka memiliki faktor skala tersebut relatif terhadap
ukuran dan lokasi awal saat faktor skala adalah 1.

Menetapkan rotasi identitas model yang diberikan, memungkinkan Anda untuk mereset
rotasi seluruh model nanti, melalui penggunaan metode
`ResetOrientationToIdentity`.

Model:SetIdentityOrientation

Fungsi ini telah digantikan oleh `Class.PVInstance:PivotTo()` yang
bertindak sebagai pengganti yang lebih efisien dan tidak mengubah perilaku
kode Anda. Gunakan `Class.PVInstance:PivotTo()` untuk pekerjaan baru dan migrasikan
panggilan `Class.Model:SetPrimaryPartCFrame()` yang ada saat nyaman.

Menetapkan `Class.BasePart.CFrame` dari `Class.Model.PrimaryPart` model.
Semua bagian lain dalam model juga akan dipindahkan dan akan mempertahankan
orientasi dan offset mereka masing-masing relatif terhadap `Class.Model.PrimaryPart`.

Perhatikan, fungsi ini akan melempar kesalahan jika tidak ada
`Class.Model.PrimaryPart` yang ada untuk model. Ini dapat menyebabkan masalah jika, misalnya,
bagian utama tidak pernah disetel atau telah dihancurkan.

Model:SetPrimaryPartCFrame

cframe

Menetapkan `Class.BasePart.CFrame` dari `Class.Model.PrimaryPart` model.
Semua bagian lain dalam model juga akan dipindahkan dan akan mempertahankan
orientasi dan offset mereka masing-masing relatif terhadap `Class.Model.PrimaryPart`.

Contoh ini menunjukkan bagaimana `Class.Model:TranslateBy()` mengabaikan tabrakan
 dan menghormati orientasi model.

Sebuah `Class.Model` sederhana yang terdiri dari dua bagian dibuat, diputar 45 derajat pada sumbu Y,
dan `Class.Model.PrimaryPart`-nya diatur. Sebuah bagian penghalang besar diletakkan
 di sebelahnya.

Setelah 5 detik `Class.Model:TranslateBy()` digunakan untuk mengarahkan model agar
 bergerak ke dalam bagian penghalang. Model akan bergerak ke dalam
 penghalang dan mempertahankan orientasi saat ini.

Menggeser `Class.Model` dengan offset `Datatype.Vector3` yang diberikan, mempertahankan
orientasi model. Jika `Class.BasePart` atau `Class.Terrain` lain sudah
ada di posisi baru maka `Class.Model` akan menumpuk pada
objek tersebut.

Penerjemahan diterapkan di ruang dunia bukan di ruang objek,
yang berarti bahkan jika bagian model memiliki orientasi berbeda akan tetap
bergerak sepanjang sumbu standar.

Model:TranslateBy

delta

`Datatype.Vector3` untuk menerjemahkan `Class.Model`.

Menggeser `Class.Model` dengan offset `Datatype.Vector3` yang diberikan, mempertahankan
orientasi model. Jika `Class.BasePart` atau `Class.Terrain` lain sudah
ada di posisi baru maka `Class.Model` akan menumpuk pada
objek tersebut.

Model

Mengatur level detail pada model untuk pengalaman dengan instance
[streaming](/workspace/streaming) diaktifkan. Mesh komposit atau
imposter tidak mendukung fisika, deteksi tabrakan, atau
raycasting.

Saat diatur ke `Enum.ModelLevelOfDetail|StreamingMesh`, sebuah mesh
"imposter" resolusi lebih rendah (mesh berwarna, kasar yang membungkus
semua bagian anak dari model) dirender di luar jangkauan streaming.
Tidak mendukung tekstur.

Saat diatur ke `Enum.ModelLevelOfDetail|SLIM`, model **SLIM** (Model
Interaktif Ringan yang Dapat Diskalakan) merender komposit dari
semua bagian anak pada resolusi yang secara progresif lebih rendah pada
jarak berdasarkan jangkauan streaming. Ini sangat meningkatkan kualitas visual
dibandingkan dengan `Enum.ModelLevelOfDetail|StreamingMesh`.

Saat diatur ke `Enum.ModelLevelOfDetail|Disabled` atau
`Enum.ModelLevelOfDetail|Automatic`, mesh resolusi lebih rendah tidak akan
ditampilkan.


Model.LevelOfDetail

Menentukan tingkat detail pada model untuk pengalaman dengan streaming instansi
aktif.

Mengontrol bagaimana `Class.Model|Models` di-stream in dan out ketika
[streaming](/workspace/streaming) diaktifkan. Perilaku
tergantung pada enum yang dipilih. Tidak ada efek saat streaming tidak diaktifkan.

Properti ini hanya boleh diubah di Studio melalui jendela
[Properties](/studio/properties) saat streaming diaktifkan, atau di
`Class.Script|Scripts`, tetapi tidak pernah di
`Class.LocalScript|LocalScripts` (melakukannya dapat menyebabkan perilaku yang tidak terdefinisi).

Model.ModelStreamingMode

Mengontrol perilaku streaming model di `Class.Model|Models` ketika
streaming instansi diaktifkan.

Contoh kode ini membuat dan melempar model dadu, lalu mengeluarkan apakah itu
jatuh dengan sisi biru menghadap ke atas. Jika `Class.Model.PrimaryPart` tidak diatur,
pivot / bounding box dari dadu akan berputar, karena bagian di dalamnya
simulasi fisiknya selama roll.

Menunjuk ke bagian utama dari `Class.Model`. Bagian utama adalah
`Class.BasePart` yang berfungsi sebagai referensi fisik untuk pivot model.
Artinya, saat bagian-bagian dalam model dipindahkan karena simulasi fisika atau cara lain,
pivot akan bergerak seiring dengan bagian utama.

Perlu dicatat bahwa `Class.Model|Models` tidak memiliki `PrimaryPart` yang disetel secara default.
Jika Anda membuat model yang perlu dipengaruhi oleh fisika, Anda
harus secara manual menyetel properti ini di Studio atau dalam skrip. Jika
bagian utama **tidak** disetel, pivot akan tetap berada di lokasi yang sama di
ruang dunia, bahkan jika bagian dalam model dipindahkan.

Juga perhatikan bahwa saat menyetel properti ini, itu harus merupakan
`Class.BasePart` yang merupakan keturunan dari model. Jika Anda mencoba menyetel
`Class.Model.PrimaryPart` ke `Class.BasePart` yang **bukan** keturunan dari model, itu
akan disetel ke bagian tersebut tetapi direset ke `nil`
saat langkah simulasi berikutnya &mdash; ini adalah perilaku warisan untuk mendukung
skrip yang mengasumsikan mereka dapat sementara menyetel bagian utama ke
`Class.BasePart` yang bukan merupakan keturunan dari model.

Aturan umum untuk model adalah:

- Model yang bagiannya dihubungkan melalui sendi fisik seperti
  `Class.WeldConstraint|WeldConstraints` atau `Class.Motor6D|Motor6Ds`
  harus memiliki bagian utama yang ditetapkan. Misalnya, model karakter
  Roblox memiliki `Class.Model.PrimaryPart` yang disetel ke
  **HumanoidRootPart** secara default.
- Model statis (biasanya `Class.BasePart.Anchored|Anchored`) yang tetap di
  satu tempat kecuali skrip secara eksplisit memindahkannya tidak memerlukan
  `Class.Model.PrimaryPart` dan cenderung tidak mendapatkan manfaat dari
  memiliki salah satu yang disetel.

Model.PrimaryPart

Bagian utama dari `Class.Model`, atau `nil` jika tidak ditentukan secara eksplisit.

Menetapkan properti ini di jendela Properties akan mengubah skala model seolah-olah
`Class.Model:ScaleTo()` telah dipanggil di atasnya, mengubah ukuran semua Instansi keturunan
berada dalam model, seperti material, gambar, dan geometri 3D dari
bagian, sehingga model memiliki faktor skala yang ditentukan relatif terhadap ukurannya
sebelum diubah.

Properti ini hanya tersedia di Studio dan akan melempar kesalahan jika digunakan
di `Class.Script` atau `Class.LocalScript`. `Class.Model:ScaleTo()` dan
`Class.Model:GetScale()` harus digunakan dari skrip.

Model.Scale

Properti khusus editor yang digunakan untuk mengubah skala model di sekitar pivotnya. Menetapkan
properti ini akan memindahkan skala seolah-olah `Class.Model:ScaleTo()` telah
dipanggil di atasnya.

Contoh kode ini menunjukkan fungsi kustom untuk mengatur ulang pivot dari sebuah model
kembali ke pusat kotak batas model itu.

Properti ini menentukan di mana pivot dari `Class.Model` yang
**tidak** memiliki `Class.Model.PrimaryPart` yang disetel terletak. Jika
`Class.Model` **memang** memiliki `Class.Model.PrimaryPart|PrimaryPart`, pivot dari
`Class.Model` adalah sama dengan pivot dari bagian utama tersebut
sebaliknya, dan properti `Class.Model.WorldPivot|WorldPivot` ini diabaikan.

Untuk `Class.Model` yang baru dibuat, pivotnya akan diperlakukan sebagai pusat
bounding box dari isinya sampai **pertama kali** properti
`Class.Model.WorldPivot` disetel. Setelah pivot dunia disetel untuk
tama kali, tidak mungkin untuk mengembalikan perilaku awal ini.

Umumnya, memindahkan model dengan alat Studio, atau dengan fungsi
pergerakan model seperti `Class.PVInstance:PivotTo()` dan
`Class.Model:MoveTo()`, akan menyetel pivot dunia dan dengan demikian mengakhiri perilaku baru model ini.

Tujuan dari perilaku ini adalah untuk memungkinkan kode Luau mendapatkan pivot yang masuk akal
hanya dengan membuat model baru dan mengaitkan objek padanya, menghindari kebutuhan untuk
menyetel `Class.Model.WorldPivot` secara eksplisit setiap kali Anda membuat model di kode.

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

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

print(model:GetPivot())  -- Saat ini sama dengan pusat bounding box yang berisi "BluePart" dan "RedPart"

model:PivotTo(CFrame.new(0, 10, 0))  -- Ini berfungsi tanpa perlu menyetel "model.WorldPivot" secara eksplisit
```

Model.WorldPivot

Menentukan di mana pivot dari `Class.Model` yang **tidak** memiliki
`Class.Model.PrimaryPart` yang disetel terletak.

Model adalah objek kontainer, yang berarti mereka mengelompokkan objek bersama. Mereka
lebih baik digunakan untuk menyimpan koleksi dari `Class.BasePart|BaseParts` dan memiliki sejumlah
fungsi yang memperluas fungsionalitas mereka.

Sebuah `Class.PVInstance` adalah kelas abstrak yang tidak dapat dibuat. Ini adalah
dasar untuk semua objek yang memiliki lokasi fisik di dunia.


Contoh kode ini adalah skrip teleportasi sederhana yang memindahkan karakter Anda
10&nbsp;stud ke depan dalam arah yang Anda hadapi saat Anda menekan
kunci <kbd>F</kbd>. Ini dilakukan dengan mendapatkan pivot saat ini dengan
`Class.PVInstance:GetPivot()` dan memanggil `PVInstance|PivotTo` untuk memindahkan
karakter ke depan.

Fungsi ini mendapatkan pivot dari sebuah `Class.PVInstance`. Ini sering digunakan
bersama `Class.PVInstance:PivotTo()` untuk memindahkan sebuah model.

`Class.Model|Models` dan `Class.BasePart|BaseParts` keduanya adalah
`Class.PVInstance|PVInstances` ("Posisi Kecepatan Instance") dan jadi keduanya
memiliki fungsi ini.


PVInstance:GetPivot

Mendapatkan pivot dari sebuah `Class.PVInstance`.


Mengubah `Class.PVInstance` bersama dengan semua `Class.PVInstance|PVInstances`
keturunannya sehingga pivot sekarang terletak di `Datatype.CFrame` yang
ditetapkan. Ini adalah fungsi utama yang seharusnya
 DIGUNAKAN untuk memindahkan `Class.Model|Models` melalui skrip.

`Class.BasePart|BaseParts` dipindahkan dengan cara ini dengan
transformasi `Datatype.CFrame` mereka menggunakan offset yang diperlukan.
`Class.Model|Models` dipindahkan dengan cara ini dengan
transformasi `Class.Model.WorldPivot` mereka menggunakan offset yang diperlukan.

Perhatikan bahwa demi efisiensi, acara `Class.Object.Changed` tidak
dipicu untuk `Class.BasePart.Position|Position` dan
`Class.BasePart.Orientation|Orientation` dari `Class.BasePart|BaseParts`
yang dipindahkan dengan cara ini; mereka hanya dipicu untuk `Datatype.CFrame`.

Saat memanggil `Class.PVInstance:PivotTo()|PivotTo` pada `Class.Model|Models`,
offset dari bagian dan model keturunan disimpan, sehingga
panggilan berikutnya ke `Class.PVInstance:PivotTo()|PivotTo` pada model yang sama
tidak mengakumulasi drifting floating point antara bagian-bagian yang
membentuk model.

`Class.Model|Models` dan `Class.BasePart|BaseParts` keduanya adalah
`Class.PVInstance|PVInstances` ("Posisi Kecepatan Instances") dan sehingga keduanya
memiliki fungsi ini.


PVInstance:PivotTo

targetCFrame

`Datatype.CFrame` yang seharusnya sama dengan pivot `Class.PVInstance`
setelah dipindahkan.


Mengubah `Class.PVInstance` bersama dengan semua `Class.PVInstance|PVInstances`
keturunannya sehingga pivot sekarang terletak di `Datatype.CFrame` yang
ditentukan.


PVInstance

PVInstance.Origin

PVInstance.Pivot Offset

Kelas abstrak untuk semua objek yang memiliki lokasi fisik di dunia.


`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.

Tidak mungkin untuk secara langsung membuat objek root `Instance`, tetapi konstruktor khusus
`Datatype.Instance.new()` membuat objek melalui kode, mengambil nama kelas
sebagai parameter dan mengembalikan objek yang dibuat.

Menunjukkan cara mendeteksi perubahan pada leluhur sebuah instance dengan menghubungkan ke
`Class.Instance.AncestryChanged` event.

Parent dari ChangingPart diatur ke nilai yang berbeda seiring waktu. Parent dari
part adalah leluhur part, jadi event `Class.Instance.AncestryChanged`
akan dipicu setiap kali terjadi perubahan.


Dibakar saat instans ini diubah parent-nya atau saat salah satu nenek
moyangnya diubah parent-nya.

Anda dapat menggunakan peristiwa ini untuk melacak penghapusan sebuah
instans di Studio, seperti penghapusan manual di Explorer atau melalui
plugin. Jika Anda perlu mendeteksi saat sebuah instans dihancurkan menggunakan
`Class.Instance:Destroy()`, gunakan peristiwa `Class.Instance.Destroying`
sebagai gantinya.

Instance.AncestryChanged

child

Instans yang properti `Class.Instance.Parent|Parent`-nya diubah,
yang bisa jadi instans ini atau nenek moyang yang lebih jauh, **tidak**
selalu instans yang terhubung dengan handler.

parent

Dibakar saat properti `Class.Instance.Parent` dari objek ini atau salah satu
nenek moyangnya diubah.

Peristiwa ini dibakar setiap kali atribut apa pun diubah pada instans,
termasuk ketika atribut diatur ke `nil`. Nama atribut yang diubah
akan diteruskan ke fungsi yang terhubung.

Sebagai contoh, cuplikan kode berikut menghubungkan fungsi `attributeChanged()`
untuk dibakar kapan pun salah satu atribut bagian diubah:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang mengembalikan sebuah
event yang dibakar saat atribut tertentu diubah.

Instance.AttributeChanged

attribute

Dibakar kapan pun atribut diubah pada `Class.Instance`.

Cuplikan ini mencetak nama objek saat mereka ditambahkan ke Workspace:


Dibakar setelah sebuah objek di-parent ke `Class.Instance` ini.

Catatan, saat menggunakan metode ini di client untuk mendeteksi objek yang
 dibuat oleh server itu perlu menggunakan `Class.Instance:WaitForChild()` saat
mengindeks keturunan objek ini. Ini karena objek dan keturunannya tidak
dijamin untuk direplikasi dari server ke client secara bersamaan. Sebagai contoh:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gunakan WaitForChild() karena keturunan mungkin belum direplikasi
	local head = child:WaitForChild("Head")
end)
```
Catatan, peristiwa ini hanya beroperasi untuk anak-anak langsung dari
`Class.Instance`. Untuk sebuah peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantAdded`.

Lihat juga `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Dibakar setelah sebuah objek di-parent ke `Class.Instance` ini.

Instance.childAdded

Potongan ini mencetak nama objek saat mereka dihapus dari Workspace:

Dibakar setelah seorang anak dihapus dari `Class.Instance` ini.

Dihapus berarti saat parent objek diubah dari `Class.Instance` ini ke
sesuatu selain `Class.Instance` ini. Catatan, peristiwa ini juga akan dibakar
 saat seorang anak dihancurkan (menggunakan
`Class.Instance:Destroy()`) karena fungsi hancur menetapkan parent objek ke
`nil`.

Peristiwa ini hanya beroperasi untuk anak-anak langsung dari `Class.Instance`.
Untuk sebuah peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantRemoving`.

Lihat juga `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Dibakar setelah seorang anak dihapus dari `Class.Instance` ini.

Contoh berikut akan mencetak nama objek apa pun yang ditambahkan ke
Workspace:

Peristiwa ini dibakar setelah sebuah keturunan ditambahkan ke `Class.Instance`.

Karena dibakar untuk setiap keturunan, meng-parent sebuah objek ke
`Class.Instance` akan membakar peristiwa untuk objek ini dan semua keturunannya
secara terpisah.

Jika Anda hanya khawatir dengan **anak-anak langsung** dari
`Class.Instance`, gunakan `Class.Instance.ChildAdded` sebagai gantinya.

Lihat juga `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Dibakar setelah sebuah keturunan ditambahkan ke `Class.Instance`.

Contoh berikut mencetak nama dari setiap keturunan saat sedang dihapus
 dari Workspace:

Peristiwa ini dibakar **segera sebelum** parent `Class.Instance`
berubah sehingga sebuah instans **keturunan** tidak lagi menjadi
keturunan. `Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent`
menjadi `nil`, jadi memanggil metode itu pada seorang keturunan dari parent
akan menyebabkan peristiwa ini dibakar.

Karena peristiwa ini dibakar **sebelum** penghapusan keturunan, parent dari
keturunan tidak akan berubah pada saat peristiwa ini dibakar. Jika keturunan
 juga adalah **anak langsung** dari parent, peristiwa ini akan dibakar
sebelum `Class.Instance.ChildRemoved`.

Jika keturunan memiliki anak, peristiwa ini dibakar dengan keturunan terlebih dahulu,
dikuti oleh keturunannya.

#### Peringatan

Peristiwa ini dibakar dengan objek keturunan yang sedang dihapus.
Mencoba mengatur `Class.Instance.Parent|Parent` dari keturunan ke yang lain
akan gagal. Di bawah ini adalah contoh yang menunjukkan hal ini:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Jangan manipulasi parent dari keturunan dalam fungsi ini!
	-- Peristiwa ini dibakar KARENA parent telah dimanipulasi, dan perubahan belum terjadi
	-- Oleh karena itu, problematik untuk mengubah parent seperti ini:
	descendant.Parent = game
end)

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

Instance.DescendantRemoving

Dibakar segera sebelum seorang keturunan dari `Class.Instance` dihapus.

Contoh ini menunjukkan bagaimana, saat menggunakan perilaku sinyal Segera, sebuah
Instance yang dihancurkan tetap berada di tempatnya sampai fungsi yang terhubung menunggu.


Contoh ini menunjukkan bagaimana, ketika menggunakan perilaku sinyal Tertunda, sebuah Instance
 dihancurkan sebelum sinyal dipicu.


`Class.Instance` tidak akan pernah dihapus dari memori selama fungsi yang terhubung
masih menggunakannya. Namun, jika fungsi tersebut menunggu pada titik manapun,
`Class.Instance` dan keturunannya akan di-parent ke `nil`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Immediate`, peristiwa ini dibakar segera sebelum
`Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Deferred`, peristiwa ini dibakar pada titik pemulihan
b berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred`, menghubungkan skrip
dengan peristiwa `Class.Instance.Destroying` sendiri adalah problematik,
karena skrip akan dihancurkan sebelum callback dapat dipanggil (berarti tidak
akan dieksekusi).

Saat menghapus `Class.Instance` di Studio, seperti menghapus secara manual
melalui [Explorer](/studio/explorer) atau melalui plugin,
`Class.Instance` tidak dihapus. Sebagai gantinya, parent diatur ke `nil`
 yang dapat Anda lacak dengan `Class.Instance.AncestryChanged`.

Instance.Destroying

Dibakar segera sebelum (atau ditunda sampai setelah) instans dihancurkan
melalui `Class.Instance:Destroy()`.

Peristiwa ini dibakar kapan pun properti gaya apa pun diubah pada instans,
termasuk ketika sebuah properti diatur ke `nil`.

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

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

local function stylePropertyChanged()
	print("Properti gaya diubah")
end

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

Instance.StyledPropertiesChanged

Dibakar kapan pun properti gaya apa pun diubah pada instans, termasuk
ketika sebuah properti diatur ke `nil`.

Metode ini memberi tag pada instance, tanpa efek jika tag sudah
 diterapkan. Menambahkan tag dengan sukses akan memicu sinyal yang dibuat untuk
`Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

#### Peringatan

- Tag-tag dari sebuah instance yang ditambahkan di sisi klien akan diabaikan jika
  server menghapus atau menambah tag pada instance tersebut karena server
  mereplikasi semua tag bersama-sama dan menimpa tag sebelumnya.

- Ketika memberi tag pada sebuah instance, umum untuk menggunakan beberapa sumber
  daya untuk memberikan fungsionalitas kepada tag tersebut, misalnya sambungan
  peristiwa atau tabel. Untuk mencegah kebocoran memori, merupakan ide baik
  untuk membersihkannya (putuskan sambungan, atur ke `nil`, dll.) ketika
  tidak lagi dibutuhkan untuk tag. Ini dilakukan saat memanggil
  `Class.Instance:RemoveTag()`, memanggil
  `Class.Instance:Destroy()`, atau dalam fungsi yang terhubung ke sinyal
  yang dikembalikan oleh`Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Fungsi anak mengembalikan array dari anak-anak objek.

Instance:children

Mengembalikan array dari anak-anak objek.

Metode ini menghancurkan semua anak dari sebuah instance dan keturunannya.

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

-- Tambahkan beberapa kilau
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Jika Anda tidak ingin menghancurkan **semua** anak dan keturunan, gunakan
`Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk
menelusuri anak-anak/keturunan tersebut dan memilih apa yang akan dihancurkan.
Sebagai contoh, sampel kode berikut akan menghancurkan semua
`Class.BasePart|BaseParts` yang turun dari sebuah `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

Metode ini menghancurkan semua anak dari sebuah instance.

Menunjukkan cara mengkloning sebuah model menggunakan `Class.Instance:Clone()`.

`Clone()` membuat salinan dari sebuah instance dan semua keturunannya,
mengabaikan semua instance yang tidak
`Class.Instance.Archivable|Archivable`. Salinan dari instance root dikembalikan
oleh metode ini dan `Class.Instance.Parent|Parent`-nya diatur menjadi
`nil`. Perlu dicatat bahwa jika instance itu sendiri memiliki
`Class.Instance.Archivable|Archivable` diatur menjadi `false`, metode ini akan
mengembalikan `nil`.

Jika properti referensi seperti `Class.ObjectValue.Value` diatur pada
instance yang dikloning, nilai dari properti salinan tergantung pada
nilai asli:

- Jika sebuah properti referensi merujuk pada instance yang **juga**
dikloning, salinan akan merujuk pada salinan tersebut.
- Jika sebuah properti referensi merujuk pada instance yang **tidak**
dikloning, nilai yang sama dipertahankan di dalam salinan.

Instance:Clone

Buat salinan dari sebuah instance dan semua keturunannya, mengabaikan instance
 yang tidak `Class.Instance.Archivable|Archivable`.

Instance:clone

Menunjukkan cara menghancurkan sebuah Part menggunakan fungsi `Class.Instance:Destroy()`.

Fungsi ini adalah cara yang benar untuk membuang objek yang tidak lagi
dibutuhkan.


Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutus semua koneksi, dan memanggil
`Destroy()` pada semua anak. Metode ini adalah cara yang benar untuk menghapus
objek yang tidak lagi diperlukan.

Menghapus objek yang tidak diperlukan sangat penting, karena objek dan
koneksi yang tidak dibutuhkan dapat menghabiskan memori yang dapat
menyebabkan masalah kinerja yang serius seiring waktu.

Sebagai praktik terbaik setelah memanggil `Destroy()` pada sebuah objek,
aturkan variabel apa pun yang merujuk ke objek (atau keturunannya) ke `nil`.
Ini mencegah kode Anda mengakses hal yang berkaitan dengan objek tersebut.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Jangan lakukan ini:
print(part.Name)  --> "Hello, world"
-- Lakukan ini untuk mencegah baris di atas bekerja:
part = nil
```
Setelah `Class.Instance` dihancurkan oleh metode ini, tidak dapat digunakan
kembali karena properti `Class.Instance.Parent` dikunci. Untuk
**sementara** menghapus objek alih-alih menghancurkannya, atur
`Class.Instance.Parent|Parent` menjadi `nil`. Sebagai contoh:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Untuk menghancurkan objek setelah jangka waktu tertentu, gunakan
`Class.Debris:AddItem()`.

Instance:Destroy

Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutus semua koneksi, dan memanggil
`Destroy()` pada semua anak.

Instance:destroy

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

Sampel kode berikut akan menemukan nenek moyang pertama dari objek
bernama `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Untuk varian dari metode ini yang menemukan nenek moyang dari kelas tertentu,
lihat `Class.Instance:FindFirstAncestorOfClass()` dan
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Nama `Class.Instance.Name` yang akan dicari.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

Kegunaan umum dari metode ini adalah menemukan `Class.Model` tempat
 `Class.BasePart` bernaung. Sebagai contoh:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Metode ini adalah varian dari `Class.Instance:FindFirstAncestor()` yang
memeriksa properti `Class.Object.ClassName` alih-alih `Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` juga
ada, menggunakan metode `Class.Object:IsA()` alih-alih untuk menghormati
pewarisan kelas.

Instance:FindFirstAncestorOfClass

className

Nama `Class.Object.ClassName` yang akan dicari.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

Berbeda dengan `Class.Instance:FindFirstAncestorOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Oleh karena itu, sampel kode berikut akan mengembalikan
nenek moyang pertama `Class.BasePart`, terlepas dari apakah itu `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Lihat juga `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Di bawah ini akan mencari di Workspace untuk objek dengan nama "Brick". Jika ditemukan,
akan mengganti nama objek tersebut menjadi "Foo".

Mengembalikan anak pertama dari `Class.Instance` dengan nama yang diberikan, atau
`nil` jika tidak ada anak seperti itu. Jika argumen opsional `recursive`
bernilai `true`, metode ini mencari semua keturunan daripada hanya anak langsung
`Class.Instance`.

#### Memeriksa Keberadaan Objek

`FindFirstChild()` diperlukan jika Anda perlu memverifikasi sebuah objek ada
sebelum melanjutkan. Mencoba mengindeks seorang anak berdasarkan nama menggunakan
operator titik akan menghasilkan kesalahan jika anak tidak ada.

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

-- Baris berikut menghasilkan kesalahan jika bagian tidak ada di workspace
Workspace.Part.Transparency = 0.5
```
Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk
pertama memeriksa `Part`, kemudian menggunakan pernyataan `if` untuk menjalankan
kode yang membutuhkannya.

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

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

#### Menemukan Anak yang Nama Sesuai dengan Properti

Kadang-kadang nama `Class.Instance.Name|Name` dari sebuah objek sama dengan
sebuah properti dari `Class.Instance.Parent|Parent`-nya. Saat menggunakan operator titik,
properti memiliki prioritas lebih dari anak-anak jika keduanya memiliki nama yang sama.

Pada contoh berikut, sebuah `Class.Folder` yang disebut `Color` ditambahkan ke
`Class.Part`, yang juga memiliki properti `Class.Part.Color`. Perhatikan bahwa
`part.Color` merujuk pada nilai properti `Datatype.Color3`, bukan pada instance
anak `Class.Folder`. Keuntungan dari menggunakan
`Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa
pengenalan properti baru tidak mengenakan risiko pada kode Anda.

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

#### Catatan Kinerja

`Class.Instance:FindFirstChild()|FindFirstChild()` memakan waktu sekitar 20%
lebih lama daripada menggunakan operator titik dan hampir 8 kali lebih lama daripada
hanya menyimpan referensi ke suatu objek. Oleh karena itu, Anda harus menghindari
memanggilnya dalam kode yang bergantung pada kinerja seperti dalam loop ketat atau
fungsi yang terhubung ke `Class.RunService.Heartbeat` dan `Class.RunService.PreRender`.
Sebaliknya, simpan hasil dalam variabel, atau pertimbangkan untuk menggunakan
`Class.Instance.ChildAdded|ChildAdded` atau
`Class.Instance:WaitForChild()|WaitForChild()` untuk mendeteksi kapan anak dengan
nama tertentu tersedia.

Instance:FindFirstChild

recursive

Apakah pencarian harus dilakukan secara rekursif.

Mengembalikan anak pertama dari `Class.Instance` yang ditemukan dengan
nama yang diberikan.

Instance:findFirstChild

Mengembalikan anak pertama dari `Class.Instance` yang memiliki
`Class.Object.ClassName|ClassName` yang sama dengan `className` yang diberikan.
Tidak seperti `Class.Instance:FindFirstChildWhichIsA()`, metode ini hanya mengembalikan
objek yang kelasnya cocok dengan `className`, mengabaikan pewarisan kelas. Jika tidak
ada anak yang cocok ditemukan, metode ini mengembalikan `nil`.

Instance:FindFirstChildOfClass

Mengembalikan anak pertama dari `Class.Instance` yang memiliki
`Class.Object.ClassName|ClassName` yang sama dengan nama kelas yang diberikan.

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Jika tidak ada anak yang cocok ditemukan, metode ini mengembalikan `nil`. Jika
argumen opsional rekursif bernilai benar, metode ini mencari semua keturunan
dari hanya anak langsung `Class.Instance`.

Tidak seperti `Class.Instance:FindFirstChildOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Oleh karena itu, sampel kode berikut akan mengembalikan anak pertama
`Class.BasePart`, terlepas dari apakah itu `Class.WedgePart`,
`Class.MeshPart`, atau `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Pengembang yang mencari anak berdasarkan nama, sebaiknya menggunakan
`Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstChildWhichIsA

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Mengembalikan keturunan pertama yang ditemukan dengan
`Class.Instance.Name` yang diberikan.

Metode ini dinonaktifkan dan tidak dapat digunakan. Untuk menemukan
keturunan pertama dari sebuah instance, pertimbangkan untuk menggunakan
parameter `recursive` pada `Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstDescendant

Mengembalikan keturunan pertama yang ditemukan dengan
`Class.Instance.Name` yang diberikan.

Jika `Class.Instance` adalah `Class.Actor`, `Class.Actor` itu sendiri akan
 dikembalikan. Jika tidak, nenek moyang terdekat `Class.Actor` akan
 dikembalikan. Jika tidak ada nenek moyang `Class.Actor`, hasilnya adalah `nil`.

Instance:GetActor

Mengembalikan `Class.Actor` yang terkait dengan Instance, jika ada.

Instance

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.