Ketika dipasangkan ke `Class.ViewportFrame`, `WorldModel` memperluas fisika terbatas
untuk anak-anaknya ke `Class.ViewportFrame` tersebut. Sebagai contoh,
`Class.BasePart|BaseParts` yang dipasangkan ke `WorldModel` dapat
diubah animasinya dan ditanya secara spasial (misalnya dengan raycasts) tetapi bagian-bagian tersebut
**tidak** disimulasikan. Selanjutnya, Anda dapat menempatkan karakter `Class.Humanoid` di dalam
`WorldModel` dan sendi-sendi mereka akan diatur dengan benar untuk animasi.

Untuk menghindari kemungkinan masalah kinerja, pastikan untuk hanya membuat `WorldModels`
ketika Anda ingin menampilkannya dan untuk menghapus `WorldModels` yang saat ini tidak
sedang digunakan.

WorldModel

Memperluas fisika terbatas untuk anak-anaknya ke dalam `Class.ViewportFrame` induk.

Kelas dasar ini menyediakan API untuk setiap instance yang dimaksudkan untuk menangani kueri spasial 3D dan simulasi, seperti `Class.Workspace` dan `Class.WorldModel`.

Blok kode di bawah ini menunjukkan cara menggunakan
`Class.WorldRoot:ArePartsTouchingOthers()` untuk memeriksa apakah bagian dalam daftar sedang
touching bagian mana pun di workspace yang tidak ada dalam daftar.

Pertama, skrip ini membuat dua bagian kotak yang tumpang tindih 1 stud, `Part1` dan
`Part2`. Kemudian, mencetak nilai yang dikembalikan oleh ArePartsTouchingOthers() saat
Part1 dipass ke `partList` pada tiga nilai tumpang tindih yang berbeda: `0`, `0.999`,
dan `1`. Dua kali pertama ArePartsTouchingOthers() dipanggil mengembalikan `false`
karena nilai tumpang tindih kurang dari jarak di mana Part1 dan Part2
tumpang tindih. Panggilan ketiga mengembalikan `true` karena nilai tumpang tindih sama dengan
jarak di mana bagian-bagian tersebut tumpang tindih.

**ArePartsTouchingOthers** mengembalikan true jika setidaknya satu dari `Class.BasePart` yang diberikan menyentuh bagian lainnya. Dua bagian dianggap "menyentuh" jika mereka berada dalam ambang jarak, `overlapIgnored`.

Jika tidak ada bagian yang diberikan, false akan dikembalikan.

WorldRoot:ArePartsTouchingOthers

partList

Daftar bagian untuk memeriksa apakah ada bagian dalam daftar yang menyentuh bagian yang tidak ada dalam daftar.

overlapIgnored

Ambang tumpang tindih bagian dalam stud yang diabaikan sebelum bagian dianggap menyentuh.

True jika dan hanya jika salah satu dari `Class.Part|parts` dalam `partList` menyentuh bagian lainnya (bagian yang tidak ada dalam partList). False jika tidak ada bagian yang dipass.

Mengembalikan true jika salah satu dari `Class.BasePart` yang diberikan menyentuh bagian lainnya.

Melakukan raycasting dan mengembalikan tabrakan pertama dengan `Class.BasePart` atau
`Class.Terrain`. Mencetak properti dari RaycastResult jika suatu hasil terkena.


Mengcast sebuah bentuk blok ke arah tertentu dan mengembalikan tabrakan pertama
 dengan `Class.BasePart` atau sel `Class.Terrain`. Ini analog dengan bagaimana
 `Class.WorldRoot:Raycast()` mengcast sebuah sinar linier ke arah tertentu untuk menemukan
 tabrakan, tetapi menggunakan bentuk 3D alih-alih sinar.

Tidak seperti `Class.WorldRoot:GetPartsInPart()`, metode ini tidak mendeteksi
`Class.BasePart|BaseParts` yang **awal** bertemu dengan bentuk tersebut.

Jika tabrakan terdeteksi, `Datatype.RaycastResult` dikembalikan yang berisi
informasi tabrakan. Properti `Datatype.RaycastResult.Distance|Distance`
mewakili jarak yang harus ditempuh bentuk untuk menemukan tabrakan,
dan properti `Datatype.RaycastResult.Position|Position` mewakili
titik perpotongan yang menyebabkan tabrakan.

Metode ini melempar kesalahan jika diberikan input `Datatype.CFrame`,
ukuran, atau arah yang tidak valid.

WorldRoot:Blockcast

cframe

Posisi awal dan rotasi dari bentuk blok yang dikast.

size

Ukuran bentuk blok yang dikast dalam stud. Ukuran maksimum adalah 512
stud.

direction

Arah dari shapecast, dengan magnitudo mewakili
jarak maksimum yang dapat ditempuh bentuk. Jarak maksimum adalah 1024
stud.

params

Mengandung hasil dari operasi shapecast, atau `nil` jika tidak ada
`Class.BasePart` atau sel `Class.Terrain` yang memenuhi syarat yang terkena.

Mengcast sebuah bentuk blok ke arah tertentu dan mengembalikan
`Datatype.RaycastResult` jika bentuk tersebut mengenai `Class.BasePart` atau
sel `Class.Terrain`.

Fungsi ini memindahkan tabel `Class.BasePart|BaseParts` ke tabel
`Datatype.CFrame|CFrames` tanpa harus memicu properti default
`Class.Object.Changed|Changed` events. Ini menyediakan cara yang sangat cepat untuk
memindahkan sejumlah besar bagian, karena Anda tidak perlu membayar biaya dari sekumpulan
properti untuk setiap bagian individu.

Argumen ketiga memungkinkan Anda untuk lebih mengoptimalkan operasi pemindahan.
Secara default, `Class.Object.Changed|Changed` event dari setiap bagian terpicu
untuk `Class.BasePart.Position|Position`,
`Class.BasePart.Orientation|Orientation`, dan
`Class.BasePart.CFrame|CFrame`. Namun, jika Anda menentukan
`Enum.BulkMoveMode|FireCFrameChanged` sebagai argumen ketiga, hanya
`Class.Object.Changed|Changed` event untuk
`Class.BasePart.CFrame|CFrame` properti yang akan terpicu.

Perhatikan bahwa Anda hanya boleh menggunakan fungsi ini jika Anda yakin
bahwa pemindahan bagian adalah bottleneck dalam kode Anda. Sederhana menyetel
`Class.BasePart.CFrame|CFrame` properti dari bagian individu dan
model yang dilas sudah cukup cepat dalam sebagian besar kasus.

WorldRoot:BulkMoveTo

cframeList

eventMode

Memindahkan tabel `Class.BasePart|BaseParts` ke tabel
`Datatype.CFrame|CFrames`.

**FindPartOnRay** menggunakan [raycasting](/workspace/raycasting) untuk
menemukan `Class.BasePart` pertama atau sel `Class.Terrain` yang memotong
 dengan `Datatype.Ray` yang diberikan. Fungsi ini mengembalikan `Class.BasePart` atau
sel terrain yang terkena, titik perpotongan, normal permukaan di titik
perpotongan, dan `Enum.Material` terkait dari objek yang terkena.

Jika parameter `ignoreDescendantsInstance` diberikan, perhitungan raycasting
akan mengabaikan objek yang diberikan dan semua keturunannya. Ia
berperilaku mirip dengan properti `Class.Mouse.TargetFilter`.

Parameter `terrainCellsAreCubes` dan `ignoreWater` menentukan apakah
sel `Class.Terrain` harus dianggap sebagai kubus atau tidak, dan apakah
air harus diabaikan atau tidak.

Untuk menyertakan atau mengecualikan beberapa objek dan keturunannya,
gunakan varian `Class.WorldRoot:FindPartOnRayWithWhitelist()` dan
`Class.WorldRoot:FindPartOnRayWithIgnoreList()`.

#### Catatan

- Secara teoritis, sebuah sinar membentang tak terhingga ke satu arah. Namun,
panjang maksimum dari vektor arah di Roblox adalah 15000 stud.
- Panjang (magnitudo) dari vektor arah itu penting, karena bagian
  yang lebih jauh dari panjangnya tidak akan diuji.
- Jika sinar tidak memotong apapun, nilai kembali akan `nil`
dan titik di ujung sinar,
  masing-masing.
- Bagian yang berada dalam
  [grup tabrakan](/workspace/collisions#collision-filtering)
yang tidak bertabrakan dengan grup tabrakan "Default" akan diabaikan
  secara implisit.

WorldRoot:FindPartOnRay

ignoreDescendantsInstance

terrainCellsAreCubes

ignoreWater

Sel `Class.BasePart` atau `Class.Terrain` yang terkena, poin
`Datatype.Vector3` perpotongan, normal permukaan `Datatype.Vector3` di titik
perpotongan, dan `Enum.Material`
dari `Class.BasePart` atau sel terrain yang terkena.

Mengembalikan `Class.BasePart` pertama atau sel `Class.Terrain` yang memotong
 dengan `Datatype.Ray` yang diberikan.

WorldRoot:findPartOnRay

Fungsi ini adalah varian dari `Class.WorldRoot:FindPartOnRay()` dengan
penambahan daftar abaikan. Ini memungkinkan Anda untuk mengabaikan bagian tertentu atau
`Class.Model|Models`.

Mereka yang ingin **menyertakan** kelompok objek tertentu sebaiknya
digunakan `Class.WorldRoot:FindPartOnRayWithWhitelist()`.

WorldRoot:FindPartOnRayWithIgnoreList

ignoreDescendantsTable

Sel `Class.BasePart` atau `Class.Terrain` yang terkena, titik
`Datatype.Vector3` perpotongan, normal permukaan `Datatype.Vector3` di titik
perpotongan, dan `Enum.Material`
dari `Class.BasePart` atau sel terrain yang terkena.

Mengembalikan sel `Class.BasePart` atau `Class.Terrain` pertama yang memotong
 dengan  `Datatype.Ray` yang diberikan yang tidak ada dalam, maupun merupakan keturunan dari
objek dalam, daftar abaikan yang diberikan.

Fungsi ini adalah varian dari `Class.WorldRoot:FindPartOnRay()` dengan
tambahan daftar inklusi. Ini memungkinkan Anda untuk mendeteksi hanya bagian tertentu atau
`Class.Model|Models` dan sangat berguna ketika, misalnya, mencari
 titik perpotongan antara sinar dan bagian tunggal.

Jika nilai `nil` diberikan dalam daftar inklusi, instance setelahnya akan
 diabaikan.

Mereka yang ingin **mengecualikan** kelompok objek tertentu sebaiknya
gunakan `Class.WorldRoot:FindPartOnRayWithIgnoreList()`.

WorldRoot:FindPartOnRayWithWhitelist

whitelistDescendantsTable

Mengembalikan sel `Class.BasePart` atau `Class.Terrain` pertama yang memotong
dengan `Datatype.Ray` yang diberikan yang ada dalam, atau merupakan keturunan dari objek
 dalam, daftar inklusi yang diberikan.

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang diberikan.

Fungsi ini mengambil parameter opsional maxParts (default 20) yang
membatasi jumlah `Class.BasePart|BaseParts` yang dapat dikembalikan. Setelah
jumlah ini tercapai, pencarian `Class.BasePart|BaseParts`
akan berhenti. Ini berarti beberapa `Class.BasePart|BaseParts` mungkin tidak dikembalikan
 meskipun mereka berada dalam `Datatype.Region3`

Parameter opsional `ignoreDescendantsInstance` dapat digunakan untuk menentukan
objek spesifik yang mana dirinya dan semua keturunannya harus diabaikan
oleh fungsi ini. Ini bisa berguna ketika, misalnya, ingin
melihat apakah ada `Class.BasePart|BaseParts` yang di dalam `Class.BasePart` selain
`Class.BasePart` itu sendiri.

```
local min = part.Position - (0.5 * part.Size)
local max = part.Position + (0.5 * part.Size)
local region = Region3.new(min, max)
local parts = worldroot:FindPartsInRegion3(region, part)  -- Abaikan bagian
```
Varian dari metode ini, `Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` dan
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()` ada untuk memberikan
fungsi pengecualian dan inklusi yang spesifik.

Jika tidak ada `Class.BasePart|BaseParts` yang ditemukan, array kosong akan dikembalikan.

WorldRoot:FindPartsInRegion3

region

Sebuah `Class.Instance` yang akan diabaikan.

maxParts

Jumlah maksimum `Class.BasePart|BaseParts` yang akan dikembalikan.

Array `Class.BasePart|BaseParts` di dalam `Datatype.Region3`.

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang diberikan.

WorldRoot:findPartsInRegion3

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang tidak ada dalam, atau merupakan keturunan dari entri dalam,
daftar abaikan yang diberikan.

Jika nilai `nil` diberikan dalam daftar abaikan, instance setelah nilai ini
akan diabaikan. Jika tidak ada `Class.BasePart|BaseParts` yang ditemukan, array kosong
akan dikembalikan.

Fungsi ini adalah varian dari `Class.WorldRoot:FindPartsInRegion3()` dengan
penambahan daftar abaikan. Ini memungkinkan pengembang untuk mengecualikan
bagian tertentu `Class.BasePart|BaseParts` atau `Class.Model|Models` dari pencarian.
Mereka yang ingin menemukan `Class.BasePart|BaseParts` dalam
`Datatype.Region3` menggunakan daftar inklusi harus menggunakan
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()`.

WorldRoot:FindPartsInRegion3WithIgnoreList

Array `Class.BasePart|BaseParts` ditemukan dalam `Datatype.Region3`.

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang tidak ada dalam, atau merupakan keturunan dari entri dalam,
daftar abaikan yang diberikan.

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang ada dalam, atau merupakan keturunan dari entri dalam,
dalist inklusi yang diberikan.

Jika nilai `nil` diberikan dalam daftar inklusi, instance setelah nilai ini
akan diabaikan. Jika tidak ada `Class.BasePart|BaseParts` yang ditemukan, array
kosong akan dikembalikan.

Fungsi ini adalah varian dari `Class.WorldRoot:FindPartsInRegion3()` dengan
penambahan daftar inklusi. Ini memungkinkan pengembang untuk menyertakan
hanya bagian tertentu `Class.BasePart|BaseParts` atau `Class.Model|Models` dalam
 pencarian. Mereka yang ingin menemukan `Class.BasePart|BaseParts` dalam
`Datatype.Region3` menggunakan daftar pengecualian harus menggunakan
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.

WorldRoot:FindPartsInRegion3WithWhiteList

Mengembalikan array `Class.BasePart|BaseParts` di dalam
`Datatype.Region3` yang ada dalam, atau merupakan keturunan dari entri dalam,
dalist inklusi yang diberikan.

`Class.WorldRoot:GetPartBoundsInBox()` mengembalikan array bagian yang
 **kotak pembatasnya** bertabrakan dengan kotak yang volumennya dijelaskan menggunakan pusat yang diberikan
(`Datatype.CFrame`) dan ukuran (`Datatype.Vector3`).

Seperti yang ditekankan, metode kueri spasial ini secara efisien mempertimbangkan volume
kotak pembatas bagian, bukan volume yang sebenarnya ditempati. Ini
mungkin penting ketika mempertimbangkan silinder, bola, unis, dan
`Class.MeshPart|MeshParts` yang memiliki bentuk non-blok. Untuk kasus di mana
akurasi sangat penting, gunakan `Class.WorldRoot:GetPartsInPart()`
sebagai gantinya, atau saring hasil metode ini sendiri.

Metode ini menggunakan objek `Datatype.OverlapParams` untuk mendeskripsikan
bagian yang dapat digunakan kembali dari kueri spasial, seperti daftar inklusi atau
pengecualian, jumlah maksimum bagian untuk diquery, grup
[tabrakan](/workspace/collisions#collision-filtering) yang
 digunakan, dan apakah kueri memprioritaskan nilai `Class.BasePart.CanCollide`
dari bagian yang dipotong dibandingkan dengan nilai `Class.BasePart.CanQuery`.

WorldRoot:GetPartBoundsInBox

Lokasi pusat dari volume kotak yang diberikan untuk diproses.

Ukuran dari volume kotak yang diberikan untuk diproses.

overlapParams

Mengandung bagian yang dapat digunakan kembali dari parameter kueri spasial.

Array `Class.BasePart|BaseParts` yang cocok dengan kueri spasial.

Mengembalikan array bagian yang **kotak pembatasnya** bertabrakan dengan kotak yang diberikan.

`Class.WorldRoot:GetPartBoundsInRadius()` mengembalikan array bagian yang
 **kotak pembatasnya** bertabrakan dengan sebuah bola yang volumennya dijelaskan menggunakan
pusat yang diberikan (`Datatype.Vector3`) dan radius (angka).

Seperti yang ditekankan, metode kueri spasial ini secara efisien mempertimbangkan volume
kotak pembatas bagian, bukan volume yang sebenarnya ditempati. Ini
mungkin penting ketika mempertimbangkan silinder, bola, unis, dan
`Class.MeshPart|MeshParts` yang memiliki bentuk non-blok. Untuk kasus di mana
akurasi sangat penting, gunakan `Class.WorldRoot:GetPartsInPart()`
sebagai gantinya, atau saring hasil metode ini sendiri.

Metode ini menggunakan objek `Datatype.OverlapParams` untuk mendeskripsikan
bagian yang dapat digunakan kembali dari kueri spasial, seperti daftar inklusi atau
pengecualian, jumlah maksimum bagian untuk diquery, grup
[tabrakan](/workspace/collisions#collision-filtering) yang
 digunakan, dan apakah kueri memprioritaskan nilai `Class.BasePart.CanCollide`
dari bagian yang dipotong dibandingkan dengan nilai `Class.BasePart.CanQuery`.

WorldRoot:GetPartBoundsInRadius

position

Lokasi pusat dari volume bola yang diberikan untuk diproses.

radius

Radius dari volume bola yang diberikan untuk diproses.

Mengembalikan array bagian yang **kotak pembatasnya** bertabrakan dengan bola yang diberikan.

`Class.WorldRoot:GetPartsInPart()` mengembalikan array bagian yang ruang yang ditempatinya berbagi dengan bagian yang diberikan (yang harus ada di `Class.WorldRoot` yang sama dengan bagian yang akan diproses). Metode ini dapat digunakan sebagai pengganti `Class.BasePart:GetTouchingParts()` dan umumnya merupakan pilihan yang lebih baik.

Seperti yang dicatat, metode kueri spasial ini mempertimbangkan **volume tepat**
 yang ditempati oleh bagian yang diberikan menggunakan pemeriksaan tabrakan geometris penuh. Sebagai contoh, bagian cekung/kosong tidak akan cocok dengan bagian yang ditanyakan di dalamnya kecuali
mereka benar-benar bertabrakan/menghubungi bagian tersebut. Untuk volume yang lebih sederhana, pertimbangkan untuk menggunakan `Class.WorldRoot:GetPartBoundsInBox()` atau
`Class.WorldRoot:GetPartBoundsInRadius()`, karena mereka kurang akurat tetapi
beroperasi lebih efisien.

Metode ini menggunakan objek `Datatype.OverlapParams` untuk mendeskripsikan
 bagian yang dapat digunakan kembali dari kueri spasial, seperti daftar inklusi atau
pengecualian, jumlah maksimum bagian untuk diquery, grup
[tabrakan](/workspace/collisions#collision-filtering) yang digunakan, dan apakah kueri memprioritaskan nilai `Class.BasePart.CanCollide`
dari bagian yang dipotong dibandingkan dengan nilai `Class.BasePart.CanQuery`.

WorldRoot:GetPartsInPart

part

Bagian yang volumenya diperiksa terhadap bagian lainnya.

Mengembalikan array bagian yang ruang yang ditempatinya berbagi dengan bagian yang diberikan.

Fungsi ini memindahkan bagian yang ditentukan ke lokasi yang ditentukan melalui
[kinematika terbalik](https://en.wikipedia.org/wiki/Inverse_kinematics)
bukan memindahkannya secara langsung, untuk memastikan bahwa semua sendi,
`Class.Constraint|constraints`, atau batas yang dihadapi oleh bagian tersebut tetap
berada dalam kondisi fisik yang terpenuhi. Saat ini fungsi ini hanya tersedia
 di Studio untuk `Class.Plugin|plugins`, karena saat ini bertentangan dengan
fisika permainan yang sedang berlangsung.

**Translate stiffness** adalah angka antara 0 dan 1 yang menentukan seberapa
agresif untuk mencocokkan posisi bagian dengan posisi bagian dari `Datatype.CFrame`
yang menjadi target. **Rotate stiffness** adalah angka antara 0 dan 1 yang menentukan
seberapa agresif untuk mencocokkan rotasi bagian dengan rotasi bagian dari
`Datatype.CFrame` yang menjadi target.

Contoh:

- Jika translate stiffness dan rotate stiffness keduanya sama dengan 1, maka
  bagian tersebut akan dipindahkan tepat ke CFrame target tanpa mempedulikan apa yang
  batas fisik ada pada bagian tersebut.
- Jika translate stiffness dan rotate stiffness keduanya sama dengan 0.5, maka
  bagian tersebut akan mencoba untuk berpindah tepat ke CFrame target, tetapi mungkin
  didorong keluar oleh batas fisik yang dikenakan kepadanya.
- Jika translate stiffness dan rotate stiffness keduanya sama dengan 0, maka
  CFrame target akan diabaikan dan batas fisik akan diselesaikan untuk objek pada posisi dimana ia berada.

WorldRoot:IKMoveTo

target

Lokasi untuk memindahkan bagian yang ditentukan.

translateStiffness

Angka antara 0 dan 1 yang menentukan seberapa agresif untuk mencocokkan
posisi bagian dengan posisi bagian dari `Datatype.CFrame` yang menjadi target.

rotateStiffness

Angka antara 0 dan 1 yang menentukan seberapa agresif untuk mencocokkan
rotasi bagian dengan rotasi bagian dari `Datatype.CFrame` yang menjadi target.

collisionsMode

Memungkinkan Anda untuk menentukan objek mana yang harus dipengaruhi oleh penyelesaian fisik.

Memindahkan bagian yang ditentukan ke lokasi yang ditentukan melalui kinematika terbalik
 dan bukan memindahkannya langsung, untuk memastikan bahwa semua sendi, batas,
atau tabrakan yang dihadapi oleh bagian tersebut tetap terpenuhi secara fisik.

**IsRegion3Empty** mengembalikan bool yang menunjukkan apakah tidak ada
`Class.BasePart|BaseParts` yang berada dalam `Datatype.Region3` yang diberikan.

Parameter opsional `ignoreDescendantsInstance` dapat digunakan untuk menentukan
objek spesifik yang mana dirinya dan semua keturunannya harus diabaikan
oleh fungsi ini. Ini bisa berguna ketika, misalnya, ingin
melihat apakah ada `Class.BasePart|BaseParts` yang di dalam `Class.BasePart` selain
`Class.BasePart` itu sendiri.

```
local min = part.Position - (0.5 * part.Size)
local max = part.Position + (0.5 * part.Size)
local region = Region3.new(min, max)
local isPartEmpty = worldroot:IsRegion3Empty(region, part)  -- Abaikan bagian
```
Jika lebih dari satu objek dan keturunannya perlu dikecualikan dari
pencarian, pengembang harus menggunakan
`Class.WorldRoot:IsRegion3EmptyWithIgnoreList()`.

Fungsi ini hanya mengembalikan apakah sebuah wilayah kosong atau tidak. Pengembang yang ingin menemukan `Class.BasePart|BaseParts` dalam sebuah wilayah sebaiknya menggunakan
`Class.WorldRoot:FindPartsInRegion3()`.

#### Bagaimana pengecekan Region3 bekerja?

Memeriksa apakah sebuah bagian bertabrakan dengan `Datatype.Region3` bukanlah proses yang sederhana.
Ini sebenarnya memakan waktu dan rumit. Sebagai gantinya, ia memeriksa apakah bagian-bagian
ada di area yang kira-kira sama. Saat fungsi ini dipanggil, ia menentukan
voxel mana yang mengandung `Datatype.Region3`. Setelah itu, ia menentukan bagian mana yang mungkin ada di
dalam voxel tersebut. Ia melakukannya dengan membandingkan kotak pembatas yang terarah (kadang-kadang disebut AABB) dari bagian
 dengan voxel. Kotak pembatas terarah bisa terlihat di Roblox Studio saat sebuah bagian dipilih.

Ini berarti bahwa area yang diperiksa oleh fungsi ini mungkin lebih besar
 daripada `Datatype.Region3`. Oleh karena itu disarankan untuk memastikan bahwa `Datatype.Region3`
ada pada grid voxel. Cara terbaik untuk melakukannya adalah dengan mengatur
koordinat `Datatype.Region3` menjadi kelipatan 4 (karena voxel
berukuran 4 x 4 x 4 stud).

Metode ini adalah cara yang cukup cepat dan mudah untuk melihat apakah ada bagian dalam area umum. Jika sebuah permainan perlu tahu apakah bagian ada
secara tepat dalam area, maka `Class.BasePart:GetTouchingParts()` harus digunakan. Ada biaya lebih tinggi untuk menggunakan
`Class.BasePart:GetTouchingParts()` karena sebuah bagian diperlukan
 dalam `Class.WorldRoot` dan fungsi ini membutuhkan waktu lebih lama untuk dijalankan.

WorldRoot:IsRegion3Empty

ignoreDescendentsInstance

Mengembalikan bool yang menunjukkan apakah tidak ada `Class.BasePart|BaseParts`
yang berada dalam `Datatype.Region3` yang diberikan.

Mengembalikan boolean yang menunjukkan apakah tidak ada
`Class.BasePart|BaseParts` dalam `Datatype.Region3` yang diberikan, mengabaikan
setiap `Class.BasePart|BaseParts` yang merupakan keturunan dari objek-objek dalam
daftar abaikan yang diberikan. Jika nilai `nil` diberikan dalam daftar abaikan,
instance setelahnya akan diabaikan.

Fungsi ini hanya akan mengembalikan apakah sebuah wilayah kosong atau tidak. Pengembang yang ingin menemukan `Class.BasePart|BaseParts` yang spesifik
 dalam sebuah wilayah sebaiknya menggunakan
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.

Fungsi ini adalah varian dari `Class.WorldRoot:IsRegion3Empty()` dengan
penambahan daftar abaikan. Dalam kasus di mana daftar inklusi diperlukan
sebaliknya, pengembang harus memeriksa apakah ada bagian yang dikembalikan oleh
`Class.WorldRoot:FindPartsInRegion3WithWhitelist()`.

WorldRoot:IsRegion3EmptyWithIgnoreList

ignoreDescendentsTable

Mengembalikan boolean yang menunjukkan apakah tidak ada
`Class.BasePart|BaseParts` dalam `Datatype.Region3` yang diberikan, mengabaikan
setiap `Class.BasePart|BaseParts` yang merupakan keturunan dari objek-objek dalam
daftar abaikan yang diberikan.

Mengeluarkan sinar dan mengembalikan tabrakan pertama dengan `Class.BasePart` atau
`Class.Terrain`. Mencetak properti dari RaycastResult jika ada hasil yang
terkena.


Mengcast sebuah sinar menggunakan asal, arah, dan opsional
`Datatype.RaycastParams`. Jika menemukan `Class.BasePart` atau sel `Class.Terrain`
yang memenuhi syarat, `Datatype.RaycastResult` dikembalikan yang berisi
hasil dari operasi tersebut. Jika tidak diberikan objek `Datatype.RaycastParams`,
default digunakan (semua bagian dianggap dan air `Class.Terrain` tidak diabaikan).

Perhatikan bahwa panjang (magnitudo) dari vektor arah itu penting,
karena objek/terrain yang lebih jauh dari panjangnya tidak akan diuji. Jika
you menggunakan `Datatype.CFrame` untuk membantu membuat komponen sinar,
pertimbangkan untuk menggunakan `Datatype.CFrame.LookVector` sebagai vektor arah dan
mengalikannya dengan panjang yang diinginkan seperti yang ditunjukkan dalam contoh di bawah.
Panjang maksimum vektor arah adalah 15,000 stud.

Metode ini **tidak** menggunakan objek `Datatype.Ray`, tetapi asal dan
komponennya dapat dipinjam dari `Datatype.Ray.Origin` dan
`Datatype.Ray.Direction`.

WorldRoot:Raycast

origin

Vektor arah dari sinar. Perhatikan bahwa panjang vektor ini
berarti, karena bagian/terrain yang lebih jauh dari panjangnya tidak akan diuji.

raycastParams

Objek yang digunakan untuk menentukan kelayakan tabrakan dalam operasi raycast. Jika
tidak diberikan, nilai default digunakan dimana semua bagian dianggap
 dan air `Class.Terrain` tidak diabaikan.

Mengandung hasil dari operasi raycast, atau `nil` jika tidak ada `Class.BasePart` atau
sel `Class.Terrain` yang memenuhi syarat yang terkena.

Mengcast sebuah sinar menggunakan asal, arah, dan opsional
`Datatype.RaycastParams`, kemudian mengembalikan `Datatype.RaycastResult` jika ada
objek atau terrain yang memenuhi syarat yang memotong sinar tersebut.

WorldRoot:Shapecast

Mengeluarkan sebuah bola dan mengembalikan tabrakan pertama dengan `Class.BasePart` atau
`Class.Terrain`. Mencetak properti dari RaycastResult jika ada hasil yang
terkena.


Mengcast bentuk bulat ke arah tertentu dan mengembalikan tabrakan pertama
 dengan `Class.BasePart` atau sel `Class.Terrain`. Ini
analog dengan bagaimana `Class.WorldRoot:Raycast()` mengcast sebuah sinar linier ke arah tertentu untuk menemukan tabrakan, tetapi menggunakan bentuk 3D alih-alih sinar.

Tidak seperti `Class.WorldRoot:GetPartsInPart()`, metode ini tidak mendeteksi
`Class.BasePart|BaseParts` yang **awal** berpotongan dengan bentuk tersebut.

Jika tabrakan terdeteksi, `Datatype.RaycastResult` dikembalikan yang berisi
informasi tabrakan. Properti `Datatype.RaycastResult.Distance|Distance`
mewakili jarak yang harus ditempuh bentuk untuk menemukan tabrakan,
dan properti `Datatype.RaycastResult.Position|Position` mewakili
 titik perpotongan yang menyebabkan tabrakan.

Metode ini membuang kesalahan jika diberikan masukan radius atau arah
 yang tidak valid.

WorldRoot:Spherecast

Posisi awal dari bentuk bulat yang dikast.

Radius dari bentuk bulat yang dikast dalam stud. Radius maksimum adalah
256 stud.

Arah dari shapecast, dengan magnitudo mewakili
 jarak maksimum yang dapat ditempuh bentuk. Jarak maksimum adalah 1024
stud.

Mengcast sebuah bentuk bulat ke arah tertentu dan mengembalikan
`Datatype.RaycastResult` jika bentuk tersebut mengenai `Class.BasePart` atau
sel `Class.Terrain`.

Mensimulasikan bagian-bagian di workspace untuk jangka waktu tetap dengan memanggil
fungsi StepPhysics sekali per frame sampai waktu yang ditentukan telah berlalu.


Maju simulasi untuk bagian dalam dunia berdasarkan
increment waktu yang ditentukan dan set `Class.BasePart` yang opsional. Ketika set bagian
diberikan, hanya bagian-bagian ini yang akan disimulasikan dan semua
 bagian lainnya di dunia akan diperlakukan sebagai terikat. Ketika argumen ini dibiarkan,
simulasi akan mencakup semua bagian dalam dunia. Increment waktu yang ditentukan dapat berupa
angka positif manapun, dengan nilai yang lebih besar meningkatkan waktu proses fungsi.
Tergantung pada nilai dari increment waktu, sistem fisika dapat membagi
ini menjadi beberapa langkah individual untuk mempertahankan akurasi dan
stabilitas simulasi. Bahkan jika fungsi menjalankan beberapa langkah sub,
hasil simulasi hanya akan terlihat setelah fungsi selesai. Untuk memvisualisasikan langkah-langkah individual dari simulasi,
fungsi dapat dipanggil sekali per RenderStep melalui event `Class.RunService.RenderStepped`.

WorldRoot:StepPhysics

Jumlah waktu yang akan disimulasikan. Argumen ini harus berupa
angka positif. Nilai yang lebih besar akan meningkatkan waktu proses fungsi ini.

parts

Array opsional dari bagian yang akan disimulasikan. Set ini harus berisi
 instance yang bertipe `Class.BasePart`; tipe lainnya akan diabaikan.

Maju simulasi untuk bagian-bagian dalam dunia berdasarkan
increment waktu yang ditentukan dan set optional
`Class.BasePart|BaseParts`.

WorldRoot

Kelas dasar untuk menangani simulasi fisika dan kueri spasial 3D.

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

`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

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

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.

/reference/engine/classes/WorldModel.yaml