HopperBins는 플레이어가 사용할 수 있는 도구를 생성하기 위한 오래된 시스템입니다. HopperBins 대신 `Class.Tool`을 사용하시기 바랍니다.

역사적으로, `Class.Part`인 'Handle' 없이 작동할 수 있는 것은 오직 HopperBins뿐이었으나, 이제는 도구의 `Class.Tool.RequiresHandle` 속성 덕분에 더 이상 그렇지 않습니다.


HopperBin.Deselected

HopperBin.Selected

mouse

HopperBin

HopperBin.Active

HopperBin.BinType

BackpackItem은 HopperBins 및 도구와 같은 배낭 아이템을 위한 추상 클래스입니다.


BackpackItem

플레이어의 배낭에 있는 도구에 대해 표시되는 텍스처 아이콘입니다.

이 속성은 Roblox 웹사이트에 업로드된 이미지의 콘텐츠 ID로 설정해야 합니다.
이 속성은 자산 URI만 지원합니다.

이 속성이 비워져 있으면 `Class.Backpack` GUI는 도구의 이름을 대신 표시합니다.


BackpackItem.TextureContent

플레이어의 배낭에 있는 도구에 대해 표시되는 텍스처 아이콘입니다.
자산 URI만 지원합니다.


플레이어의 배낭에 있는 도구에 대해 표시되는 텍스처 아이콘입니다.

이 속성은 Roblox 웹사이트에 업로드된 이미지의 콘텐츠 ID로 설정해야 합니다.

이 속성이 비워져 있으면 `Class.Backpack` GUI는 도구의 이름을 대신 표시합니다.


BackpackItem.TextureId

플레이어의 배낭에 있는 도구에 대해 표시되는 텍스처 아이콘입니다.


다음 샘플은 객체 테이블을 받아들이고
새 모델에 부모로 설정하여 해당 모델을 반환하는 기본 함수를 포함합니다.


모델은 컨테이너 객체로, 객체를 함께 그룹화합니다. 이들은
`Class.BasePart|BaseParts`의 컬렉션을 보유하는 데 가장 적합하며,
기능을 확장하는 여러 함수를 가지고 있습니다.

모델은 **기하학적** 그룹화를 나타내기 위해 설계되었습니다. 만약
당신의 그룹화가 기하학적 해석이 없다면, 예를 들어
`Class.Script|Scripts`의 컬렉션이 있다면, 대신 `Class.Folder`를 사용하세요.

부품이 조인트로 연결된 모델(그래서 물리 시뮬레이션을 통해
움직이거나 파괴될 수 있는 경우)은 일반적으로
`Class.Model.PrimaryPart|PrimaryPart`가 설정되어 있어야 하며,
이는 모델이 이동할 때 피벗과 경계 상자가 "따르는" 부품을 지정합니다. 한 곳에
머무는 정적 모델은 기본 부품이 설정되어 있어도 이점을 얻지 못합니다.

모델은 Roblox 플레이어 캐릭터를 포함하여 다양한 용도로 사용됩니다.
또한, 다음과 같은 몇 가지 고유한 동작이 있으므로 유의해야 합니다:

- `Class.Humanoid`와 **Head**라는 이름의 `Class.Part`가 모델 아래에
  부모로 설정되면, 모델 위에 이름/건강 GUI가 나타납니다; 자세한 내용은
  [캐릭터 이름/건강 표시](/characters/name-health-display)를 참조하세요.
- 부품의 **Y** 축 위치가
  `Class.Workspace.FallenPartsDestroyHeight` 값에 도달하면,
  `Class.Model` 내부의 마지막 객체였던 경우 모델도 파괴됩니다.
- `Class.Workspace.StreamingEnabled`가 true로 설정된 장소에서 사용될 때,
  `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.Model.ModelStreamingMode|ModelStreamingMode`는
`Enum.ModelStreamingMode|PersistentPerPlayer`로 설정되어야 하며,
추가의 결과로 동작이 변경됩니다.


이 샘플에서는 모든 플레이어 캐릭터 모델의 관절이 스폰된 후 3초 뒤에 부서집니다.
이 관절을 부수면 휴머노이드가 죽게 됩니다.

이 코드 샘플은 스크립트의 형제인 두 개의 파트(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.Model:GetBoundingBox()`를 보여줍니다.


이 함수는 `Class.Model` 내의 모든 `Class.BasePart` 자식들을 포함하는 볼륨에 대한 설명을 반환합니다.
볼륨의 방향은 `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`입니다.


Model:GetBoundingBox

볼륨의 방향을 나타내는 `Datatype.CFrame`과 볼륨의 크기를 나타내는
`Datatype.Vector3`입니다.


모델의 모든 부품을 포함하는 볼륨에 대한 설명을 반환합니다.


아래의 코드 샘플은 Model.GetExtentsSize를 사용하여 부품을 포함하는 경계 상자의 크기를 가져오는 방법을 보여줍니다.


모델의 모든 `Class.BasePart|BaseParts`를 포함하는 가장 작은 경계 상자의 크기를 반환합니다.
방향은 `Class.PVInstance.GetPivot|Pivot`의 방향과 일치합니다 -
`Class.Model.PrimaryPart|PrimaryPart`의 피벗(존재하는 경우) 또는
모델의 `Class.Model.WorldPivot|WorldPivot`입니다.

이 함수는 가장 작은 경계 상자의 크기만 반환하며,
개발자는 경계 상자의 위치를 얻기 위해 자신의 방법을 사용해야 합니다.


Model:GetExtentsSize

`Class.Model`의 `Datatype.Vector3` 크기입니다.


모델의 모든 `Class.BasePart|BaseParts`를 포함하는 가장 작은 경계 상자의 크기를 반환합니다.
`Class.Model.PrimaryPart`가 설정된 경우에는 그에 맞춰 정렬됩니다.


이 값은 역사적으로 모델의 중심 위치의 CFrame을 반환했습니다.


Model:GetModelCFrame

모델의 중심 위치를 나타내는 `Datatype.CFrame`입니다.


이 코드는 모델을 생성하고, 그 안에 일부 부품을 넣고, 무작위로 위치를 지정한 다음,
그 크기를 출력합니다:


GetModelSize 함수는 `Class.Model`의 `Datatype.Vector3` 크기를 반환합니다.


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에 생성되고, 루프가 시작되어
모델이 Y축을 중심으로 0.2초마다 10도 회전합니다.


이 함수는 `Class.PVInstance:GetPivot()`로 대체되었으며,
대체로 작동하며 코드의 동작을 변경하지 않습니다. 새로운 작업에는
`Class.PVInstance:GetPivot()`를 사용하고, 기존의
`Class.Model:GetPrimaryPartCFrame()` 호출을 편리할 때 마이그레이션하세요.

모델의 `Class.Model.PrimaryPart`의 `Datatype.CFrame`을 반환합니다.

이 함수는 다음과 같습니다.

    Model.PrimaryPart.CFrame

이 함수는 `Class.Model`에 기본 부품이 존재하지 않으면 오류를 발생시킵니다.
이 동작이 원하지 않는 경우, 개발자는 다음과 같이 할 수 있으며,
기본 부품이 없으면 `nil`과 같습니다.

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


Model:GetPrimaryPartCFrame

모델의 `Class.Model.PrimaryPart`의 `Datatype.CFrame`입니다.


모델의 `Class.Model.PrimaryPart`의 `Datatype.CFrame`을 반환합니다.
이 함수는 `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)`을 호출하면 원래 구성으로 _정확히_ 돌아갈 수 있음을 의미합니다.
부동 소수점 드리프트를 피하는 것이 스케일**To** 함수가 스케일**By** 함수 대신 존재하는 이유입니다.

스케일 팩터는 엔진 동작에 한 가지 방식으로 영향을 미칩니다: 모델의 스케일 팩터는
해당 모델 아래의 `Class.Animation|Animations`에서 재생되는 조인트 오프셋에 적용되므로,
애니메이션이 스케일되더라도 애니메이션 리그가 올바르게 재생됩니다.


Model:GetScale

모델의 현재 표준 스케일 팩터입니다.


모델의 표준 스케일을 반환합니다. 새로 생성된 모델의 경우 기본값은 1이며,
`Class.Model:ScaleTo()`를 통해 스케일이 변경됩니다.


이 코드 샘플은 Model:MakeJoints 함수를 사용하여 조인트를 만드는 방법을 보여줍니다.

모델이 인스턴스화되며, 두 개의 파트가 서로 겹쳐 있습니다. 위쪽 파트는
고정되어 있고 아래쪽 파트는 고정되어 있지 않습니다. 일반적으로, Workspace에
부모가 될 때 아래쪽 파트는 Baseplate로 떨어질 것입니다.

그러나 아래쪽 파트의 TopSurface 속성이 Enum.SurfaceType.Weld로 설정되어
있기 때문에, Model:MakeJoints가 실행될 때 이들 사이에 연결이 생성됩니다.

따라서 아래쪽 파트는 모델의 조인트가 파괴될 때까지 떨어지지 않습니다.
이것은 종종 Model:BreakJoints를 사용하여 수행되지만, 이 예제에서는
폭발을 사용하여 연결이 파괴됩니다.


이 코드 샘플은 스크립트의 형제인 두 개의 파트(PartA 및 PartB)에서 조인트를 생성하는 방법을 보여줍니다. 호환 가능한 표면 유형(Studs 및 Inlet)을 가진 두 개의 접촉하는 파트에서 MakeJoints를 사용합니다.


SurfaceType 기반 조인트 생성은 deprecated되었습니다. 새로운 프로젝트에는 MakeJoints를 사용하지 마세요.
대신 `Class.WeldConstraint|WeldConstraints` 및
`Class.HingeConstraint|HingeConstraints`를 사용하세요.

`Class.Model`의 모든 `Class.BasePart|Parts`를 순회하며,
지정된 부품과 평면 접촉 표면 간의 조인트를 생성합니다.

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

이 함수는 부품이 `Class.Workspace`의 자손이 아닐 경우 작동하지 않습니다.
따라서 MakeJoints를 사용하기 전에 모델이 Workspace에 부모로 설정되어 있는지 확인해야 합니다.


Model:MakeJoints

`Class.Model`의 모든 `Class.BasePart|BaseParts`를 순회합니다. 만약
어떤 부품의 면이 조인트를 만들 수 있는 SurfaceType을 가지고 있다면,
인접한 부품과 조인트를 생성합니다.


Model:makeJoints

Model:move

location

이 샘플은 `Class.Model:MoveTo()`가 충돌을 피하는 방법을 보여줍니다.

간단한 두 부분으로 이루어진 `Class.Model`이 생성되고, 그 `Class.Model.PrimaryPart`
가 설정됩니다. 큰 장애물 부분이 그 옆에 배치됩니다.

5초 후에 `Class.Model:MoveTo()`가 사용되어 모델이
장애물 부분 안으로 이동하도록 지시합니다. 그러나 MoveTo는 모델을
장애물 안으로 이동하지 않기 때문에 `Class.Model`은 Y축으로 위로 이동하여
장애물 위에 배치됩니다.


`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

`Class.Model`이 이동할 `Datatype.Vector3`입니다.


`Class.Model.PrimaryPart|PrimaryPart`를 주어진 위치로 이동합니다. 기본 부품이
지정되지 않은 경우 모델의 루트 부품이 사용됩니다.


Model:moveTo

지정된 플레이어에 대해 이 모델을 더 이상 지속적으로 설정하지 않습니다. 이는
모델이 플레이어에게 즉시 제거된다는 보장을 하지 않습니다; 이 메서드를 호출한 후,
모델은 해당 플레이어에 대해 `Enum.ModelStreamingMode|Atomic`으로 처리되며,
목표 스트리밍 반경 내에 있는 한 계속 존재합니다.

`Class.Model.ModelStreamingMode|ModelStreamingMode`는
`Enum.ModelStreamingMode|PersistentPerPlayer`로 설정되어야 하며,
제거의 결과로 동작이 변경됩니다.


Model:RemovePersistentPlayer

이 모델을 더 이상 지속적으로 만들 플레이어입니다.


지정된 플레이어에 대해 이 모델을 더 이상 지속적으로 설정하지 않습니다.
`Class.Model.ModelStreamingMode|ModelStreamingMode`는
`Enum.ModelStreamingMode|PersistentPerPlayer`로 설정되어야 하며,
제거의 결과로 동작이 변경됩니다.


모델의 부품 회전을 이전에 설정된 정체 회전으로 재설정합니다. 이는
`Class.Model:SetIdentityOrientation()` 메서드를 통해 수행됩니다.


Model:ResetOrientationToIdentity

모델은 지속적인 표준 스케일 팩터를 포함하며, 새로 생성된 모델의 경우 1로 시작합니다.
이 함수는 피벗 위치를 기준으로 모델을 스케일링합니다. 이를 달성하기 위해 두 가지 작업을 수행합니다:

- 모델의 현재 스케일 팩터를 지정된 값으로 설정합니다.
- 모든 자손 인스턴스를 그에 따라 크기 조정하고 재배치합니다.

위치의 스케일링은 피벗 위치를 기준으로 수행됩니다.

모든 자손 인스턴스의 "기하학적" 속성이 스케일링됩니다. 이는 부품의 크기를 포함하지만,
다음은 스케일링되는 속성의 몇 가지 다른 예입니다:

- `Class.WeldConstraint|WeldConstraints` 및 `Class.RopeConstraint`와 같은 조인트의 길이
- `Class.HingeConstraint`와 같은 물리적 속도 및 힘
- 입자 방출기 크기와 같은 시각적 속성
- `Class.Sound.RollOffMinDistance`와 같은 다른 길이 속성


Model:ScaleTo

newScaleFactor

모델의 새로운 스케일 팩터로, 양의 비제로 숫자여야 합니다. 1의 값은 모델의 원래 크기를 나타냅니다.


모델의 스케일 팩터를 설정하여 모든 자손 인스턴스의 크기와 위치를 조정합니다.
이들은 초기 크기와 위치에 대해 해당 스케일 팩터를 가집니다.


주어진 모델의 정체 회전을 설정하여 나중에 전체 모델의 회전을 재설정할 수 있도록 합니다.
`ResetOrientationToIdentity` 메서드를 통해 수행됩니다.


Model:SetIdentityOrientation

이 함수는 `Class.PVInstance:PivotTo()`로 대체되었으며,
더욱 성능이 향상된 대체로 작동하며 코드의 동작을 변경하지 않습니다. 새로운 작업에는
`Class.PVInstance:PivotTo()`를 사용하고, 기존의
`Class.Model:SetPrimaryPartCFrame()` 호출을 편리할 때 마이그레이션하세요.

모델의 `Class.Model.PrimaryPart`의 `Class.BasePart.CFrame`을 설정합니다.
모델의 다른 모든 부품도 이동하며, `Class.Model.PrimaryPart`에 대한 방향과 오프셋을 유지합니다.

이 함수는 모델에 `Class.Model.PrimaryPart`가 존재하지 않으면 오류를 발생시킵니다.
이는 기본 부품이 설정되지 않았거나 파괴된 경우와 같은 문제를 일으킬 수 있습니다.


Model:SetPrimaryPartCFrame

cframe

모델의 `Class.Model.PrimaryPart`의 `Class.BasePart.CFrame`을 설정합니다.
모델의 다른 모든 부품도 이동하며, `Class.Model.PrimaryPart`에 대한 방향과 오프셋을 유지합니다.


이 샘플은 `Class.Model:TranslateBy()`가 충돌을 무시하고
모델의 방향을 존중하는 방법을 보여줍니다.

간단한 두 부분으로 이루어진 `Class.Model`이 생성되고, Y축을 기준으로 45도 회전하며,
`Class.Model.PrimaryPart`가 설정됩니다. 큰 장애물 부분이 그 옆에 배치됩니다.

5초 후에 `Class.Model:TranslateBy()`가 사용되어 모델이
장애물 부분 안으로 이동하도록 지시합니다. 모델은 장애물 안으로 이동하며
현재 방향을 유지합니다.


주어진 `Datatype.Vector3` 오프셋으로 `Class.Model`을 이동시키며, 모델의 방향을 유지합니다.
다른 `Class.BasePart` 또는 `Class.Terrain`이 새 위치에 이미 존재하는 경우,
`Class.Model`은 해당 객체와 겹칩니다.

변환은 객체 공간이 아닌 월드 공간에서 적용되므로,
모델의 부품이 다르게 방향이 설정되어 있더라도 여전히 표준 축을 따라 이동합니다.


Model:TranslateBy

delta

`Class.Model`을 변환할 `Datatype.Vector3`입니다.


주어진 `Datatype.Vector3` 오프셋으로 `Class.Model`을 이동시키며, 모델의 방향을 유지합니다.
다른 `Class.BasePart` 또는 `Class.Terrain`이 새 위치에 이미 존재하는 경우,
`Class.Model`은 해당 객체와 겹칩니다.


Model

인스턴스 [스트리밍](/workspace/streaming)이 활성화된 경험을 위해 모델의 세부 수준을 설정합니다. 복합 또는
임포스터 메시에는 물리, 충돌 감지 또는 레이캐스팅이 지원되지 않습니다.

`Enum.ModelLevelOfDetail|StreamingMesh`로 설정하면, 낮은 해상도의
"임포스터" 메시(모델의 모든 자식 부품을 감싸는 색이 있는 거친 메시)가
스트리밍 반경 외부에서 렌더링됩니다. 텍스처는 지원되지 않습니다.

`Enum.ModelLevelOfDetail|SLIM`으로 설정하면, **SLIM** 모델(확장 가능한
경량 인터랙티브 모델)이 모든 자식 부품의 복합체를 스트리밍 반경에 따라
점진적으로 낮은 해상도로 렌더링합니다. 이는
`Enum.ModelLevelOfDetail|StreamingMesh`보다 시각적 품질을 크게 향상시킵니다.

`Enum.ModelLevelOfDetail|Disabled` 또는
`Enum.ModelLevelOfDetail|Automatic`으로 설정하면, 낮은 해상도의 메시가
표시되지 않습니다.


Model.LevelOfDetail

인스턴스 스트리밍이 활성화된 경험을 위해 모델의 세부 수준을 설정합니다.


인스턴스 [스트리밍](/workspace/streaming)이 활성화된 경우 `Class.Model|Models`가 어떻게 스트리밍되고
제거되는지를 제어합니다. 동작은 선택된 열거형에 따라 다릅니다. 스트리밍이
비활성화된 경우에는 효과가 없습니다.

이 속성은 스트리밍이 활성화된 상태에서 Studio의
[속성](/studio/properties) 창에서만 변경해야 하며,
`Class.Script|Scripts`에서만 변경해야 하며, 절대
`Class.LocalScript|LocalScripts`에서 변경해서는 안 됩니다(이렇게 하면 정의되지 않은
동작이 발생할 수 있습니다).


Model.ModelStreamingMode

인스턴스 스트리밍이 활성화된 경우 `Class.Model|Models`의 모델 스트리밍 동작을 제어합니다.


이 코드 샘플은 주사위 모델을 생성하고 던진 다음, 주사위가 파란 면이 위로 향했는지 여부를 출력합니다.
`Class.Model.PrimaryPart`가 설정되지 않은 경우, 주사위의 피벗 / 경계 상자가 회전하게 되며, 내부의 부품들은 롤링 중 물리적으로 시뮬레이션됩니다.


`Class.Model`의 기본 부품을 가리킵니다. 기본 부품은 모델의 피벗에 대한 물리적 참조 역할을 하는
`Class.BasePart`입니다. 즉, 모델 내의 부품이 물리적 시뮬레이션이나 다른 수단으로 이동할 때,
피벗은 기본 부품과 동기화되어 이동합니다.

`Class.Model|Models`는 기본적으로 `PrimaryPart`가 설정되어 있지 않습니다.
물리적으로 작용해야 하는 모델을 생성하는 경우,
Studio 또는 스크립트 내에서 이 속성을 수동으로 설정해야 합니다. 기본 부품이 **설정되지 않으면**,
피벗은 모델 내의 부품이 이동하더라도 월드 공간에서 동일한 위치에 유지됩니다.

또한 이 속성을 설정할 때, 모델의 자손인 `Class.BasePart`여야 합니다. 만약
`Class.Model.PrimaryPart`를 모델의 자손이 **아닌** `Class.BasePart`로 설정하려고 하면,
그 부품으로 설정되지만 다음 시뮬레이션 단계에서 `nil`로 재설정됩니다. 이는
모델의 자손이 아닌 `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`입니다.


속성 창에서 이 속성을 설정하면 `Class.Model:ScaleTo()`가 호출된 것처럼 모델이 스케일링되며,
모델의 모든 자손 인스턴스(재료, 이미지 및 부품의 3D 기하학 포함)가 원래 크기에 대한
지정된 스케일 팩터를 가지도록 조정됩니다.

이 속성은 Studio에서만 사용할 수 있으며, `Class.Script` 또는 `Class.LocalScript`에서 사용하면
오류가 발생합니다. 스크립트에서 `Class.Model:ScaleTo()` 및 `Class.Model:GetScale()`를 사용해야 합니다.


Model.Scale

모델의 피벗 주위에서 모델을 스케일링하는 데 사용되는 편집기 전용 속성입니다. 이 속성을 설정하면
`Class.Model:ScaleTo()`가 호출된 것처럼 스케일이 이동합니다.


이 코드 샘플은 모델의 피벗을 해당 모델의 경계 상자의 중심으로 재설정하는 사용자 정의 함수를 보여줍니다.


 `Class.Model.WorldPivot`를 보여줍니다.


이 속성은 설정된 `Class.Model.PrimaryPart`가 **없는** 경우 `Class.Model`의 피벗이 위치하는 곳을 결정합니다.
`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`를 명시적으로 설정할 필요를 피하는 것입니다.


Model.WorldPivot

`Class.Model`이 설정된 `Class.Model.PrimaryPart`가 **없는** 경우 피벗이 위치하는 곳을 결정합니다.


모델은 컨테이너 객체로, 객체를 함께 그룹화합니다. 이들은
`Class.BasePart|BaseParts`의 컬렉션을 보유하는 데 가장 적합하며,
기능을 확장하는 여러 함수를 가지고 있습니다.


`Class.PVInstance`는 생성할 수 없는 추상 클래스입니다. 이는 세상에 물리적 위치가 있는 모든 객체의 기반입니다.

이 코드 샘플은 사용자가 <kbd>F</kbd> 키를 눌렀을 때 현재 바라보고 있는 방향으로
10&nbsp;스탯만큼 캐릭터를 이동시키는 간단한 텔레포트 스크립트입니다. 이는
`Class.PVInstance:GetPivot()`을 사용하여 현재 피벗을 가져오고 `PVInstance|PivotTo`
를 호출하여 캐릭터를 앞으로 이동시킵니다.


이 함수는 `Class.PVInstance`의 피벗을 가져옵니다. 이는 종종 `Class.PVInstance:PivotTo()`와 함께 사용되어 모델을 이동하는 데 사용됩니다.

`Class.Model|Models`와 `Class.BasePart|BaseParts`는 모두 `Class.PVInstance|PVInstances`("Position Velocity Instances")이며, 따라서 둘 다 이 함수를 가지고 있습니다.

PVInstance:GetPivot

인스턴스의 피벗의 세계 공간 `Datatype.CFrame`입니다.


`Class.PVInstance`의 피벗을 가져옵니다.

`Class.PVInstance`와 모든 자손 `Class.PVInstance|PVInstances`를 변형시켜 피벗이 지정된 `Datatype.CFrame`에 위치하도록 합니다. 이것은 스크립트를 통해 `Class.Model|Models`를 이동하는 데 사용해야 하는 주요 함수입니다.

`Class.BasePart|BaseParts`는 필요에 따라 변형된 `Datatype.CFrame`로 이동합니다.
`Class.Model|Models`는 필요에 따라 변형된 `Class.Model.WorldPivot`로 이동합니다.

효율성을 위해 `Class.BasePart|BaseParts`의 `Class.BasePart.Position|Position`과 `Class.BasePart.Orientation|Orientation`에 대해 `Class.Object.Changed` 이벤트가 발생하지 않으며, 이는 `Datatype.CFrame`에 대해서만 발생합니다.

`Class.Model|Models`에서 `Class.PVInstance:PivotTo()|PivotTo`를 호출할 때, 자손 부품과 모델의 오프셋이 캐쉬되어 다음에 같은 모델에서 `Class.PVInstance:PivotTo()|PivotTo`를 호출해도 부품 간의 부동 소수점 누적 오류가 발생하지 않습니다.

`Class.Model|Models`와 `Class.BasePart|BaseParts`는 모두 `Class.PVInstance|PVInstances`("Position Velocity Instances")이며 따라서 둘 다 이 함수를 가지고 있습니다.

PVInstance:PivotTo

targetCFrame

`Class.PVInstance` 피벗이 이동 후 같아야 하는 `Datatype.CFrame`입니다.

`Class.PVInstance`와 모든 자손 `Class.PVInstance|PVInstances`를 변형시켜 피벗이 지정된 `Datatype.CFrame`에 위치하도록 합니다.

PVInstance

편집기 전용 속성으로, 스튜디오 속성 창에서 **원점 위치** 및 **원점 방향** 아래의 **변환**으로 표시됩니다. 그 값은 인스턴스의 피벗의 세계 공간 `Datatype.CFrame`이며, 이를 읽으면 `Class.PVInstance:GetPivot()`과 동일한 `Datatype.CFrame`이 반환됩니다. 자체적으로 저장된 값이 없으며 항상 현재 피벗을 반영합니다.

속성 창에서 설정하면 전체 인스턴스가 이동하여 피벗이 새로운 `Datatype.CFrame`에 위치하게 되며, 이는 `Class.PVInstance:PivotTo()`와 유사합니다. 속성 창을 통해 편집하면 이동을 위해 다른 객체에 대한 `Class.WeldConstraint|WeldConstraints`가 일시적으로 비활성화됩니다; `PivotTo`는 조인트를 수정하지 않습니다.

스크립트에서 사용할 수 없습니다; 대신 런타임에서 `Class.PVInstance:GetPivot()` 및 `Class.PVInstance:PivotTo()`를 사용하십시오.


PVInstance.Origin

편집기 전용 속성으로, `Class.PVInstance`의 피벗의 세계 `Datatype.CFrame`을 읽고 설정합니다. 스튜디오 속성 창에서 변경할 때 전체 인스턴스가 이동합니다.


편집기 전용 속성으로, 스튜디오 속성 창에서 **피벗 위치** 및 **피벗 방향** 아래의 **피벗**으로 표시됩니다. 이는 인스턴스의 자체 프레임에 대한 피벗의 `Datatype.CFrame`입니다.

속성 창에서 변경하면 인스턴스는 제자리에 남고 피벗만 인스턴스에 상대적으로 이동합니다. 이는 전체 인스턴스를 이동하는 `원점`과는 다릅니다. `Class.BasePart`의 경우, 오프셋은 기본적으로 항등 `Datatype.CFrame`으로 설정되므로 피벗이 파트의 중심과 일치합니다. `Class.Model`의 경우, 이 속성은 모델에 `Class.Model.PrimaryPart|PrimaryPart`가 있을 때만 나타나며, 그 경우 해당 파트의 `Class.BasePart.PivotOffset|PivotOffset`을 반영하고 편집합니다. `Class.Model:GetPivot()`은 기본 파트의 피벗을 별칭합니다.

스크립트에서 사용할 수 없습니다; 스크립트는 `Class.BasePart.PivotOffset`과 같은 구체적인 클래스를 통해 동등한 값을 읽고 씁니다.


PVInstance.Pivot Offset

편집기 전용 속성으로, 인스턴스에 대한 피벗의 `Datatype.CFrame`을 표시하고 편집합니다. 피벗만 이동하고 인스턴스는 제자리에 남습니다.


세상에 물리적 위치가 있는 모든 객체의 추상 클래스입니다.

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리의 일부가 될 수 있습니다.

루트 `Instance` 객체를 직접 생성하는 것은 불가능하지만, 특별한
`Datatype.Instance.new()` 생성자는 코드로 객체를 생성하며,
클래스의 이름을 매개변수로 받아 생성된 객체를 반환합니다.


인스턴스의 조상을 변경하는 것을 감지하기 위해 `Class.Instance.AncestryChanged` 이벤트에 연결하는 방법을 보여줍니다.

ChangingPart의 부모는 시간이 지남에 따라 다른 값으로 설정됩니다. 파트의 부모는 파트의 조상이므로, `Class.Instance.AncestryChanged` 이벤트는 변경될 때마다 발생합니다.

이 인스턴스가 재부모화되거나 그 조상 중 하나가 재부모화될 때 발생합니다.

이 이벤트를 사용하여 스튜디오에서 인스턴스의 삭제를 추적할 수 있습니다. 예를 들어 탐색기에서 수동으로 삭제하거나 플러그인을 통해 삭제하는 경우입니다. `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

인스턴스에서 속성이 변경될 때마다 발생합니다.


이 코드 조각은 객체가 Workspace에 추가될 때 그 이름을 출력합니다:


이 `Class.Instance`에 자식이 추가된 후 발생합니다.

클라이언트에서 서버가 생성한 객체를 감지하기 위해 이 메서드를 사용할 때는, 이러한 객체의 자손을 인덱싱할 때 `Class.Instance:WaitForChild()`를 사용하는 것이 필요합니다. 이는 객체와 그 자손이 서버에서 클라이언트로 동시에 복제될 것이라는 보장이 없기 때문입니다. 예를 들어:

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

Workspace.ChildAdded:Connect(function(child)
	-- 자손이 아직 복제되지 않았을 수 있으므로 WaitForChild()를 사용하세요
	local head = child:WaitForChild("Head")
end)
```
이 이벤트는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 캡처하는 이벤트가 필요하다면 `Class.Instance.DescendantAdded`를 사용하세요.

`Class.Instance.ChildRemoved`도 참조하세요.


Instance.ChildAdded

이 `Class.Instance`에 자식이 추가된 후 발생합니다.


Instance.childAdded

이 코드 조각은 객체가 작업 공간에서 제거될 때 그 이름을 출력합니다:


이 `Class.Instance`에서 자식이 제거된 후 발생합니다.

제거된 것은 객체의 부모가 이 `Class.Instance`에서 이 `Class.Instance`가 아닌 다른 것으로 변경된 경우를 의미합니다. 이 이벤트는 자식이 파괴될 때도 발생합니다(`Class.Instance:Destroy()` 사용) 파괴 함수가 객체의 부모를 `nil`로 설정하기 때문입니다.

이 이벤트는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 캡처하는 이벤트가 필요하다면 `Class.Instance.DescendantRemoving`을 사용하세요.

`Class.Instance.ChildAdded`도 참조하세요.


Instance.ChildRemoved

이 `Class.Instance`에서 자식이 제거된 후 발생합니다.


다음 예제는 Workspace에 추가되는 모든 객체의 이름을 출력합니다:

이 이벤트는 자손이 이 `Class.Instance`에 추가된 후 발생합니다.

모든 자손에 대해 발생하므로, 객체를 `Class.Instance`에 부모로 설정하면 이 객체와 모든 자손에 대해 개별적으로 이벤트가 발생합니다.

`Class.Instance`의 **직접 자식**에만 관심이 있다면, 대신 `Class.Instance.ChildAdded`를 사용하세요.

`Class.Instance.DescendantRemoving`도 참조하세요.


Instance.DescendantAdded

descendant

자손이 이 `Class.Instance`에 추가된 후 발생합니다.


다음 예제는 Workspace에서 제거되는 하위 항목의 이름을 출력합니다:

이 이벤트는 **직접적으로** 부모 `Class.Instance`가 변경되어 **자손** 인스턴스가 더 이상 자손이 되지 않도록 할 때 발생합니다. `Class.Instance:Destroy()|Destroy()`는 인스턴스의 `Class.Instance.Parent|Parent`를 `nil`로 변경하므로, 부모의 자손에 대해 이 메서드를 호출하면 이 이벤트가 발생합니다.

이 이벤트가 발생할 때 자손의 부모는 변경되지 않습니다. 만약 자손이 부모의 **직접 자식**인 경우, 이 이벤트는 `Class.Instance.ChildRemoved`보다 먼저 발생합니다.

자손이 자식을 가지고 있는 경우, 이 이벤트는 자손을 먼저 발생시키고, 그 다음에 자손을 발생시킵니다.

#### 경고

이 이벤트는 제거되는 자손 객체와 함께 발생합니다. 자손의 `Class.Instance.Parent|Parent`를 다른 것으로 설정하려고 하면 실패합니다. 아래는 이를 보여주는 예입니다:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 이 함수에서 자손의 부모를 조작하지 마세요!
	-- 이 이벤트는 부모가 조작되었기 때문에 발생하며, 변경이 아직 발생하지 않았습니다
	-- 따라서 이렇게 부모를 변경하는 것은 문제가 됩니다:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```

`Class.Instance.DescendantAdded|DescendantAdded`도 참조하세요.


Instance.DescendantRemoving

이 `Class.Instance`의 자손이 제거되기 직전에 발생합니다.


이 샘플은 즉시 신호 동작을 사용할 때 인스턴스가 파괴되더라도 연결된 함수가 yield될 때까지 그대로 유지된다는 것을 보여줍니다.

이 샘플은 Deferred 신호 동작을 사용할 때, 인스턴스가 신호가 발생하기 전에 어떻게 파괴되는지를 보여줍니다.

연결된 함수가 여전히 사용 중인 동안 `Class.Instance`는 메모리에서 삭제되지 않습니다. 그러나 함수가 어느 시점에서든 대기하면, `Class.Instance`와 그 자손은 `nil`로 부모가 설정됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Immediate`로 설정된 경우, 이 이벤트는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴되기 직전에 발생합니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Deferred`로 설정된 경우, 이 이벤트는 다음 재개 지점에서 발생하며, 이는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴된 후입니다.

`Enum.SignalBehavior.Deferred|Deferred` 동작에서는 스크립트를 자신의 `Class.Instance.Destroying` 이벤트에 연결하는 것이 문제가 됩니다. 스크립트가 콜백이 호출되기 전에 파괴되기 때문입니다(즉, 실행되지 않습니다).

스튜디오에서 `Class.Instance`를 삭제할 때, 예를 들어 [탐색기](/studio/explorer)를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.


Instance.Destroying

인스턴스가 `Class.Instance:Destroy()`를 통해 파괴되기 직전에 발생합니다.


 `Class.Instance.StyledPropertiesChanged`를 보여줍니다.


이 이벤트는 인스턴스에서 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


Instance.StyledPropertiesChanged

인스턴스에서 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


이 메서드는 인스턴스에 태그를 적용하며, 태그가 이미 적용된 경우에는 효과가 없습니다.
태그를 성공적으로 추가하면 `Class.CollectionService:GetInstanceAddedSignal()`에 의해 생성된 신호가 주어진 태그로 발생합니다.

#### 경고

- 클라이언트 측에서 추가된 인스턴스의 태그는 서버가 나중에 해당 인스턴스에 태그를 추가하거나 제거하면 삭제됩니다.
서버는 모든 태그를 함께 복제하고 이전 태그를 덮어씁니다.

- 인스턴스에 태그를 추가할 때, 태그의 기능을 제공하기 위해 일부 리소스가 사용됩니다.
예를 들어 이벤트 연결 또는 테이블입니다.
메모리 누수를 방지하기 위해 태그가 더 이상 필요하지 않을 때 이를 정리하는 것이 좋습니다(연결 해제, `nil`로 설정 등).
`Class.Instance:RemoveTag()`를 호출하거나 `Class.Instance:Destroy()`를 호출하거나
`Class.CollectionService:GetInstanceRemovedSignal()`에 의해 반환된 신호에 연결된 함수에서 이를 수행하십시오.


Instance:AddTag

인스턴스에 적용할 태그입니다.


인스턴스에 태그를 적용합니다.


자식 함수는 객체의 자식 배열을 반환합니다.


Instance:children

자식 객체/인스턴스의 배열입니다.


객체의 자식 배열을 반환합니다.


이 메서드는 인스턴스의 모든 자식과 자손을 파괴합니다.

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

-- 반짝임 추가
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
모든 자식과 자손을 파괴하고 싶지 않다면,
`Class.Instance:GetChildren()` 또는 `Class.Instance:GetDescendants()`를 사용하여
그 자식/자손을 반복하고 파괴할 대상을 선택하십시오.
예를 들어, 다음 코드 샘플은 `Class.Model`에서 내려오는 모든 `Class.BasePart|BaseParts`를 파괴합니다:

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

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

이 메서드는 인스턴스의 모든 자식을 파괴합니다.


 `Class.Instance:Clone()` 를 사용하여 모델을 복제하는 방법을 보여줍니다.

`Clone()`은 인스턴스와 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`이 아닌 모든 인스턴스는 무시합니다.
루트 인스턴스의 복사본은 이 메서드에 의해 반환되며,
그 `Class.Instance.Parent|Parent`는 `nil`로 설정됩니다.
인스턴스 자체가 `Class.Instance.Archivable|Archivable`가 `false`로 설정되어 있으면,
이 메서드는 `nil`을 반환합니다.

`Class.ObjectValue.Value`와 같은 참조 속성이 복제된 인스턴스에 설정되면,
복사본의 속성 값은 원본의 값에 따라 달라집니다:

- 참조 속성이 **또한** 복제된 인스턴스를 참조하면,
  복사본은 복제를 참조합니다.
- 참조 속성이 **복제되지 않은** 인스턴스를 참조하면,
  복사본에서 동일한 값이 유지됩니다.


Instance:Clone

인스턴스의 복사본 또는 인스턴스가 `Class.Instance.Archivable|Archivable`가 아닌 경우 `nil`입니다.


인스턴스와 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`이 아닌 인스턴스는 무시합니다.


Instance:clone

`Class.Instance:Destroy()` 함수를 사용하여 Part를 파괴하는 방법을 보여줍니다.

이 함수는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다. 이 메서드는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

불필요한 객체를 처리하는 것은 중요합니다. 왜냐하면 장소에 불필요한 객체와 연결이 있으면
메모리를 소모하여 시간이 지남에 따라 심각한 성능 문제를 일으킬 수 있기 때문입니다.

`Destroy()`를 호출한 후에는 객체(또는 그 자손)를 참조하는 모든 변수를 `nil`로 설정하는 것이 좋습니다.
이렇게 하면 코드가 객체와 관련된 어떤 것도 접근하지 못하게 됩니다.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 이렇게 하지 마세요:
print(part.Name)  --> "Hello, world"
-- 위의 줄이 작동하지 않도록 하려면:
part = nil
```

`Class.Instance`가 이 메서드에 의해 파괴된 후에는 재사용할 수 없습니다.
왜냐하면 `Class.Instance.Parent` 속성이 잠겨 있기 때문입니다. 객체를 **일시적으로** 제거하려면,
`Class.Instance.Parent|Parent`를 `nil`로 설정하십시오. 예를 들어:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
설정된 시간 후에 객체를 파괴하려면 `Class.Debris:AddItem()`을 사용하십시오.


Instance:Destroy

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다.


Instance:destroy

주어진 이름과 같은 `Class.Instance.Name`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

다음 코드 조각은 `Car`라는 이름의 객체의 첫 번째 조상을 찾습니다.

```
local car = object:FindFirstAncestor("Car")
```
특정 클래스의 조상을 찾는 이 메서드의 변형은 `Class.Instance:FindFirstAncestorOfClass()`와
`Class.Instance:FindFirstAncestorWhichIsA()`를 참조하십시오.


Instance:FindFirstAncestor

name

찾고자 하는 `Class.Instance.Name`입니다.


주어진 이름과 같은 `Class.Instance.Name`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.


Instance

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리의 일부가 될 수 있습니다.


요약