Khi được gán làm cha cho một `Class.ViewportFrame`, `WorldModel` mở rộng vật lý hạn chế
cho các đối tượng con lên `Class.ViewportFrame` đó. Ví dụ,
`Class.BasePart|BaseParts` được gán làm cha cho `WorldModel` có thể được
hoạt hình và truy vấn không gian (ví dụ bằng cách sử dụng raycasts) nhưng các phần này thì
**không** được mô phỏng. Hơn nữa, bạn có thể đặt các nhân vật `Class.Humanoid` vào trong
`WorldModel` và các khớp của chúng sẽ được thiết lập chính xác cho hoạt hình.

Để tránh các vấn đề hiệu suất có thể xảy ra, hãy đảm bảo chỉ tạo `WorldModels`
khi bạn muốn hiển thị chúng và xóa `WorldModels` không còn được sử dụng.

WorldModel

Mở rộng vật lý hạn chế cho các đối tượng con lên một `Class.ViewportFrame`.

Lớp cơ sở này cung cấp một API cho bất kỳ thể hiện nào được thiết kế để xử lý
các truy vấn không gian 3D và mô phỏng, chẳng hạn như `Class.Workspace` và
`Class.WorldModel`.


Khối mã bên dưới minh họa cách sử dụng
`Class.WorldRoot:ArePartsTouchingOthers()` để kiểm tra xem các phần trong danh sách có
chạm vào bất kỳ phần nào trong không gian làm việc không có trong danh sách.

Trước tiên, kịch bản tạo hai phần vuông chồng lên nhau 1 stud, `Part1` và
`Part2`. Sau đó, nó in giá trị trả về bởi ArePartsTouchingOthers() khi
Part1 được truyền vào `partList` với ba giá trị chồng lên khác nhau: `0`, `0.999`,
và `1`. Hai lần đầu tiên ArePartsTouchingOthers() được gọi trả về `false`
bởi vì giá trị chồng lên nhỏ hơn khoảng cách mà Part1 và Part2
chồng lên nhau. Lần gọi thứ ba trả về `true` vì giá trị chồng lên bằng
khoảng cách mà các phần chồng lên nhau.

**ArePartsTouchingOthers** trả về true nếu ít nhất một trong các
`Class.BasePart` được cung cấp đang chạm vào bất kỳ phần nào khác. Hai phần được coi
là "chạm" nếu chúng nằm trong ngưỡng khoảng cách, `overlapIgnored`.

Nếu không có phần nào được cung cấp, giá trị false sẽ được trả về.


WorldRoot:ArePartsTouchingOthers

partList

Một danh sách các phần để kiểm tra xem có bất kỳ phần nào trong danh sách đang chạm vào
các phần không có trong danh sách.


overlapIgnored

Ngưỡng chồng lấp phần trong studs bị bỏ qua trước khi các phần được coi là
đang chạm vào nhau.


Đúng nếu và chỉ nếu bất kỳ `Class.Part|parts` nào trong `partList` đang
chạm vào bất kỳ phần nào khác (các phần không có trong partList). Sai nếu không có
phần nào được truyền vào.


Trả về true nếu bất kỳ `Class.BasePart` nào được cung cấp đang chạm vào bất kỳ
phần nào khác.


Phát một khối và trả về va chạm đầu tiên với một `Class.BasePart` hoặc
`Class.Terrain`. In ra các thuộc tính của RaycastResult nếu có kết quả
bị va chạm.


Đẩy một hình khối theo một hướng và trả về va chạm đầu tiên
với một `Class.BasePart` hoặc `Class.Terrain` cell. Điều này tương tự như cách
`Class.WorldRoot:Raycast()` đẩy một tia theo một hướng để tìm một
va chạm, nhưng sử dụng một hình 3D thay vì một tia.

Khác với `Class.WorldRoot:GetPartsInPart()`, phương pháp này không phát hiện
`Class.BasePart|BaseParts` mà **ban đầu** giao cắt với hình.

Nếu phát hiện được va chạm, một `Datatype.RaycastResult` sẽ được trả về chứa
thông tin va chạm. Thuộc tính `Datatype.RaycastResult.Distance|Distance`
đại diện cho khoảng cách mà hình phải di chuyển để tìm một va chạm,
và thuộc tính `Datatype.RaycastResult.Position|Position` đại diện cho
điểm giao cắt gây ra va chạm.

Phương pháp này sẽ ném lỗi nếu nó được truyền vào các giá trị không hợp lệ cho `Datatype.CFrame`,
kích thước, hoặc đầu vào hướng.


WorldRoot:Blockcast

cframe

Vị trí ban đầu và độ xoay của hình khối được đẩy.


size

Kích thước của hình khối được đẩy trong studs. Kích thước tối đa là 512
studs.


direction

Hướng của hình đẩy, với độ lớn đại diện cho
khoảng cách tối đa mà hình có thể di chuyển. Khoảng cách tối đa là 1024
studs.


params

Chứa kết quả của hoạt động đẩy hình, hoặc `nil` nếu không có
`Class.BasePart` hoặc `Class.Terrain` cell hợp lệ nào bị va chạm.


Đẩy một hình khối theo một hướng nhất định và trả về một
`Datatype.RaycastResult` nếu hình đó chạm vào một `Class.BasePart` hoặc
`Class.Terrain` cell.


Hàm này di chuyển một bảng của `Class.BasePart|BaseParts` đến một bảng của
`Datatype.CFrame|CFrames` mà không nhất thiết phải kích hoạt các sự kiện thuộc tính
`Class.Object.Changed|Changed` mặc định. Điều này cung cấp một cách rất nhanh để
di chuyển một số lượng lớn các phần, bởi vì bạn không phải chịu chi phí của việc
thiết lập thuộc tính riêng cho mỗi phần riêng lẻ.

Tham số thứ ba cho phép bạn tối ưu hóa thêm hoạt động di chuyển.
Theo mặc định, sự kiện `Class.Object.Changed|Changed` của mỗi phần được kích hoạt
cho `Class.BasePart.Position|Position`,
`Class.BasePart.Orientation|Orientation`, và
`Class.BasePart.CFrame|CFrame`. Tuy nhiên, nếu bạn chỉ định
`Enum.BulkMoveMode|FireCFrameChanged` làm tham số thứ ba, chỉ sự kiện
`Class.Object.Changed|Changed` cho thuộc tính
`Class.BasePart.CFrame|CFrame` sẽ được kích hoạt.

Lưu ý rằng bạn chỉ nên sử dụng hàm này nếu bạn chắc chắn rằng di chuyển các phần
là một điểm nghẽn trong mã của bạn. Chỉ cần thiết lập thuộc tính
`Class.BasePart.CFrame|CFrame` của các phần riêng lẻ và các mô hình hàn cũng đủ nhanh trong hầu hết các trường hợp.


WorldRoot:BulkMoveTo

cframeList

eventMode

Di chuyển một bảng của `Class.BasePart|BaseParts` đến một bảng của
`Datatype.CFrame|CFrames`.


**FindPartOnRay** sử dụng [raycasting](/workspace/raycasting) để
tìm `Class.BasePart` đầu tiên hoặc `Class.Terrain` cell giao cắt với
a `Datatype.Ray` đã cho. Hàm này trả về `Class.BasePart` hoặc
cell địa hình bị va chạm, điểm giao cắt, pháp tuyến bề mặt tại điểm giao cắt,
và vật liệu `Enum.Material` liên quan.

Nếu tham số `ignoreDescendantsInstance` được cung cấp, phép tính raycasting
sẽ bỏ qua đối tượng đã cho và tất cả các con của nó. Nó
hành xử tương tự như thuộc tính `Class.Mouse.TargetFilter`.

Tham số `terrainCellsAreCubes` và `ignoreWater` xác định liệu
các cells `Class.Terrain` nên được coi là khối hay không, và liệu nước
có nên bị bỏ qua hay không.

Để bao gồm hoặc loại trừ nhiều đối tượng và các con của chúng, hãy sử dụng
`Class.WorldRoot:FindPartOnRayWithWhitelist()` và
`Class.WorldRoot:FindPartOnRayWithIgnoreList()`.

#### Ghi chú

- Về lý thuyết, một tia mở rộng vô hạn theo một hướng. Tuy nhiên, độ dài tối đa của
tuần hoàn vectơ trong Roblox là 15000 studs.
- Độ dài (độ lớn) của vectơ hướng là rất quan trọng, vì các phần
xa hơn độ dài của nó sẽ không được kiểm tra.
- Nếu tia không giao cắt với bất kỳ cái gì, các giá trị trả về sẽ là `nil`
và điểm ở cuối tia, tương ứng.
- Các phần nằm trong một
  [nhóm va chạm](/workspace/collisions#collision-filtering)
  không va chạm với nhóm va chạm "Mặc định" sẽ được bỏ qua
  ngầm.


WorldRoot:FindPartOnRay

ignoreDescendantsInstance

terrainCellsAreCubes

ignoreWater

Phần `Class.BasePart` hoặc cell `Class.Terrain` bị chạm, điểm giao cắt `Datatype.Vector3`, pháp tuyến bề mặt `Datatype.Vector3`
tại điểm giao cắt, và vật liệu `Enum.Material`
của phần `Class.BasePart` hoặc cell địa hình bị chạm.


Trả về `Class.BasePart` đầu tiên hoặc `Class.Terrain` cell giao cắt
với `Datatype.Ray` đã cho.


WorldRoot:findPartOnRay

Hàm này là một biến thể của `Class.WorldRoot:FindPartOnRay()` thêm một
danh sách bỏ qua. Điều này cho phép bạn bỏ qua một số phần hoặc
`Class.Model|Models` nhất định.

Những người muốn **bao gồm** một nhóm đối tượng cụ thể nên sử dụng
`Class.WorldRoot:FindPartOnRayWithWhitelist()`.


WorldRoot:FindPartOnRayWithIgnoreList

ignoreDescendantsTable

Trả về `Class.BasePart` đầu tiên hoặc `Class.Terrain` cell giao cắt
với `Datatype.Ray` đã cho mà không nằm trong, cũng không phải là con của một
đối tượng trong danh sách bỏ qua đã cho.


Hàm này là một biến thể của `Class.WorldRoot:FindPartOnRay()` với việc
thêm một danh sách bao gồm. Điều này cho phép bạn chỉ phát hiện các phần hoặc
`Class.Model|Models` nhất định và đặc biệt hữu ích khi, chẳng hạn,
bạn đang tìm kiếm các điểm giao cắt giữa một tia và một phần duy nhất.

Nếu một giá trị `nil` được đưa vào danh sách bao gồm, các thể hiện sau nó sẽ
bị bỏ qua.

Những người muốn **loại trừ** một nhóm đối tượng cụ thể nên sử dụng
`Class.WorldRoot:FindPartOnRayWithIgnoreList()`.


WorldRoot:FindPartOnRayWithWhitelist

whitelistDescendantsTable

Trả về `Class.BasePart` đầu tiên hoặc `Class.Terrain` cell giao cắt
với `Datatype.Ray` đã cho mà có trong, hoặc là con của một đối tượng
trong danh sách bao gồm đã cho.


Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3` đã cho.

Hàm này nhận một tham số maxParts tùy chọn (mặc định 20) giới hạn số lượng
`Class.BasePart|BaseParts` có thể được trả về. Khi số lượng này đạt đến,
tìm kiếm `Class.BasePart|BaseParts` sẽ dừng lại. Điều này có nghĩa là một số
`Class.BasePart|BaseParts` có thể không được trả về ngay cả khi chúng nằm trong
`Datatype.Region3`

Tham số `ignoreDescendantsInstance` tùy chọn có thể được sử dụng để chỉ định
một thể hiện cụ thể mà nó và tất cả các con của nó nên bị bỏ qua bởi hàm
này. Điều này có thể hữu ích khi, chẳng hạn, bạn đang tìm kiếm xem có bất kỳ
`Class.BasePart|BaseParts` nào nằm bên trong một `Class.BasePart` nào khác
không phải là `Class.BasePart` tự nó.

```
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)  -- Bỏ qua phần
```
Các biến thể của phương pháp này là `Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` và
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()` tồn tại để cung cấp các
chức năng loại trừ và bao gồm cụ thể.

Nếu không tìm thấy `Class.BasePart|BaseParts` nào, một mảng rỗng sẽ được
trả về.


WorldRoot:FindPartsInRegion3

region

Một `Class.Instance` để bị bỏ qua.


maxParts

Số lượng tối đa của `Class.BasePart|BaseParts` được trả về.


Một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3`.


Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3` đã cho.


WorldRoot:findPartsInRegion3

Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3`
dang không nằm trong, hoặc là con của một mục trong, danh sách bỏ qua đã cho.

Nếu một giá trị `nil` được đưa vào danh sách bỏ qua, các thể hiện sau giá trị này
sẽ không bị bỏ qua. Nếu không tìm thấy `Class.BasePart|BaseParts` nào, một mảng
rỗng sẽ được trả về.

Hàm này là một biến thể của `Class.WorldRoot:FindPartsInRegion3()` với
việc thêm vào một danh sách bỏ qua. Điều này cho phép nhà phát triển loại trừ
các `Class.BasePart|BaseParts` hoặc `Class.Model|Models` nhất định khỏi
tìm kiếm. Những người muốn tìm `Class.BasePart|BaseParts` trong một
`Datatype.Region3` bằng danh sách bao gồm nên sử dụng
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()`.


WorldRoot:FindPartsInRegion3WithIgnoreList

Một mảng các đối tượng để bị bỏ qua.


Một mảng của `Class.BasePart|BaseParts` được tìm thấy trong
`Datatype.Region3`.


Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3`
đang không nằm trong, hoặc là con của một mục trong, danh sách bỏ qua đã cho.


Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3`
thuộc về, hoặc là con của một mục trong, danh sách bao gồm đã cho.

Nếu một giá trị `nil` được đưa vào danh sách bao gồm, các thể hiện sau giá trị này
sẽ không bị bỏ qua. Nếu không tìm thấy `Class.BasePart|BaseParts` nào, một
mảng rỗng sẽ được trả về.

Hàm này là một biến thể của `Class.WorldRoot:FindPartsInRegion3()` với
việc thêm vào một danh sách bao gồm. Điều này cho phép nhà phát triển chỉ bao gồm
các `Class.BasePart|BaseParts` hoặc `Class.Model|Models` nhất định trong tìm kiếm. Những người muốn tìm
`Class.BasePart|BaseParts` trong một `Datatype.Region3` bằng danh sách loại trừ nên sử dụng
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.


WorldRoot:FindPartsInRegion3WithWhiteList

Một mảng các đối tượng để kiểm tra.


Trả về một mảng của `Class.BasePart|BaseParts` trong `Datatype.Region3`
thuộc về, hoặc là con của một mục trong, danh sách bao gồm đã cho.


`Class.WorldRoot:GetPartBoundsInBox()` trả về một mảng các phần có
**hộp chứa** giao cắt với một hộp có thể tích được mô tả bằng trung tâm đã cho
(`Datatype.CFrame`) và kích thước (`Datatype.Vector3`).

Như đã nhấn mạnh, phương pháp truy vấn không gian này xem xét hiệu quả thể tích
của hộp chứa các phần mà không xét đến thể tích thực sự mà chúng chiếm giữ. Điều này
có thể quan trọng khi xem xét các hình trụ, hình cầu, hợp nhất, và
`Class.MeshPart|MeshParts` có hình dạng không khối. Đối với các trường hợp mà
dộ chính xác là rất quan trọng, hãy sử dụng `Class.WorldRoot:GetPartsInPart()`
thay vào đó, hoặc tự lọc kết quả của phương pháp này.

Phương pháp này sử dụng một đối tượng `Datatype.OverlapParams` để mô tả các
phần có thể tái sử dụng của truy vấn không gian, chẳng hạn như danh sách bao gồm hoặc
loại trừ, số lượng tối đa các phần cần truy vấn, nhóm va chạm
[collisions](/workspace/collisions#collision-filtering) nên sử dụng, và liệu
truy vấn có ưu tiên giá trị `Class.BasePart.CanCollide` của phần bị giao cắt
oh hơn giá trị `Class.BasePart.CanQuery` của nó hay không.


WorldRoot:GetPartBoundsInBox

Vị trí trung tâm của thể tích hộp đã cho để được truy vấn.


Kích thước của thể tích hộp đã cho để được truy vấn.


overlapParams

Chứa các phần có thể tái sử dụng của các tham số truy vấn không gian.


Một mảng của `Class.BasePart|BaseParts` phù hợp với truy vấn không gian.


Trả về một mảng các phần có **hộp chứa** giao cắt với một hộp đã cho.


`Class.WorldRoot:GetPartBoundsInRadius()` trả về một mảng các phần có
**hộp chứa** giao cắt với một hình cầu có thể tích được mô tả bằng trung tâm đã cho
(`Datatype.Vector3`) và bán kính (số).

Như đã nhấn mạnh, phương pháp truy vấn không gian này xem xét hiệu quả thể tích
của hộp chứa các phần mà không xét đến thể tích thực sự mà chúng chiếm giữ. Điều này
có thể quan trọng khi xem xét các hình trụ, hình cầu, hợp nhất, và
`Class.MeshPart|MeshParts` có hình dạng không khối. Đối với các trường hợp mà
dộ chính xác là rất quan trọng, hãy sử dụng `Class.WorldRoot:GetPartsInPart()`
thay vào đó, hoặc tự lọc kết quả của phương pháp này.

Phương pháp này sử dụng một đối tượng `Datatype.OverlapParams` để mô tả các
phần có thể tái sử dụng của truy vấn không gian, chẳng hạn như danh sách bao gồm hoặc
loại trừ, số lượng tối đa các phần cần truy vấn, nhóm va chạm
[collisions](/workspace/collisions#collision-filtering) nên sử dụng, và liệu
truy vấn có ưu tiên giá trị `Class.BasePart.CanCollide` của phần bị giao cắt
oh hơn giá trị `Class.BasePart.CanQuery` của nó hay không.


WorldRoot:GetPartBoundsInRadius

position

Vị trí trung tâm của thể tích hình cầu đã cho để được truy vấn.


radius

Bán kính của thể tích hình cầu đã cho để được truy vấn.


Trả về một mảng các phần có **hộp chứa** giao cắt với một hình cầu đã cho.


`Class.WorldRoot:GetPartsInPart()` trả về một mảng các phần có
không gian chiếm giữ được chia sẻ với phần đã cho (phần phải tồn tại trong
`Class.WorldRoot` cùng với các phần được truy vấn). Phương pháp này có thể được sử dụng
thay cho `Class.BasePart:GetTouchingParts()` và thường là một lựa chọn tốt hơn.

Như đã lưu ý, phương pháp truy vấn không gian này xem xét **thể tích chính xác**
chiếm giữ bởi phần đã cho bằng một kiểm tra va chạm hình học đầy đủ. Làm ví dụ, một phần lõm/rỗng sẽ không phù hợp với các phần được truy vấn bên trong nó trừ khi
them thực sự chồng lấp/chạm vào một phần như vậy. Đối với các thể tích đơn giản hơn, hãy xem xét
sử dụng `Class.WorldRoot:GetPartBoundsInBox()` hoặc
`Class.WorldRoot:GetPartBoundsInRadius()`, vì chúng không chính xác nhưng
thực hiện nhanh hơn.

Phương pháp này sử dụng một đối tượng `Datatype.OverlapParams` để mô tả các
phần có thể tái sử dụng của truy vấn không gian, chẳng hạn như danh sách bao gồm hoặc
loại trừ, số lượng tối đa các phần cần truy vấn, nhóm va chạm
[collisions](/workspace/collisions#collision-filtering) nên sử dụng, và liệu
truy vấn có ưu tiên giá trị `Class.BasePart.CanCollide` của phần bị giao cắt
oh hơn giá trị `Class.BasePart.CanQuery` của nó hay không.


WorldRoot:GetPartsInPart

part

Phần mà thể tích của nó được kiểm tra với các phần khác.


Trả về một mảng các phần có không gian chiếm giữ được chia sẻ với phần đã cho.


Hàm này di chuyển phần được chỉ định đến vị trí được chỉ định thông qua
[động học nghịch đảo](https://en.wikipedia.org/wiki/Inverse_kinematics)
thay vì di chuyển trực tiếp đến đó, để đảm bảo rằng bất kỳ khớp nối,
`Class.Constraint|constraints`, hoặc va chạm mà phần này đang tham gia
vẫn được thỏa mãn về mặt vật lý. Hiện tại, hàm này chỉ có sẵn
trong Studio cho `Class.Plugin|plugins`, vì nó hiện tại gây xung đột với
vật lý của một trò chơi đang chạy.

**Độ cứng dịch chuyển** là một số từ 0 đến 1 chỉ định mức độ
tham chiếu của phần đến vị trí của `Datatype.CFrame` mục tiêu. **Độ cứng xoay** là một số từ 0 đến 1 chỉ định mức độ
tham chiếu của phần đến độ xoay của `Datatype.CFrame` mục tiêu.

Ví dụ:

- Nếu độ cứng dịch chuyển và độ cứng xoay đều bằng 1, phần
  sẽ được di chuyển chính xác đến `CFrame` mục tiêu bất kể những gì
  ràng buộc vật lý nào có trên nó.
- Nếu độ cứng dịch chuyển và độ cứng xoay đều bằng 0.5, phần
  sẽ cố gắng di chuyển chính xác đến `CFrame` mục tiêu, nhưng có thể
  bị đẩy ra ngoài bởi các ràng buộc vật lý trên nó.
- Nếu độ cứng dịch chuyển và độ cứng xoay đều bằng 0, thì
  `CFrame` mục tiêu sẽ bị bỏ qua và các ràng buộc vật lý sẽ được
  giải quyết cho đối tượng ở vị trí nơi nó đã đặt.


WorldRoot:IKMoveTo

target

Vị trí để di chuyển phần đã chỉ định.


translateStiffness

Một số từ 0 đến 1 chỉ định mức độ tham chiếu của
phần đến vị trí của `Datatype.CFrame` mục tiêu.


rotateStiffness

Một số từ 0 đến 1 chỉ định mức độ tham chiếu của
phần đến độ xoay của `Datatype.CFrame` mục tiêu.


collisionsMode

Cho phép bạn chỉ định những đối tượng nào nên bị ảnh hưởng bởi việc
giải quyết vật lý.


Di chuyển phần được chỉ định đến vị trí được chỉ định thông qua động học nghịch đảo
thay vì di chuyển trực tiếp đến đó, để đảm bảo rằng bất kỳ khớp nối, ràng buộc,
hoặc va chạm mà phần đang tham gia vẫn được thỏa mãn về mặt vật lý.


**IsRegion3Empty** trả về một giá trị bool chỉ ra rằng không có
`Class.BasePart|BaseParts` trong `Datatype.Region3` đã cho.

Tham số `ignoreDescendantsInstance` tùy chọn có thể được sử dụng để chỉ định
một thể hiện cụ thể mà nó và tất cả các con của nó nên bị bỏ qua bởi hàm
này. Điều này có thể hữu ích khi, chẳng hạn, bạn đang tìm kiếm xem có bất kỳ
`Class.BasePart|BaseParts` nào nằm bên trong một `Class.BasePart` khác
không phải là `Class.BasePart` tự nó.

```
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)  -- Bỏ qua phần
```
Nếu nhiều hơn một đối tượng và các con của nó cần được loại trừ khỏi
tìm kiếm, các nhà phát triển nên sử dụng
`Class.WorldRoot:IsRegion3EmptyWithIgnoreList()`.

Hàm này chỉ trả về nếu một khu vực trống hay không. Các nhà phát triển muốn
tìm `Class.BasePart|BaseParts` trong một khu vực nên sử dụng
`Class.WorldRoot:FindPartsInRegion3()`.

#### Lưu ý về cách hoạt động của kiểm tra Region3

Kiểm tra xem một phần có giao cắt với `Datatype.Region3` không phải là một quá trình đơn giản.
Nó thực sự là một quá trình tốn thời gian và phức tạp. Thay vào đó, nó kiểm tra xem các phần
có nằm trong cùng một khu vực hay không. Khi hàm này được gọi, nó tính toán
các voxel nào chứa `Datatype.Region3`. Sau đó, nó xác định xem các phần nào
có thể nằm trong các voxel đó. Nó làm điều này bằng cách so sánh hộp chứa
trục gọn (đôi khi gọi là AABB) của phần với các voxel. Hộp chứa trục gọn có thể được thấy trong Studio Roblox khi một phần được
chọn.

Điều này có nghĩa là khu vực mà hàm kiểm tra có thể lớn hơn
`Datatype.Region3`. Vì lý do này, nó được khuyến nghị để đảm bảo rằng
`Datatype.Region3` nằm trên lưới voxel. Cách tốt nhất để làm
điều này là đặt các tọa độ của `Datatype.Region3` thành bội số
của 4 (vì voxel là 4 x 4 x 4 studs).

Phương pháp này là một cách đơn giản và nhanh chóng để xem liệu có bất kỳ phần nào trong
một khu vực tổng quát hay không. Nếu một trò chơi cần biết có phần nào trong một khu vực chính xác,
thì `Class.BasePart:GetTouchingParts()` nên được sử dụng. Có một chi phí lớn hơn để sử dụng
`Class.BasePart:GetTouchingParts()` vì cần phải có một phần trong
`Class.WorldRoot` và hàm này tốn nhiều thời gian hơn để chạy.


WorldRoot:IsRegion3Empty

ignoreDescendentsInstance

Đúng nếu `Datatype.Region3` là trống.


Trả về một giá trị bool chỉ ra rằng không có `Class.BasePart|BaseParts`
trong `Datatype.Region3` đã cho.


Trả về một giá trị boolean chỉ ra rằng không có
`Class.BasePart|BaseParts` trong `Datatype.Region3` đã cho, bỏ qua
các `Class.BasePart|BaseParts` là con của các đối tượng trong
danh sách bỏ qua đã cho. Nếu một giá trị `nil` được đưa vào danh sách bỏ qua,
các thể hiện sau giá trị này sẽ không bị bỏ qua.

Hàm này chỉ trả về nếu một khu vực trống hay không. Các nhà phát triển muốn
trong nhóm `Class.BasePart|BaseParts` cụ thể trong một khu vực nên sử dụng
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.

Hàm này là một biến thể của `Class.WorldRoot:IsRegion3Empty()` với
việc thêm vào một danh sách bỏ qua. Trong các trường hợp mà
danh sách bao gồm được yêu cầu, các nhà phát triển nên kiểm tra xem có bất kỳ phần nào được trả về bởi
`Class.WorldRoot:FindPartsinRegion3WithWhitelist()`.


WorldRoot:IsRegion3EmptyWithIgnoreList

ignoreDescendentsTable

Trả về một giá trị boolean chỉ ra rằng không có
`Class.BasePart|BaseParts` trong `Datatype.Region3` đã cho, bỏ qua
các `Class.BasePart|BaseParts` là con của các đối tượng trong
danh sách bỏ qua đã cho.


Phát ra một tia và trả về va chạm đầu tiên với `Class.BasePart` hoặc
`Class.Terrain`. In ra các thuộc tính của RaycastResult nếu có kết quả bị
va chạm.


Đẩy một tia sử dụng một điểm gốc, hướng, và tùy chọn
`Datatype.RaycastParams`. Nếu nó tìm thấy một `Class.BasePart` hoặc
`Class.Terrain` cell hợp lệ, một `Datatype.RaycastResult` sẽ được trả về chứa
các kết quả của hoạt động. Nếu không có đối tượng `Datatype.RaycastParams`
được cung cấp, các giá trị mặc định sẽ được sử dụng (tất cả các phần được coi là hợp lệ và
nước `Class.Terrain` không bị bỏ qua).

Lưu ý rằng chiều dài (độ lớn) của vectơ hướng là quan trọng,
bởi vì các đối tượng/địa hình xa hơn chiều dài của nó sẽ không được kiểm tra. Nếu
bạn đang sử dụng `Datatype.CFrame` để hỗ trợ tạo các thành phần của tia,
hãy xem xét sử dụng `Datatype.CFrame.LookVector` làm vectơ hướng và
nhân nó với chiều dài mong muốn như hiển thị dưới đây. Chiều dài tối đa của vectơ
hướng là 15.000 studs.

Phương pháp này **không** sử dụng một đối tượng `Datatype.Ray`, nhưng các thành phần gốc và
hướng của nó có thể được mượn từ `Datatype.Ray.Origin` và
`Datatype.Ray.Direction`.


WorldRoot:Raycast

origin

Vectơ hướng của tia. Lưu ý rằng chiều dài của vectơ này
là quan trọng, vì các phần/địa hình xa hơn chiều dài của nó sẽ không được
t kiểm tra.


raycastParams

Một đối tượng được sử dụng để xác định tính đủ điều kiện va chạm trong hoạt động đẩy. Nếu
không được cung cấp, các giá trị mặc định sẽ được sử dụng, nơi tất cả các phần đều được coi là hợp lệ
và nước `Class.Terrain` sẽ không bị bỏ qua.


Chứa các kết quả của hoạt động đẩy, hoặc `nil` nếu không có `Class.BasePart`
hoặc `Class.Terrain` cell nào bị chạm.


Đẩy một tia sử dụng một điểm gốc, hướng, và tùy chọn
`Datatype.RaycastParams`, sau đó trả về một `Datatype.RaycastResult` nếu một
đối tượng hợp lệ hoặc địa hình giao cắt tia.


WorldRoot:Shapecast

Kéo một hình cầu và trả về va chạm đầu tiên với một `Class.BasePart` hoặc
`Class.Terrain`. In các thuộc tính của RaycastResult nếu có kết quả bị
va chạm.


Đẩy một hình cầu theo một hướng nhất định và trả về va chạm đầu tiên
với một `Class.BasePart` hoặc `Class.Terrain` cell. Điều này tương tự
như cách `Class.WorldRoot:Raycast()` đẩy một tia theo một hướng để tìm một
va chạm, nhưng sử dụng một hình 3D thay vì một tia.

Khác với `Class.WorldRoot:GetPartsInPart()`, phương pháp này không phát hiện
`Class.BasePart|BaseParts` mà **ban đầu** giao cắt với hình.

Nếu phát hiện được va chạm, một `Datatype.RaycastResult` sẽ được trả về
chứa thông tin va chạm. Thuộc tính `Datatype.RaycastResult.Distance|Distance`
đại diện cho khoảng cách mà hình phải di chuyển để tìm một va chạm,
và thuộc tính `Datatype.RaycastResult.Position|Position` đại diện cho
điểm giao cắt gây ra va chạm.

Phương pháp này sẽ ném lỗi nếu nó nhận vào bán kính hoặc đầu vào hướng không hợp lệ.


WorldRoot:Spherecast

Vị trí ban đầu của hình cầu được đẩy.


Bán kính của hình cầu được đẩy trong studs. Bán kính tối đa là
256 studs.


Chứa kết quả của hoạt động đẩy hình, hoặc `nil` nếu không có
`Class.BasePart` hoặc `Class.Terrain` cell nào bị chạm.


Đẩy một hình cầu theo một hướng nhất định và trả về một
`Datatype.RaycastResult` nếu hình này chạm vào một `Class.BasePart`
hay một cell `Class.Terrain`.


Mô phỏng các phần trong không gian làm việc trong một khoảng thời gian cố định bằng cách gọi hàm
StepPhysics một lần mỗi khung hình cho đến khi thời gian được chỉ định đã trôi qua.


Tiến triển mô phỏng cho các phần trong thế giới dựa trên một
tăng thời gian được chỉ định và một tập hợp tùy chọn của `Class.BasePart`. Khi một
tập hợp các phần được chỉ định, chỉ các phần này sẽ được mô phỏng và tất cả
các phần khác trong thế giới sẽ được coi là đã neo cố định. Khi tham số này
bị bỏ qua, tất cả các phần trong thế giới sẽ được đưa vào mô phỏng.
Tăng thời gian được chỉ định có thể là bất kỳ số dương nào, với các giá trị lớn hơn tăng thời gian chạy của hàm. Tùy thuộc vào giá trị của
tăng thời gian, hệ thống vật lý có thể chia nó thành nhiều
bước riêng lẻ để duy trì độ chính xác và ổn định của mô phỏng.
Ngay cả khi hàm thực hiện nhiều bước phụ, kết quả của
toàn bộ mô phỏng chỉ được thấy khi hàm hoàn thành. Để minh họa các
bước riêng lẻ của một mô phỏng, hàm có thể được gọi một lần mỗi
RenderStep thông qua sự kiện `Class.RunService.RenderStepped`.


WorldRoot:StepPhysics

Khoảng thời gian sẽ được mô phỏng. Tham số này phải là một
số dương. Các giá trị lớn hơn sẽ làm tăng thời gian chạy của hàm này.


parts

Mảng tùy chọn của các phần sẽ được mô phỏng. Tập hợp này phải chứa
các thể hiện thuộc loại `Class.BasePart`; bất kỳ loại nào khác sẽ bị
bỏ qua.


Tiến triển mô phỏng cho các phần trong thế giới dựa trên một
tăng thời gian được chỉ định và một tập hợp tùy chọn của
`Class.BasePart|BaseParts`.


WorldRoot

Lớp cơ sở để xử lý mô phỏng vật lý và truy vấn không gian 3D.


Mẫu sau đây bao gồm một hàm cơ bản lấy một bảng đối tượng
và gán chúng vào một Mô Hình mới, trả về Mô Hình đó.

Mô hình là các đối tượng chứa, có nghĩa là chúng nhóm các đối tượng lại với nhau. Chúng được sử dụng tốt nhất để giữ các bộ sưu tập của `Class.BasePart|BaseParts` và có một số chức năng mở rộng khả năng của chúng.

Mô hình được dự định để đại diện cho các nhóm **hình học**. Nếu nhóm của bạn không có cách lý giải hình học, ví dụ như một bộ sưu tập của `Class.Script|Scripts`, hãy sử dụng một `Class.Folder` thay thế.

Mô hình có các phần constituent được kết nối với nhau bằng các khớp (để chúng có thể di chuyển hoặc bị phá hủy thông qua mô phỏng vật lý) thường có một `Class.Model.PrimaryPart|PrimaryPart` được thiết lập, vì nó xác định phần nào trong mô hình mà pivot và bounding box sẽ "theo" khi mô hình di chuyển. Các mô hình tĩnh giữ nguyên một chỗ không có lợi ích gì từ việc thiết lập một phần chính.

Mô hình có một loạt các ứng dụng rộng rãi, bao gồm các nhân vật người chơi Roblox. Chúng cũng có một số hành vi độc đáo mà bạn cần lưu ý:

- Khi một `Class.Humanoid` và một `Class.Part` có tên là **Head** được làm cha dưới một mô hình, một GUI tên/sức khỏe sẽ xuất hiện trên mô hình; xem [Hiển thị Tên/Sức khỏe Nhân vật](/characters/name-health-display) để biết chi tiết.
- Nếu vị trí của một phần trên trục **Y** đạt giá trị `Class.Workspace.FallenPartsDestroyHeight`, và nó là đối tượng cuối cùng bên trong một `Class.Model`, mô hình cũng sẽ bị phá hủy.
- Khi sử dụng ở một nơi có `Class.Workspace.StreamingEnabled` được đặt là true, giá trị của `Class.Model.ModelStreamingMode|ModelStreamingMode` kiểm soát các hành vi khác nhau liên quan đến việc mô hình và tất cả các hình con của nó được sao chép và/hoặc loại bỏ khỏi các khách hàng. Ngoài ra, giá trị của `Class.Model.LevelOfDetail|LevelOfDetail` ảnh hưởng đến việc hiển thị của mô hình.

Giống như tất cả các loại `Class.Instance`, việc một `Class.Model` cha được sao chép đến một khách hàng không đảm bảo rằng tất cả các con của nó cũng được sao chép. Điều này đặc biệt quan trọng nếu những thể hiện này đang được truy cập bởi mã chạy trên khách hàng, chẳng hạn như trong một `Class.LocalScript`. Sử dụng `Class.Model.ModelStreamingMode|ModelStreamingMode` với các giá trị như `Enum.ModelStreamingMode|Atomic` có thể đảm bảo rằng toàn bộ mô hình và tất cả những hình con của nó hiện diện nếu mô hình cha tồn tại trên khách hàng, hoặc bạn có thể sử dụng `Class.Instance:WaitForChild()|WaitForChild()` khi không muốn có tính chất nguyên tử.

Thiết lập mô hình này để duy trì cho người chơi đã chỉ định. Các mô hình duy trì sẽ luôn hiện diện cho người chơi bất kể cài đặt hoặc điều kiện streaming.

`Class.Model.ModelStreamingMode|ModelStreamingMode` phải được thiết lập thành `Enum.ModelStreamingMode|PersistentPerPlayer` thì hành vi mới được thay đổi do sự bổ sung.

Model:AddPersistentPlayer

playerInstance

Người `Class.Player` mà mô hình này sẽ duy trì.

Thiết lập mô hình này để duy trì cho người chơi đã chỉ định.
`Class.Model.ModelStreamingMode|ModelStreamingMode` phải được thiết lập thành `Enum.ModelStreamingMode|PersistentPerPlayer` thì hành vi mới được thay đổi do sự bổ sung.

Trong ví dụ này, các khớp trong mỗi Mô hình nhân vật Người chơi sẽ bị phá vỡ
3 giây sau khi được sinh ra. Việc phá vỡ các khớp này sẽ khiến Nhân dạng
chết.

Mẫu mã này minh họa việc tạo khớp thủ công trên hai phần mà là
anh/em của script (PartA và PartB). Nó tạo ra các khớp trên hai phần chạm
vào nhau với các loại bề mặt tương thích (Studs và Inlet).

Phá vỡ các kết nối giữa `BaseParts`, bao gồm các kết nối bề mặt với bất kỳ các phần lân cận nào, `Class.WeldConstraint|WeldConstraints`, và tất cả các `Class.Weld|Welds` và các `Class.JointInstance|JointInstances` khác.

Khi BreakJoints được sử dụng trên một nhân vật người chơi `Class.Model`, `Class.Humanoid` của nhân vật sẽ chết vì nó dựa vào khớp Cổ.

Lưu ý rằng mặc dù các khớp được tạo từ các kết nối bề mặt với các phần lân cận có thể được khôi phục bằng cách sử dụng `Class.Model:MakeJoints()`, điều này sẽ chỉ khôi phục lại các khớp được tạo ra từ các bề mặt. Các nhà phát triển không nên dựa vào điều này vì sau khi các khớp được phá vỡ, các phần có thể không còn tiếp xúc với nhau.

Model:BreakJoints

Phá vỡ các kết nối giữa `BaseParts`, bao gồm các kết nối bề mặt với bất kỳ các phần lân cận nào, `Class.WeldConstraint|WeldConstraints` và tất cả các `Class.Weld|Welds` và các `Class.JointInstance|JointInstances` khác.

Model:breakJoints

Hàm này trả về một mô tả về một khối lượng chứa tất cả các phần con `Class.BasePart` trong một `Class.Model`. Hướng của khối lượng dựa trên hướng của `Class.Model.PrimaryPart|PrimaryPart`, và khớp với hộp chọn được hiển thị trong Studio khi mô hình được chọn. Phản ánh hành vi của `Class.Terrain:FillBlock()`, nó trả về một `Datatype.CFrame` đại diện cho trung tâm của bounding box đó và một `Datatype.Vector3` đại diện cho kích thước của nó. Kích thước có thể không chính xác tại thời điểm chạy nếu các giới hạn vật lý đang tác động lên các phần bên trong `Class.Model`.

Hướng của bounding box khớp với hướng của `Class.PVInstance.GetPivot|Pivot` - hoặc là pivot của `Class.Model.PrimaryPart|PrimaryPart` (nếu có) hoặc là `Class.Model.WorldPivot|WorldPivot` của mô hình.

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

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

-- Thay đổi kích thước và vị trí phần bằng với bounding box của mô hình
part.Size = size
part.CFrame = orientation
```

Model:GetBoundingBox

Một `Datatype.CFrame` đại diện cho hướng của khối lượng
sau đó là một `Datatype.Vector3` đại diện cho kích thước của khối lượng.

Trả về một mô tả về một khối lượng chứa tất cả các phần của một Mô hình.

Mẫu mã dưới đây minh họa cách sử dụng Model.GetExtentsSize để nhận được
kích thước của bounding box chứa các phần tử.

Trả về kích thước của hộp bao nhỏ nhất chứa tất cả các `Class.BasePart|BaseParts` trong `Class.Model`. Hướng khớp với hướng của `Class.PVInstance.GetPivot|Pivot` - hoặc là pivot của `Class.Model.PrimaryPart|PrimaryPart` (nếu có) hoặc là `Class.Model.WorldPivot|WorldPivot` của mô hình.

Lưu ý rằng hàm này chỉ trả về kích thước của hộp bao nhỏ nhất, và nhà phát triển phải tự áp dụng cách của mình để lấy vị trí của hộp bao.

Model:GetExtentsSize

Kích thước `Datatype.Vector3` của `Class.Model`.

Trả về kích thước của hộp bao nhỏ nhất chứa tất cả các `Class.BasePart|BaseParts` trong `Class.Model`, căn chỉnh với `Class.Model.PrimaryPart` nếu nó được thiết lập.

Giá trị này từ trước đến nay trả về CFrame của một vị trí trung tâm trong mô hình.

Model:GetModelCFrame

Đoạn mã này sẽ tạo một mô hình, đặt một số phần vào trong đó, vị trí của chúng ngẫu nhiên,
và sau đó in kích thước của nó:


Hàm GetModelSize trả về kích thước `Datatype.Vector3` của `Class.Model`.

Model:GetModelSize

Trả về kích thước Vector3 của Mô hình.

Khi phương thức này được gọi từ `Class.Script`, nó trả về tất cả các
đối tượng `Class.Player` mà mô hình này đang duy trì. Khi được gọi từ
từ `Class.LocalScript`, phương thức này chỉ kiểm tra xem mô hình này có duy trì
cho `Class.Players.LocalPlayer|LocalPlayer` hay không.

Model:GetPersistentPlayers

Một bảng chứa tất cả các đối tượng `Class.Player` mà mô hình này là
duy trì cho.

Trả về tất cả các đối tượng `Class.Player` mà mô hình này là
duy trì cho. Hành vi thay đổi dựa trên việc phương thức này được gọi
từ `Class.Script` hoặc `Class.LocalScript`.

Mã sau đây minh họa cách GetPrimaryPartCFrame và
SetPrimaryPartCFrame có thể được sử dụng để quay một mô hình.

Một mô hình đơn giản được tạo trong Workspace và một vòng lặp được bắt đầu để
quay mô hình 10 độ quanh trục Y mỗi 0.2 giây.

Hàm này đã được thay thế bởi `Class.PVInstance:GetPivot()` mà
hoạt động như một thay thế và không thay đổi hành vi của mã của bạn. Sử dụng
`Class.PVInstance:GetPivot()` cho công việc mới và di chuyển các
cuộc gọi `Class.Model:GetPrimaryPartCFrame()` trước đó của bạn khi thuận tiện.

Trả về `Datatype.CFrame` của phần chính của mô hình.

Hàm này tương đương với điều sau.

    Model.PrimaryPart.CFrame

Lưu ý rằng hàm này sẽ tạo ra một lỗi nếu không có phần chính nào tồn tại cho
`Class.Model`. Nếu hành vi này không mong muốn, các nhà phát triển có thể làm điều sau, nó sẽ bằng `nil` nếu không có phần chính.

    local cFrame = Model.PrimaryPart và Model.PrimaryPart.CFrame

Model:GetPrimaryPartCFrame

Trả về `Datatype.CFrame` của `Class.Model.PrimaryPart` của mô hình.
Hàm này sẽ tạo ra một lỗi nếu không có phần chính tồn tại cho
`Class.Model`.

Mẫu mã này minh họa việc thay thế tất cả các bản sao
của một mô hình cây bằng `Class.Model:PivotTo()` và `Class.Model:ScaleTo()`. Việc
pivot và tỉ lệ của các mô hình được sử dụng làm tham chiếu, đảm bảo rằng kích thước và vị trí
của các mô hình thay thế phù hợp với các mô hình gốc.


Các mô hình chứa một hệ số tỷ lệ chính thống bền vững, bắt đầu từ 1
cho các mô hình mới được tạo ra và thay đổi khi mô hình được thay đổi tỷ lệ bằng cách gọi
`Class.Model:ScaleTo()`. Hàm này trả về hệ số tỷ lệ chính thống hiện tại
của mô hình.

Hệ số tỷ lệ hiện tại không _trực tiếp_ ảnh hưởng đến kích thước của các Instance
dưới mô hình. Nó được sử dụng cho việc tạo nội dung và lập trình nhằm nhớ lại cách mà mô hình đã được thay đổi kích thước tương đối với kích thước ban đầu của nó.

Trong một phiên nhất định, mô hình sẽ lưu trữ thông tin kích thước chính xác của các Instance con
sau cuộc gọi đầu tiên `Class.Model:ScaleTo()`. Điều này có nghĩa là gọi
`Class.Model:ScaleTo()|ScaleTo(x)` sau đó là
`Class.Model:ScaleTo()|ScaleTo(1)` sẽ trả bạn _chính xác_ cách cấu hình ban đầu của mô hình mà không bị trôi hơi dấu phẩy. Tránh việc trôi dấu phẩy là lý do để có một hàm Scale**To** thay vì một hàm Scale**By**.

Hệ số tỷ lệ có ảnh hưởng đến hành vi của động cơ theo một cách: Hệ số tỷ lệ
của một mô hình sẽ được áp dụng cho các offset khớp của
`Class.Animation|Animations` được phát trên một `Class.AnimationController`
dưới mô hình đó, vì vậy các bộ rig được hoạt hình sẽ phát lại
hành động một cách chính xác ngay cả khi đã thay đổi tỷ lệ.

Model:GetScale

Hệ số tỷ lệ chính thống hiện tại của mô hình.

Trả về quy mô chính thống của mô hình, mặc định là 1 cho các mô hình mới
được tạo ra và sẽ thay đổi khi nó được thay đổi tỷ lệ thông qua
`Class.Model:ScaleTo()`.

Đoạn mã này minh họa cách mà các khớp có thể được tạo ra thông qua
hàm Model:MakeJoints.

Một mô hình được khởi tạo, với hai phần xếp chồng lên nhau. Phần trên
được ghim và phần dưới thì không. Thông thường, khi được gán vào Workspace,
phần dưới sẽ rơi xuống Baseplate.

Tuy nhiên, vì thuộc tính TopSurface của phần dưới được đặt thành
Enum.SurfaceType.Weld, điều này có nghĩa là khi Model:MakeJoints được thực thi,
một kết nối được tạo ra giữa chúng.

Do đó, phần dưới không rơi cho đến khi các khớp trong mô hình bị
đứt. Điều này thường được thực hiện bằng cách sử dụng Model:BreakJoints, nhưng trong ví dụ này
kết nối bị đứt bằng cách sử dụng một vụ nổ.

Mẫu mã này minh họa cách tạo khớp trên hai mảnh mà là
anh em của kịch bản (PartA và PartB). Nó sử dụng MakeJoints trên hai mảnh chạm
nhau với các loại bề mặt tương thích (Studs và Inlet).

Việc kết nối dựa trên SurfaceType đã bị lỗi thời. Đừng sử dụng MakeJoints cho các dự án mới. Sử dụng `Class.WeldConstraint|WeldConstraints` và
`Class.HingeConstraint|HingeConstraints` thay vào đó.

Duyệt qua tất cả `Class.BasePart|Parts` trong `Class.Model` và tạo ra các khớp giữa các phần đã chỉ định và bất kỳ bề mặt tiếp xúc
phẳng nào, phụ thuộc vào các bề mặt của các phần.

- Bề mặt nhẵn sẽ không tạo ra các khớp
- Bề mặt keo sẽ tạo ra một khớp `Class.Glue`
- Hàn sẽ tạo ra một khớp `Class.Weld` với bất kỳ bề mặt nào ngoại trừ
  Unjoinable
- Các khớp, Inlet hoặc Universal sẽ tạo ra một khớp `Class.Snap` với
  bất kỳ bề mặt nào khác trong hai bề mặt khác (ví dụ: khớp với Inlet và
  Universal)
- Bề mặt Hinge và Motor sẽ tạo ra các biến thể khớp `Class.Rotate` và `Class.RotateV`

Hàm này không hoạt động nếu phần này không phải là một phần con của
`Class.Workspace`. Do đó, bạn phải đảm bảo trước rằng Mô hình đã được làm cha
cho Workspace trước khi sử dụng MakeJoints.

Model:MakeJoints

Duyệt qua tất cả `Class.BasePart|BaseParts` trong `Class.Model`. Nếu bất kỳ
phần nào có một mặt có SurfaceType có thể tạo ra một khớp, nó sẽ tạo ra một khớp
với bất kỳ các phần lân cận nào.

Model:makeJoints

Model:move

location

Mẫu này trình bày cách `Class.Model:MoveTo()` tránh va chạm.

Một `Class.Model` đơn giản gồm hai phần được tạo ra, và phần chính của nó `Class.Model.PrimaryPart`
được thiết lập. Một phần chắn lớn được đặt bên cạnh nó.

Sau 5 giây, `Class.Model:MoveTo()` được sử dụng để chỉ định mô hình di chuyển
vào bên trong phần chắn. Tuy nhiên, vì MoveTo sẽ không di chuyển mô hình vào
bên trong một phần chắn, `Class.Model` được di chuyển lên trên trục Y và đặt bên trên
the phần chắn.


Di chuyển `Class.Model.PrimaryPart|PrimaryPart` đến vị trí đã cho. Nếu
phần chính chưa được xác định, phần gốc của mô hình sẽ được sử dụng, nhưng phần gốc không phải là xác định và nên luôn thiết lập một phần chính
khi sử dụng `Class.Model:MoveTo()|MoveTo()`.

Nếu có bất kỳ trở ngại nào tại nơi mô hình sẽ được di chuyển, chẳng hạn như
`Class.Terrain` hoặc các `Class.BasePart|BaseParts` khác, mô hình sẽ được
di chuyển lên trên cho đến khi không còn gì cản trở. Nếu hành vi này không mong muốn, `Class.PVInstance:PivotTo()` nên được sử dụng
thay vào đó.

Lưu ý rằng việc xoay không được bảo toàn khi di chuyển một mô hình bằng
`Class.Model:MoveTo()|MoveTo()`. Khuyến nghị sử dụng
`Class.Model:TranslateBy()|TranslateBy()` hoặc `Class.PVInstance:PivotTo()` nếu cần bảo vệ vị trí hiện tại của mô hình.

Model:MoveTo

`Datatype.Vector3` mà mô hình `Class.Model` được di chuyển đến.

Di chuyển `Class.Model.PrimaryPart|PrimaryPart` đến vị trí đã cho. Nếu
phần chính chưa được xác định, phần gốc của mô hình sẽ được sử dụng.

Model:moveTo

Làm cho mô hình này không còn tồn tại cho người chơi đã chỉ định. Điều này không đảm bảo rằng mô hình sẽ được loại bỏ ngay lập tức cho người chơi; sau
khi gọi phương thức này, mô hình sẽ được coi là
`Enum.ModelStreamingMode|Atomic` cho người chơi đó và sẽ vẫn tồn tại
miễn là nó trong phạm vi streaming mục tiêu.

`Class.Model.ModelStreamingMode|ModelStreamingMode` phải được thiết lập thành
`Enum.ModelStreamingMode|PersistentPerPlayer` để hành vi này thay đổi
do sự loại bỏ.

Model:RemovePersistentPlayer

Người `Class.Player` mà mô hình này sẽ không còn tồn tại cho.

Làm cho mô hình này không còn tồn tại cho người chơi đã chỉ định.
`Class.Model.ModelStreamingMode|ModelStreamingMode` phải được thiết lập thành
`Enum.ModelStreamingMode|PersistentPerPlayer` thì hành vi mới được thay đổi
do sự loại bỏ.

Thiết lập lại độ xoay của các phần của mô hình về độ xoay danh tính đã được thiết lập trước đó,
được thực hiện thông qua phương thức `Class.Model:SetIdentityOrientation()`.

Model:ResetOrientationToIdentity

Các mô hình chứa một hệ số tỷ lệ chính thống bền vững, bắt đầu từ 1
cho các mô hình mới được tạo ra. Hàm này thay đổi tỷ lệ mô hình, quanh vị trí pivot,
tuỳ theo mẫu hình của 1. Để thực hiện điều này, nó thực hiện hai điều:

- Đặt hệ số tỷ lệ hiện tại của mô hình thành giá trị đã chỉ định
- Thay đổi kích thước và định vị tất cả các Instance con một cách tương ứng

Việc điều chỉnh vị trí được thực hiện quanh vị trí pivot.

Tất cả các thuộc tính "hình học" của các Instance con sẽ được thay đổi tỷ lệ. Điều này rõ ràng bao gồm kích thước của các phần, nhưng đây là một số ví dụ khác về
các thuộc tính mà sẽ bị biến đổi:

- Độ dài của các khớp như `Class.WeldConstraint|WeldConstraints`, và
  `Class.RopeConstraint`
- Tốc độ và lực vật lý như `Class.HingeConstraint`
- Các thuộc tính hình ảnh như kích thước của các bộ phát hạt
- Các thuộc tính độ dài khác như `Class.Sound.RollOffMinDistance`

Model:ScaleTo

newScaleFactor

Thiết lập hệ số tỷ lệ của mô hình, điều chỉnh kích thước và vị trí của
tất cả các Instance con sao cho chúng có hệ số đó tương đối với
tính năng ban đầu của chúng và vị trí khi hệ số tỷ lệ là 1.

Thiết lập độ xoay danh tính của mô hình đã cho, cho phép bạn đặt lại độ xoay của toàn bộ mô hình sau này,
thông qua phương thức `ResetOrientationToIdentity`.

Model:SetIdentityOrientation

Hàm này đã được thay thế bởi `Class.PVInstance:PivotTo()` mà
hoạt động như một giải pháp hiệu quả hơn và không thay đổi hành vi của mã của bạn. Sử dụng `Class.PVInstance:PivotTo()` cho công việc mới và di chuyển các
cuộc gọi `Class.Model:SetPrimaryPartCFrame()` trước đó của bạn khi thuận tiện.

Thiết lập `Class.BasePart.CFrame` của phần chính của mô hình.
Tất cả các phần khác trong mô hình cũng sẽ được di chuyển và sẽ duy trì
hướng và độ lệch tương ứng với `Class.Model.PrimaryPart`.

Lưu ý rằng hàm này sẽ tạo ra một lỗi nếu không tồn tại `Class.Model.PrimaryPart`
cho mô hình. Điều này có thể gây ra các vấn đề nếu, ví dụ, phần chính không được thiết lập
hoặc đã bị phá hủy.

Model:SetPrimaryPartCFrame

`Datatype.CFrame` sẽ được thiết lập.

Thiết lập `Class.BasePart.CFrame` của phần chính của mô hình.
Tất cả các phần khác trong mô hình cũng sẽ được di chuyển và sẽ duy trì
hướng và độ lệch tương ứng với `Class.Model.PrimaryPart`.

Model

Mô hình là các đối tượng chứa, có nghĩa là chúng nhóm các đối tượng lại với nhau. Chúng được sử dụng tốt nhất để giữ các bộ sưu tập của `Class.BasePart|BaseParts` và có một số chức năng mở rộng khả năng của chúng.

/reference/engine/classes/WorldModel.yaml