이 샘플은 스폰 위치를 사용하여 체크포인트 시스템을 만드는 방법을 보여줍니다.
일반적으로 이는 Lua가 아닌 스튜디오에서 수행되지만, 이 예시는 팀 및 스폰 위치 속성이
이 설정을 달성하기 위해 무엇이 필요한지에 대한 포괄적인 예시를 제공합니다.

`SpawnLocations`, 또는 "스폰 지점"은 `Class.Player`가 사망했을 때 다시 생성되는 위치를 결정합니다. 각 스폰을 사용하도록 특정 플레이어만 허용하도록 `Class.Team|Teams`를 사용하여 구성할 수 있습니다. 또한 새로 생성된 플레이어를 위한 `Class.ForceField|ForceFields`의 설정 방법을 제어합니다.

`SpawnLocations`는 장애물 코스와 같은 게임에서 체크포인트로 사용될 수 있으며, `Class.SpawnLocation.AllowTeamChangeOnTouch` 속성을 사용하여 플레이어가 이를 터치하면 그 스폰 지점의 팀으로 팀을 변경합니다. 이 경우, 첫 번째 `Class.Team`만 `Class.Team.AutoAssignable`이 true로 설정되어야 하며, 그렇지 않으면 플레이어가 첫 번째 체크포인트에서 시작하지 않습니다.

Studio에서 `Class.Workspace`에 SpawnLocation이 추가될 경우 `Class.SpawnLocation.Neutral`이 false로 설정되어 있으면 `Class.SpawnLocation.TeamColor`와 일치하는 팀이 생성됩니다. 이 행동은 게임 내에서 `Class.Script`를 사용하여 스폰이 생성되거나 SpawnLocation 속성을 이미 추가된 후 변경될 때 발생하지 않습니다. 개발자는 항상 팀을 수동으로 설정하고 이 행동에 의존하지 않는 것이 좋습니다.

## 스폰 규칙

특정 SpawnLocation에서 플레이어가 다시 생성될 때 여러 규칙이 적용됩니다:

- `Class.SpawnLocation.Neutral`이 false로 설정된 경우, `Class.Player|Players`의 `Class.Player.TeamColor`가 `Class.SpawnLocation.TeamColor`와 일치하는 경우에만 그 위에서 다시 생성됩니다.
- `Class.SpawnLocation.Neutral`이 true로 설정된 경우 모든 플레이어가 `Class.SpawnLocation.TeamColor`에 관계없이 그 위에서 스폰할 수 있습니다.
- 여러 개의 적격 스폰이 `Class.Player`에게 제공될 경우, 랜덤으로 선택됩니다.
- 플레이어는 SpawnLocation 위의 서로 다른 지점에서 스폰하지만, 현재는 바로 뒤에서 스폰할 경우 서로 겹쳐서 스폰될 수 있습니다.

또한 참고:

- 플레이어의 재출현 시간 조정을 원한다면, `Class.Players.RespawnTime|RespawnTime` 속성을 확인하세요.


SpawnLocation

`Class.SpawnLocation`를 터치하면 `Class.Player`가 팀에 가입할 수 있습니다. true로 설정된 경우, `Class.Player` 캐릭터가 `Class.SpawnLocation`과 접촉하면 플레이어의 `Class.Player.TeamColor`가 `Class.SpawnLocation.TeamColor`로 설정됩니다.
`Class.Player.Neutral`도 접촉 시 `Class.SpawnLocation.Neutral`로 설정되며, 즉 플레이어는 스폰 지점을 터치함으로써 중립 상태가 될 수 있습니다.

이 기능은 `Class.SpawnLocation.Enabled`가 false로 설정된 경우에는 작동하지 않습니다.

#### 체크포인트 만들기

이 기능은 종종 장애물 코스나 유사한 게임에서 체크포인트를 만드는 데 사용됩니다.


SpawnLocation.AllowTeamChangeOnTouch

`Class.SpawnLocation`를 터치하면 `Class.Player`가 팀에 가입할 수 있습니다. true로 설정된 경우, `Class.Player` 캐릭터가 `Class.SpawnLocation`과 접촉하면 플레이어의 `Class.Player.TeamColor`가 `Class.SpawnLocation.TeamColor`로 설정됩니다.


이 샘플은 플레이어가 20초 동안 포스 필드를 받는 중립 스폰 위치를 작업 공간에 생성합니다.

`Class.SpawnLocation`에서 스폰하는 `Class.Player` 캐릭터에게 적용되는 `Class.ForceField`의 지속 시간(초 단위)입니다. 지속 시간이 0인 경우 `Class.ForceField`는 생성되지 않으며, `Class.Instance.DescendantAdded` 또는 `Class.Instance.ChildAdded` 이벤트를 트리거하지 않습니다.

이 속성의 기본값은 10초입니다.

지속 시간 기능을 통해 개발자는 '스폰 킬링'으로부터 `Class.Player|Players`를 쉽게 보호할 수 있으며, 이는 플레이어에게 짜증나는 경험이 될 수 있습니다. 참고로, `Class.ForceField|ForceFields`는 `Class.Explosion|Explosions` 및 `Class.Humanoid:TakeDamage()`를 사용하여 피해를 입히거나 `Class.ForceField`를 확인하는 무기 사용자를 보호합니다.


SpawnLocation.Duration

`Class.SpawnLocation`에서 스폰하는 `Class.Player` 캐릭터에게 적용되는 `Class.ForceField`의 지속 시간(초 단위)입니다. 지속 시간이 0인 경우 `Class.ForceField`는 생성되지 않으며, `Class.Instance.DescendantAdded` 또는 `Class.Instance.ChildAdded` 이벤트를 트리거하지 않습니다.


다음 샘플은 비활성화되었을 때 반투명해지는 스폰 위치를 Workspace에 생성합니다.

`Class.SpawnLocation`이 활성화되어 있는지 여부를 설정합니다. 비활성화된 경우 플레이어는 `Class.SpawnLocation`에서 스폰할 수 없으며 `Class.SpawnLocation.AllowTeamChangeOnTouch` 기능도 비활성화됩니다.

이 속성은 `Class.Player|Players`가 스폰에서 스폰하는 것을 방지하는 가장 편리한 방법을 제공합니다.

참고로, `Enabled`가 false로 설정된 경우 `Class.SpawnLocation.AllowTeamChangeOnTouch`를 사용하여 터치 시 팀 변경은 비활성화되지만, `Class.BasePart.Touched`를 사용하는 다른 터치 이벤트는 여전히 발생합니다.


SpawnLocation.Enabled

`Class.SpawnLocation`이 활성화되어 있는지 여부를 설정합니다. 비활성화된 경우 플레이어는 `Class.SpawnLocation`에서 스폰할 수 없으며 AllowTeamChangeOnTouch 기능도 비활성화됩니다.


스폰이 특정 팀과 관련되어 있는지 여부입니다. 즉, 이 속성이 true로 설정된 경우 모든 `Class.Player`가 어떤 `Class.Team`에도 불구하고 그 위에서 스폰할 수 있습니다.

`Neutral`이 false로 설정된 경우, `Class.Player.TeamColor`가 `Class.SpawnLocation.TeamColor`와 일치하는 플레이어만 `Class.SpawnLocation`을 사용할 수 있습니다.

`Class.SpawnLocation.AllowTeamChangeOnTouch`가 true인 경우, 플레이어는 스폰과 접촉할 때 이 속성이 설정됩니다.


SpawnLocation.Neutral

`Class.SpawnLocation`이 특정 팀과 관련되어 있는지 여부입니다. 즉, 이 속성이 true로 설정된 경우 모든 `Class.Player`가 어떤 `Class.Team`에도 불구하고 그 위에서 스폰할 수 있습니다.


TeamColor 속성은 `Class.SpawnLocation`이 어떤 팀에 속하는지를 설정합니다. `Class.SpawnLocation.Neutral` 속성이 false인 경우, 동일한 `Class.Player.TeamColor`를 가진 `Class.Player|Players`만 그곳에서 스폰할 수 있습니다.

`Class.SpawnLocation.AllowTeamChangeOnTouch`가 true인 경우, 플레이어는 스폰과 접촉할 때 이 속성이 설정됩니다.


SpawnLocation.TeamColor

`Class.SpawnLocation`이 어떤 팀에 속하는지를 설정합니다. `Class.SpawnLocation.Neutral` 속성이 false인 경우, 동일한 `Class.Player.TeamColor`를 가진 `Class.Player|Players`만 그곳에서 스폰할 수 있습니다.


`Class.SpawnLocation|SpawnLocations`, 또는 "스폰 지점"은 `Class.Player`가 사망했을 때 다시 생성되는 위치를 결정합니다. 각 스폰을 사용하도록 특정 플레이어만 허용하도록 `Class.Team|Teams`를 사용하여 구성할 수 있습니다. 또한 새로 생성된 플레이어를 위한 `Class.ForceField|ForceFields`의 설정 방법을 제어합니다.


아래 스크립트는 새로운 `Part` 인스턴스를 생성하고 여러 속성을 설정합니다.

특히, 스크립트는 `Class.Part.Shape` 속성을 `Enum.PartType.Ball`로 설정합니다. 또한 파트의 이름을 _JurassicPart_로 지정하고, 고정하고, _Workspace_의 자식으로 만들며, 색상을 흰색으로 설정합니다.

Part 객체는 `Class.BasePart`의 한 유형입니다. 다섯 가지 서로 다른
기본 형태: Ball, Block, Cylinder, Wedge, 및 CornerWedge 형태로 제공됩니다.


Part

Shape 속성은 객체의 전체 모양을 미리 정해진 내장 형태 목록 중 하나로 설정합니다.

`Enum.PartType` 열거형이 형태 값을 제어하며, 다섯 가지 가능한
형태가 있습니다:

| Shape/Value | Description                             |
| ----------- | --------------------------------------- |
| Ball        | 구형 모양입니다.                         |
| Block       | 블록 형태입니다.                         |
| Cylinder    | 원통형입니다.                            |
| Wedge       | 한 쪽에 경사가 있는 쐐기 형태입니다.      |
| CornerWedge | 두 쪽에 경사가 있는 쐐기 형태입니다.     |

`Class.MeshPart`와 [솔리드 모델링](/parts/solid-modeling)
을 사용하여 완전히 사용자 정의된 부품 모양을 얻을 수 있습니다.

Ball, Block, Wedge, 및 CornerWedge 간의 충돌은 정확하나,
지형, 원통, TriangleMeshes 및 기타 기하학적 유형 간의 충돌은 근사치입니다. 이는
Ball 형태가 차량 바퀴용 안정적인 충돌체를 만드는 데 유용할 수 있음을 의미합니다.


Part.Shape

객체의 전체 모양을 설정합니다.


`Class.BasePart`의 일반적인 유형으로 다양한 기본 형태로 제공됩니다.


FormFactorPart 클래스는 추상 클래스입니다. 이 클래스는 `Class.BasePart` 클래스에서 상속되며, 이를 상속하는 클래스에 `Class.FormFactorPart.FormFactor` 속성을 추가합니다.


FormFactorPart

이 속성은 부품 크기의 그리드 제약을 지정하는 데 사용되었습니다. 더 이상 아무런 기능을 하지 않습니다.


FormFactorPart.FormFactor

부품이 크기 조정 시 어떻게 동작하는지와 크기로 가질 수 있는 값들을 결정합니다.


FormFactorPart.formFactor

FormFactorPart 클래스는 추상 클래스입니다. 이 클래스는 BasePart 클래스에서 상속되며, 이를 상속하는 클래스에 FormFactor 속성을 추가합니다.


`Class.BasePart`는 `Class.Workspace` 내에서 렌더링되고 물리적으로 시뮬레이션되는 월드 내 객체들의 추상 기본 클래스입니다. `Class.BasePart`의 구현체는 여러 가지가 있으며, 가장 일반적인 것은 `Class.Part`와 `Class.MeshPart`입니다. 그 외에는 `Class.WedgePart`, `Class.SpawnLocation`, 그리고 단일 객체인 `Class.Terrain`이 포함됩니다. 일반적으로 문서에서 "part"를 언급할 때, 대부분의 `Class.BasePart` 구현체가 작동하며 단지 `Class.Part`만 해당되지 않습니다.

`Class.BasePart|BaseParts`가 시뮬레이션된 강체로 그룹화되는 방법에 대한 정보는 [Assemblies](/physics/assemblies)를 참조하십시오.

`Class.BasePart`와 상호작용하는 다양한 객체들(즉 `Class.Terrain`을 제외한)은 다음과 같습니다:

- 여러 개의 `Class.BasePart|BaseParts`가 `Class.Model` 내에 그룹화되고 `Class.PVInstance:PivotTo()`를 사용하여 동시에 이동할 수 있습니다. [Models](/parts/models)를 참조하십시오.
- `Class.Decal`은 `Class.BasePart`의 면에 늘어난 이미지 텍스처를 적용하고, `Class.Texture`는 면에 타일 형태의 이미지 텍스처를 적용합니다. [Textures and Decals](/parts/textures-decals)를 참조하십시오.
- `Class.SurfaceGui`는 part의 면에 `Class.GuiObject|GuiObjects`를 렌더링합니다. [In-Experience UI Containers](/ui/in-experience-containers)를 참조하십시오.
- `Class.Attachment|Attachments`는 `Class.BasePart`에 추가되어 part에 대해 상대적인 `Datatype.CFrame|CFrames`를 지정할 수 있습니다. 이러한 Attachments는 [Mechanical Constraints](/physics/mechanical-constraints)와 [Mover Constraints](/physics/mover-constraints)에서 설명된 물리적 `Class.Constraint` 객체에서 자주 사용됩니다.
- `Class.ParticleEmitter` 객체는 그들이 부모로 설정된 `Class.BasePart`의 부피 내에서 균일하게 입자를 방출합니다. [Particle Emitters](/effects/particle-emitters)를 참조하십시오.
- `Class.PointLight`와 같은 빛 객체는 [Light Sources](/effects/light-sources)에서 설명된 대로 `Class.BasePart`의 중심에서 빛을 방출합니다.
- `Class.Tool`에 부모로 설정되고 이름이 **Handle**이 주어지면, `Class.BasePart`는 캐릭터에 의해 잡힐 수 있습니다. [In-Experience Tools](/players/tools)를 참조하십시오.


다른 부품이 다른 객체와 접촉할 때 발생합니다. 이 이벤트는 두 부분이 충돌하였음을 알리는 클라이언트에게 데이터만 보냅니다. 반면, `Class.BasePart.Touched`는 서버에 데이터를 보냅니다.


BasePart.LocalSimulationTouched

part

물체의 외관이 `Class.Shirt` 클래스에 의해 영향을 받을 경우 발생합니다.


BasePart.OutfitChanged

BasePart.StoppedTouching

otherPart

이 코드 샘플은 부품에 BillboardGui를 생성하여 현재 접촉하고 있는 부품의 수를 표시합니다.

`Class.BasePart.Touched`의 유사한 조건에서 다른 물체와의 접촉을 중지할 때 발생합니다.

이 이벤트는 `Class.Workspace.TouchesUseCollisionGroups`와 결합하여 [충돌 그룹](/workspace/collisions#collision-filtering)이 탐지에 대해 인정되는지 여부를 지정합니다.


BasePart.TouchEnded

물체가 물리적 이동으로 인해 다른 물체와의 접촉을 중지할 때 발생합니다.


이 코드 샘플은 `Class.Model`의 여러 파트의 `Class.BasePart.Touched` 이벤트를 하나의 함수에 연결하는 방법을 보여줍니다.

물체가 다른 물체와 접촉할 때 **Touched** 이벤트가 발생합니다. 예를 들어, **PartA**가 **PartB**에 부딪히면 `Class.BasePart.Touched|PartA.Touched`는 **PartB**와 함께 발생하고, `Class.BasePart.Touched|PartB.Touched`는 **PartA**와 함께 발생합니다.

이 이벤트는 물리적 이동의 결과로만 발생하므로, `Class.BasePart.CFrame|CFrame` 속성의 변경으로 서로 겹치게 될 때는 발생하지 않습니다. 이는 관련된 물체 중 적어도 하나가 충돌 시간에 `Class.BasePart.Anchored|Anchored`가 아니어야 함을 의미합니다.

이 이벤트는 `Class.Workspace.TouchesUseCollisionGroups`와 결합하여 [충돌 그룹](/workspace/collisions#collision-filtering)이 탐지에 대해 인정되는지 여부를 지정합니다.


BasePart.Touched

주어진 물체와 접촉한 다른 물체입니다.


물체가 물리적 이동으로 인해 다른 물체와 접촉할 때 발생합니다.


BasePart:AngularAccelerationToTorque

angAcceleration

angVelocity

각운동량의 즉각적인 힘 임펄스를 이 부품의 조립체에 적용하여 조립체가 회전하도록 합니다.

임펄스에서 유도된 결과 각속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 움직이기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 폭발이나 충돌과 같이 힘을 즉시 적용하고 싶을 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출되어야 합니다 (그것은 `Class.LocalScript`나
`Class.Script`에서 `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 경우에서 호출될 수 없습니다).
부품이 **자동** 소유권을 통해 클라이언트에 의해 소유된 경우, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있으며, 서버 소유 부품에 대해 클라이언트 스크립트에서 호출하면 효과가 없습니다.


BasePart:ApplyAngularImpulse

impulse

조립체에 적용될 각운동량 벡터입니다.


조립체에 각운동량 임펄스를 적용합니다.


이 함수는 이 부품의 조립체에 즉각적인 힘 임펄스를 적용합니다.

힘은 조립체의 `Class.BasePart.AssemblyCenterOfMass|center of mass`에서 적용되므로 결과로 얻는 움직임은 오직 선형입니다.

임펄스에서 유도된 결과 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 움직이기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 폭발이나 충돌과 같이 힘을 즉시 적용하고 싶을 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출되어야 합니다 (그것은 `Class.LocalScript`나
`Class.Script`의 경우, `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 경우에서 호출될 수 없습니다).
부품이 **자동** 소유권을 통해 클라이언트에 의해 소유된 경우, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있으며, 서버 소유 부품에 대해 클라이언트 스크립트에서 호출하면 효과가 없습니다.


BasePart:ApplyImpulse

조립체에 적용될 선형 임펄스 벡터입니다.


조립체의 `Class.BasePart.AssemblyCenterOfMass|center of mass` 위치에서 임펄스를 적용합니다.


이 함수는 이 부품의 조립체에 지정된 세계 공간 위치에서 즉각적인 힘 임펄스를 적용합니다.

위치가 조립체의 `Class.BasePart.AssemblyCenterOfMass|center of mass`가 아닐 경우, 임펄스는 위치적 운동과 회전 운동을 유발합니다.

임펄스에서 유도된 결과 속도는 조립체의 `Class.BasePart.AssemblyMass|mass`에 의존합니다. 따라서 더 무거운 조립체를 움직이기 위해서는 더 높은 임펄스가 필요합니다. 임펄스는 폭발이나 충돌과 같이 개발자들이 힘을 즉시 적용하고 싶을 때 유용합니다.

부품이 [소유](/physics/network-ownership)된 경우, 이 함수는 서버 `Class.Script`에서 호출되어야 합니다 (그것은 `Class.LocalScript`나
`Class.Script`의 경우, `Class.BaseScript.RunContext|RunContext`가 `Enum.RunContext.Client`로 설정된 경우에서 호출될 수 없습니다).
부품이 **자동** 소유권을 통해 클라이언트에 의해 소유된 경우, 이 함수는 클라이언트 스크립트 **또는** 서버 스크립트에서 호출될 수 있으며, 서버 소유 부품에 대해 클라이언트 스크립트에서 호출하면 효과가 없습니다.


BasePart:ApplyImpulseAtPosition

조립체에 적용될 임펄스 벡터입니다.


position

임펄스를 적용할 위치 (세계 공간 내)입니다.


지정된 위치에서 조립체에 임펄스를 적용합니다.


인접한 부품과의 모든 표면 연결을 끊습니다. 여기에는 `Class.Weld` 및 다른 `Class.JointInstance`가 포함됩니다.


BasePart:BreakJoints

부품들이 서로 충돌할 수 있는지를 반환합니다. 이 함수는 두 부품의 충돌 그룹을 고려합니다. 주어진 부품이 BasePart가 아닐 경우 이 함수는 오류를 발생시킵니다.


BasePart:CanCollideWith

충돌 가능성을 확인할 특정 부품입니다.


부품들이 서로 충돌할 수 있는지 여부입니다.


부품들이 서로 충돌할 수 있는지를 반환합니다.


이 예시는 `Workspace`에 있는 _Part_라는 이름을 가진 첫 번째 `BasePart`의 네트워크 소유권을 설정할 수 있는지 여부를 확인합니다.

CanSetNetworkOwnership 함수는 부품의 네트워크 소유권을 설정할 수 있는지를 확인합니다.

이 함수의 반환 값은 `Class.BasePart:SetNetworkOwner()` 또는 `Class.BasePart:SetNetworkOwnershipAuto()`를 오류 없이 호출할 수 있는지를 검증합니다.
소유권을 수정/읽을 수 있으면 true를 반환하며, 그렇지 않으면 false와 그 이유를 문자열로 반환합니다.


BasePart:CanSetNetworkOwnership

네트워크 소유권을 수정하거나 읽을 수 있는지 여부 및 그 이유입니다.


부품의 네트워크 소유권 설정 가능성을 확인합니다.


BasePart:GetClosestPointOnSurface

어떤 종류의 강체 연결로 객체와 연결된 부품의 테이블을 반환합니다.

`recursive`가 true일 경우 이 함수는 BasePart와 강체로 연결된 모든 부품을 반환합니다.

#### 강체 연결

두 부품을 연결하는 조인트가 `(Part0 → Part1)` 일 때, `Part1`의 물리는 `Part0`에 의해 완전히 고정되어 있을 경우,
이 조인트는 **강체**입니다. 이는 다음 조인트 유형에만 적용됩니다:

- `Class.Weld`
- `Class.Snap`
- `Class.ManualWeld`
- `Class.Motor`
- `Class.Motor6D`
- `Class.WeldConstraint`


BasePart:GetConnectedParts

recursive

어떤 종류의 `Class.JointInstance|joint`로 객체와 연결된 부품의 테이블입니다.


어떤 종류의 강체 연결로 객체와 연결된 부품의 테이블을 반환합니다.


이 파트에 연결된 모든 접합 또는 제약을 반환합니다.


BasePart:GetJoints

Part에 연결된 모든 접합 또는 제약의 배열입니다.


이 예제는 게임의 Workspace에 새로운 부품 myPart를 생성합니다. 크기는 4x6x4 스터드입니다. 부품은 고정되어 있습니다.

그 다음, myMass는 새로운 부품의 질량과 같도록 설정됩니다. 부품의 질량은 프린트 문장의 마지막에 출력됩니다:

> 내 부품의 질량은 ...

**GetMass**는 읽기 전용 `Class.BasePart.Mass|Mass` 속성의 값을 반환합니다.

이 함수는 Mass 속성보다 먼저 존재했습니다. 역호환성을 위해 여전히 지원되며, 직접 Mass 속성을 사용해야 합니다.


BasePart:GetMass

`Class.BasePart.Mass|Mass` 속성의 값을 반환합니다.


현재 네트워크 소유자가 누구인지 반환합니다. 서버인 경우 `nil`을 반환합니다.


BasePart:GetNetworkOwner

현재 네트워크 소유자의 플레이어 또는 서버인 경우 `nil`입니다.


게임 엔진이 이 부품의 네트워크 소유자를 자동으로 결정하는지 여부를 반환합니다.


BasePart:GetNetworkOwnershipAuto

게임 엔진이 이 부품의 네트워크 소유자를 자동으로 결정하는지 여부입니다.


BasePart:GetNoCollisionConstraints

이 함수는 Roblox의 부분 온라인에서 지연 보상 보간이 내부에서 관련이 있었을 때 유용했습니다. 보간은 현재
`Datatype.CFrame`에 직접 적용됩니다.


BasePart:GetRenderCFrame

구식입니다. 부품이 렌더링되는 위치를 설명하는 CFrame을 반환합니다.


부품 조립체의 기본 부품을 반환합니다. `Datatype.CFrame`를 사용하여 부품 조립체를 이동할 때, 이 기본 부품을 이동하는 것이 중요합니다 (이렇게 하면 그에 연결된 모든 다른 부품도 적절히 이동합니다).
자세한 정보는 [조립체](/physics/assemblies) 기사에서 확인할 수 있습니다.

이 함수는 `Class.BasePart.AssemblyRootPart|AssemblyRootPart` 속성보다 먼저 존재했습니다. 역호환성을 위해 여전히 지원되지만,
`Class.BasePart.AssemblyRootPart|AssemblyRootPart` 속성을 직접 사용하는 것이 좋습니다.


BasePart:GetRootPart

조립체의 기본 부품 (서로 연결된 부품의 집합)입니다.


부품 조립체의 기본 부품을 반환합니다.


이 부품과 물리적으로 상호작용하는 모든 부품의 테이블을 반환합니다. 부품 자체의 CanCollide가 false로 설정된 경우,
이 함수는 비어 있는 테이블을 반환합니다. 단, 부품에 `Class.TouchTransmitter|TouchInterest` 객체가 부모로 연결된 경우,
여기에는 그 부품의 Touched 이벤트에 연결된 무언가가 있습니다. 인접하지만 교차하지 않는 부품은 접촉하는 것으로 간주되지 않습니다. 이 함수는
더 큰 유연성을 제공하고 위에서 설명한 특별한 `Class.TouchTransmitter|TouchInterest` 규칙을 피하기 위해 `Class.WorldRoot:GetPartsInPart()` 함수보다 먼저 존재했습니다.
대신 `Class.WorldRoot:GetPartsInPart()`를 사용하세요.


BasePart:GetTouchingParts

이 부품과 교차하고 충돌할 수 있는 모든 부품의 테이블입니다.


이 부품과 교차하는 모든 `Class.BasePart.CanCollide`가 true인 부품의 테이블을 반환합니다.


이 부품에 대해 주어진 위치에서 조립체의 선형 속도를 반환합니다. 이는 루트 부품 이외의 조립체의 부품의 선형 속도를 식별하는 데 사용할 수 있습니다.
조립체에 각속성이 없으면 모든 위치에서 선형 속도는 항상 동일합니다.


BasePart:GetVelocityAtPosition

이 부품에 대해 주어진 위치에서 조립체의 선형 속도를 반환합니다.


부품과 주어진 배열의 다른 부품들의 교차하는 기하로부터 새 `Class.IntersectOperation`을 생성합니다. 오직 `Class.Part|Parts`만 지원되며,
`Class.Terrain`이나 `Class.MeshPart|MeshParts`는 지원되지 않습니다. `Class.Instance:Clone()|Clone()`과 유사하게, 반환된 객체는 설정된 `Class.Instance.Parent|Parent`가 없습니다.

부르는 부품의 다음 속성이 생성된 `Class.IntersectOperation`에 적용됩니다:

- `Class.BasePart.Color|Color`, `Class.BasePart.Material|Material`, `Class.BasePart.MaterialVariant|MaterialVariant`,
  `Class.BasePart.Reflectance|Reflectance`, `Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`, `Class.BasePart.Density|Density`, `Class.BasePart.Elasticity|Elasticity`,
  `Class.BasePart.ElasticityWeight|ElasticityWeight`, `Class.BasePart.Friction|Friction`, `Class.BasePart.FrictionWeight|FrictionWeight`

아래의 이미지 비교에서,
`Class.BasePart:IntersectAsync()|IntersectAsync()`는 파란 블록을 포함하는 테이블을 사용하여 보라색 블록에서 호출됩니다.
생성된 `Class.IntersectOperation`은 두 부품의 교차하는 기하의 형태로 되어 있습니다.

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Intersect.jpg"
width="720" alt="두 블록 부품이 겹친 모습" />
<figcaption>분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Intersect-Result.jpg"
width="720" alt="부품이 서로 겹쳐져 새 고형 모델로 합쳐진 모습" />
<figcaption>결과 <code>Class.IntersectOperation</code></figcaption>
</figure>

#### 주의사항

- 성공적인 교차 작업 후, 원래 부품은 그대로 유지됩니다. 대부분의 경우, 모든 원래 부품을 `Class.Instance.Destroy|Destroy()`로 파괴하고
  반환된 `Class.IntersectOperation`을 부르는 `Class.BasePart`와 같은 위치에 부모로 설정하는 것이 좋습니다.
- 기본적으로, 생성된 교차의 면 색상은 원래 부품의 `Class.BasePart.Color|Color` 속성에서 가져옵니다. 전체 교차를 특정 색상으로 변경하려면,
  `Class.PartOperation.UsePartColor|UsePartColor` 속성을 true로 설정하십시오.
- 교차 작업으로 20,000개 이상의 삼각형을 가진 부품이 생성되면, 그것은 20,000개의 삼각형으로 단순화됩니다.


BasePart:IntersectAsync

parts

교차 작업에 참여하는 객체들입니다.


collisionfidelity

결과 `Class.IntersectOperation`의 `Enum.CollisionFidelity` 값입니다.


renderFidelity

결과 `Class.PartOperation`의 `Enum.RenderFidelity` 값입니다.


기본 이름 **Intersect**로 결과 `Class.IntersectOperation`입니다.


부품과 주어진 배열의 다른 부품들의 겹치는 기하로부터 새 `Class.IntersectOperation`을 생성합니다.


물체가 제자리에 고정할 부분에 연결되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. `Class.BasePart.Anchored|Anchored` 부분이 있는 조립체에서 모든 다른 부분은 고정되어 있습니다.


BasePart:IsGrounded

물체가 제자리에 고정할 부분에 연결되어 있는지 여부입니다.


물체가 제자리에 고정할 부분에 연결되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.


조인트를 만들 수 있는 `Class.BasePart|Part`의 어느 쪽에서 조인트를 만들며, 인접한 부분과 조인트를 만듭니다.

조인트는 면의 표면에 따라 해당 면의 접촉하는 평면 사이에 만들어질 것입니다.

- 매끄러운 표면은 조인트를 생성하지 않습니다.
- 접착 표면은 `Class.Glue` 조인트를 생성합니다.
- 용접은 Unjoinable을 제외한 모든 표면과 함께 `Class.Weld` 조인트를 생성합니다.
- 스터드, 인렛, 또는 유니버설은 각각 다른 두 표면(예: 스터드와 인렛, 유니버설)과 `Class.Snap` 조인트를 생성합니다.
- 힌지와 모터 표면은 `Class.Rotate` 및 `Class.RotateV` 조인트 인스턴스를 생성합니다.

`Class.Model:MakeJoints()`와는 달리, 이 함수는 매개변수로 부분 배열을 요구합니다. 이 배열은 다음과 같이 주어집니다:

```
part:MakeJoints({part1, part2, part3})
```
충분한 힘이 가해지면 조인트가 파손됩니다.`Class.Explosion`에 의한 것이며, `Class.ForceField` 객체가 `Class.BasePart` 또는 조상 `Class.Model`에 부모로 설정되지 않는 한 가능합니다. 이로 인해 종종 간단한 파괴 가능한 건물 및 기타 모델을 만드는 데 사용됩니다.


BasePart:MakeJoints

조인트를 만들 수 있는 표면 ID가 있는 물체의 어느 쪽에서 조인트를 만듭니다.


스튜디오 크기 조정 도구를 사용하는 것처럼 물체의 크기를 변경합니다.


BasePart:Resize

normalId

deltaAmount

지정된 면에서 얼마나 늘리거나 줄일 것인지입니다.


부품이 크기가 조정되었는지 여부입니다.


주어진 플레이어를 이 및 모든 연결된 부분의 네트워크 소유자로 설정합니다. playerInstance가 `nil`인 경우 서버가 플레이어 대신 소유자가 됩니다.


BasePart:SetNetworkOwner

playerInstance

부품의 네트워크 소유권을 부여받는 플레이어입니다.


주어진 플레이어를 이 및 모든 연결된 부분의 네트워크 소유자로 설정합니다.


게임 엔진이 물체의 물리학을 처리할 클라이언트 중 한 명 또는 서버를 동적으로 결정하도록 합니다.


BasePart:SetNetworkOwnershipAuto

이 예제는 `Class.BasePart`에서 다른 파트(들)를 빼서 부정된 `Class.UnionOperation`을 형성하는 방법을 보여줍니다.

주어진 배열에 있는 부분이 차지하는 기하학을 제외하고 사용하여 부분에서 새로운 `Class.UnionOperation`를 생성합니다. `Class.Part|Parts`만 지원됩니다. `Class.Terrain`이나 `Class.MeshPart|MeshParts`는 지원되지 않습니다. `Class.Instance:Clone()|Clone()`과 유사하게, 반환된 객체에는 설정된 `Class.Instance.Parent|Parent`가 없습니다.

뺄셈으로 인해 결과 조합이 비어 있을 수 없습니다. 전체적으로 비어 있는 기하학이 결과로 나오면 실패합니다.

다음 이미지 비교에서,
`Class.BasePart:SubtractAsync()|SubtractAsync()`가 파란 실린더에서 보라색 블록이 포함된 테이블을 사용하여 호출됩니다. 결과 `Class.UnionOperation`은 실린더의 기하학에서 블록의 기하학을 생략합니다.

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Subtract.jpg"
width="720" alt="긴 블록이 실린더와 겹침" />
<figcaption>분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Negate-Result.jpg" width="720"
alt="실린더에서 빼낸 블록 부분" />
<figcaption>결과 <code>Class.UnionOperation</code></figcaption>
</figure>


BasePart:SubtractAsync

결과 `Class.UnionOperation`의 `Enum.CollisionFidelity` 값입니다.


기본 이름 **Union**의 결과 `Class.UnionOperation`입니다.


주어진 배열에 있는 부분이 차지하는 기하학을 제외하고 사용하여 부분에서 새로운 `Class.UnionOperation`를 생성합니다.


BasePart:TorqueToAngularAcceleration

torque

이 예제에서는 `Class.BasePart`의 기하학과 다른 부품의 기하학을 결합하여 `Class.UnionOperation`을 형성하는 방법을 보여줍니다.

주어진 배열에 있는 부분이 차지하는 기하학을 추가하여 부분에서 새로운 `Class.UnionOperation`을 생성합니다. `Class.Part|Parts`만 지원되며, `Class.Terrain`이나 `Class.MeshPart|MeshParts`는 지원되지 않습니다. `Class.Instance:Clone()|Clone()`과 유사하게, 반환된 객체에는 설정된 `Class.Instance.Parent|Parent`가 없습니다.

다음 속성이 호출한 부분에서 결과 `Class.UnionOperation`에 적용됩니다:

- `Class.BasePart.Color|Color`, `Class.BasePart.Material|Material`,
  `Class.BasePart.MaterialVariant|MaterialVariant`,
  `Class.BasePart.Reflectance|Reflectance`,
  `Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`, `Class.BasePart.Density|Density`,
  `Class.BasePart.Elasticity|Elasticity`,
  `Class.BasePart.ElasticityWeight|ElasticityWeight`,
  `Class.BasePart.Friction|Friction`,
  `Class.BasePart.FrictionWeight|FrictionWeight`

다음 이미지 비교에서,
`Class.BasePart:UnionAsync()|UnionAsync()`가 파란 블록에서 보라색 실린더가 포함된 테이블을 사용하여 호출됩니다. 결과 `Class.UnionOperation`은 두 부분의 기하학을 결합한 형태가 됩니다.

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Union.jpg"
width="720" alt="블록과 실린더 부품이 겹쳐 있음" />
<figcaption>분리된 부품</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Union-Result.jpg" width="720"
alt="하나의 단일 고체 결합으로 결합된 부품" />
<figcaption>결과 <code>Class.UnionOperation</code></figcaption>
</figure>

#### 노트

- 원래의 부분은 성공적인 합병 작업 후에도 intact 합니다.
  대부분의 경우, 결과 `Class.UnionOperation`을 호출하는 `Class.BasePart`와 같은 곳에 두려면 이전의 모든 원래 부품을 `Class.Instance.Destroy|Destroy()`해야 합니다.
- 기본적으로 결과 유니온은 각 파트의 `Class.BasePart.Color|Color` 속성을 존중합니다. 전체 조합을 특정 색상으로 변경하려면 `Class.PartOperation.UsePartColor|UsePartColor` 속성을 `true`로 설정합니다.
- 조합 작업이 20,000 삼각형 이상의 부품을 결과로 내면 20,000 삼각형으로 단순화됩니다.


BasePart:UnionAsync

호출하는 부분과 함께 유니온에 참여하는 객체입니다.


주어진 배열에 있는 부분이 차지하는 기하학을 추가하여 부분에서 새로운 `Class.UnionOperation`을 생성합니다.


BasePart:breakJoints

BasePart:getMass

BasePart:makeJoints

BasePart:resize

BasePart

이 코드 샘플은 부품을 클릭하여 고정 속성을 전환할 수 있도록 합니다. 전환할 때 부품의 시각적 외관이 업데이트됩니다 (빨간색은 고정됨, 노란색은 자유).

`Anchored` 속성은 part가 물리학에 의해 이동 불가능한지를 결정합니다. 활성화되면 part는 중력, 다른 part와의 충돌, 다른 parts와의 겹침 또는 기타 물리 관련 원인으로 인해 위치가 변하지 않습니다. 따라서 두 개의 고정된 parts는 서로에 대해 `Class.BasePart.Touched|Touched` 이벤트를 발생시키지 않습니다.

고정된 part는 `Class.BasePart.CFrame|CFrame` 또는 `Class.BasePart.Position|Position`을 변경하여 여전히 이동할 수 있으며, 여전히 0이 아닌 `Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity` 및 `Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`를 가질 수 있습니다.

마지막으로, 고정되지 않은 part가 `Class.Weld`와 같은 객체를 통해 고정된 part와 결합되면, 그 또한 고정된 것처럼 행동할 수 있습니다. 이러한 조인이 끊어지면 해당 part는 다시 물리적 영향을 받을 수 있습니다. 자세한 사항은 [Assemblies](/physics/assemblies)를 참조하십시오.

고정된 parts에 대한 네트워크 소유권은 설정할 수 없습니다. 서버에서 part의 고정 상태가 변경되면 해당 part의 네트워크 소유권도 영향을 받습니다.


BasePart.Anchored

part가 물리학적 법칙에 의해 이동 불가능한지 여부를 결정합니다.


이 part의 조립체의 각속도 벡터입니다. 이는 초당 라디안으로 방향 변화의 비율입니다.

각속도는 조립체의 모든 지점에서 동일합니다.

속도를 직접 설정하면 비현실적인 움직임이 발생할 수 있습니다. `Class.Torque` 또는 `Class.AngularVelocity` 제약 조건을 사용하는 것이 선호되며, 순간적인 속도 변화를 원할 경우 `Class.BasePart:ApplyAngularImpulse()|ApplyAngularImpulse()`를 사용하십시오.

part가 서버에 의해 [owned](/physics/network-ownership)되는 경우, 이 속성은 서버 `Class.Script`에서 변경되어야 하며(`Class.LocalScript` 또는 `Class.Script`에서 `Class.BaseScript.RunContext|RunContext` 설정이 `Enum.RunContext.Client`으로 되어서는 안 됨). 클라이언트가 **자동** 소유권을 통해 owned 되면 이 속성은 클라이언트 스크립트 **또는** 서버 스크립트에서 변경할 수 있으며; 서버 소유 part에 대한 클라이언트 스크립트에서 이를 변경하면 효과가 없습니다.


BasePart.AssemblyAngularVelocity

part의 조립체의 각속도입니다.


조립체 내의 모든 parts의 `Class.BasePart.Mass|Mass` 및 `Class.BasePart.Position|Position`에 의해 계산된 위치입니다.

만약 조립체에 고정된 part가 있다면, 그 part의 질량 중심은 조립체의 질량 중심이 되며 조립체는 무한한 질량을 갖게 됩니다.

질량 중심을 아는 것은 조립체의 안정성을 유지하는 데 도움이 될 수 있습니다. 질량 중심에 작용하는 힘은 각가속도를 발생시키지 않고 선형적으로만 발생시킵니다. 질량 중심이 낮은 조립체가 중력에 의해 똑바로 서 있는 시간이 더 길어집니다.


BasePart.AssemblyCenterOfMass

part의 조립체의 질량 중심입니다.


이 part의 조립체의 선형 속도 벡터입니다. 이는 `Class.BasePart.AssemblyCenterOfMass|AssemblyCenterOfMass`의 위치 변화 비율을 나타냅니다.

조립체의 질량 중심이 아닌 지점에서의 속도를 알고 싶다면 `Class.BasePart:GetVelocityAtPosition()|GetVelocityAtPosition()`을 사용하십시오.

속도를 직접 설정하면 비현실적인 움직임이 발생할 수 있습니다. `Class.VectorForce` 제약 조건을 사용하는 것이 선호되며, 순간적인 속도 변화를 원할 경우 `Class.BasePart:ApplyImpulse()|ApplyImpulse()`를 사용하십시오.

part가 서버에 의해 [owned](/physics/network-ownership)되는 경우, 이 속성은 서버 `Class.Script`에서 변경되어야 하며(`Class.LocalScript` 또는 `Class.Script`에서 `Class.BaseScript.RunContext|RunContext` 설정이 `Enum.RunContext.Client`으로 되어서는 안 됨). 클라이언트가 **자동** 소유권을 통해 owned 되면 이 속성은 클라이언트 스크립트 **또는** 서버 스크립트에서 변경할 수 있으며; 서버 소유 part에 대한 클라이언트 스크립트에서 이를 변경하면 효과가 없습니다.


BasePart.AssemblyLinearVelocity

part의 조립체의 선형 속도입니다.


이 part의 조립체 내 모든 `Class.BasePart|BaseParts`의 질량 합계입니다. `Class.BasePart.Massless|Massless`인 parts 및 조립체의 루트 part가 아닌 부분은 `AssemblyMass`에 기여하지 않습니다.

조립체에 고정된 part가 있는 경우, 조립체의 질량은 무한한 것으로 간주됩니다. 고정되지 않은 조립체 간에 질량 차이가 클 경우, 제약 조건 및 기타 물리적 상호작용이 불안정성을 초래할 수 있습니다.


BasePart.AssemblyMass

part의 조립체의 총 질량입니다.


이 속성은 조립체의 루트 part로 자동 선택된 `Class.BasePart`를 나타냅니다. part가 `Class.Workspace`에 부모로 설정되지 않는 경우, 이 속성은 `nil`입니다.

조립체 내의 parts의 `Class.BasePart.RootPriority|RootPriority`를 변경하여 루트 part를 변경할 수 있습니다.

모두 같은 `AssemblyRootPart`를 공유하는 parts는 같은 조립체에 속합니다.

루트 parts에 대한 더 많은 정보는 [Assemblies](/physics/assemblies)를 참조하십시오.


BasePart.AssemblyRootPart

조립체의 루트 part에 대한 참조입니다.


`AudioCanCollide`는 part가 조명에 대한 `Class.BasePart.CastShadow|CastShadow`와 유사하게 오디오 시뮬레이션과 물리적으로 상호작용하는지를 결정합니다.

비활성화되면, 오디오는 part를 통과하며 차단하거나 반사되지 않습니다.


BasePart.AudioCanCollide

part가 조명과 유사하게 오디오 시뮬레이션과 물리적으로 상호작용하는지 여부를 결정합니다.


이 코드 샘플은 NormalId(위쪽, 앞쪽 등)만 사용하여 표면 속성을 설정하는 방법을 보여줍니다. 모터의 -SurfaceInput을 NoInput, Constant 및 Sin으로 전환하여 각각이 -ParamA 및 -ParamB 속성을 사용하여 어떻게 작동하는지 보여줍니다.

`BackParamA` 속성은 part의 `Class.BasePart.BackSurface`가 Motor 또는 SteppingMotor로 설정되고 `Class.BasePart.BackSurfaceInput`이 Sin으로 설정될 때 관련이 있습니다. 이는 모터의 회전 속도의 **진폭**을 결정합니다.


BasePart.BackParamA

part의 뒷면의 SurfaceType에 대한 첫 번째 매개변수를 결정합니다.


`BackParamB` 속성은 part의 `Class.BasePart.BackSurface`가 Motor 또는 SteppingMotor로 설정되고 `Class.BasePart.BackSurfaceInput`이 Constant 또는 Sin으로 설정될 때 관련이 있습니다. Constant의 경우, 이는 모터의 일정한 회전 속도를 결정합니다. Sin의 경우, 이는 모터의 회전 속도의 **주파수**를 결정합니다.


BasePart.BackParamB

part의 뒷면의 SurfaceType에 대한 두 번째 매개변수를 결정합니다.


`BackSurface` 속성은 part의 양의 **Z** 방향에 사용되는 표면 유형을 결정합니다. 두 parts의 면이 서로 가까이 배치되면, 이들은 서로 간의 조인트를 생성할 수 있습니다.


BasePart.BackSurface

part의 뒷면의 표면 유형을 결정합니다.


`BackSurfaceInput` 속성은 part의 `Class.BasePart.BackSurface`에 제공되는 입력 유형을 결정합니다. 이는 Motor 또는 SteppingMotor SurfaceTypes에만 관련이 있습니다. 이 속성은 `Class.BasePart.BackParamA` 및 `Class.BasePart.BackParamB`가 어떻게 사용되는지를 결정합니다. 간단하게 ParamA 및 ParamB로 언급하도록 하겠습니다.

- 기본값은 NoInput로 설정됩니다. 이는 모터를 완전히 정지시킵니다.
- Constant의 경우, 모터는 `ParamB`와 동일한 일정한 속도로 회전합니다.
- Sin의 경우, 모터는 `ParamA * math.sin(workspace.DistributedGameTime * ParamB)`와 같은 속도로 회전합니다. `Class.Workspace.DistributedGameTime`을 참조하십시오.


BasePart.BackSurfaceInput

part의 뒷면의 입력 유형을 결정합니다.


part의 `Class.BasePart.BottomSurface`가 Motor 또는 SteppingMotor로 설정되고 `Class.BasePart.BottomSurfaceInput`이 Sin으로 설정될 때 관련이 있습니다. 이는 모터의 회전 속도의 **진폭**을 결정합니다.


BasePart.BottomParamA

part의 바닥면의 SurfaceType에 대한 첫 번째 매개변수를 결정합니다.


물리적으로 상호작용하는 월드 내 객체들의 추상 기본 클래스입니다.


/reference/engine/classes/SpawnLocation.yaml