BackpackItem là một lớp trừu tượng cho các vật phẩm trong ba lô như HopperBins và
Công cụ.


BackpackItem

Biểu tượng kết cấu được hiển thị cho một công cụ trong ba lô của người chơi.

Thuộc tính này nên được đặt thành ID nội dung của hình ảnh được tải lên trang web
Roblox. Chỉ hỗ trợ URI tài sản cho thuộc tính này.

Nếu thuộc tính này để trống, GUI `Class.Backpack` sẽ hiển thị tên của công cụ thay vào đó.


BackpackItem.TextureContent

Biểu tượng kết cấu được hiển thị cho một công cụ trong ba lô của người chơi.
Chỉ hỗ trợ URI tài sản.


Biểu tượng kết cấu được hiển thị cho một công cụ trong ba lô của người chơi.

Thuộc tính này nên được đặt thành ID nội dung của hình ảnh được tải lên trang web
Roblox.

Nếu thuộc tính này để trống, GUI `Class.Backpack` sẽ hiển thị tên của công cụ thay vào đó.


BackpackItem.TextureId

Biểu tượng kết cấu được hiển thị cho một công cụ trong ba lô của người chơi.


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

position

`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

cframe

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

Ví dụ này minh hoạ cách mà `Class.Model:TranslateBy()` bỏ qua va chạm
và tôn trọng định hướng của mô hình.

Một `Class.Model` đơn giản với hai phần được tạo ra, xoay 45 độ trên trục Y,
và phần `Class.Model.PrimaryPart` của nó được thiết lập. Một phần cản lớn
được đặt bên cạnh nó.

Sau 5 giây, `Class.Model:TranslateBy()` được sử dụng để chỉ đạo mô hình
di chuyển vào bên trong phần cản. Mô hình sẽ di chuyển vào bên trong
phần cản và giữ nguyên định hướng hiện tại của nó.


Di chuyển `Class.Model` theo độ lệch `Datatype.Vector3` đã cho, bảo toàn
hướng của mô hình. Nếu một `Class.BasePart` hoặc `Class.Terrain`
khác đã tồn tại tại vị trí mới thì `Class.Model` sẽ chồng lên
đối tượng đó.

Phép dịch được áp dụng trong không gian thế giới thay vì không gian đối tượng,
nghĩa là ngay cả khi các phần của mô hình được định hướng khác nhau, nó vẫn sẽ
di chuyển theo trục tiêu chuẩn.

Model:TranslateBy

delta

Độ lệch `Datatype.Vector3` mà `Class.Model` sẽ được dịch chuyển.

Di chuyển `Class.Model` theo độ lệch `Datatype.Vector3` đã cho, bảo toàn
hướng của mô hình. Nếu một `Class.BasePart` hoặc `Class.Terrain`
khác đã tồn tại tại vị trí mới thì `Class.Model` sẽ chồng lên
đối tượng đó.

Model

Đặt mức độ chi tiết trên mô hình cho các trải nghiệm với
[streaming](/workspace/streaming) được bật. Các lưới composite hoặc
lưới giả không hỗ trợ vật lý, phát hiện va chạm hoặc
raycasting.

Khi được đặt thành `Enum.ModelLevelOfDetail|StreamingMesh`, một lưới "imposter"
độ phân giải thấp (lưới màu, thô bao quanh tất cả các phần con của
mô hình) sẽ được hiển thị bên ngoài bán kính streaming. Không hỗ trợ
vật liệu.

Khi được đặt thành `Enum.ModelLevelOfDetail|SLIM`, một mô hình **SLIM** (Mô hình
Tương tác Nhẹ và Có thể Mở rộng) sẽ hiển thị một hợp chất của tất cả các phần con ở
các độ phân giải thấp hơn một cách dần dần dựa trên khoảng cách từ bán kính
streaming. Điều này cải thiện chất lượng hình ảnh đáng kể so với
`Enum.ModelLevelOfDetail|StreamingMesh`.

Khi được đặt thành `Enum.ModelLevelOfDetail|Disabled` hoặc
`Enum.ModelLevelOfDetail|Automatic`, các lưới độ phân giải thấp sẽ không được
hiển thị.


Model.LevelOfDetail

Thiết lập mức độ chi tiết cho mô hình trong các trải nghiệm có streaming đối tượng được kích hoạt.

Kiểm soát cách mà `Class.Model|Models` được streaming vào và ra khi [streaming](/workspace/streaming) được kích hoạt. Hành vi phụ thuộc vào enum được chọn. Không có hiệu lực khi streaming không được kích hoạt.

Thuộc tính này chỉ nên được thay đổi trong Studio thông qua cửa sổ [Properties](/studio/properties) khi streaming được kích hoạt, hoặc trong `Class.Script|Scripts`, nhưng không bao giờ trong `Class.LocalScript|LocalScripts` (thực hiện như vậy có thể dẫn đến hành vi không xác định).

Model.ModelStreamingMode

Kiểm soát hành vi streaming của mô hình `Class.Model|Models` khi streaming đối tượng được kích hoạt.

Mẫu mã này tạo ra và ném một mô hình xúc xắc, sau đó xuất ra liệu nó
có rơi xuống với mặt màu xanh hướng lên. Nếu `Class.Model.PrimaryPart` không được thiết lập,
của pivot / bounding box của xúc xắc sẽ xoay, vì các phần bên trong nó
được mô phỏng vật lý trong quá trình lăn.

Trỏ đến phần chính của `Class.Model`. Phần chính là `Class.BasePart` hoạt động như tham chiếu vật lý cho pivot của mô hình. Điều này có nghĩa là, khi các phần bên trong mô hình được di chuyển do mô phỏng vật lý hoặc các phương tiện khác, pivot sẽ di chuyển đồng bộ với phần chính.

Lưu ý rằng các `Class.Model|Models` không có `PrimaryPart` được thiết lập theo mặc định. Nếu bạn đang tạo một mô hình cần bị tác động bởi vật lý, bạn nên thiết lập thuộc tính này bằng tay trong Studio hoặc trong một tập lệnh. Nếu phần chính **không** được thiết lập, pivot sẽ giữ nguyên vị trí trong không gian thế giới, ngay cả khi các phần bên trong mô hình bị di chuyển.

Cũng lưu ý rằng khi thiết lập thuộc tính này, nó phải là một `Class.BasePart` là một phần con của mô hình. Nếu bạn cố gắng đặt `Class.Model.PrimaryPart` thành một `Class.BasePart` không phải là một phần con của mô hình, nó sẽ được đặt thành phần đó nhưng sẽ được đặt lại thành `nil` trong bước mô phỏng tiếp theo &mdash; đó là hành vi theo di sản để hỗ trợ các tập lệnh giả định rằng họ có thể tạm thời đặt phần chính thành một `Class.BasePart` không phải là một phần con của mô hình.

Quy tắc chung cho các mô hình là:

- Các mô hình có các phần được kết nối với nhau thông qua các khớp vật lý như `Class.WeldConstraint|WeldConstraints` hoặc `Class.Motor6D|Motor6Ds` nên có một phần chính được gán. Ví dụ, các mô hình nhân vật Roblox có `Class.Model.PrimaryPart` được đặt thành **HumanoidRootPart** theo mặc định.
- Các mô hình tĩnh (thường là `Class.BasePart.Anchored|Anchored`) giữ nguyên một chỗ trừ khi một tập lệnh rõ ràng di chuyển chúng không yêu cầu một `Class.Model.PrimaryPart` và thường không có lợi ích gì từ việc thiết lập một phần chính.

Model.PrimaryPart

Phần chính của `Class.Model`, hoặc `nil` nếu không được thiết lập rõ ràng.

Việc thiết lập thuộc tính này trong cửa sổ Properties sẽ thay đổi kích thước mô hình như thể `Class.Model:ScaleTo()` đã được gọi trên nó, thay đổi kích thước tất cả các Instance con trong mô hình, chẳng hạn như vật liệu, hình ảnh, và hình học 3D của các phần, sao cho mô hình có hệ số tỷ lệ được chỉ định tương đối với kích thước ban đầu của nó.

Thuộc tính này chỉ có sẵn trong Studio và sẽ tạo ra lỗi nếu được sử dụng trong `Class.Script` hoặc `Class.LocalScript`. `Class.Model:ScaleTo()` và `Class.Model:GetScale()` nên được sử dụng từ các tập lệnh.

Model.Scale

Thuộc tính chỉ dành cho biên tập viên được sử dụng để thay đổi kích thước mô hình quanh pivot của nó. Việc thiết lập thuộc tính này sẽ di chuyển kích thước như thể `Class.Model:ScaleTo()` đã được gọi trên nó.

Mẫu mã này cho thấy một hàm tùy chỉnh để đặt lại pivot của một mô hình
trở về trung tâm của hộp giới hạn của mô hình đó.


Thuộc tính này xác định vị trí của pivot của một `Class.Model` không có `Class.Model.PrimaryPart` được thiết lập. Nếu `Class.Model` **có** `Class.Model.PrimaryPart|PrimaryPart`, pivot của `Class.Model` sẽ bằng với pivot của phần chính đó thay vào đó, và thuộc tính `Class.Model.WorldPivot|WorldPivot` này sẽ bị bỏ qua.

Đối với một `Class.Model` mới được tạo, pivot của nó sẽ được coi như trung tâm của bounding box của nội dung của nó cho đến **lần đầu tiên** thuộc tính `Class.Model.WorldPivot` của nó được đặt. Sau khi pivot thế giới được thiết lập lần đầu tiên, rất khó để phục hồi hành vi ban đầu này.

Thông thường, việc di chuyển mô hình bằng các công cụ của Studio, hoặc bằng các chức năng di chuyển mô hình như `Class.PVInstance:PivotTo()` và `Class.Model:MoveTo()`, sẽ thiết lập pivot thế giới và do đó kết thúc hành vi mô hình mới này.

Mục đích của hành vi này là cho phép mã Luau có được một pivot hợp lý chỉ bằng cách tạo một mô hình mới và làm cha các đối tượng cho nó, tránh cần thiết phải thiết lập `Class.Model.WorldPivot` một cách rõ ràng mỗi khi bạn tạo một mô hình trong mã.

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

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

print(model:GetPivot())  -- Hiện tại bằng với trung tâm của bounding box chứa "BluePart" và "RedPart"

model:PivotTo(CFrame.new(0, 10, 0))  -- Điều này hoạt động mà không cần thiết lập rõ ràng "model.WorldPivot"
```

Model.WorldPivot

Xác định vị trí của pivot của một `Class.Model` không có `Class.Model.PrimaryPart` được thiết lập.

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ột `Class.PVInstance` là một lớp trừu tượng không thể được tạo ra. Nó là
cơ sở cho tất cả các đối tượng có vị trí vật lý trong thế giới.


Mẫu mã này là một đoạn mã di chuyển đơn giản mà chuyển nhân vật của bạn
10&nbsp;studs về phía trước trong hướng bạn đang đối diện khi bạn nhấn
phím <kbd>F</kbd>. Nó thực hiện điều đó bằng cách lấy trục hiện tại với
`Class.PVInstance:GetPivot()` và gọi `PVInstance|PivotTo` để di chuyển nhân vật
về phía trước.

Hàm này lấy điểm pivot của một `Class.PVInstance`. Đây thường được sử dụng
với `Class.PVInstance:PivotTo()` để di chuyển một mô hình.

`Class.Model|Models` và `Class.BasePart|BaseParts` đều là
`Class.PVInstance|PVInstances` ("Vị trí Tốc độ Instances") và cả hai
đều có chức năng này.


PVInstance:GetPivot

Lấy điểm pivot của một `Class.PVInstance`.


Biến đổi `Class.PVInstance` cùng với tất cả các `Class.PVInstance|PVInstances` con của nó
sao cho điểm pivot hiện nằm ở `Datatype.CFrame` được chỉ định. Đây là hàm chính
mà nên sử dụng để di chuyển `Class.Model|Models` thông qua scripting.

`Class.BasePart|BaseParts` được di chuyển theo cách này bằng cách biến đổi
`Datatype.CFrame` của chúng bằng độ offset cần thiết.
`Class.Model|Models` được di chuyển theo cách này bằng cách biến đổi
`Class.Model.WorldPivot` của chúng bằng độ offset cần thiết.

Lưu ý rằng vì lý do hiệu suất, các sự kiện `Class.Object.Changed` không
được kích hoạt cho `Class.BasePart.Position|Position` và
`Class.BasePart.Orientation|Orientation` của `Class.BasePart|BaseParts`
bị di chuyển theo cách này; chúng chỉ được kích hoạt cho `Datatype.CFrame`.

Khi gọi `Class.PVInstance:PivotTo()|PivotTo` trên `Class.Model|Models`,
các độ offset của các phần và mô hình con được lưu trữ, sao cho
các cuộc gọi sau đó đến `Class.PVInstance:PivotTo()|PivotTo` trên cùng một mô hình
không tích lũy độ trôi điểm nổi giữa các phần tạo nên mô hình.

`Class.Model|Models` và `Class.BasePart|BaseParts` đều là
`Class.PVInstance|PVInstances` ("Vị trí Tốc độ Instances") và cả hai
đều có chức năng này.


PVInstance:PivotTo

targetCFrame

`Datatype.CFrame` mà điểm pivot của `Class.PVInstance` nên bằng
sau khi di chuyển nó.


Biến đổi `Class.PVInstance` cùng với tất cả các `Class.PVInstance|PVInstances` con của nó
sao cho điểm pivot hiện nằm ở `Datatype.CFrame` được chỉ định.


PVInstance

PVInstance.Origin

PVInstance.Pivot Offset

Lớp trừu tượng cho tất cả các đối tượng có vị trí vật lý trong thế giới.


`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
mà có thể là một phần của cây `Class.DataModel`.

Không thể tạo các đối tượng `Instance` gốc trực tiếp, nhưng
constructor đặc biệt `Datatype.Instance.new()` tạo ra các đối tượng qua mã,
lấy tên của lớp làm tham số và trả về đối tượng đã được tạo ra.

Minh họa việc phát hiện các thay đổi trong tổ tiên của một thể hiện bằng cách kết nối với sự kiện
`Class.Instance.AncestryChanged`.

Cha của ChangingPart được thiết lập với các giá trị khác nhau theo thời gian. Cha của
phần đó là tổ tiên của phần đó, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt
mỗi khi nó thay đổi.


Bắt đầu khi thể hiện này được đặt lại cha hoặc khi bất kỳ tổ tiên nào của nó được
đặt lại cha.

Bạn có thể sử dụng sự kiện này để theo dõi việc xóa một thể hiện trong Studio,
hay là xóa thủ công trong Explorer hoặc thông qua một plugin. Nếu bạn cần
tìm thời điểm một thể hiện bị hủy bằng cách dùng `Class.Instance:Destroy()`,
sử dụng sự kiện `Class.Instance.Destroying` thay vào đó.

Instance.AncestryChanged

child

Thể hiện có thuộc tính `Class.Instance.Parent|Parent` đã thay đổi,
điều này có thể là thể hiện này hoặc một tổ tiên xa hơn, **không**
hất thiết là thể hiện mà hàm xử lý đang kết nối với.

parent

Bắt đầu khi thuộc tính `Class.Instance.Parent` của đối tượng này hoặc một trong
những tổ tiên của nó bị thay đổi.

Sự kiện này bắt đầu bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được thiết lập thành `nil`. Tên của thuộc tính đã thay đổi
được truyền vào hàm kết nối.

Chẳng hạn, đoạn mã sau kết nối hàm `attributeChanged()`
để kích hoạt bất cứ khi nào một trong những thuộc tính của phần thay đổi:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "đã thay đổi")
end

part.AttributeChanged:Connect(attributeChanged)
```
Xem thêm `Class.Instance:GetAttributeChangedSignal()` trả về một
sự kiện mà kích hoạt khi một thuộc tính nhất định thay đổi.

Instance.AttributeChanged

attribute

Tên của thuộc tính đã bị thay đổi.

Bắt đầu bất cứ khi nào một thuộc tính được thay đổi trên `Class.Instance`.

Đoạn mã này in tên các đối tượng khi chúng được thêm vào Workspace:


Bắt đầu sau khi một đối tượng được gán làm con của `Class.Instance`.

Lưu ý, khi sử dụng phương thức này trên client để phát hiện các đối tượng được tạo bởi
máy chủ, cần thiết phải sử dụng `Class.Instance:WaitForChild()` khi
chỉ mục các đối tượng con của những đối tượng này. Điều này là do đối tượng và các
đối tượng con của nó không được đảm bảo sao chép từ máy chủ sang client
một cách đồng bộ. Ví dụ:

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

Workspace.ChildAdded:Connect(function(child)
	-- Sử dụng WaitForChild() vì các đối tượng con có thể chưa được sao chép
	local head = child:WaitForChild("Head")
end)
```
Lưu ý, sự kiện này chỉ hoạt động cho các đối tượng con ngay lập tức của
`Class.Instance`. Đối với một sự kiện mà ghi lại tất cả các đối tượng con, hãy sử dụng
`Class.Instance.DescendantAdded`.

Xem thêm `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Đối tượng `Class.Instance` đã được thêm vào.

Bắt đầu sau khi một đối tượng được gán làm con của `Class.Instance`.

Instance.childAdded

Đoạn mã này in ra tên của các đối tượng khi chúng bị xóa khỏi
Workspace:

Bắt đầu sau khi một đối tượng con bị xóa khỏi `Class.Instance`.

Bị xóa đề cập đến khi cha của một đối tượng bị thay đổi từ `Class.Instance`
sang một cái gì đó khác ngoài `Class.Instance`. Lưu ý, sự kiện này
cũng sẽ xảy ra khi một đối tượng con bị hủy (sử dụng
`Class.Instance:Destroy()`) khi chức năng hủy đặt cha của đối tượng
thành `nil`.

Sự kiện này chỉ hoạt động cho các đối tượng con ngay lập tức của
`Class.Instance`. Đối với một sự kiện mà ghi lại tất cả các đối tượng con, hãy sử dụng
`Class.Instance.DescendantRemoving`.

Xem thêm `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Đối tượng `Class.Instance` đã bị xóa.

Bắt đầu sau khi một đối tượng con bị xóa khỏi `Class.Instance`.

Ví dụ sau đây sẽ in ra tên của bất kỳ đối tượng nào được thêm vào
Workspace:


Sự kiện này xảy ra sau khi một đối tượng con được thêm vào `Class.Instance`.

Vì nó xảy ra cho từng đối tượng con, việc gán một đối tượng vào
`Class.Instance` sẽ kích hoạt sự kiện cho đối tượng này và tất cả các
đối tượng con của nó một cách riêng biệt.

Nếu bạn chỉ quan tâm đến **các đối tượng con trực tiếp** của
`Class.Instance`, hãy sử dụng `Class.Instance.ChildAdded` thay vào đó.

Xem thêm `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Bắt đầu sau khi một đối tượng con được thêm vào `Class.Instance`.

Ví dụ sau in tên của bất kỳ đối tượng con nào khi nó đang được gỡ ra
khỏi Workspace:

Sự kiện này xảy ra **ngay trước khi** `Class.Instance`
thay đổi sao cho một thể hiện **con cháu** sẽ không còn là một
con cháu nữa. `Class.Instance:Destroy()|Destroy()` thay đổi
thuộc tính `Class.Instance.Parent|Parent` của một thể hiện thành `nil`, vì vậy việc gọi phương thức đó trên một con cháu của cha sẽ gây ra sự kiện này xảy ra.

Vì sự kiện này xảy ra **trước** khi con cháu bị xóa, cha của
con cháu sẽ không thay đổi tại thời điểm sự kiện này xảy ra. Nếu con cháu
cũng là một **đối tượng trực tiếp** của cha, sự kiện này sẽ xảy ra
trước `Class.Instance.ChildRemoved`.

Nếu một con cháu có các đối tượng con, sự kiện này sẽ xảy ra với con cháu trước,
được theo sau bởi các con cháu của nó.

#### Cảnh báo

Sự kiện này xảy ra với đối tượng con đang bị xóa.
Cố gắng thiết lập thuộc tính `Class.Instance.Parent|Parent` của con cháu thành
một cái gì đó khác sẽ thất bại. Dưới đây là một ví dụ minh họa điều này:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Không thao tác với cha của con cháu trong hàm này!
	-- Sự kiện này xảy ra BỞI vì cha được thao tác, và sự thay đổi chưa diễn ra
	-- Do đó, việc thay đổi cha như thế này là vấn đề:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Xem thêm `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Đối tượng `Class.Instance` đang bị xóa.

Bắt đầu ngay trước khi một đối tượng con của `Class.Instance` bị xóa.

Mẫu này minh họa cách mà, khi sử dụng hành vi tín hiệu Ngay lập tức, một
Instance đang bị xóa vẫn giữ nguyên vị trí cho đến khi hàm kết nối tạm dừng.


Ví dụ này cho thấy cách mà, khi sử dụng hành vi tín hiệu Deferred, một Instance
được xóa trước khi tín hiệu được phát.


Đối tượng `Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi một hàm kết nối
vẫn đang sử dụng nó. Tuy nhiên, nếu hàm đó chờ tại bất kỳ thời điểm nào,
đối tượng `Class.Instance` và các con cháu của nó sẽ được chuyển thành `nil`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được thiết lập thành
`Enum.SignalBehavior.Immediate`, sự kiện này sẽ xảy ra ngay trước khi
`Class.Instance` hoặc một trong các tổ tiên của nó bị xóa bằng cách dùng
`Class.Instance:Destroy()`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được thiết lập thành
`Enum.SignalBehavior.Deferred`, sự kiện này sẽ xảy ra tại điểm tiếp theo,
điều này sẽ diễn ra sau khi `Class.Instance` hoặc một trong các tổ tiên của nó
bị xóa bằng cách dùng `Class.Instance:Destroy()`.

Với hành vi `Enum.SignalBehavior.Deferred|Deferred`, việc kết nối một kịch bản
với sự kiện `Class.Instance.Destroying` của chính nó là vấn đề, vì kịch bản
sẽ bị xóa trước khi callback có thể được gọi (nghĩa là nó sẽ không
thực thi).

Khi xóa một `Class.Instance` trong Studio, chẳng hạn như xóa thủ công
thông qua [Explorer](/studio/explorer) hoặc thông qua một plugin,
thì `Class.Instance` không bị xóa. Thay vào đó, cha được đặt thành `nil`
điều này bạn có thể theo dõi bằng `Class.Instance.AncestryChanged`.

Instance.Destroying

Bắt đầu ngay trước khi (hoặc được hoãn đến sau) thể hiện bị
hủy bằng cách dùng `Class.Instance:Destroy()`.

Sự kiện này xảy ra bất cứ khi nào bất kỳ thuộc tính phong cách nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được thiết lập thành `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("Các thuộc tính phong cách đã thay đổi")
end

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

Instance.StyledPropertiesChanged

Bắt đầu bất cứ khi nào bất kỳ thuộc tính phong cách nào được thay đổi trên thể hiện, bao gồm
khi một thuộc tính được thiết lập thành `nil`.

Phương thức này áp dụng một thẻ cho đối tượng, không có hiệu ứng nếu thẻ đã
được áp dụng. Thêm thành công một thẻ sẽ kích hoạt tín hiệu được tạo ra bởi
`Class.CollectionService:GetInstanceAddedSignal()` với thẻ đã cho.

#### Cảnh báo

- Các thẻ của một đối tượng đã được thêm từ phía khách hàng sẽ bị xóa nếu máy chủ
   sau đó thêm hoặc xóa một thẻ trên đối tượng đó vì máy chủ
   nhân bản tất cả các thẻ cùng nhau và ghi đè lên các thẻ trước đó.

- Khi đánh dấu một đối tượng, thường có một số tài nguyên được sử dụng để
   cung cấp chức năng cho thẻ đó, ví dụ như các kết nối sự kiện hoặc bảng.
   Để tránh rò rỉ bộ nhớ, tốt nhất là dọn dẹp chúng (ngắt kết nối,
   đặt thành `nil`, v.v.) khi không còn cần thiết cho một thẻ.
   Làm điều này khi gọi `Class.Instance:RemoveTag()`, gọi
   `Class.Instance:Destroy()`, hoặc trong một hàm kết nối với một tín hiệu
   được trả về bởi `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Áp dụng một thẻ cho đối tượng.

Hàm con trả về một mảng của các con của đối tượng.

Instance:children

Mảng của các đối tượng/các trường hợp con.

Trả về một mảng của các con của đối tượng.

Phương thức này sẽ tiêu diệt tất cả con và hậu duệ của một đối tượng.

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

-- Thêm một số lấp lánh
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
```
Nếu bạn không muốn tiêu diệt **tất cả** con và hậu duệ, vui lòng sử dụng,
`Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để
lặp qua các con/hậu duệ đó và chọn những gì để tiêu diệt. Ví dụ,
mẫu mã sau đây sẽ tiêu diệt tất cả
`Class.BasePart|BaseParts` kế thừa từ một `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

Phương thức này tiêu diệt tất cả con của một đối tượng.

Minh họa việc nhân bản một mô hình bằng cách sử dụng `Class.Instance:Clone()`.


`Clone()` tạo ra một bản sao của một đối tượng và tất cả các hậu duệ của nó,
 bỏ qua tất cả các đối tượng không phải
`Class.Instance.Archivable|Archivable`. Bản sao của đối tượng gốc được
trả về bởi phương thức này và `Class.Instance.Parent|Parent` của nó được đặt thành
`nil`. Lưu ý rằng nếu chính đối tượng có
`Class.Instance.Archivable|Archivable` đặt thành `false`, phương thức này sẽ
trả về `nil`.

Nếu một thuộc tính tham chiếu như `Class.ObjectValue.Value` được đặt trong một
đối tượng được sao chép, giá trị của thuộc tính của bản sao phụ thuộc vào
giá trị của đối tượng gốc:

- Nếu một thuộc tính tham chiếu trỏ đến một đối tượng cũng được sao chép,
  bản sao sẽ trỏ đến bản sao đó.
- Nếu một thuộc tính tham chiếu trỏ đến một đối tượng không được sao chép,
  giá trị tương tự được giữ lại trong bản sao.

Instance:Clone

Tạo một bản sao của một đối tượng và toàn bộ hậu duệ của nó, bỏ qua các đối tượng
mà không phải là `Class.Instance.Archivable|Archivable`.

Instance:clone

Minh họa việc phá hủy một Part bằng cách sử dụng hàm `Class.Instance:Destroy()`.

Hàm này là cách đúng để giải phóng các đối tượng không còn cần thiết.

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` trên tất cả các con. Phương thức này là cách chính xác để loại bỏ
các đối tượng không còn cần thiết.

Việc loại bỏ các đối tượng không cần thiết là quan trọng, vì các đối tượng và
kết nối không cần thiết trong một địa điểm sử dụng bộ nhớ mà có thể dẫn đến
các vấn đề hiệu suất nghiêm trọng theo thời gian.

Như một phương pháp tốt nhất sau khi gọi `Destroy()` trên một đối tượng, hãy đặt bất kỳ
biến nào tham chiếu đến đối tượng (hoặc các hậu duệ của nó) thành `nil`. Điều này
ngăn chặn mã của bạn truy cập bất kỳ điều gì liên quan đến đối tượng đó.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Đừng làm điều này:
print(part.Name)  --> "Hello, world"
-- Làm điều này để ngăn dòng trên hoạt động:
part = nil
```
Một khi một `Class.Instance` đã bị tiêu diệt bởi phương thức này, nó không thể được
sử dụng lại vì thuộc tính `Class.Instance.Parent` bị khóa. Để **tạm thời**
loại bỏ một đối tượng thay vì tiêu diệt nó, hãy đặt `Class.Instance.Parent|Parent`
thành `nil`. Ví dụ:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Để tiêu diệt một đối tượng sau một khoảng thời gian nhất định, sử dụng
`Class.Debris:AddItem()`.

Instance:Destroy

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` trên tất cả các con.

Instance:destroy

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Instance.Name` bằng với tên đã cho.

Phương thức này hoạt động lên trên, nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay tức thì và đi lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên tương ứng, nó sẽ trả về `nil`.

Mẫu mã sau đây sẽ tìm tổ tiên đầu tiên của đối tượng
có tên là `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Đối với các biến thể của phương thức này tìm tổ tiên của một lớp cụ thể,
hãy xem `Class.Instance:FindFirstAncestorOfClass()` và
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Tên của `Class.Instance.Name` sẽ được tìm kiếm.

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Instance.Name` bằng với tên đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Object.ClassName` bằng với tên lớp đã cho.

Phương thức này hoạt động lên trên, nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay tức thì và đi lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên tương ứng, nó sẽ trả về `nil`.

Một cách sử dụng phổ biến của phương thức này là tìm `Class.Model` mà một
`Class.BasePart` thuộc về. Ví dụ:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Phương thức này là một biến thể của `Class.Instance:FindFirstAncestor()` mà
kiểm tra thuộc tính `Class.Object.ClassName` thay vì
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` cũng
có, sử dụng phương thức `Class.Object:IsA()` để tôn trọng sự kế thừa lớp.

Instance:FindFirstAncestorOfClass

className

Tên `Class.Object.ClassName` sẽ được tìm kiếm.

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Object.ClassName` bằng với tên lớp đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho tên lớp đã cho.

Phương thức này hoạt động lên trên, nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay tức thì và đi lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên tương ứng, nó sẽ trả về `nil`.

Khác với `Class.Instance:FindFirstAncestorOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` mà tôn trọng sự kế thừa lớp. Ví dụ:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Do đó, mẫu mã sau sẽ trả về tổ tiên đầu tiên của `Class.BasePart`, bất kể nó là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Cũng xem `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho tên lớp đã cho.

Phía dưới sẽ tìm kiếm trong Workspace cho một đối tượng có tên là "Brick". Nếu tìm thấy, nó
sẽ thay đổi tên của đối tượng thành "Foo".

Trả về con đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không có con nào tồn tại. Nếu tham số tùy chọn `recursive`
được đặt thành `true`, phương thức này sẽ tìm kiếm tất cả các hậu duệ thay vì chỉ
các con ngay tức thì của `Class.Instance`.

#### Kiểm tra sự tồn tại của một đối tượng

`FindFirstChild()` là cần thiết nếu bạn cần xác minh một đối tượng tồn tại
trước khi tiếp tục. Cố gắng chỉ mục một con theo tên bằng cách sử dụng toán tử chấm sẽ gây lỗi nếu con không tồn tại.

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

-- Dòng sau sẽ báo lỗi nếu phần không tồn tại trong không gian làm việc
Workspace.Part.Transparency = 0.5
```
Cách tốt hơn là sử dụng `FindFirstChild()` để trước tiên kiểm tra cho `Part`,
sau đó sử dụng câu lệnh `if` để chạy mã cần nó.

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

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

#### Tìm một con có tên khớp với một thuộc tính

Đôi khi `Class.Instance.Name|Name` của một đối tượng là giống với đó
của một thuộc tính của `Class.Instance.Parent|Parent`. Khi sử dụng toán tử chấm,
thuộc tính ưu tiên hơn các con nếu chúng chia sẻ cùng một tên.

Trong ví dụ sau đây, một `Class.Folder` gọi là `Color` đã được thêm vào một
`Class.Part`, mà cũng có thuộc tính `Class.Part.Color`. Lưu ý rằng
`part.Color` ám chỉ đến giá trị thuộc tính `Datatype.Color3`, không phải đối tượng con `Class.Folder`. Lợi ích của việc sử dụng
`Class.Instance:FindFirstChild()|FindFirstChild()` là việc giới thiệu các thuộc tính mới không tạo ra
rủi ro cho mã của bạn.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Thuộc tính
local c2 = part:FindFirstChild("Color")  -- Thư mục con
```

#### Ghi chú về hiệu suất

`Class.Instance:FindFirstChild()|FindFirstChild()` mất khoảng 20% thời gian
so với việc sử dụng toán tử chấm và gần như 8 lần lâu hơn so với việc chỉ lưu
trữ một tham chiếu đến một đối tượng. Do đó, bạn nên tránh gọi nó trong
mã phụ thuộc vào hiệu suất chẳng hạn như trong các vòng lặp chặt chẽ hoặc các hàm được kết nối
với `Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
lưu trữ kết quả trong một biến, hoặc xem xét sử dụng
`Class.Instance.ChildAdded|ChildAdded` hoặc
`Class.Instance:WaitForChild()|WaitForChild()` để phát hiện khi một con có
tên nhất định trở nên khả dụng.

Instance:FindFirstChild

Tên `Class.Instance.Name` sẽ được tìm kiếm.

recursive

Liệu việc tìm kiếm có nên được thực hiện một cách đệ quy hay không.

Trả về con đầu tiên của `Class.Instance` được tìm thấy với tên đã cho.

Instance

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
mà có thể là một phần của cây `Class.DataModel`.

/reference/engine/classes/BackpackItem.yaml