เมื่อมีการตั้งค่าให้เป็นบิดาของ `Class.ViewportFrame`, `WorldModel` ขยายฟิสิกส์ที่จำกัด
สำหรับบุตรของมันไปยัง `Class.ViewportFrame` นั้น ตัวอย่างเช่น,
`Class.BasePart|BaseParts` ที่ตั้งอยู่ภายใต้ `WorldModel` สามารถทำ
อนิเมชั่นและทำการสอบถามเชิงพื้นที่ (เช่น โดยการเรย์คาสต์) แต่ชิ้นส่วนเหล่านั้น
**ไม่** ถูกจำลอง นอกจากนี้คุณยังสามารถใส่ตัวละคร `Class.Humanoid` ใน
`WorldModel` และข้อต่อของพวกเขาจะได้รับการตั้งค่าอย่างถูกต้องสำหรับการอนิเมชั่น.

เพื่อหลีกเลี่ยงปัญหาด้านประสิทธิภาพที่เป็นไปได้ ให้แน่ใจว่าได้สร้าง `WorldModels`
เฉพาะเมื่อคุณต้องการแสดงมันและลบ `WorldModels` ที่ขณะนี้ไม่
ได้ใช้งาน.


WorldModel

ขยายฟิสิกส์ที่จำกัดสำหรับบุตรของมันไปยัง `Class.ViewportFrame`.


คลาสพื้นฐานนี้ให้ API สำหรับทุกอินสแตนซ์ที่มีวัตถุประสงค์ในการจัดการการค้นหาพื้นที่ 3D
และการจำลอง เช่น `Class.Workspace` และ
`Class.WorldModel`.


โค้ดบล็อกด้านล่างแสดงวิธีการใช้
`Class.WorldRoot:ArePartsTouchingOthers()` เพื่อตรวจสอบว่าชิ้นส่วนในรายการกำลัง
สัมผัสกับชิ้นส่วนใด ๆ ในพื้นที่ทำงานที่ไม่อยู่ในรายการ

ก่อนอื่นสคริปต์สร้างชิ้นส่วนสี่เหลี่ยมจัตุรัสสองชิ้นที่ซ้อนทับกัน 1 สตัด `Part1` และ
`Part2` จากนั้นพิมพ์ค่าที่ส่งกลับโดย ArePartsTouchingOthers() เมื่อ
Part1 ถูกส่งใน `partList` ที่ค่าซ้อนทับต่าง ๆ สามค่า: `0`, `0.999`,
และ `1` สองครั้งแรกที่เรียก ArePartsTouchingOthers() ส่งคืน `false`
เพราะค่าซ้อนทับน้อยกว่าระยะห่างที่ Part1 และ Part2
ซ้อนทับกัน การเรียกครั้งที่สามส่งคืน `true` เพราะค่าซ้อนทับเท่ากับ
ระยะห่างที่ชิ้นส่วนซ้อนทับกัน.

**ArePartsTouchingOthers** ส่งค่าจริงหากอย่างน้อยหนึ่งของ
`Class.BasePart` ที่กำหนดสัมผัสกับส่วนอื่น ๆ สองส่วนถือว่าทำการ
"สัมผัส" หากอยู่ภายในขอบเขตระยะทาง `overlapIgnored`.

หากไม่ได้ให้ส่วนใด ๆ จะส่งค่าผิดกลับ.


WorldRoot:ArePartsTouchingOthers

partList

รายการของส่วนที่ตรวจสอบว่า ส่วนใด ๆ ในรายการสัมผัสกับ
ส่วนที่ไม่อยู่ในรายการ.


overlapIgnored

ขีดจำกัดการซ้อนทับของส่วนใน studs ที่จะถูกละเว้นก่อนที่จะถือว่า
ส่วนสัมผัสกัน.


จริงหากและเฉพาะเมื่อส่วนใด ๆ ของ `Class.Part|parts` ใน `partList` สัมผัสกับ
ส่วนอื่น (ส่วนที่ไม่อยู่ใน partList). ผิดหากไม่มี
ส่วนใดถูกส่ง.


ส่งค่าจริงหากส่วนใด ๆ ของ `Class.BasePart` ที่กำหนดสัมผัสกับส่วนอื่น ๆ


สร้างบล็อกและส่งคืนการชนครั้งแรกกับ `Class.BasePart` หรือ
`Class.Terrain` แสดงคุณสมบัติของ RaycastResult หากมีผลลัพธ์


ฉายรูปทรงบล็อกในทิศทางที่กำหนดและส่งคืนการชนครั้งแรก
กับ `Class.BasePart` หรือ `Class.Terrain` cell นี่เป็นการเปรียบเทียบกับวิธี
`Class.WorldRoot:Raycast()` ที่ฉายรังสีเชิงเส้นในทิศทางเพื่อหาการชนกัน
แต่ใช้รูปทรง 3D แทนที่จะเป็นรังสี.

แตกต่างจาก `Class.WorldRoot:GetPartsInPart()`, วิธีนี้ไม่ตรวจจับ
`Class.BasePart|BaseParts` ที่ **เริ่มต้น** ไปทับซ้อนกับรูปทรง.

หากตรวจพบการชนกัน จะส่งคืน `Datatype.RaycastResult` ที่มีข้อมูลการชน.
คุณสมบัติ `Datatype.RaycastResult.Distance|Distance` แทนระยะทางที่รูปทรงต้องเดินทางเพื่อหาการชนกัน,
และคุณสมบัติ `Datatype.RaycastResult.Position|Position` เเทนจุดตัดที่ทำให้เกิดการชน.

วิธีนี้จะโยนข้อผิดพลาดหากได้รับข้อมูลนำเข้า `Datatype.CFrame`,
ขนาดหรือตำแหน่งที่ไม่ถูกต้อง.


WorldRoot:Blockcast

cframe

ตำแหน่งเริ่มต้นและการหมุนของรูปทรงบล็อกที่ฉาย.


size

ขนาดของรูปทรงบล็อกที่ฉายใน studs. ขนาดสูงสุดคือ 512
studs.


direction

ทิศทางของการฉายรูปทรง โดยมีขนาดแสดงถึง
ระยะทางสูงสุดที่รูปทรงสามารถเคลื่อนไหวได้ สูงสุด 1024
studs.


params

ประกอบด้วยผลลัพธ์ของการฉายรูปทรง หรือ `nil` หากไม่มี
`Class.BasePart` หรือ `Class.Terrain` ที่มีสิทธิ์ถูกชน.


ฉายรูปทรงบล็อกในทิศทางที่กำหนดและส่งคืน
`Datatype.RaycastResult` หากรูปทรงชนกับ `Class.BasePart` หรือ
`Class.Terrain`.


ฟังก์ชันนี้ย้ายตารางของ `Class.BasePart|BaseParts` ไปยังตารางของ
`Datatype.CFrame|CFrames` โดยไม่ต้องทำให้เกิดเหตุการณ์คุณสมบัติดีฟอลต์
`Class.Object.Changed|Changed` ฟังก์ชันนี้มีวิธีเร็วมากในการ
ย้ายส่วนจำนวนมาก เนื่องจากไม่ต้องเสียค่าใช้จ่ายในการตั้งค่าคุณสมบัติต่าง ๆ สำหรับแต่ละส่วน.

อาร์กิวเมนต์ที่สามอนุญาตให้คุณเพิ่มประสิทธิภาพการเคลื่อนที่.
โดยดีฟอลต์ เหตุการณ์ `Class.Object.Changed|Changed` ของแต่ละส่วนจะเกิดขึ้น
สำหรับ `Class.BasePart.Position|Position`,
`Class.BasePart.Orientation|Orientation`, และ
`Class.BasePart.CFrame|CFrame`. อย่างไรก็ตาม หากระบุ
`Enum.BulkMoveMode|FireCFrameChanged` เป็นอาร์กิวเมนต์ที่สาม จะเกิดสิ่งนี้
เฉพาะสำหรับเหตุการณ์ `Class.Object.Changed|Changed` ของ
`Class.BasePart.CFrame|CFrame`.

หมายเหตุว่าคุณควรใช้ฟังก์ชันนี้เฉพาะถ้าคุณมั่นใจว่าการเคลื่อนที่
ของส่วนเป็นจุดที่ชะลอในโค้ดของคุณ การตั้งค่าเพียง
`Class.BasePart.CFrame|CFrame` ของแต่ละส่วนและโมเดลที่เชื่อมต่อก็เร็วพอในกรณีส่วนใหญ่.


WorldRoot:BulkMoveTo

cframeList

eventMode

ย้ายตารางของ `Class.BasePart|BaseParts` ไปยังตารางของ
`Datatype.CFrame|CFrames`.


**FindPartOnRay** uses [raycasting](/workspace/raycasting) to
find the first `Class.BasePart` or `Class.Terrain` cell intersecting with
a given `Datatype.Ray`. This function returns the `Class.BasePart` or
terrain cell hit, the point of intersection, the surface normal at the
point of intersection, and the associated `Enum.Material` hit.

If the `ignoreDescendantsInstance` parameter is provided, the raycasting
calculation will ignore the given object and all of its descendants. It
behaves similar to the `Class.Mouse.TargetFilter` property.

The `terrainCellsAreCubes` and `ignoreWater` parameters determine whether
`Class.Terrain` cells should be treated as cubes or not, and whether water
should be ignored or not.

In order to include or exclude multiple objects and their descendants, use
the `Class.WorldRoot:FindPartOnRayWithWhitelist()` and
`Class.WorldRoot:FindPartOnRayWithIgnoreList()` variants.

#### Notes

- Theoretically, a ray extends infinitely in one direction. However, the
  max length of the direction vector on Roblox is 15000 studs.
- The length (magnitude) of the directional vector is important, as parts
  further away than its length will not be tested.
- If the ray does not intersect anything, the return values will be `nil`
  and the point at the end of the ray, respectively.
- Parts that are in a
  [collision group](/workspace/collisions#collision-filtering)
  that does not collide with the "Default" collision group are ignored
  implicitly.


WorldRoot:FindPartOnRay

ignoreDescendantsInstance

terrainCellsAreCubes

ignoreWater

`Class.BasePart` หรือ `Class.Terrain` ที่ถูกชน, จุดตัด `Datatype.Vector3`,
ทิศทางผิว `Datatype.Vector3` ที่จุดตัด, และ `Enum.Material` ของ
`Class.BasePart` หรือเซลล์ภูมิประเทศที่ถูกชน.


ส่งคืน `Class.BasePart` หรือ `Class.Terrain` cell แรกที่ตัดกับ
`Datatype.Ray` ที่กำหนด.


WorldRoot:findPartOnRay

ฟังก์ชันนี้เป็นอสมการของ `Class.WorldRoot:FindPartOnRay()` โดยมีการเพิ่มรายการละเว้น.
ทำให้นักพัฒนาสามารถละเว้นบางส่วนหรือ `Class.Model|Models`.

ผู้ที่ต้องการ **รวม** กลุ่มวัตถุเฉพาะควรใช้
`Class.WorldRoot:FindPartOnRayWithWhitelist()` แทน.


WorldRoot:FindPartOnRayWithIgnoreList

ignoreDescendantsTable

`Class.BasePart` หรือ `Class.Terrain` cell ที่ถูกชน, จุดตัด
`Datatype.Vector3`, ทิศทางผิว `Datatype.Vector3` ที่จุดตัด,
และ `Enum.Material` ของ `Class.BasePart` หรือเซลล์ภูมิประเทศที่ถูกชน.


ส่งคืน `Class.BasePart` หรือ `Class.Terrain` cell แรกที่ตัดกับ
`Datatype.Ray` ที่กำหนดซึ่งไม่อยู่ในหรือเป็นลูกหลานของวัตถุ
ในรายการละเว้นที่กำหนด.


ฟังก์ชันนี้เป็นอสมการของ `Class.WorldRoot:FindPartOnRay()` โดยมีการเพิ่มรายการรวม.
ทำให้นักพัฒนาสามารถตรวจจับเฉพาะบางส่วนหรือ `Class.Model|Models` ซึ่งมีประโยชน์โดยเฉพาะเมื่อมองหาจุดตัดระหว่างรังสีและส่วนเดียว.

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

ผู้ที่ต้องการ **แยก** กลุ่มวัตถุเฉพาะควรใช้
`Class.WorldRoot:FindPartOnRayWithIgnoreList()` แทน.


WorldRoot:FindPartOnRayWithWhitelist

whitelistDescendantsTable

ส่งคืน `Class.BasePart` หรือ `Class.Terrain` cell แรกที่ตัดกับ
`Datatype.Ray` ที่กำหนดซึ่งอยู่ในหรือเป็นลูกหลานของวัตถุใน
รายการรวมที่กำหนด.


ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3` ที่กำหนด.

ฟังก์ชันนี้จะใช้พารามิเตอร์ maxParts (ดีฟอลต์คือ 20) ซึ่งจำกัดจำนวนนับที่
`Class.BasePart|BaseParts` ที่สามารถส่งคืนได้. เมื่อถึงจำนวนนี้
การค้นหาสำหรับ `Class.BasePart|BaseParts` จะหยุด. หมายเหตุว่าส่วนใด ๆ จาก
`Class.BasePart|BaseParts` อาจไม่ถูกส่งคืนแม้จะอยู่ภายใน `Datatype.Region3`

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

```
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)  -- ละเว้นส่วน
```

`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()` และ
`Class.WorldRoot:FindPartsInRegion3WithWhiteList()` อสมการของวิธีนี้มีอยู่เพื่อให้
การทำงานเฉพาะการรวมและการละเว้น.

หากไม่พบ `Class.BasePart|BaseParts` จะส่งคืนอาร์เรย์ที่ว่างเปล่า.


WorldRoot:FindPartsInRegion3

region

`Datatype.Region3` ที่จะได้รับการตรวจสอบ.


เป็น `Class.Instance` ที่จะถูกละเว้น.


maxParts

จำนวนสูงสุดของ `Class.BasePart|BaseParts` ที่จะถูกส่งคืน.


อาร์เรย์ของ `Class.BasePart|BaseParts` ภายใน `Datatype.Region3`.


ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3` ที่กำหนด.


WorldRoot:findPartsInRegion3

ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ที่ไม่ได้อยู่ในหรือเป็นลูกหลานของรายการในรายการละเว้นที่กำหนด.

หากมีค่า `nil` ในรายการละเว้น อินสแตนซ์หลังจากค่านั้นจะไม่ได้รับการละเว้น.
หากไม่พบ `Class.BasePart|BaseParts` จะส่งคืนอาร์เรย์ที่ว่างเปล่า.

ฟังก์ชันนี้เป็นอสมการของ `Class.WorldRoot:FindPartsInRegion3()` ที่มี
การเพิ่มรายการละเว้น. สิ่งนี้ช่วยให้นักพัฒนาแยก
บางส่วน `Class.BasePart|BaseParts` หรือ `Class.Model|Models` ออกจากการ
ค้นหา. ผู้ที่ต้องการหา `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ควรใช้ `Class.WorldRoot:FindPartsInRegion3WithWhiteList()`.


WorldRoot:FindPartsInRegion3WithIgnoreList

อาร์เรย์ของออบเจ็กต์ที่จะถูกละเว้น.


อาร์เรย์ของ `Class.BasePart|BaseParts` ที่พบภายใน
`Datatype.Region3`.


ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ที่ไม่ได้อยู่ในหรือเป็นลูกหลานของรายการในรายการละเว้นที่กำหนด.


ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ที่อยู่ในหรือลูกหลานของการลงทะเบียนในรายการรวมที่กำหนด.

หากมีค่า `nil` ในรายการรวม อินสแตนซ์หลังจากค่านั้นจะไม่ได้รับการละเว้น. หากไม่พบ
`Class.BasePart|BaseParts` จะส่งคืนอาร์เรย์ที่ว่างเปล่า.

ฟังก์ชันนี้เป็นอสมการของ `Class.WorldRoot:FindPartsInRegion3()` ที่มีการเพิ่มรายการรวม.
สิ่งนี้ช่วยให้นักพัฒนาแยก
เฉพาะบางส่วน `Class.BasePart|BaseParts` หรือ `Class.Model|Models` ใน
การค้นหา. ผู้ที่ต้องการหา `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ควรใช้ `Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.


WorldRoot:FindPartsInRegion3WithWhiteList

อาร์เรย์ของวัตถุที่จะตรวจสอบ.


ส่งคืนอาร์เรย์ของ `Class.BasePart|BaseParts` ใน `Datatype.Region3`
ที่อยู่ในหรือลูกหลานของการลงทะเบียนในรายการรวมที่กำหนด.


`Class.WorldRoot:GetPartBoundsInBox()` ส่งคืนอาร์เรย์ของส่วนที่
**กล่องพิกัด** ทับซ้อนกับกล่องที่อธิบายด้วย
(center) (`Datatype.CFrame`) และขนาด (`Datatype.Vector3`).

อย่างที่กล่าวถึงแล้ว วิธีการค้นหาพื้นที่นี้คำนึงถึงปริมาตรของ
กล่องพิกัดของส่วนแทนที่จะเป็นปริมาตรจริงที่ใช้. สิ่งนี้อาจมีความสำคัญ
เมื่อพิจารณาถึงทรงกระบอก, ทรงกลม, การรวมกัน, และ
`Class.MeshPart|MeshParts` ที่มีรูปร่างที่ไม่เป็นบล็อก. ในกรณีที่ความแม่นยำมีความสำคัญโดยเฉพาะ
ให้ใช้ `Class.WorldRoot:GetPartsInPart()` แทน, หรือกรองผลลัพธ์ของวิธีนี้ด้วยตัวคุณเอง.

วิธีนี้ใช้ `Datatype.OverlapParams` ออบเจ็กต์ในการอธิบายส่วนที่ใช้ซ้ำได้
ของพารามิเตอร์การค้นหาพื้นที่ เช่น รายการรวมและละเว้น,
จำนวนสูงสุดของส่วนที่ค้นหา, กลุ่มการชนที่ต้องใช้งาน,
และว่าการค้นหานั้นให้ความสำคัญกับค่าของ
`Class.BasePart.CanCollide` มากกว่าค่า `Class.BasePart.CanQuery`.


WorldRoot:GetPartBoundsInBox

ตำแหน่งของศูนย์กลางของปริมาตรกล่องที่กำหนดที่จะทำการค้นหา.


ขนาดของปริมาตรกล่องที่กำหนดที่จะทำการค้นหา.


overlapParams

ประกอบด้วยส่วนที่ใช้ซ้ำได้ของพารามิเตอร์การค้นหาพื้นที่.


อาร์เรย์ของ `Class.BasePart|BaseParts` ที่ตรงกับการค้นหาพื้นที่.


ส่งคืนอาร์เรย์ของส่วนที่ **กล่องพิกัด** ทับซ้อนกับกล่องที่กำหนด.


`Class.WorldRoot:GetPartBoundsInRadius()` ส่งคืนอาร์เรย์ของส่วนที่ **กล่องพิกัด** ทับซ้อนกับทรงกลมที่อธิบายด้วย
(center) (`Datatype.Vector3`) และรัศมี (number).

อย่างที่กล่าวถึงแล้ว วิธีการค้นหาพื้นที่นี้คำนึงถึงปริมาตรของกล่องพิกัดของส่วนให้มีประสิทธิภาพกว่าปริมาตรจริงที่ใช้. สิ่งนี้อาจมีความสำคัญเมื่อพิจารณาถึงทรงกระบอก, ทรงกลม,
การรวมกัน, และ `Class.MeshPart|MeshParts` ที่มีรูปร่างที่ไม่เป็นบล็อก. ในกรณีที่ความแม่นยำมีความสำคัญโดยเฉพาะ ใช้
`Class.WorldRoot:GetPartsInPart()` แทน, หรือตองกรองผลลัพธ์ของวิธีนี้ด้วยตัวคุณเอง.

วิธีนี้ใช้ `Datatype.OverlapParams` ออบเจ็กต์ในการอธิบายส่วนที่ใช้ซ้ำได้
ของพารามิเตอร์การค้นหาพื้นที่ เช่น รายการรวมและละเว้น,
จำนวนสูงสุดของส่วนที่ค้นหา, กลุ่มการชนที่ต้องใช้งาน,
และว่าการค้นหานั้นให้ความสำคัญกับค่าของ `Class.BasePart.CanCollide`
มากกว่าค่า `Class.BasePart.CanQuery`.


WorldRoot:GetPartBoundsInRadius

position

ตำแหน่งของศูนย์กลางของปริมาตรทรงกลมที่กำหนดที่จะทำการค้นหา.


radius

รัศมีของปริมาตรทรงกลมที่กำหนดที่จะทำการค้นหา.


ส่งคืนอาร์เรย์ของส่วนที่ **กล่องพิกัด** ทับซ้อนกับทรงกลมที่กำหนด.


`Class.WorldRoot:GetPartsInPart()` ส่งคืนอาร์เรย์ของส่วนที่
พื้นที่ถูกแชร์กับส่วนที่กำหนด (ซึ่งต้องอยู่ใน
`Class.WorldRoot` เดียวกับส่วนที่ต้องการค้นหา). ฟังก์ชันนี้สามารถใช้แทน
`Class.BasePart:GetTouchingParts()` และโดยทั่วไปถือเป็นทางเลือกที่ดีกว่า.

อย่างที่กล่าวถึง วิธีการค้นหาพื้นที่นี้พิจารณาถึง **ปริมาตรที่แน่นอน**
ที่ถูกใช้งานโดยส่วนที่กำหนดโดยใช้การตรวจสอบการชนที่สมบูรณ์. เช่น,
ส่วนที่โค้งหรือกลวงจะไม่ตรงกับส่วนที่กำลังค้นหาภายในจนกว่าจะมีการทับซ้อนหรือสัมผัสกับส่วนดังกล่าว. สำหรับปริมาตรที่ง่ายกว่าให้พิจารณา
การใช้ `Class.WorldRoot:GetPartBoundsInBox()` หรือ
`Class.WorldRoot:GetPartBoundsInRadius()` เนื่องจากมีความแม่นยำน้อยกว่าแต่มีประสิทธิภาพมากกว่า.

วิธีนี้ใช้ `Datatype.OverlapParams` ออบเจ็กต์ในการอธิบายส่วนที่ใช้ซ้ำได้
ของพารามิเตอร์การค้นหาพื้นที่ เช่น รายการรวมและละเว้น,
จำนวนสูงสุดของส่วนที่ค้นหา, กลุ่มการชนที่ต้องใช้งาน,
และว่าการค้นหานั้นให้ความสำคัญกับค่าของ `Class.BasePart.CanCollide`
มากกว่าค่า `Class.BasePart.CanQuery`.


WorldRoot:GetPartsInPart

part

ส่วนที่ปริมาตรจะถูกตรวจสอบเทียบกับส่วนอื่น.


ส่งคืนอาร์เรย์ของส่วนที่มีพื้นที่ที่ถูกแชร์กับส่วนที่กำหนด.


ฟังก์ชันนี้ย้ายส่วนที่กำหนดไปยังตำแหน่งที่กำหนดผ่าน
[ไอเคอรนิกส์](https://en.wikipedia.org/wiki/Inverse_kinematics) แทนที่จะย้ายโดยตรง,
เพื่อให้แน่ใจว่าข้อต่อ,
`Class.Constraint|constraints`, หรือการชนที่ส่วนนี้เข้าร่วม
จะยังคงเป็นไปตามกฎทางกายภาพ. ขณะนี้ฟังก์ชันนี้ใช้ได้เฉพาะใน Studio สำหรับ
`Class.Plugin|plugins`, เนื่องจากมีความขัดแย้งกับ
ฟิสิกส์ของเกมที่กำลังทำงาน.

**Translate stiffness** คือค่าระหว่าง 0 ถึง 1 ที่กำหนดถึงความเข้มข้น
ที่ส่วนจะไปถึงตำแหน่งส่วนของ `Datatype.CFrame` เป้าหมาย **Rotate stiffness** คือค่าระหว่าง 0 ถึง 1 ที่กำหนดถึงความเข้มข้น
ที่ส่วนจะไปถึงการหมุนส่วนของ `Datatype.CFrame` เป้าหมาย.

ตัวอย่างเช่น:
- หากความเข้มข้นการแปลและความเข้มข้นการหมุนเท่ากับ 1,
  ส่วนจะถูกย้ายไปยัง `Datatype.CFrame` เป้าหมายโดยไม่มีการพิจารณาตาม
  ข้อจำกัดทางกายภาพ.
- หากความเข้มข้นการแปลและความเข้มข้นการหมุนเท่ากับ 0.5,
  ส่วนจะพยายามย้ายไปยัง `Datatype.CFrame` ที่กำหนด แต่ก็อาจจะถูก
  ผลักออกโดยข้อจำกัดทางกายภาพ.
- หากความเข้มข้นการแปลและความเข้มข้นการหมุนเท่ากับ 0,
  `Datatype.CFrame` เป้าหมายจะถูกละเว้นและข้อจำกัดทางกายภาพจะถูก
  แก้ไขสำหรับวัตถุในตำแหน่งที่มันอยู่.


WorldRoot:IKMoveTo

ส่วนที่จะถูกย้าย.


target

ตำแหน่งที่จะย้ายส่วนที่กำหนด.


translateStiffness

หมายเลขระหว่าง 0 และ 1 ที่ระบุว่าความเข้มข้นในการจับคู่ตำแหน่ง
ของส่วนกับตำแหน่งของ `Datatype.CFrame` เป้าหมายต้องเท่าไร.


rotateStiffness

หมายเลขระหว่าง 0 และ 1 ที่ระบุว่าความเข้มข้นในการจับคู่การหมุน
ของส่วนกับการหมุนของ `Datatype.CFrame` เป้าหมายต้องเท่าไร.


collisionsMode

อนุญาตให้คุณระบุว่าวัตถุใดจะถูกส่งผลกระทบต่อการแก้ไขทางกายภาพ.


ย้ายส่วนที่กำหนดไปยังตำแหน่งที่กำหนดผ่านไอเคอรนิกส์
แทนที่จะย้ายโดยตรง เพื่อให้มั่นใจว่าข้อต่อ,
ข้อจำกัด, หรือการชนที่ส่วนนี้เข้าร่วมจะยังคงเป็นไปตามกฎทางกายภาพ.


**IsRegion3Empty** ส่งคืน bool ที่แสดงว่ามี `Class.BasePart|BaseParts`
ใด ๆ ภายใน `Datatype.Region3` ที่กำหนด.

พารามิเตอร์ `ignoreDescendantsInstance` ที่เป็นออปชันสามารถใช้เพื่อตรวจสอบ
อินสแตนซ์เฉพาะ ซึ่งตัวมันเองและลูกหลานทั้งหมดจะถูกละเว้นโดยฟังก์ชั่นนี้. สิ่งนี้มีประโยชน์เมื่อ,
ดูว่า `Class.BasePart|BaseParts` ใด ๆ ที่อยู่ภายใน `Class.BasePart` อื่น
นอกจาก `Class.BasePart` เอง.

```
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)  -- ละเว้นส่วน
```
หากต้องการละเว้นออบเจ็กต์มากกว่าหนึ่งและลูกหลานของมันในการ
ค้นหา นักพัฒนาควรใช้
`Class.WorldRoot:IsRegion3EmptyWithIgnoreList()`.

ฟังก์ชั่นนี้จะส่งคืนข้อมูลเพียงแค่ภูมิภาคนั้นว่าว่างหรือไม่. นักพัฒนาที่ต้องการหา
`Class.BasePart|BaseParts` ในภูมิภาคควรใช้
`Class.WorldRoot:FindPartsInRegion3()`.

#### วิธีการทำงานของการตรวจสอบ Region3?

การตรวจสอบว่ามีส่วนใดที่ทับซ้อนกับ `Datatype.Region3` ไม่ใช่กระบวนการที่ง่าย.
มันใช้เวลานานและซับซ้อนมาก. แทนที่จะทำการตรวจสอบโดยการทดสอบเมื่อ
ฟังก์ชันนี้ทำงาน, มันทำให้เข้าใจว่ามีเสียงที่ประกอบด้วย `Datatype.Region3`. จากนั้นมันตรวจสอบว่ามี
พาร์ทที่อยู่ในเสียงเหล่านั้นหรือไม่. มันทำกิจกรรมนี้โดยการเปรียบเทียบกล่องพิกัดที่เรียบง่าย
(ซึ่งเรียกว่า AABB) ของพาร์ทกับเสียงนั้น. กล่องพิกัดที่เรียบง่ายสามารถเห็นได้ใน Roblox Studio เมื่อเลือกพาร์ท.

สิ่งนี้หมายความว่าพื้นที่ที่ถูกตรวจสอบโดยฟังก์ชันอาจใหญ่กว่าตัว `Datatype.Region3`. ด้วยเหตุนี้ขอแนะนำให้แน่ใจว่าตัว
`Datatype.Region3` อยู่ในเครื่องหมายกริด. วิธีที่ดีที่สุดในการทำเช่นนี้คือเพียงตั้งค่า
พิกัดของ `Datatype.Region3` เป็นผลคูณของ 4 (เนื่องจากละติจูดมีขนาด 4 x 4 x 4 studs).

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


WorldRoot:IsRegion3Empty

`Datatype.Region3` ที่จะถูกตรวจสอบ.


ignoreDescendentsInstance

จริงหาก `Datatype.Region3` ว่าง.


ส่งคืน bool ที่แสดงว่ามี `Class.BasePart|BaseParts`
ใด ๆ ภายใน `Datatype.Region3` ที่กำหนด.


ส่งคืน boolean ที่บ่งชี้ว่ามี `Class.BasePart|BaseParts`
ใด ๆ ภายใน `Datatype.Region3` ที่กำหนด โดยละเว้น
`Class.BasePart|BaseParts` ที่เป็นลูกหลานของวัตถุในรายการที่ระบุ. หากมีค่า `nil`
ในรายการละเว้น อินสแตนซ์หลังจากค่าดังกล่าวจะไม่ได้รับการละเว้น.

ฟังก์ชันนี้จะคืนข้อมูลแค่ภูมิภาคนั้นว่าว่างหรือไม่ นักพัฒนาที่ต้องการหา `Class.BasePart|BaseParts`
ในภูมิภาคควรใช้
`Class.WorldRoot:FindPartsInRegion3WithIgnoreList()`.

ฟังก์ชันนี้เป็นอสมการของ `Class.WorldRoot:IsRegion3Empty()` ที่มีการเพิ่มรายชื่อที่ละเว้น.
ในกรณีที่มีความต้องการรายชื่อรวมแทน ผู้พัฒนาควรตรวจสอบว่ามีส่วนการส่งคืน
`Class.WorldRoot:FindPartsinRegion3WithWhitelist()`.


WorldRoot:IsRegion3EmptyWithIgnoreList

ignoreDescendentsTable

อาร์เรย์ของวัตถุที่ถูกละเว้น.


จริงถ้าหาก `Datatype.Region3` ว่าง.


ส่งคืน boolean ที่บ่งชี้ว่ามี `Class.BasePart|BaseParts`
ใด ๆ ภายใน `Datatype.Region3` ที่กำหนด โดยละเว้น
`Class.BasePart|BaseParts` ที่เป็นลูกหลานของวัตถุในรายการ
ที่ระบุ.


สร้างรังสีและส่งคืนการชนครั้งแรกกับ `Class.BasePart` หรือ
`Class.Terrain` จะพิมพ์คุณสมบัติของ RaycastResult หากมีการชนเกิดขึ้น


ฉายรังสีด้วยการใช้จุดเริ่มต้น, ทิศทาง, และ
`Datatype.RaycastParams` ออปชัน. หากพบ `Class.BasePart` หรือ
`Class.Terrain` cell ที่มีสิทธิ์ จะส่งคืน `Datatype.RaycastResult` ที่มี
ผลลัพธ์ของการดำเนินการ. หากไม่มีออบเจ็กต์ `Datatype.RaycastParams`
ถูกระบุ จะใช้ค่าดีฟอลต์ (พิจารณาทุกส่วนและไม่ละเว้นน้ำท่าชุ่ม).

หมายเหตุว่าความยาว (ขนาด) ของเวกเตอร์ทิศทางจะมีความสำคัญ,
เนื่องจากวัตถุ/ภูมิประเทศที่อยู่ห่างไปมากกว่าความยาวจะไม่ได้รับการทดสอบ. หาก
คุณใช้ `Datatype.CFrame` เพื่อช่วยสร้างองค์ประกอบของรังสี,
พิจารณาใช้ `Datatype.CFrame.LookVector` เป็นเวกเตอร์ทิศทางและ
คูณด้วยความยาวที่ต้องการ ดังตัวอย่างด้านล่าง. ความยาวสูงสุดของเวกเตอร์ทิศทางคือ 15,000 studs.

วิธีนี้ **ไม่** ใช้ออบเจ็กต์ `Datatype.Ray`, แต่สามารถยืมส่วนประกอบของจุดเริ่มต้นและทิศทางจาก `Datatype.Ray.Origin` และ
`Datatype.Ray.Direction`.


WorldRoot:Raycast

origin

จุดเริ่มต้นของรังสี.


เวกเตอร์ทิศทางของรังสี. หมายเหตุว่าความยาวของเวกเตอร์นี้มีความสำคัญ,
เนื่องจากส่วน/ภูมิประเทศที่อยู่ห่างออกไปเกินกว่าความยาวจะไม่ได้รับการทดสอบ.


raycastParams

ออบเจ็กต์ที่ใช้เพื่อกำหนดคุณสมบัติการชนในการฉายรังสี. หาก
ไม่มีระบุจะใช้ค่าดีฟอลต์ที่ทุกส่วนจะได้รับการพิจารณา
และน้ำท่า`Class.Terrain` จะไม่ได้รับการละเว้น.


ประกอบด้วยผลลัพธ์ของการดำเนินการฉายรังสี หรือ `nil` หากไม่มี
`Class.BasePart` หรือ `Class.Terrain` cell ที่ถูกชน.


ฉายรังสีโดยใช้จุดเริ่มต้น, ทิศทาง, และ
`Datatype.RaycastParams` ออปชัน จากนั้นส่งคืน `Datatype.RaycastResult`
หากวัตถุหรือภูมิประเทศที่มีสิทธิ์ตัดกับรังสี.


WorldRoot:Shapecast

สร้างสสารกลมและคืนค่าการชนครั้งแรกกับ `Class.BasePart` หรือ
`Class.Terrain` แสดงคุณสมบัติของ RaycastResult หากมีการชน


ฉายรูปร่างทรงกลมในทิศทางที่กำหนดและส่งคืนการชนครั้งแรก
กับ `Class.BasePart` หรือ `Class.Terrain` cell. นี่คือการเปรียบเทียบกับวิธี
`Class.WorldRoot:Raycast()` ที่ฉายรังสีเชิงเส้นในทิศทางเพื่อหาการชนกัน,
แต่ใช้รูปทรง 3D แทนที่จะเป็นรังสี.

แตกต่างจาก `Class.WorldRoot:GetPartsInPart()`, วิธีนี้ไม่ตรวจจับ
`Class.BasePart|BaseParts` ที่ **เริ่มต้น** ไปทับซ้อนกับรูปทรง.

หากตรวจพบการชนกัน จะส่งคืน `Datatype.RaycastResult` ที่เก็บข้อมูลการชน.
คุณสมบัติ `Datatype.RaycastResult.Distance|Distance` แทนระยะทางที่รูปทรงต้องเดินทางเพื่อหาการชน,
และคุณสมบัติ `Datatype.RaycastResult.Position|Position` แทนจุดตัดที่ทำให้เกิดการชน.

วิธีนี้จะโยนข้อผิดพลาดหากได้รับข้อมูลนำเข้าเช่นรัศมีหรือตำแหน่งที่ไม่ถูกต้อง.


WorldRoot:Spherecast

ตำแหน่งเริ่มต้นของรูปร่างทรงกลมที่ฉาย.


รัศมีของรูปร่างทรงกลมที่ฉายใน studs. รัศมีสูงสุดคือ 256 studs.


ทิศทางของการฉายรูปร่าง โดยมีขนาดแสดงถึง
ระยะทางสูงสุดที่รูปร่างสามารถเคลื่อนไหวได้ สูงสุด 1024
studs.


ประกอบด้วยผลลัพธ์ของการฉายรูปร่าง หรือ `nil` หากไม่มี
`Class.BasePart` หรือ `Class.Terrain` cell ที่ถูกชน.


ฉายรูปร่างทรงกลมในทิศทางที่กำหนดและส่งคืน
`Datatype.RaycastResult` หากรูปร่างชนกับ `Class.BasePart` หรือ
`Class.Terrain`.


จำลองพาร์ทในพื้นที่ทำงานเป็นระยะเวลาคงที่โดยการเรียกใช้ฟังก์ชัน
StepPhysics หนึ่งครั้งต่อเฟรมจนกว่าจะถึงเวลาที่กำหนด

ก้าวหน้าในการจำลองสำหรับพาร์ทในโลกไปข้างหน้าตามการเพิ่มเวลาที่
ระบุและชุดของ `Class.BasePart` ที่ไม่ต้องการ. เมื่อชุดของพาร์ทถูกระบุ,
จะมีเพียงพาร์ทเหล่านั้นที่จำลอง และพาร์ททั้งหมดในโลกจะถูกถือว่าเป็น
ข้อจำกัด. เมื่อไม่มีการส่งอาร์กิวเมนต์นี้ จะมีพาร์ททั้งหมดในโลกที่ถูก
รวมในจำลอง. การเพิ่มเวลาที่ระบุสามารถเป็นหมายเลขบวกใด ๆ,
โดยที่ค่าที่มากกว่าจะเพิ่มเวลาทำงานของฟังก์ชัน. ขึ้นอยู่กับค่าของการเพิ่มเวลา,
ระบบฟิสิกส์อาจแบ่งมันออกเป็นหลายขั้นตอนเพื่อรักษาความแม่นยำและเสถียรภาพของ
การจำลอง. แม้ว่าฟังก์ชันจะทำหลายขั้นตอนย่อย
ผลลัพธ์ของการจำลองจะปรากฏขึ้นเมื่าฟังก์ชันเสร็จสิ้น. เพื่อตรวจสอบขั้นตอนปัจเจกของการจำลอง,
ฟังก์ชันสามารถถูกเรียกหนึ่งครั้งต่อ RenderStep ผ่าน
เหตุการณ์ `Class.RunService.RenderStepped`.


WorldRoot:StepPhysics

จำนวนเวลาที่จะจำลอง. อาร์กิวเมนต์นี้ต้องเป็นหมายเลขบวก. ค่าที่ใหญ่กว่าจะ
เพิ่มเวลาทำงานของฟังก์ชันนี้.


parts

อาร์เรย์ของพาร์ทที่จำลอง ซึ่งชุดนี้ต้องประกอบด้วย
อินสแตนซ์ที่เป็นชนิดของ `Class.BasePart`; ชนิดอื่น ๆ จะถูกละเว้น.


ก้าวหน้าในการจำลองสำหรับพาร์ทในโลกไปข้างหน้าตามการเพิ่มเวลาที่
ระบุและชุดของ `Class.BasePart|BaseParts` ที่ไม่ต้องการ.


WorldRoot

คลาสพื้นฐานสำหรับการจัดการการจำลองฟิสิกส์และการค้นหาพื้นที่ 3D.


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

โมเดลเป็นวัตถุที่ใช้เป็นตัวเก็บข้อมูล ซึ่งหมายถึงการรวบรวมวัตถุเข้าด้วยกัน พวกเขา
เหมาะที่สุดสำหรับการเก็บรวมกลุ่มของ `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

ตำแหน่ง `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

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

Model

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

/reference/engine/classes/WorldModel.yaml