Flag เป็นหน่วยที่เกิดขึ้นพร้อมกับวัตถุ `Class.FlagStand` และจะเกิดใหม่เมื่อถูกจับ เมื่อผู้เล่นสัมผัส Handle ของวัตถุนี้ ซึ่งต้องเป็นลูกของวัตถุ Flag ซึ่งเป็น Part ที่ชื่อว่า "Handle" ธงจะถูกเพิ่มเข้าไปในเป้สะพายหลังของผู้เล่นและจะปรากฏในมือของพวกเขา ผู้เล่นไม่สามารถเลือกอาวุธอื่นในขณะที่ถือธงและสามารถทิ้งธงได้ตลอดเวลาทางการกด "Backspace" บนแป้นพิมพ์ หากผู้เล่นที่ถือธงก้าวเข้าสู่วัตถุ FlagStand ของทีมที่มีสีแตกต่างกัน ธงจะถูกลบออกจากเป้สะพายหลังของผู้เล่นและคะแนนจะถูกเพิ่มไปยัง leaderstats ของผู้ใช้ หากมีการระบุ ธงจะ regenerated ที่ที่ตั้งธงต้นฉบับ。


Flag

ทีม `Class.Team` ที่ธงนี้เป็นของ ม Corresponds กับ TeamColors ในบริการ `Class.Teams`。

วัตถุ `Class.Flag` และ `Class.FlagStand` ถูกสร้างขึ้นเพื่ออนุญาตให้ผู้พัฒนาสร้างเกมสไตล์ 'จับธง' ได้อย่างรวดเร็ว。


Flag.TeamColor

ทีม `Class.Team` ที่ธงนี้เป็นของ ม Corresponds กับ TeamColors ในบริการ `Class.Teams`。


วัตถุ Flag ช่วยให้คุณสร้างเกมสไตล์ 'จับธง' ได้。


โค้ดนี้ถูกออกแบบมาให้วางในสคริปต์ภายในเครื่องมือ มันอนุญาตให้ผู้เล่น
สร้างการระเบิดโดยการสวมใส่เครื่องมือและคลิกที่พื้น มันทำงาน
โดยการกำหนดฟังก์ชัน `explode` ซึ่งสร้างการระเบิดที่ไม่เป็นอันตรายที่
จุดที่กำหนด จากนั้น มันกำหนดฟังก์ชัน `onActivated` ซึ่งทำงานเมื่อ
เครื่องมือถูกเปิดใช้งาน สุดท้าย มันเชื่อมต่อเหตุการณ์ Activated ของเครื่องมือ
กับฟังก์ชัน `onActivated`.

ในการทดสอบโค้ดนี้ คุณสามารถสร้างเครื่องมือและใส่ชิ้นส่วนภายในมัน ตั้งชื่อ
ชิ้นส่วนนั้นว่า "Handle" ใส่สคริปต์ภายในเครื่องมือถัดไป และวางโค้ดลงไป
ในนั้น สุดท้าย ให้วางเครื่องมือใน StarterPack.

ตัวอย่างโค้ดนี้เป็นสำหรับวัตถุเครื่องมือที่มีชิ้นส่วนชื่อ Handle มันตรวจจับ
เมื่อ Humanoid ที่ไม่ใช่ผู้ถือปัจจุบันตีไปที่ Handle และทำให้เกิดความเสียหาย
แก่พวกเขา นอกจากนี้เมื่อเครื่องมือถูกเปิดใช้งาน จะทำให้เกิดอนิเมชันการฟัน
ในสคริปต์การอนิเมชันตัวละครเริ่มต้น ลองใช้สคริปต์นี้โดยการสร้างวัตถุเครื่องมือใน
StarterPack วางชิ้นส่วนภายในมันและตั้งชื่อว่า Handle จากนั้นวางโค้ดนี้ลงใน
สคริปต์ภายในเครื่องมือ แล้วลองฟันที่ Humanoid อื่น!

เครื่องมือ (`Tool`) เป็นวัตถุที่สามารถติดตั้งโดยวัตถุ `Class.Humanoid` สำหรับผู้เล่น,
พวกเขาจะถูกจัดเก็บในวัตถุ `Class.Backpack` ที่เป็นต้นแบบให้กับวัตถุ `Class.Player`
ในประสบการณ์ ผู้เล่นอาจมีเครื่องมือหลายชิ้นซึ่งปรากฏเป็นไอคอน
ที่ด้านล่างของหน้าจอ การติดตั้งเครื่องมือจะย้ายมันจาก
`Class.Backpack` ไปยังโมเดล `Class.Player.Character` ใน
`Class.Workspace` โดยค่าเริ่มต้น เครื่องมือจะถือในมือขวาและมี
ด้ามในนั้น ซึ่งเป็น `Class.BasePart` ที่ชื่อว่า `Handle` ภายใน (แม้ว่าจะไม่จำเป็นหาก `Class.Tool.RequiresHandle` เป็น `false`) เครื่องมือที่จะมอบให้แก่ผู้เล่นที่ (re)เกิดใหม่ควรจัดเก็บใน `Class.StarterPack`。

เหตุการณ์นี้เกิดขึ้นเมื่อผู้เล่นคลิกขณะ `Class.Tool` ถูก
ติดตั้ง มันจะ **ไม่** เกิดขึ้นหากกดปุ่ม <kbd>Ctrl</kbd> ขณะคลิก。

เหตุการณ์นี้โดยทั่วไปใช้เพื่อดำเนินการเมื่อผู้เล่นใช้งาน
เครื่องมือ เช่น การปล่อยจรวดจากเครื่องมืออาวุธปล่อยจรวด。

โค้ดด้านล่าง เมื่อวางใน `Class.LocalScript` จะสร้างเครื่องมือใน
`Class.Backpack` ของผู้เล่นที่กำหนดและพิมพ์ "เครื่องมือถูกเปิดใช้งาน" เมื่อผู้เล่นคลิกขณะเครื่องมือที่สร้างถูกติดตั้งอยู่。

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

local tool = Instance.new("Tool")
tool.RequiresHandle = false
tool.Parent = Players.LocalPlayer.Backpack

function onActivation()
	print("เครื่องมือถูกเปิดใช้งาน")
end

tool.Activated:Connect(onActivation)
```

Tool.Activated

เกิดขึ้นเมื่อผู้เล่นคลิกขณะเครื่องมือถูกติดตั้ง。

เหตุการณ์นี้เกิดขึ้นเมื่อผู้เล่นปล่อยคลิกขณะ
`Class.Tool` ถูกติดตั้งและเปิดใช้งาน โดยทั่วไปจะใช้เพื่อดำเนินการเมื่อผู้เล่นหยุดใช้งานเครื่องมือ。

โค้ดด้านล่าง เมื่อวางใน `Class.LocalScript` จะสร้างเครื่องมือใน
`Class.Backpack` ของผู้เล่นที่กำหนดและพิมพ์ "เครื่องมือถูกปิดใช้งาน" เมื่อผู้เล่นปล่อยคลิกขณะเครื่องมือถูกติดตั้งและเปิดใช้งานอยู่。

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

local tool = Instance.new("Tool")
tool.RequiresHandle = false
tool.Parent = Players.LocalPlayer.Backpack

function toolDeactivated()
	print("เครื่องมือถูกปิดใช้งาน")
end

tool.Deactivated:Connect(toolDeactivated)
```

Tool.Deactivated

เกิดขึ้นเมื่อผู้เล่นปล่อยคลิกขณะเครื่องมือถูกติดตั้งและ
เปิดใช้งาน。

ตัวอย่างด้านล่างนี้จะพิมพ์ "มีการสวมอุปกรณ์" ทุกครั้งที่อุปกรณ์ถูก
iswear โดยผู้เล่น โปรดทราบว่าตัวอย่างด้านล่างนี้สมมติว่าคุณได้
กำหนดแล้วว่า "อุปกรณ์" คืออะไร

เหตุการณ์นี้เกิดขึ้นเมื่อผู้เล่นติดตั้ง `Class.Tool` (นำออกจาก
`Class.Backpack`)。

เหตุการณ์ตรงกันข้ามกับเหตุการณ์นี้คือ `Class.Tool.Unequipped` สามารถใช้เพื่อ
ระบุเมื่อผู้เล่นประกอบเครื่องมือโดยนำมันออกจากกระเป๋าของพวกเขา。

โปรดทราบว่าเหตุการณ์นี้ **ไม่** เกิดขึ้นเมื่อ `Class.Tool.RequiresHandle` ถูก
เปิดใช้งานและไม่มีด้ามอยู่。

Tool.Equipped

mouse

เมาส์ของผู้เล่น。

เกิดขึ้นเมื่อเครื่องมือถูกติดตั้ง。

เหตุการณ์นี้เกิดขึ้นเมื่อผู้เล่นถอดเครื่องมือ `Class.Tool` (ใส่ลงใน
`Class.Backpack`)。

เหตุการณ์ตรงกันข้ามกับเหตุการณ์นี้คือ `Class.Tool.Equipped` สามารถใช้เพื่อ
ระบุเมื่อผู้เล่นติดตั้งเครื่องมือโดยนำออกจากกระเป๋าของเขา。

โปรดทราบว่าเหตุการณ์นี้ **ไม่** เกิดขึ้นเมื่อ `Class.Tool.RequiresHandle` ถูก
เปิดใช้งานและไม่มีด้ามอยู่。

Tool.Unequipped

เกิดขึ้นเมื่อเครื่องมือถูกถอดออก。

โค้ดด้านล่างสร้าง `Class.Tool` ใน `Class.Backpack` ของผู้เล่นท้องถิ่น
ที่ทำให้ผู้เล่นหายตัวเมื่อเปิดใช้งานและกลับมามีตัวตนเมื่อปิดใช้งาน

เมื่อถูกสวมใส่ สคริปต์จะจำลองการเปิดใช้งานเครื่องมือและทำให้
ผู้เล่นหายตัวเป็นเวลา 3 วินาทีและจากนั้นจำลองการปิดใช้งานเครื่องมือ
การกดปุ่มเมาส์ซ้ายค้างจะทำให้ผู้เล่นหายตัวได้นานสูงสุด 3
วินาที โดยมีระยะเวลาฟื้นฟู 1 วินาที หรือจนกว่าผู้เล่นจะปล่อย
ปุ่มเมาส์ซ้ายของตน.

ฟังก์ชันนี้จำลองการเปิดใช้งานของ `Class.Tool` เครื่องมือจะต้องถูก
ติดตั้งสำหรับฟังก์ชันนี้ทำงาน。

Tool:Activate

จำลองการเปิดใช้งานของ `Class.Tool`。

ฟังก์ชันนี้จำลองการปิดใช้งานของ `Class.Tool` เครื่องมือจะต้องถูก
ติดตั้งสำหรับฟังก์ชันนี้ทำงาน。

Tool:Deactivate

จำลองการปิดใช้งานของ `Class.Tool`。

Tool

คุณสมบัติ CanBeDropped ควบคุมว่าผู้เล่นสามารถปล่อย
`Class.Tool` ได้หรือไม่。

หากเป็นจริง เมื่อกดปุ่มลบ เครื่องมือจะถูกจัดให้อยู่ใน
`Class.Workspace` และถูกนำออกจาก `Class.Backpack` ของผู้เล่น หาก
เป็นเท็จ จะไม่มีอะไรเกิดขึ้นเมื่อกดลบและเครื่องมือจะยังคงติดตั้งอยู่。

Tool.CanBeDropped

ควบคุมว่าผู้เล่นสามารถปล่อยเครื่องมือได้หรือไม่。

ตัวอย่างโค้ดด้านล่างนี้สร้าง `Class.Tool` ใน `Class.Backpack` ของผู้เล่นท้องถิ่น
ซึ่งเพิ่ม `Class.Humanoid.JumpPower|JumpPower`
จาก `50` เป็น `150` เป็นเวลา 5 วินาที。

ตัวอย่างนี้ใช้คุณสมบัติ `Class.Tool.Enabled` ของเครื่องมือเป็นการป้องกันโดย
ตั้งค่าคุณสมบัติเป็น `true` เมื่อผู้เล่นกระโดดและกลับเป็น `false` หลังจาก
ระยะเวลา 5 วินาที。

การถอดเครื่องมือออกก็หยุดผู้เล่นจากการกระโดดซุปเปอร์โดยการเปลี่ยน
`Class.Humanoid.JumpPower|JumpPower` กลับเป็น `50`.

คุณสมบัติ **Enabled** เกี่ยวข้องกับว่า `Class.Tool` สามารถ
ใช้งานได้หรือไม่ สิ่งนี้มีประโยชน์หากคุณต้องการป้องกันไม่ให้ผู้เล่นใช้เครื่องมือ,
แต่ไม่ต้องการนำออกจาก `Class.Backpack` ของพวกเขา。

เมื่อตั้งค่าเป็น `true` ผู้เล่นสามารถใช้เครื่องมือได้ เมื่อเป็น `false` เครื่องมือจะถูกปิดใช้งานและผู้เล่นไม่สามารถใช้มันได้; สิ่งนี้ป้องกันเครื่องมือจากการใช้งานหรือปิดการใช้งานโดยวิธี `Class.Tool:Activate()` และ
`Class.Tool:Deactivate()` และป้องกันเหตุการณ์
`Class.Tool.Activated` และ `Class.Tool.Deactivated` จากการเกิดขึ้น。

Tool.Enabled

เกี่ยวข้องกับว่าเครื่องมือสามารถใช้งานได้หรือไม่。

โค้ดด้านล่างจะใส่ `Class.Tool` ที่มีชื่อว่า **Stick** ลงใน
`Class.BackPack` ของผู้เล่นท้องถิ่น เมื่อผู้เล่นเปิดใช้งานเครื่องมือ โค้ดจะแสดงค่า
ของคุณสมบัติของที่จับของเครื่องมือ

คุณสมบัติ `Grip` เก็บคุณสมบัติ "grip" ของเครื่องมือเป็นหนึ่ง
`Datatype.CFrame` คุณสมบัติเหล่านี้ตำแหน่งวิธีที่ผู้เล่นถือเครื่องมือ
และรวมถึง `Class.Tool.GripUp|GripUp`, `Class.Tool.GripRight|GripRight`,
`Class.Tool.GripForward|GripForward`, และ `Class.Tool.GripPos|GripPos`。

Tool.Grip

เก็บคุณสมบัติ "grip" ของเครื่องมือเป็น `Datatype.CFrame` เดียว。

คุณสมบัติบางอย่างที่ระบุการจัดเก็บเครื่องมือในมือของตัวละคร
นี่แสดงถึงค่า `R02`, `R12`, และ `R22` ของมุมหมุน
`Datatype.CFrame` ของ grip。

คุณสมบัติของเครื่องมืออื่น ๆ ที่ควบคุมวิธีที่ตัวละครถือเครื่องมือรวมถึง
`Class.Tool.GripUp`, `Class.Tool.GripRight`, และ `Class.Tool.GripPos` คุณสมบัติทั้งหมดนี้
จะถูกจัดเก็บใน `Datatype.CFrame` เดียวใน
คุณสมบัติ `Class.Tool.Grip`。

Tool.GripForward

แสดงค่า `R02`, `R12`, และ `R22` ของมุมหมุน
`Datatype.CFrame` ของ grip。

คุณสมบัตินี้ควบคุมการเบี่ยงเบนเชิงตำแหน่งของเมตริกการเชื่อมโยงของเครื่องมือ มัน
เป็นหนึ่งในหลาย ๆ คุณสมบัติที่ใช้ในการกำหนดตำแหน่งที่ตัวละครผู้เล่น
ถือเครื่องมือ。

คุณสมบัติอื่น ๆ ที่ควบคุมว่าตัวละครถือเครื่องมืออย่างไร รวมถึง
`Class.Tool.GripUp`, `Class.Tool.GripRight`, และ `Class.Tool.GripForward` คุณสมบัติทั้งหมดนี้
จะถูกจัดเก็บใน `Datatype.CFrame` เดียวใน
คุณสมบัติ `Class.Tool.Grip`。

Tool.GripPos

การเบี่ยงเบนเชิงตำแหน่งของเมตริกการเชื่อมโยงของเครื่องมือ。

คุณสมบัติบางอย่างที่ระบุการจัดเก็บเครื่องมือในมือของตัวละคร
นี่แสดงถึงค่า `R00`, `R10`, และ `R20` ของมุมหมุน
`Datatype.CFrame` ของ grip。

คุณสมบัติของเครื่องมืออื่น ๆ ที่ควบคุมว่าตัวละครถือเครื่องมืออย่างไร รวมถึง
`Class.Tool.GripUp`, `Class.Tool.GripForward`, และ `Class.Tool.GripPos` คุณสมบัติทั้งหมดนี้
จะถูกจัดเก็บใน `Datatype.CFrame` เดียวใน
คุณสมบัติ `Class.Tool.Grip`。

Tool.GripRight

แสดงค่า `R00`, `R10`, และ `R20` ของมุมหมุน
`Datatype.CFrame` ของ grip。

คุณสมบัติบางอย่างที่ระบุการจัดเก็บเครื่องมือในมือของตัวละคร
นี่แสดงถึงค่า `R01`, `R11`, และ `R21` ของมุมหมุน
`Datatype.CFrame` ของ grip。

คุณสมบัติของเครื่องมืออื่น ๆ ที่ควบคุมว่าตัวละครถือเครื่องมืออย่างไร รวมถึง
`Class.Tool.GripRight`, `Class.Tool.GripForward`, และ
`Class.Tool.GripPos` คุณสมบัติทั้งหมดนี้จะถูกจัดเก็บใน `Datatype.CFrame` เดียวใน
คุณสมบัติ `Class.Tool.Grip`。

Tool.GripUp

แสดงค่า `R01`, `R11`, และ `R21` ของมุมหมุน
`Datatype.CFrame` ของ grip。

โค้ดตัวอย่างด้านล่างนี้สร้าง `Class.Tool` ใน `Class.Backpack` ของผู้เล่นท้องถิ่น
ที่เพิ่ม `Class.Humanoid.Walkspeed|WalkSpeed` ของพวกเขา
จาก `16` เป็น `30` เป็นเวลา 5 วินาที.

ในตัวอย่างนี้ใช้คุณสมบัติ `Class.Tool.ManualActivationOnly` ของเครื่องมือเป็น
debounce โดยการตั้งค่าคุณสมบัติเป็น `true` เมื่อตัวละครเริ่มวิ่ง
และเป็น `false` เมื่อตัวละครหยุดวิ่ง ส่งผลให้เมื่อผู้เล่น
กำลังวิ่ง เครื่องมือไม่สามารถเปิดใช้งานใหม่ได้.

การถอดเครื่องมือก็ยังหยุดผู้เล่นจากการวิ่งโดยการเปลี่ยน
`Class.Humanoid.Walkspeed|WalkSpeed` เป็น `16`.

คุณสมบัตินี้ควบคุมว่า `Class.Tool` สามารถเปิดใช้งานได้โดย
ไม่ต้องดำเนินการ `Class.Tool:Activate()` ในสคริปต์อย่างชัดเจน。

เมื่อถูกตั้งค่าเป็น `true` เครื่องมือจะยิง `Class.Tool.Activated` เฉพาะเมื่อ
`Class.Tool:Activate()` ถูกเรียก นอกจากนี้ยังปิดการใช้งานฟังก์ชัน
`Class.ContextActionService:BindActivate()`。

เมื่อถูกตั้งค่าเป็น `false` การคลิกเมาส์ (เมื่อเครื่องมือถูกติดตั้ง) จะยิง `Class.Tool.Activated` ด้วยเช่นกัน。

Tool.ManualActivationOnly

ควบคุมว่า `Class.Tool` สามารถเปิดใช้งานได้โดยไม่ต้องดำเนินการ
`Class.Tool:Activate()` หรือไม่。

คุณสมบัตินี้กำหนดว่า `Class.Tool` ทำงานโดยไม่ต้องมีด้ามหรือไม่。

เครื่องมือจะมีด้ามเมื่อมันมีชิ้นส่วนลูกที่ชื่อว่า **Handle** เครื่องมือ
ที่มีด้ามมักต้องการให้ผู้เล่นติดตั้งมันเพื่อถือวัตถุเพื่อใช้งาน,
เช่น อาวุธ เครื่องมือที่ไม่มีด้ามมักไม่ต้องการให้ผู้เล่นติดตั้ง
มันเพื่อถืออะไรก็ตามในการใช้งานเช่น "บิน" หรือ "เรียก" เครื่องมือ。

เมื่อถูกตั้งค่าเป็น `true` เครื่องมือจะทำงานเฉพาะเมื่อมีด้ามเท่านั้น เมื่อถูกตั้งค่าเป็น
`false` เครื่องมือจะทำงานแม้ไม่มีด้าม。

Tool.RequiresHandle

กำหนดว่า `Class.Tool` ทำงานโดยไม่ต้องมีด้ามหรือไม่。

คุณสมบัติ ToolTip ควบคุมข้อความที่จะแสดงเมื่อ
`Class.Mouse` ของผู้เล่นลอยอยู่เหนือ `Class.Tool` ใน
`Class.Backpack` ของพวกเขา。

โดยทั่วไป ค่าในคุณสมบัตินี้ควรอธิบายว่าเครื่องมือคืออะไร
หรือการใช้งานของมัน ตัวอย่างเช่น สำหรับเครื่องมือพลั่ว คุณอาจเลือกที่จะตั้งค่า
ToolTip เป็น:

```lua
tool.ToolTip = "พลั่ว"
```
หรือ

```lua
tool.ToolTip = "ใช้ในการขุด"
```
หรือ

```lua
tool.ToolTip = "พลั่ว - ใช้ในการขุด"
```

Tool.ToolTip

ควบคุมข้อความที่แสดงเมื่อเมาส์ของผู้เล่นลอยอยู่เหนือเครื่องมือใน
กระเป๋าของพวกเขา。

วัตถุ เช่น อาวุธ ที่สามารถติดตั้งโดย `Class.Humanoid`。

BackpackItem เป็นคลาสนามธรรมสำหรับรายการในกระเป๋าเป้ เช่น HopperBins และ
Tools.


BackpackItem

ไอคอนพื้นผิวที่แสดงสำหรับเครื่องมือในกระเป๋าเป้ของผู้เล่น.

คุณสมบัตินี้ควรตั้งค่าให้กับ ID เนื้อหาของภาพที่อัปโหลดไปยัง
เว็บไซต์ Roblox. รองรับเฉพาะ URI ของทรัพย์สินสำหรับคุณสมบัตินี้.

หากคุณสมบัตินี้ถูกปล่อยว่างไว้ GUI `Class.Backpack` จะแสดง
ชื่อของเครื่องมือแทน.


BackpackItem.TextureContent

ไอคอนพื้นผิวที่แสดงสำหรับเครื่องมือในกระเป๋าเป้ของผู้เล่น.
รองรับเฉพาะ URI ของทรัพย์สิน.


ไอคอนพื้นผิวที่แสดงสำหรับเครื่องมือในกระเป๋าเป้ของผู้เล่น.

คุณสมบัตินี้ควรตั้งค่าให้กับ ID เนื้อหาของภาพที่อัปโหลดไปยัง
เว็บไซต์ Roblox.

หากคุณสมบัตินี้ถูกปล่อยว่างไว้ GUI `Class.Backpack` จะแสดง
ชื่อของเครื่องมือแทน.


BackpackItem.TextureId

ไอคอนพื้นผิวที่แสดงสำหรับเครื่องมือในกระเป๋าเป้ของผู้เล่น.


ตัวอย่างต่อไปนี้รวมฟังก์ชันพื้นฐานที่รับตารางของออบเจ็กต์
และทำให้พวกมันเป็นพ่อแม่ในโมเดลใหม่ โดยส่งคืนโมเดลนั้น

โมเดลเป็นวัตถุที่ใช้เป็นตัวเก็บข้อมูล ซึ่งหมายถึงการรวบรวมวัตถุเข้าด้วยกัน พวกเขา
เหมาะที่สุดสำหรับการเก็บรวมกลุ่มของ `Class.BasePart|BaseParts` และมีฟังก์ชันมากมาย
ที่เพิ่มความสามารถของพวกเขา。

โมเดลมีวัตถุประสงค์เพื่อแสดงถึงการจัดกลุ่ม **เชิงเรขาคณิต** หากการจัดกลุ่มของคุณไม่มีการตีความเชิงเรขาคณิต เช่น การรวมกลุ่มของ
`Class.Script|Scripts` ให้ใช้ `Class.Folder` แทน。

โมเดลที่มีส่วนประกอบประกอบร่วมกันด้วยข้อต่อ (เพื่อให้พวกเขาสามารถเคลื่อนที่หรือลดก๊าซผ่านการจำลองฟิสิกส์) มักจะมี
`Class.Model.PrimaryPart|PrimaryPart` กำหนดไว้ เนื่องจากมันระบุว่าส่วนใดภายในโมเดลจะ "ตาม" เมื่อโมเดลเคลื่อนที่ กลุ่ม
โมเดลที่อยู่กับที่ซึ่งอยู่กับที่ไม่สามารถรับประโยชน์จากการตั้งค่าชิ้นส่วนหลักได้。

โมเดลมีการใช้งานในช่วงกว้าง รวมถึงตัวละครผู้เล่นใน Roblox。
พวกเขายังมีพฤติกรรมที่ไม่ซ้ำกันมากมายที่สำคัญให้คำนึงถึง:

- เมื่อมี `Class.Humanoid` และ `Class.Part` ที่ชื่อ **Head** ถูกพาเข้ามาใน
  โมเดล GUI ชื่อ/สุขภาพจะปรากฏขึ้นเหนือโมเดล; ดู
  [การแสดงชื่อ/สุขภาพของตัวละคร](/characters/name-health-display)
  สำหรับรายละเอียด。
- หากตำแหน่งของส่วนบนแกน **Y** แตะค่า
  `Class.Workspace.FallenPartsDestroyHeight` และมันเป็นวัตถุสุดท้ายภายใน `Class.Model`
  โมเดลจะถูกทำลายด้วย。
- เมื่อใช้ในที่ที่ `Class.Workspace.StreamingEnabled` เปิดใช้งานอยู่
  ค่า `Class.Model.ModelStreamingMode|ModelStreamingMode` จะควบคุม
  พฤติกรรมต่างๆ เกี่ยวกับวิธีที่โมเดลและบุตรหลานจะถูกทำซ้ำ
  และ/หรือนำออกจากลูกค้า นอกจากนี้แล้วค่า
  `Class.Model.LevelOfDetail|LevelOfDetail` มีผลต่อการเรนเดอร์ของโมเดล。

เช่นเดียวกับทุกประเภท `Class.Instance` ข้อเท็จจริงที่ว่าพ่อแม่ `Class.Model`
ถูกทำซ้ำไปยังลูกค้าไม่ได้รับประกันว่าสิ่งที่อยู่ในนั้นทั้งหมด
จะถูกทำซ้ำ นี่เป็นสิ่งที่สำคัญอย่างยิ่งหากอินสแตนซ์เหล่านี้กำลังถูกเข้าถึงด้วยโค้ดที่ทำงานบนลูกค้า เช่น ใน `Class.LocalScript`。
การใช้ `Class.Model.ModelStreamingMode|ModelStreamingMode` กับค่าเช่น
`Enum.ModelStreamingMode|Atomic` สามารถรับรองได้ว่าโมเดลทั้งหมดและบุตรหลานทั้งหมด
มีอยู่ถ้าพ่อแม่โมเดลมีอยู่ในลูกค้า หรือคุณสามารถใช้ `Class.Instance:WaitForChild()|WaitForChild()` เมื่อไม่ต้องการให้เป็นอะตอม。

ตั้งค่าโมเดลนี้ให้คงอยู่สำหรับผู้เล่นที่ระบุ โมเดลที่คงอยู่
จะยังคงมีอยู่สำหรับผู้เล่นโดยไม่คำนึงถึงการตั้งค่า
หรือเงื่อนไขการสตรีมมิ่ง。

`Class.Model.ModelStreamingMode|ModelStreamingMode` ต้องตั้งเป็น
`Enum.ModelStreamingMode|PersistentPerPlayer` เพื่อให้เกิดการเปลี่ยนแปลงพฤติกรรม
จากการเพิ่มเติม。

Model:AddPersistentPlayer

playerInstance

ผู้เล่น `Class.Player` ที่ต้องทำให้โมเดลนี้คงอยู่สำหรับเขา。

ตั้งค่าโมเดลนี้ให้คงอยู่สำหรับผู้เล่นที่ระบุ。
`Class.Model.ModelStreamingMode|ModelStreamingMode` ต้องตั้งเป็น
`Enum.ModelStreamingMode|PersistentPerPlayer` เพื่อให้เกิดการเปลี่ยนแปลงพฤติกรรม
จากการเพิ่มเติม。

ในตัวอย่างนี้ ข้อต่อในโมเดลตัวละครของผู้เล่นแต่ละคนจะถูกทำลาย
3 วินาทีหลังจากเกิดขึ้น การทำลายข้อต่อเหล่านี้จะทำให้ Humanoid
ตาย.

ตัวอย่างรหัสนี้แสดงให้เห็นถึงการสร้างจุดเชื่อมด้วยตนเองบนสองชิ้นส่วนที่เป็นพี่น้องของสคริปต์ (PartA และ PartB) มันสร้างจุดเชื่อมบนสองชิ้นส่วนที่สัมผัสกันซึ่งมีประเภทพื้นผิวที่เข้ากันได้ (Studs และ Inlet).

ทำให้การเชื่อมต่อระหว่าง `BaseParts` หลุดออก รวมถึงการเชื่อมต่อพื้นผิวกับ
ส่วนที่อยู่ติดกัน `Class.WeldConstraint|WeldConstraints` และ `Class.Weld|Welds` อื่นๆ
และ `Class.JointInstance|JointInstances`。

เมื่อใช้ BreakJoints กับตัวละครผู้เล่น `Class.Model` `Class.Humanoid`
ของมันจะตายเพราะมันพึ่งพาข้อต่อคอ。

โปรดทราบว่าแม้ว่าจุดเชื่อมที่เกิดจากการเชื่อมต่อพื้นผิวกับส่วนติดกันสามารถ
สร้างขึ้นใหม่ด้วยเทคนิค `Class.Model:MakeJoints()` ได้ แต่จะสร้างจุดเชื่อม
ที่เกิดจากพื้นผิวเท่านั้น ผู้พัฒนาควรไม่พึ่งพา สิ่งนี้เพราะตามหลังการทำลายจุดเชื่อม
ส่วนอาจไม่มีการสัมผัสกันอีกต่อไป。

Model:BreakJoints

ทำให้การเชื่อมต่อระหว่าง `BaseParts` หลุดออก รวมถึงการเชื่อมต่อพื้นผิวกับ
ส่วนที่อยู่ติดกัน `Class.WeldConstraint|WeldConstraints` และ `Class.Weld|Welds` อื่นๆ
และ `Class.JointInstance|JointInstances` ทุกตัว。

Model:breakJoints

ฟังก์ชันนี้คืนค่าคำพูดของปริมาตรที่ประกอบด้วย `Class.BasePart` เด็กทั้งหมด
ภายใน `Class.Model` ทิศทางของปริมาตรขึ้นอยู่กับทิศทางของ `Class.Model.PrimaryPart|PrimaryPart` และตรงกับกล่องการเลือกที่เรนเดอร์ใน Studio
เมื่อโมเดลถูกเลือก การพิจารณาพฤติกรรมของ `Class.Terrain:FillBlock()` มัน
จะคืนค่า `Datatype.CFrame` ซึ่งแสดงถึงจุดศูนย์กลางของกล่องนั้นและ `Datatype.Vector3`
แสดงถึงขนาด เมื่อทำการบังคับทางกายภาพอาจมีข้อผิดพลาด📐ในการทำงานหากข้อจำกัดฟิสิกส์ทำงานต่อต้านส่วนภายใน `Class.Model`。

ทิศทางของกล่องตรงกับทิศทางของ
`Class.PVInstance.GetPivot|Pivot` - จุดหมุนของ `Class.Model.PrimaryPart|PrimaryPart`
(ถ้ามี) หรือ `Class.Model.WorldPivot|WorldPivot` ของโมเดล。

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

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

-- ปรับขนาดและตำแหน่งของส่วนเท่ากับกล่องของโมเดล
part.Size = size
part.CFrame = orientation
```

Model:GetBoundingBox

A `Datatype.CFrame` แสดงถึงทิศทางของปริมาตร
ตามด้วย `Datatype.Vector3` แสดงถึงขนาดของปริมาตร。

คืนค่าคำพูดของปริมาตรที่ประกอบด้วยส่วนทั้งหมดของโมเดล。

ตัวอย่างโค้ดด้านล่างแสดงวิธีการใช้ Model.GetExtentsSize เพื่อรับ
ขนาดของกรอบที่มีวัตถุอยู่ภายใน.

คืนค่าขนาดของกล่องที่เล็กที่สุดซึ่งประกอบด้วยส่วนทั้งหมด
`Class.BasePart|BaseParts` ใน `Class.Model` ขนาดจะจัดเรียงตามทิศทางของ `Class.PVInstance.GetPivot|Pivot` - ไจ้ทิศทางที่พบของ `Class.Model.PrimaryPart|PrimaryPart` (ถ้ามี) หรือ `Class.Model.WorldPivot|WorldPivot` ของโมเดล。

โปรดทราบว่าฟังก์ชันนี้จะคืนค่าขนาดของกล่องที่เล็กที่สุดเท่านั้น และ
ผู้พัฒนาต้องใช้วิธีการของตนเองเพื่อให้ได้ตำแหน่งของกล่อง。

Model:GetExtentsSize

ขนาดของ `Datatype.Vector3` ของขนาดของ `Class.Model`。

คืนค่าขนาดของกล่องที่เล็กที่สุดซึ่งประกอบด้วยส่วนทั้งหมด
`Class.BasePart|BaseParts` ใน `Class.Model` โดยจัดเรียงกับ `Class.Model.PrimaryPart` หากตั้งไว้。

ค่าตัวนี้ในอดีตจะคืนค่า CFrame ของตำแหน่งศูนย์กลางในโมเดล。

Model:GetModelCFrame

โค้ดนี้จะสร้างโมเดล ใส่บางส่วนลงในนั้น วางตำแหน่งแบบสุ่ม,
แล้วพิมพ์ขนาดของมัน:

ฟังก์ชัน GetModelSize คืนค่าขนาด `Datatype.Vector3` ของ
`Class.Model`。

Model:GetModelSize

คืนค่าขนาด `Vector3` ของโมเดล。

เมื่อเรียกใช้นี้จาก `Class.Script` จะคืนค่าทุก `Class.Player` ออบเจ็กต์ที่โมเดลนี้\คงอยู่ართสำหรับพวกเขา เมื่อเรียกจาก `Class.LocalScript` ฟังกชันนี้จะตรวจสอบเพียงว่ามีโมเดลนี้คงอยู่สำหรับ
`Class.Players.LocalPlayer|LocalPlayer`。

Model:GetPersistentPlayers

เป็นตารางที่มีออบเจ็กต์ของ `Class.Player` ทั้งหมดที่โมเดลนี้คงอยู่สำหรับพวกเขา。

คืนค่าทุก `Class.Player` ออบเจ็กต์ที่โมเดลนี้คงอยู่สำหรับพวกเขา พฤติกรรมจะแตกต่างกันไป也取决于该方法是从 `Class.Script` 还是 `Class.LocalScript` 被调用。

โค้ดต่อไปนี้จะแสดงให้เห็นว่า GetPrimaryPartCFrame และ
SetPrimaryPartCFrame สามารถใช้ในการหมุนโมเดลได้อย่างไร

โมเดลดั้งเดิมจะถูกสร้างขึ้นใน Workspace และมีการเริ่มลูปที่จะ
หมุนโมเดล 10 องศารอบแกน Y ทุกๆ 0.2 วินาที


ฟังก์ชันนี้ถูกแทนที่ด้วย `Class.PVInstance:GetPivot()` ซึ่งทำหน้าที่แทนที่และไม่เปลี่ยนแปลงพฤติกรรมของโค้ดคุณ ใช้
`Class.PVInstance:GetPivot()` สำหรับการทำงานใหม่ และเปลี่ยนโค้ดที่มีอยู่ `Class.Model:GetPrimaryPartCFrame()` 当方便地。

คืนค่าค่า `Datatype.CFrame` ของ `Class.Model.PrimaryPart` ของโมเดล。

ฟังก์ชันนี้เทียบเท่ากับสิ่งต่อไปนี้。

    Model.PrimaryPart.CFrame

โปรดทราบว่าฟังก์ชันนี้จะโยนข้อผิดพลาดหากไม่มีชิ้นส่วนหลักสำหรับ `Class.Model` หากพฤติกรรมนี้ไม่ต้องการนักพัฒนาสามารถทำตามนี้ ซึ่งองค์ประกอบจะเท่ากับ `nil` หากไม่มีชิ้นส่วนหลัก。

    local cFrame = Model.PrimaryPart and Model.PrimaryPart.CFrame

Model:GetPrimaryPartCFrame

คืนค่า `Datatype.CFrame` ของ `Class.Model.PrimaryPart` ของโมเดล。
ฟังก์ชันนี้จะโยนข้อผิดพลาดหากไม่มีชิ้นส่วนหลักสำหรับ
`Class.Model`。

โค้ดตัวอย่างนี้แสดงให้เห็นการแทนที่ในการแทนที่สำเนาทั้งหมด
ของโมเดลต้นไม้โดยใช้ `Class.Model:PivotTo()` และ `Class.Model:ScaleTo()` การ
หมุนและขนาดของโมเดลจะถูกใช้เป็นข้อมูลอ้างอิงเพื่อให้แน่ใจว่าขนาดและตำแหน่ง
สัมพัทธ์ของโมเดลที่แทนที่ตรงกับต้นฉบับ


โมเดลมีปัจจัยมาตรฐานที่คงอยู่ ซึ่งเริ่มต้นที่ 1 สำหรับโมเดลที่เพิ่งสร้างขึ้น
และเปลี่ยนแปลงเมื่อโมเดลได้รับการปรับขนาดโดยการเรียกใช้
`Class.Model:ScaleTo()` ฟังก์ชันนี้จะคืนค่าปัจจัยมาตรฐานปัจจุบันของโมเดล。

ปัจจุบันไม่ส่งผลกระทบ _โดยตรง_ ต่อขนาดของอินสแตนซ์
ภายใต้โมเดล ใช้สำหรับการสร้างเนื้อหาและวัตถุประสงค์การเขียนโปรแกรม
เพื่อจดจำว่าโมเดลถูกปรับขนาดสัมพันธ์กับขนาดเดิมอย่างไร。

ในระยะการใช้งาน โมเดลจะจัดเก็บข้อมูลขนาดดั้งเดิมที่แน่นอนของ
อินสแตนซ์ที่ตั้งอยู่ภายหลังการเรียกใช้ `Class.Model:ScaleTo()` ครั้งแรก สิ่งนี้หมายความว่าเมื่อเรียกใช้งาน
`Class.Model:ScaleTo()|ScaleTo(x)` ตามด้วย
`Class.Model:ScaleTo()|ScaleTo(1)` คุณจะสามารถย้อนกลับไป依旧ที่เป็นต้นฉบับอย่างชัดเจน
โดยไม่ต้องมีการลอยตัวของจุดลอยน้ำ หลีกเลี่ยงการหลุดลอยเป็นแรงจูงใจในการใช้ฟังก์ชัน Scale**To** แทนที่ฟังก์ชัน Scale**By**。

ปัจจัยการปรับขนาดส่งผลต่อพฤติกรรมของเครื่องยนต์ในทางเดียว: ปัจจัยการปรับขนาด
ของโมเดลจะถูกนำไปใช้กับการย้ายข้อต่อของ
`Class.Animation|Animations` ที่เล่นใน `Class.AnimationController`
ภายใต้โมเดลนั้นเพื่อให้การเคลื่อนไหวที่สร้างขึ้นจะเล่นกลับถูกต้องแม้จะมีการปรับขนาดอยู่

Model:GetScale

ปัจจัยมาตรฐานปัจจุบันของโมเดล。

คืนค่าขนาดมาตรฐานของโมเดล ซึ่งค่าเริ่มต้นคือ 1 สำหรับโมเดลที่สร้างขึ้นใหม่
และจะเปลี่ยนแปลงเมื่อมันถูกปรับขนาดโดยการเรียกใช้
`Class.Model:ScaleTo()`。

ตัวอย่างโค้ดนี้แสดงให้เห็นว่าจุดเชื่อมสามารถทำได้อย่างไรโดยใช้ฟังก์ชัน
Model:MakeJoints

โมเดลถูกสร้างขึ้น โดยมีสองส่วนซ้อนทับกัน ส่วนด้านบนถูก
ยึดและส่วนด้านล่างไม่ถูกยึด ตามปกติแล้วเมื่ออยู่ภายใน Workspace
ส่วนล่างจะตกไปที่ Baseplate

อย่างไรก็ตาม เนื่องจากคุณสมบัติ TopSurface ของส่วนล่างถูกตั้งค่าเป็น
Enum.SurfaceType.Weld ซึ่งหมายความว่าเมื่อเรียกใช้ Model:MakeJoints
จะมีการเชื่อมต่อกัน

ดังนั้นส่วนล่างจึงไม่ตกจนกว่าจุดเชื่อมในโมเดลจะถูกทำลาย ซึ่งมักจะทำโดยใช้
Model:BreakJoints แต่ในตัวอย่างนี้การเชื่อมต่อจะถูกทำลายโดยการระเบิด

ตัวอย่างโค้ดนี้จะแสดงการสร้างจุดเชื่อมบนสองชิ้นส่วนที่เป็นพี่น้องกันของสคริปต์ (PartA และ PartB). มันใช้ MakeJoints กับสองชิ้นส่วนที่สัมผัสกันซึ่งมีประเภทพื้นผิวที่เข้ากันได้ (Studs และ Inlet).

การเข้าร่วมตาม Surfacetype ถูกยกเลิกการใช้งาน ห้ามใช้ MakeJoints สำหรับโปรเจ็กต์ใหม่ ใช้
`Class.WeldConstraint|WeldConstraints` และ
`Class.HingeConstraint|HingeConstraints` แทน。

ดำเนินการผ่าน `Class.BasePart|Parts` ทั้งหมดใน `Class.Model` และสร้าง
จุดเชื่อมโยงระหว่างส่วนที่กำหนดและพื้นผิวที่ติดกันตามพื้นผิวของส่วน。

- พื้นผิวที่เรียบจะไม่สร้างจุดเชื่อมต่อ
- พื้นผิวกาวจะสร้างจุดเชื่อมต่อ `Class.Glue`
- วัสดุเชื่อมจะสร้างจุดเชื่อมต่อ `Class.Weld` กับพื้นผิวใด ๆ นอกจาก
  Unjoinable
- Studs, Inlet หรือ Universal จะสร้างจุดเชื่อมต่อ `Class.Snap` กับ
  ทั้งสองพื้นผิวอื่น (เช่น Studs กับ Inlet และ
  Universal)
- พื้นผิว Hinge และ Motor สร้าง `Class.Rotate` และ `Class.RotateV` จุด
  อินสแตนซ์จุด

ฟังก์ชันนี้ใช้ไม่ได้ถ้าส่วนไม่ใช่บุตรหลานของ `Class.Workspace` ดังนั้นคุณต้องมั่นใจ
ก่อนว่าโมเดลอยู่ใน Workspace ก่อนที่จะใช้ MakeJoints。

Model:MakeJoints

ดำเนินการผ่าน `Class.BasePart|BaseParts` ทั้งหมดใน `Class.Model` หากใด ๆ
ข้างหนึ่งมี Surfacetype ที่สามารถสามารถสร้างจุดเชื่อมต่อได้มันจะสร้างจุดเชื่อมต่อกับ
ส่วนที่อยู่ติดกัน。

Model:makeJoints

Model:move

location

ตัวอย่างนี้แสดงให้เห็นว่า `Class.Model:MoveTo()` หลีกเลี่ยงการชนกันอย่างไร

มีการสร้าง `Class.Model` สองส่วนอย่างง่าย และตั้งค่า `Class.Model.PrimaryPart`
ส่วนใหญ่ของมัน มีการวางชิ้นส่วนอุปสรรคขนาดใหญ่ข้างๆ มัน

หลังจาก 5 วินาที `Class.Model:MoveTo()` ถูกใช้เพื่อกำหนดให้โมเดลย้าย
เข้าไปในชิ้นส่วนอุปสรรค อย่างไรก็ตาม เนื่องจาก MoveTo จะไม่ย้ายโมเดลไปยัง
อุปสรรค `Class.Model` จึงถูกย้ายขึ้นตามแกน Y และวางอยู่เหนือ
the obstruction.


เคลื่อนที่ `Class.Model.PrimaryPart|PrimaryPart` ไปยังตำแหน่งที่กำหนด หาก
ยังไม่ได้ระบุชิ้นส่วนหลักจะใช้ชิ้นส่วนหลักของโมเดล แต่ชิ้นส่วนหลักไม่ได้ทำนายและควรตั้ง
ชิ้นส่วนหลักเสมอเมื่อใช้งาน `Class.Model:MoveTo()|MoveTo()`。

หากมีอุปสรรคที่โมเดลจะถูกเคลื่อนที่ เช่น
`Class.Terrain` หรือ `Class.BasePart|BaseParts` โมเดลจะถูกเคลื่อนที่ขึ้นไปในแนวตั้งจนกระทั่งไม่มีอะไรอยู่ในทาง
หากพฤติกรรมนี้ไม่ต้องการ ควรใช้ `Class.PVInstance:PivotTo()` แทน。

โปรดทราบว่าการหมุนจะไม่ถูกเก็บรักษาไว้เมื่อเคลื่อนที่โมเดลด้วย `Class.Model:MoveTo()|MoveTo()` ควรใช้งาน
`Class.Model:TranslateBy()|TranslateBy()` หรือ `Class.PVInstance:PivotTo()`
หากต้องการเก็บรักษาหมุนปัจจุบันของโมเดลให้คงอยู่

Model:MoveTo

position

ตำแหน่ง `Datatype.Vector3` ซึ่งโมเดล `Class.Model` จะถูกเคลื่อน。

เคลื่อนที่ `Class.Model.PrimaryPart|PrimaryPart` ไปยังตำแหน่งที่กำหนด หาก
ยังไม่ได้ระบุชิ้นส่วนหลัก จะใช้ชิ้นส่วนหลักของโมเดล。

Model:moveTo

ทำให้โมเดลนี้ไม่คงอยู่สำหรับผู้เล่นที่ระบุ สิ่งนี้ไม่รับประกันว่าโมเดลจะถูกนำออกทันทีสำหรับผู้เล่น; หลังจากเรียกใช้งานฟังก์ชันนี้ โมเดลจะถูกปฏิบัติเสมือน
`Enum.ModelStreamingMode|Atomic` สำหรับผู้เล่นนั้นและจะยังคงมีอยู่ตราบใดที่อยู่ภายในรัศมีการสตรีมมิ่งเป้าหมาย。

`Class.Model.ModelStreamingMode|ModelStreamingMode` ต้องตั้งเป็น
`Enum.ModelStreamingMode|PersistentPerPlayer` เพื่อให้เกิดการเปลี่ยนแปลงพฤติกรรม
จากคุณสมบัติที่ถูกลบ。

Model:RemovePersistentPlayer

ผู้เล่น `Class.Player` ที่ต้องทำให้โมเดลนี้ไม่คงอยู่สำหรับเขา。

ทำให้โมเดลนี้ไม่คงอยู่สำหรับผู้เล่นที่ระบุ。
`Class.Model.ModelStreamingMode|ModelStreamingMode` ต้องตั้งเป็น
`Enum.ModelStreamingMode|PersistentPerPlayer` เพื่อให้เกิดการเปลี่ยนแปลงพฤติกรรม
จากการลบ。

รีเซ็ตการหมุนของส่วนของโมเดลกลับไปที่การหมุนระบุเริ่มต้นที่ตั้งค่าไว้ ซึ่งทำได้ผ่าน
ฟังก์ชัน `Class.Model:SetIdentityOrientation()`。

Model:ResetOrientationToIdentity

โมเดลมีปัจจัยมาตรฐานที่คงอยู่ ซึ่งเริ่มต้นที่ 1 สำหรับโมเดลที่สร้างขึ้นใหม่ ฟังก์ชันนี้จะปรับขนาดโมเดล รอบตำแหน่งจุดหมุน ที่สัมพันธ์กับจะมีลักษณะด้วยปัจจัยการปรับขนาดของ 1 สำหรับ
การทำได้สองสิ่ง:

- ตั้งค่าปัจจัยการปรับขนาดของโมเดลในปัจจุบันเป็นค่าที่ยังระบุ
- ปรับขนาดและจัดตำแหน่งอินสแตนซ์ที่เป็นบุตรหลานทั้งหมดตามนั้น

การปรับขนาดตำแหน่งจะเกิดขึ้นรอบตำแหน่งจุดหมุน。

คุณสมบัติทั้งหมดที่ "เชิงเรขาคณิต" ของอินสแตนซ์ที่เป็นบุตรหลานจะถูกปรับขนาด ซึ่ง
แน่นอนรวมถึงขนาดของส่วน แต่ยังมีตัวอย่างของ
คุณสมบัติอื่นๆ ที่ถูกปรับขนาด:

- ความยาวของข้อต่อ เช่น `Class.WeldConstraint|WeldConstraints` และ
  `Class.RopeConstraint`
- ความเร็วและแรงทางกายภาพเช่น `Class.HingeConstraint`
- คุณสมบัติทางมองเห็นเช่นขนาดของเอมิตเตอร์อนุภาค
- คุณสมบัติความยาวอื่นๆ เช่น `Class.Sound.RollOffMinDistance`

Model:ScaleTo

newScaleFactor

ตั้งค่าปัจจัยการปรับขนาดของโมเดล โดยปรับขนาดและตำแหน่งของ
อินสแตนซ์ที่เป็นบุตรหลานทั้งหมดเพื่อให้พวกเขามีปัจจัยการปรับขนาดนั้นสัมพันธ์กับ
ขนาดเริ่มต้นและตำแหน่งเมื่อปัจจัยการปรับขนาดคือ 1。

ตั้งค่าการหมุนที่ระบุตัวตนของโมเดลจากที่กำหนด ซึ่งจะทำให้คุณสามารถรีเซ็ตการหมุนของ
โมเดลทั้งหมดในภายหลังได้โดยใช้ฟังก์ชัน
`ResetOrientationToIdentity`。

Model:SetIdentityOrientation

ตั้งค่าการหมุนที่ระบุตัวตนของโมเดลที่ให้ ซึ่งจะทำให้คุณสามารถรีเซ็ตการหมุนของ
โมเดลทั้งหมดในภายหลัง ได้โดยใช้ฟังก์ชัน
`ResetOrientationToIdentity`。

ฟังก์ชันนี้ถูกแทนที่ด้วย `Class.PVInstance:PivotTo()` ซึ่งทำหน้าที่แทนที่และมีประสิทธิภาพกว่าซึ่งไม่เปลี่ยนแปลงพฤติกรรมของโค้ดคุณ ใช้
`Class.PVInstance:PivotTo()` สำหรับการทำงานใหม่และเปลี่ยนโค้ดที่มีอยู่ `Class.Model:SetPrimaryPartCFrame()` เมื่อสะดวก。

ตั้งค่า `Class.BasePart.CFrame` ของ `Class.Model.PrimaryPart` ของโมเดล。
ส่วนอื่น ๆ ในโมเดลจะถูกย้ายด้วยและจะรักษาทิศทางและการเลื่อนที่สัมพันธ์กับ `Class.Model.PrimaryPart`。

โปรดทราบว่าฟังก์ชันนี้จะโยนข้อผิดพลาดหากไม่มี `Class.Model.PrimaryPart`
อยู่สำหรับโมเดล สิ่งนี้อาจทำให้เกิดปัญหาเช่น หากชิ้นส่วนหลักไม่เคยถูกตั้งค่าหรือถูกทำลายไปแล้ว。

Model:SetPrimaryPartCFrame

cframe

ค่าที่ `Datatype.CFrame` ที่จะตั้งค่า。

ตั้งค่า `Class.BasePart.CFrame` ของ `Class.Model.PrimaryPart` ของโมเดล。
ส่วนอื่น ๆ ในโมเดลจะถูกย้ายด้วยและจะรักษาทิศทางและการเลื่อนที่สัมพันธ์กับ `Class.Model.PrimaryPart`。

ตัวอย่างนี้แสดงให้เห็นว่า `Class.Model:TranslateBy()` ไม่สนใจการชนกัน
และเคารพการหันของโมเดล

สร้าง `Class.Model` ที่ประกอบด้วยสองส่วนง่าย ๆ หมุน 45 องศาบนแกน Y
และตั้งค่า `Class.Model.PrimaryPart` ของมัน ส่วนที่มีอุปสรรคขนาดใหญ่
ถูกวางอยู่ข้าง ๆ

หลังจาก 5 วินาที `Class.Model:TranslateBy()` จะถูกใช้เพื่อชี้นำโมเดลให้
เคลื่อนที่เข้าไปในส่วนที่มีอุปสรรค โมเดลจะเคลื่อนเข้าไปใน
สิ่งกีดขวางและรักษาทิศทางปัจจุบันของมันไว้

เคลื่อนที่ `Class.Model` โดยการเลื่อน `Datatype.Vector3` ที่ให้โดยการรักษาทิศทางของโมเดลไว้ หากมี `Class.BasePart` หรือ `Class.Terrain`
อยู่แล้วที่ตำแหน่งใหม่จะทำให้ `Class.Model` ซ้อนทับกับวัตถุที่กล่าวถึง。

การแปลจะถูกนำไปใช้ในโลกแทนที่จะเป็นพื้นที่วัตถุ ทำให้แม้ว่าส่วนภายในของโมเดลจะถูกกำหนดทิศทางแตกต่างกัน มันจะยังคงเคลื่อนที่ตามแกนมาตรฐาน。

Model:TranslateBy

delta

ค่าที่ `Datatype.Vector3` จะเลื่อน `Class.Model`。

เคลื่อนที่ `Class.Model` โดยการเลื่อน `Datatype.Vector3` ที่ให้ โดยการรักษาทิศทางของโมเดลไว้ หากมี `Class.BasePart` หรือ `Class.Terrain` อื่น ๆ อยู่แล้วที่ตำแหน่งใหม่จะทำให้ `Class.Model` ซ้อนทับกับวัตถุที่กล่าวถึง。

Model

ตั้งค่าระดับรายละเอียดของโมเดลสำหรับประสบการณ์ที่เปิดใช้งาน
[การสตรีม](/workspace/streaming) อยู่ Composite หรือ
Imposter meshes ไม่รองรับฟิสิกส์ การตรวจจับการชนกัน หรือ
การเรย์แคสต์

เมื่อตั้งค่าเป็น `Enum.ModelLevelOfDetail|StreamingMesh` โมเดล "imposter"
ที่มีความละเอียดต่ำ (โมเดลที่มีสีและมีผิวพรรณ粗ที่ห่อหุ้มทุกชิ้นส่วนภายในของโมเดล)
จะเรนเดอร์นอกระยะการสตรีม ไม่รองรับ
พื้นผิว

เมื่อตั้งเป็น `Enum.ModelLevelOfDetail|SLIM` โมเดล **SLIM** (โมเดลเชิงโต้ตอบที่สามารถ
ปรับขนาดได้) จะเรนเดอร์ Composite ของทุกชิ้นส่วนเด็กในระดับความละเอียดที่
ต่ำกว่าอย่างค่อยเป็นค่อยไปตามระยะที่อิงจากระยะการสตรีม
สิ่งนี้ช่วยปรับปรุงคุณภาพภาพมากขึ้นเมื่อเปรียบเทียบกับ
`Enum.ModelLevelOfDetail|StreamingMesh`

เมื่อตั้งค่าเป็น `Enum.ModelLevelOfDetail|Disabled` หรือ
`Enum.ModelLevelOfDetail|Automatic` โมเดลที่มีความละเอียดต่ำจะไม่ถูก
แสดง

Model.LevelOfDetail

ตั้งระดับรายละเอียดบนโมเดลสำหรับประสบการณ์ที่มีการสตรีมอินสแตนซ์
เปิดใช้งาน。

ควบคุมวิธีการที่ `Class.Model|Models` จะถูกสตรีมเข้าและออกเมื่อการ
[สตรีมมิ่ง](/workspace/streaming) ถูกเปิดใช้งาน พฤติกรรมขึ้นอยู่กับอีโนมที่เลือก ไม่มีผลเมื่อไม่มีการสตรีมมิ่ง。

ควรเปลี่ยนโปรพอร์ตี้นี้เฉพาะใน Studio ผ่านหน้าต่าง
[Properties](/studio/properties) เมื่อมีการเปิดใช้งานการสตรีมมิ่ง หรือใน `Class.Script|Scripts` แต่ไม่ควรทำใน
`Class.LocalScript|LocalScripts` (การกระทำนี้อาจทำให้เกิดพฤติกรรมที่ไม่ชัดเจนได้)

Model.ModelStreamingMode

ควบคุมพฤติกรรมการสตรีมโมเดลใน `Class.Model|Models` เมื่อ
การสตรีมอินสแตนซ์ถูกเปิดใช้งาน。

ตัวอย่างโค้ดนี้สร้างและโยนแบบจำลองลูกเต๋า จากนั้นแสดงผลว่ามัน
ตกลงมาข้างที่มีสีฟ้าขึ้นบนหรือไม่ หาก `Class.Model.PrimaryPart` ไม่ถูกตั้งค่า
pivot / bounding box ของลูกเต๋าจะหมุน เนื่องจากชิ้นส่วนข้างในนั้น
ถูกจำลองทางกายภาพระหว่างการโยน

ชี้ไปยังชิ้นส่วนหลักของ `Class.Model` ชิ้นส่วนหลักคือ
`Class.BasePart` ที่ทำหน้าที่เป็นการอ้างอิงทางกายภาพสำหรับจุดหมุนของ
โมเดล นั่นหมายความว่า เมื่อส่วนภายในโมเดลถูกเคลื่อนที่เนื่องจากการจำลองฟิสิกส์หรือวิธีการอื่นๆ จุดหมุนจะเคลื่อนที่ตามซิงค์กับชิ้นส่วนหลัก。

โปรดทราบว่า `Class.Model|Models` จะไม่มีการตั้งค่า `PrimaryPart` โดยค่าเริ่มต้น。
หากคุณกำลังสร้างโมเดลที่จำเป็นต้องได้รับความคุ้มครองจากฟิสิกส์ คุณ
ควรตั้งค่านี้ด้วยตนเองใน Studio หรือภายในสคริปต์ หากชิ้นส่วนหลัก **ไม่ได้** ถูกตั้งค่า จุดหมุนจะอยู่ที่ตำแหน่งเดียวใน
โลกถึงแม้ว่าส่วนภายในโมเดลจะเคลื่อนที่。

นอกจากนี้ โปรดทราบว่าการตั้งค่าโปรพอร์ตี้นี้ต้องเป็น `Class.BasePart`
ที่เป็นบุตรหลานของโมเดล หากคุณพยายามตั้งค่า
`Class.Model.PrimaryPart` เป็น `Class.BasePart` ที่ **ไม่** เป็นบุตรหลานของโมเดล เนื่องจากจะถูกตั้งเป็นส่วนที่นั้น แต่จะถูกรีเซ็ตเป็น `nil`
ในระหว่างขั้นตอนการจำลองถัดไป &mdash; นี่คือพฤติกรรมเก่าที่สนับสนุน
สคริปต์ที่สมมุติว่าพวกเขาสามารถตั้งค่าชิ้นส่วนหลักไปที่
`Class.BasePart` ที่ไม่ได้เป็นบุตรหลานของโมเดลชั่วคราวได้。

กฎทั่วไปสำหรับโมเดลคือ:

- โมเดลที่มีส่วนประกอบที่เชื่อมโยงกันผ่านข้อต่อทางกายภาพ เช่น
  `Class.WeldConstraint|WeldConstraints` หรือ `Class.Motor6D|Motor6Ds`
  ควรมีการกำหนดชิ้นส่วนหลัก สำหรับตัวอย่าง เช่น โมเดลตัวละครใน Roblox
  มีการตั้ง `Class.Model.PrimaryPart` ไปที่
  **HumanoidRootPart** โดยค่าเริ่มต้น。
- โมเดลที่นิ่ง (โดยปกติคือ `Class.BasePart.Anchored|Anchored`) ซึ่งอยู่ใน
  ที่เดียวเว้นแต่สคริปต์จะเคลื่อนที่พวกมัน ไม่จำเป็นต้องมี
  `Class.Model.PrimaryPart` และมักจะไม่เกิดประโยชน์จากการมีหนึ่ง。

Model.PrimaryPart

ชิ้นส่วนหลักของ `Class.Model` หรือ `nil` หากไม่ได้ตั้งค่าอย่างชัดเจน。

การตั้งค่าโปรพอร์ตี้นี้ในหน้าต่าง Properties จะปรับขนาดโมเดลเหมือน
กับว่า `Class.Model:ScaleTo()` ถูกเรียกใช้งานบนมัน ปรับขนาดของทุกอินสแตนซ์
ที่เป็นบุตรหลานในโมเดล เช่น วัสดุ รูปภาพ และเรขาคณิต 3D ของ
ส่วน เพื่อให้โมเดลมีปัจจัยการปรับขนาดตามที่กำหนดสัมพันธ์กับขนาด
ดั้งเดิมของมัน。

โปรพอร์ตี้นี้มีเฉพาะใน Studio และจะทำให้เกิดข้อผิดพลาดหากใช้ใน
`Class.Script` หรือ `Class.LocalScript` ควรใช้ `Class.Model:ScaleTo()` และ
`Class.Model:GetScale()` จากสคริปต์。

Model.Scale

โปรพอร์ตี้เฉพาะสำหรับผู้แก้ไขที่ใช้ในการปรับขนาดโมเดลรอบจุดหมุน การตั้ง
โปรพอร์ตี้นี้จะเคลื่อนที่การปรับขนาดเสมือนกับว่า `Class.Model:ScaleTo()` ถูก
เรียกใช้งานบนมัน。

ตัวอย่างโค้ดนี้แสดงฟังก์ชันที่กำหนดเองสำหรับการรีเซ็ตพิวทของโมเดล
กลับไปยังศูนย์กลางของกล่องขอบเขตของโมเดลนั้น


โปรพอร์ตี้นี้กำหนดว่าจุดหมุนของ `Class.Model` ที่ **ไม่มี** การตั้ง
`Class.Model.PrimaryPart` อยู่ที่ไหน หาก
`Class.Model` **มี** `Class.Model.PrimaryPart|PrimaryPart` จุดหมุนของ
`Class.Model` จะเท่ากับจุดหมุนของชิ้นส่วนหลัก และโปรพอร์ตี้นี้
`Class.Model.WorldPivot|WorldPivot` จะถูกละเลย。

สำหรับ `Class.Model` ที่สร้างขึ้นใหม่ จุดหมุนของมันจะถือเป็นจุดศูนย์กลาง
ของกล่องที่มีเนื้อหาจนกระทั่ง **ครั้งแรก** ที่การตั้งค่าของ
`Class.Model.WorldPivot` ถูกตั้งค่า เมื่อตั้งค่าจุดหมุนโลกเป็นครั้งแรกแล้วจะไม่สามารถคืนค่าพฤติกรรมเริ่มต้นนี้ได้

โดยทั่วไป การเคลื่อนที่โมเดลด้วยเครื่องมือใน Studio หรือฟังก์ชันการเคลื่อนที่ของโมเดลเช่น `Class.PVInstance:PivotTo()` และ
`Class.Model:MoveTo()` จะตั้งค่าจุดหมุนโลกและจึงสิ้นสุดพฤติกรรมโมเดลใหม่นี้。

วัตถุประสงค์ของพฤติกรรมนี้คือการให้โค้ด Luau ได้รับจุดหมุนที่เหมาะสมเพียงแค่สร้างโมเดลใหม่และ
จัดวางวัตถุไว้ด้านบนนั้น แทนที่จะต้องตั้งค่า `Class.Model.WorldPivot`
อย่างชัดเจนทุกครั้งที่คุณสร้างโมเดลในโค้ด。

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

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

print(model:GetPivot())  -- เท่ากับจุดศูนย์กลางของกล่องที่ประกอบด้วย "BluePart" และ "RedPart"

model:PivotTo(CFrame.new(0, 10, 0))  -- ฟังก์ชันนี้ทำงานโดยไม่ต้องตั้งค่า "model.WorldPivot" อย่างชัดเจน
```

Model.WorldPivot

กำหนดว่า จุดหมุนของ `Class.Model` ที่ **ไม่มี** การตั้งค่า
`Class.Model.PrimaryPart` อยู่ที่ไหน。

โมเดลเป็นวัตถุที่ใช้เป็นตัวเก็บข้อมูล ซึ่งหมายถึงการรวบรวมวัตถุเข้าด้วยกัน พวกเขา
เหมาะที่สุดสำหรับการเก็บรวมกลุ่มของ `Class.BasePart|BaseParts` และมีฟังก์ชันมากมาย
ที่เพิ่มความสามารถของพวกเขา

คลาส `Class.PVInstance` เป็นคลาสนามที่เป็นนามธรรมที่ไม่สามารถสร้างได้ มันคือ
ฐานสำหรับวัตถุทั้งหมดที่มีสถานที่จริงในโลก。


ตัวอย่างโค้ดนี้เป็นสคริปต์การเคลื่อนย้ายที่ง่ายซึ่งย้ายตัวละครของคุณ
10&nbsp;สตูดไปข้างหน้าในทิศทางที่คุณกำลังเผชิญอยู่เมื่อคุณกด
the <kbd>F</kbd> key. มันทำได้โดยการดึงพีวิตปัจจุบันด้วย
`Class.PVInstance:GetPivot()` และเรียก `PVInstance|PivotTo` เพื่อย้าย
ตัวละครไปข้างหน้า.

ฟังก์ชันนี้ดึงจุดหมุนของ `Class.PVInstance` ซึ่งมักจะใช้ร่วมกับ
`Class.PVInstance:PivotTo()` เพื่อย้ายโมเดล。

`Class.Model|Models` และ `Class.BasePart|BaseParts` ต่างก็เป็น
`Class.PVInstance|PVInstances` ("ตำแหน่งความเร็วตัวแปร") และทั้งคู่
มีฟังก์ชันนี้。


PVInstance:GetPivot

ดึงจุดหมุนของ `Class.PVInstance`。


เปลี่ยนแปลง `Class.PVInstance` พร้อมกับ `Class.PVInstance|PVInstances` ทั้งหมดที่เป็นทายาท
โดยที่จุดหมุนจะอยู่ที่ `Datatype.CFrame` ที่ระบุ ฟังก์ชันนี้เป็นฟังก์ชันหลักที่ควรใช้
ในการย้าย `Class.Model|Models` ผ่านการเขียนสคริปต์。

`Class.BasePart|BaseParts` จะถูกย้ายในลักษณะนี้โดยการแปลง
`Datatype.CFrame` ด้วย offset ที่จำเป็น。
`Class.Model|Models` จะถูกย้ายในลักษณะนี้ด้วยการแปลง
`Class.Model.WorldPivot` ด้วย offset ที่จำเป็น。

โปรดทราบว่าเพื่อความมีประสิทธิภาพ เหตุการณ์ `Class.Object.Changed` จะไม่
ถูกเรียกสำหรับ `Class.BasePart.Position|Position` และ
`Class.BasePart.Orientation|Orientation` ของ `Class.BasePart|BaseParts`
ที่ถูกย้ายในลักษณะนี้; มันจะถูกเรียกเฉพาะสำหรับ `Datatype.CFrame`。

เมื่อเรียกใช้ `Class.PVInstance:PivotTo()|PivotTo` บน `Class.Model|Models`，
ค่า offset ของ Parts และ Models ที่เป็นทายาทจะถูกเก็บไว้，ทำให้การเรียกใช้
`Class.PVInstance:PivotTo()|PivotTo` ที่ตามหลังบนโมเดลเดียวกันไม่สะสมการลอยตัวของจุดระหว่าง
Parts ที่ประกอบเป็นโมเดล。 

`Class.Model|Models` และ `Class.BasePart|BaseParts` ทั้งคู่
เป็น `Class.PVInstance|PVInstances` ("ตำแหน่งความเร็วตัวแปร") และทั้งคู่
มีฟังก์ชันนี้。


PVInstance:PivotTo

targetCFrame

`Datatype.CFrame` ที่จุดหมุนของ `Class.PVInstance` ควรเท่ากับ
หลังจากการย้ายมัน。


เปลี่ยนแปลง `Class.PVInstance` พร้อมกับ `Class.PVInstance|PVInstances` ทั้งหมดที่เป็นทายาท
โดยที่จุดหมุนจะอยู่ที่ `Datatype.CFrame` ที่ระบุ。


PVInstance

PVInstance.Origin

PVInstance.Pivot Offset

คลาสนามที่เป็นนามธรรมสำหรับวัตถุทั้งหมดที่มีสถานที่จริงในโลก。


`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาส Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`.

ไม่สามารถสร้างวัตถุ `Instance` รากโดยตรงได้ แต่สร้างวัตถุผ่านโค้ด
ด้วยคอนสตรัคเตอร์พิเศษ `Datatype.Instance.new()` โดยใช้
ชื่อของคลาสเป็นพารามิเตอร์และส่งคืนวัตถุที่สร้างขึ้น.

แสดงให้เห็นถึงการตรวจจับการเปลี่ยนแปลงในเชิงสืบพรรณของอินสแตนซ์ โดยการเชื่อมต่อกับ
`Class.Instance.AncestryChanged` event.

พารต์ ChangingPart จะถูกตั้งค่า Parent เป็นค่าที่แตกต่างกันในช่วงเวลา พ่อแม่ของ
พารต์ คือบรรพบุรุษของพารต์ ดังนั้น `Class.Instance.AncestryChanged` event
จะถูกเรียกใช้เมื่อมันเปลี่ยนแปลง.

เกิดขึ้นเมื่อมีการเปลี่ยนสถานะของอินสแตนซ์นี้ หรือลูกหลานของมัน.

คุณสามารถใช้เหตุการณ์นี้เพื่อติดตามการลบของอินสแตนซ์ใน Studio,
เช่นการลบด้วยตนเองใน Explorer หรือผ่านโปรแกรมเสริม หากคุณต้องการตรวจจับเมื่อใดที่อินสแตนซ์ถูกทำลายโดยการเรียกใช้ `Class.Instance:Destroy()`,
ให้ใช้เหตุการณ์ `Class.Instance.Destroying` แทน.

Instance.AncestryChanged

child

อินสแตนซ์ที่มีการเปลี่ยนแปลงสมบัติ `Class.Instance.Parent|Parent`, ซึ่งอาจเป็นอินสแตนซ์นี้หรือบรรพบุรุษที่ไกลกว่านี้, **ไม่**จำเป็นต้องเป็นอินสแตนซ์ที่เชื่อมต่ออยู่.

parent

พ่อแม่ใหม่ของพารามิเตอร์ `child`.

เกิดขึ้นเมื่อมีการเปลี่ยนแปลงสมบัติ `Class.Instance.Parent` ของวัตถุหรือบรรพบุรุษของมัน.

เหตุการณ์นี้เกิดขึ้นเมื่อใดก็ตามที่มีการเปลี่ยนแปลงในคุณสมบัติในอินสแตนซ์,
รวมถึงเมื่อมีการตั้งค่าคุณสมบัติให้เป็น `nil`. ชื่อของคุณสมบัติที่มีการเปลี่ยนแปลง
จะถูกส่งไปยังฟังก์ชันที่เชื่อมต่อ.

ตัวอย่างเช่น โค้ดต่อไปนี้เชื่อมต่อฟังก์ชัน `attributeChanged()`
เพื่อให้ทำงานเมื่อมีการเปลี่ยนแปลงในคุณสมบัติต่างๆ ของชิ้นส่วน:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
ดูเพิ่มเติมที่ `Class.Instance:GetAttributeChangedSignal()` ซึ่งจะส่งคืนเหตุการณ์ที่เกิดขึ้นเมื่อคุณสมบัติที่เฉพาะเจาะจงเปลี่ยนแปลง.

Instance.AttributeChanged

attribute

ชื่อของคุณสมบัติที่มีการเปลี่ยนแปลง.

เกิดขึ้นเมื่อใดก็ตามที่มีการเปลี่ยนแปลงในคุณสมบัติของ `Class.Instance`.

Instance

`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาส Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`.