`Class.Actor`는 `Library.task.desynchronize()`를 사용하여 안전하게 자체 스레드로 분리할 수 있는 코드의 컨테이너입니다. 또한 그 스크립트에서 사용되는 인스턴스를 포함해야 합니다.

스크립트 성능을 최적화하기 위해 여러 Actors를 사용하는 방법에 대해 더 알아보려면
[병렬 Luau](/scripting/multithreading)를 참조하십시오.

#### 주의사항

- 각 `Actor`는 고유한 Luau VM에서 실행됩니다. `Actor`에서 필요한 `Class.ModuleScript|ModuleScripts`는 **공유**되거나 `Actors` 또는 메인 스레드 간에 캐시되지 않습니다. 각 VM은 모듈의 자체 복사본을 실행하므로 모듈 수준의 상태는 각 `Actor`마다 격리됩니다. 공유할 의도가 있는 상태를 보유한 모듈의 경우 이를 설계하십시오.
- `script:GetActor()`는 `ModuleScript`가 `Actor`의 자식이 아닌 경우 `nil`을 반환합니다. 다른 곳에 저장된 `ModuleScripts`(예: `Class.ReplicatedStorage`)이고 `Actor`에 의해 필요한 모듈들은 `Actor`의 자식으로 간주되지 않습니다.


이 메서드는 지정된 주제를 가진 메시지에 Luau 콜백을 바인딩하는 데 사용됩니다. 메시지가 주제에 지정된 대로 전송될 때(`Class.Actor:SendMessage()|SendMessage()` 사용) 제공된 콜백이 _직렬_ 실행 컨텍스트에서 호출됩니다.

여러 개의 Luau 콜백이 단일 Actor와 단일 메시지 주제에 바인딩될 수 있습니다.

참고: Actor의 후손인 스크립트만 해당 Actor의 메시지에 바인딩할 수 있습니다.

```lua
local actor = script:GetActor()

-- 이 스크립트가 후손인 Actor에 인사 메시지가 전송될 때 메시지를 출력합니다.
local connection = actor:BindToMessage("Greeting", function(message)
  print("Received Greeting Message:", message)
end)
```

Actor:BindToMessage

topic

메시지 유형을 식별하는 데 사용되는 주제입니다.

function

이 연결 객체를 사용하여 Luau 콜백을 메시지 수신에서 연결 해제할 수 있습니다.

지정된 주제를 가진 메시지에 Luau 콜백을 바인딩합니다.

이 메서드는 지정된 주제를 가진 메시지에 Luau 콜백을 바인딩하는 데 사용됩니다. 메시지가 주제에 지정된 대로 전송될 때(`Class.Actor:SendMessage()|SendMessage()` 사용) 제공된 콜백이 _병렬_ 실행 컨텍스트에서 호출됩니다.

여러 개의 Luau 콜백이 단일 Actor와 단일 메시지 주제에 바인딩될 수 있습니다.

참고: Actor의 후손인 스크립트만 해당 Actor의 메시지에 바인딩할 수 있습니다.

```lua
local actor = script:GetActor()

-- 이 스크립트가 후손인 Actor에 인사 메시지가 전송될 때 메시지를 출력합니다.
local connection = actor:BindToMessageParallel("Greeting", function(message)
  print("Received Greeting Message:", message)
end)
```

Actor:BindToMessageParallel

Actor에 메시지를 보냅니다. 메시지는 비동기적으로 전송되므로 발신자는 `Class.Actor:SendMessage()|SendMessage()` 메서드를 호출할 때 블록되거나 대기하지 않습니다.

하나의 Actor가 다양한 종류의 메시지를 받을 수 있으므로 `topic` 매개변수를 사용하여 다양한 종류의 메시지를 구별합니다.

`Class.Actor:SendMessage()|SendMessage()`를 사용하여 전송된 메시지를 수신하는 방법에 대한 자세한 내용은 `Class.Actor:BindToMessage()|BindToMessage()`를 참조하십시오.

메시지 인수는 **복사본 방식으로** Luau VM 경계를 넘어 전달되며, 참조 방식으로 전달되지 않습니다. 큰 테이블을 전송하면 각 호출마다 전체 복사가 발생합니다. 함수는 특정 VM에 바인딩되어 있으며 메시지로 전달될 수 없습니다.

```lua
-- `actor`는 Actor 인스턴스를 참조하는 지역 변수로 가정합니다.
actor:SendMessage("Greeting", "Hello World")
```


Actor:SendMessage

전송되는 메시지를 식별하는 데 사용되는 주제입니다.

message

Actor에 전송할 메시지의 내용입니다.

Actor

`Class.Actor`는 안전하게 자체 스레드로 분할할 수 있는 코드의 컨테이너입니다.

다음 샘플은 개체 테이블을 가져와서 새로운 모델에 부모로 설정하는 기본 함수를 포함하고 있으며, 해당 모델을 반환합니다.

모델은 컨테이너 객체로, 객체들을 함께 그룹화합니다. 가장 적합하게 사용되는 것은 `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.Player`입니다.

지정된 플레이어에 대해 이 모델을 지속적으로 유지하도록 설정합니다.
`Class.Model.ModelStreamingMode|ModelStreamingMode`가 추가 결과로 동작이 변경될 수 있도록 `Enum.ModelStreamingMode|PersistentPerPlayer`로 설정되어야 합니다.

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

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

`BaseParts` 간의 연결을 끊습니다. 여기에는 인접 부품과의 표면 연결, `Class.WeldConstraint|WeldConstraints`, 모든 `Class.Weld|Welds` 및 기타 `Class.JointInstance|JointInstances`가 포함됩니다.

BreakJoints가 Player 캐릭터의 `Class.Model`에서 사용될 경우, 캐릭터의 `Class.Humanoid`는 Neck 관절에 의존하므로 죽게 됩니다.

인접 부품과의 표면 연결로 인해 생성된 관절은 기술적으로 `Class.Model:MakeJoints()`를 사용하여 다시 생성할 수 있지만, 이는 표면으로 인해 생성된 관절만 재생성됩니다. 개발자는 이 동작을 신뢰하지 말아야 하며, 관절이 끊어진 부품들은 더 이상 서로 접촉하지 않을 수 있습니다.

Model:BreakJoints

`BaseParts` 간의 연결을 끊습니다. 여기에는 인접 부품과의 표면 연결, `Class.WeldConstraint|WeldConstraints`, 모든 `Class.Weld|Welds` 및 기타 `Class.JointInstance|JointInstances`가 포함됩니다.

Model:breakJoints

이 함수는 `Class.Model` 내의 모든 `Class.BasePart` 자식들을 포함하는 볼륨에 대한 설명을 반환합니다. 볼륨의 방향은 `Class.Model.PrimaryPart|PrimaryPart`의 방향에 따라 결정되며, 모델이 선택되었을 때 Studio에서 렌더링되는 선택 박스와 일치합니다. `Class.Terrain:FillBlock()`의 동작을 반영하여, 그 경계 상자의 중심을 나타내는 `Datatype.CFrame`과 그 크기를 나타내는 `Datatype.Vector3`를 반환합니다. 물리 제약이 `Class.Model` 내의 부품에 작용할 경우, 런타임에서 크기가 부정확할 수 있습니다.

경계 상자의 방향은 `Class.PVInstance.GetPivot|Pivot`의 방향과 일치합니다 - 즉, 기본 부품의 피벗(있는 경우) 또는 모델의 `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

볼륨의 방향을 나타내는 `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

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

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축 주위로 10도 회전시키는 루프가 0.2초마다 시작됩니다.

이 함수는 `Class.PVInstance:GetPivot()`로 대체되었으며, 이는 원활한 교체를 위해 존재하고 코드의 동작을 변경하지 않습니다. 신규 작업에서는 `Class.PVInstance:GetPivot()`을 사용하고, 기존 `Class.Model:GetPrimaryPartCFrame()` 호출을 적당할 때 이전하세요.

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

이 함수는 다음과 동일합니다.

    Model.PrimaryPart.CFrame

기본 부품이 존재하지 않으면 이 함수는 오류를 발생시킵니다. 이 동작이 원하지 않는 경우, 기본 부품이 없으면 `nil`이 됩니다.

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

Model:GetPrimaryPartCFrame

모델의 `Class.Model.PrimaryPart`의 `Datatype.CFrame`을 반환합니다. 기본 부품이 존재하지 않으면 이 함수는 오류를 발생시킵니다.

이 코드 샘플은 `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`의 조인트 오프셋에 적용됩니다. 이렇게 하면 애니메이션 리그가 스케일된 상태에서도 올바르게 애니메이션을 재생할 수 있습니다.

Model:GetScale

모델의 현재 고유 스케일 팩터입니다.

모델의 고유한 스케일을 반환합니다. 기본적으로 새로 생성된 모델의 경우 1로 설정되며, `Class.Model:ScaleTo()`를 통해 스케일이 변경됩니다.

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

모델이 인스턴스화되며, 두 개의 부품이 서로 위에 있습니다. 위의 부품은
앵커가 설정되어 있고 아래의 부품은 그렇지 않습니다. 일반적으로 워크스페이스에
부모가 설정되면 아래의 부품은 기본판에 떨어질 것입니다.

하지만 아래 부품의 TopSurface 속성이 Enum.SurfaceType.Weld로 설정되어 있으므로,
이는 Model:MakeJoints가 실행될 때 이들 사이에 연결이 형성된다는 것을 의미합니다.

따라서 아래의 부품은 모델의 관절이 깨지기 전까지 떨어지지 않습니다. 이는
종종 Model:BreakJoints를 사용하여 수행되지만, 이 예에서는
폭발을 사용하여 연결을 끊습니다.

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

표면 타입 기반 연결이 deprecated 되었습니다. 신규 프로젝트에는 MakeJoints를 사용하지 마세요. 대신 `Class.WeldConstraint|WeldConstraints`와 `Class.HingeConstraint|HingeConstraints`를 사용하세요.

모델 내의 모든 `Class.BasePart|Parts`를 검사하여, 표면의 종류에 따라 지정된 부품과 평면적으로 접촉하는 표면 간에 관절을 생성합니다.

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

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

Model:MakeJoints

모델 내의 모든 `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

모델이 이동할 `Datatype.Vector3`입니다.

`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

이 함수는 `Class.PVInstance:PivotTo()`로 대체되었으며, 이는 보다 효율적인 교체 역할을 하며 코드의 동작을 변경하지 않습니다. 신규 작업에서는 `Class.PVInstance:PivotTo()`를 사용하고, 기존 `Class.Model:SetPrimaryPartCFrame()` 호출을 적절할 때 이전하세요.

모델의 `Class.Model.PrimaryPart`의 `Class.BasePart.CFrame`을 설정합니다. 모델의 모든 다른 부품도 이동하며 `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

모델을 이동할 `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.BasePart`로 `Class.Model.PrimaryPart`를 설정하려는 경우, 해당 부품으로 설정되지만 다음 시뮬레이션 단계 동안 `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`입니다.

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

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

Model.Scale

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

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

이 속성은 `Class.Model.PrimaryPart`가 설정되지 않은 `Class.Model`의 피벗 위치를 결정합니다. 만약 `Class.Model`이 `Class.Model.PrimaryPart|PrimaryPart`를 가진다면, `Class.Model`의 피벗은 해당 기본 부품의 피벗과 같습니다.

새로 생성된 `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.PrimaryPart`가 설정되지 않은 `Class.Model`의 피벗 위치를 결정합니다.

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

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


이 코드 샘플은 캐릭터를 현재 보고 있는 방향으로
10&nbsp;스튜드 앞으로 이동시키는 간단한 순간 이동 스크립트입니다. <kbd>F</kbd> 키를 눌렀을 때 현재 피벗을 얻어
`Class.PVInstance:GetPivot()`를 호출하고 `PVInstance|PivotTo`를 통해 캐릭터를 앞으로 이동시킵니다.

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

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


PVInstance:GetPivot

`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

PVInstance.Origin

PVInstance.Pivot Offset

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


`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, "변경됨")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 속성이 변경될 때 발생하는 이벤트인 `Class.Instance:GetAttributeChangedSignal()`도 참조하십시오.

Instance.AttributeChanged

attribute

`Class.Instance`에서 속성이 변경될 때마다 발생합니다.

이 코드는 객체가 작업 공간에 추가될 때 그 이름을 출력합니다:

`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: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`를 삭제할 때, 탐색기를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신, 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.

Instance.Destroying

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

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

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경됨")
end

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

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.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`이 아닌 인스턴스는 무시합니다.

Instance:clone

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

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


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

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

`Destroy()`를 호출한 후 Best Practice로, 객체를 참조하는 모든 변수를(또는 자손)
`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`의 첫 번째 조상을 반환합니다.

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

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

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

Instance:FindFirstAncestor

name

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

주어진 className과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

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

이 메서드의 전형적인 사용은 `Class.BasePart`가 속한 `Class.Model`을 찾는 것입니다. 예:

```
local model = part:FindFirstAncestorOfClass("Model")
```
이 메서드는 `Class.Instance:FindFirstAncestor()`의 변형으로,
`Class.Object.ClassName` 속성을 검사하고 `Class.Instance.Name` 대신작동합니다. `Class.Instance:FindFirstAncestorWhichIsA()`도 존재하며,
상속을 고려하여 `Class.Object:IsA()` 메서드를 대신 사용합니다.

Instance:FindFirstAncestorOfClass

className

찾을 `Class.Object.ClassName`입니다.

주어진 className과 동일한 `Class.Object.ClassName`의 첫 번째 조상을 반환합니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 조상을 반환합니다.

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

`Class.Instance:FindFirstAncestorOfClass()`와는 달리, 이 메서드는
`Class.Object:IsA()`를 사용하는데, 이는 클래스 상속을 고려합니다. 예:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 조상을 반환하며, 이는 `Class.WedgePart`,
`Class.MeshPart` 또는 `Class.Part`인지 여부에 관계없이 반환됩니다.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
또한 `Class.Instance:FindFirstAncestor()`와 관련이 있습니다.

Instance:FindFirstAncestorWhichIsA

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 조상을 반환합니다.

아래 코드는 Workspace에서 객체 이름 "Brick"을 찾습니다. 찾으면,
객체의 이름을 "Foo"로 변경합니다.

지정한 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환하며,
해당 자식이 존재하지 않으면 `nil`을 반환합니다. 선택적 `recursive` 매개변수가
`true`인 경우 메서드는 `Class.Instance`의 즉각적인 자식뿐 아니라 모든 자손을 검색합니다.

#### 객체 존재 확인

`FindFirstChild()`는 이어서 진행하기 전에 객체가 존재하는지 확인해야 할 경우에
필요합니다. 점 연산자를 사용하여 이름으로 자식을 인덱싱하려고 하면,
해당 자식이 존재하지 않으면 오류가 발생합니다.

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

-- 다음 줄은 파트가 작업 공간에 존재하지 않으면 오류가 발생합니다.
Workspace.Part.Transparency = 0.5
```
더 나은 접근 방식은 `FindFirstChild()`를 사용하여 먼저 `Part`를 확인한 후,
그렇다면 필요로 하는 코드를 실행하는 `if` 문을 사용하는 것입니다.

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

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

#### 속성이 일치하는 자식 찾기

때때로 객체의 `Class.Instance.Name|Name`이 `Class.Instance.Parent|Parent`의 속성과
동일할 수 있습니다. 점 연산자를 사용할 때는 이름을 공유하는 경우 속성이 자식보다
우선합니다.

다음 예에서 `Color`라는 `Class.Folder`가 `Class.Part`에 추가되고,
여기에도 `Class.Part.Color` 속성이 있습니다. `part.Color`는 자식 `Class.Folder` 인스턴스가 아닌
`Datatype.Color3` 속성 값을 참조하는 것을 참고하세요. `Class.Instance:FindFirstChild()|FindFirstChild()` 사용의
이점은 새로운 속성이 도입되어도 코드에 위험을 주지 않는다는 점입니다.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 속성
local c2 = part:FindFirstChild("Color")  -- 자식 폴더
```

#### 성능 주의 사항

`Class.Instance:FindFirstChild()|FindFirstChild()`는 점 연산자 사용보다 약 20% 더 오래 걸리며,
대부분의 객체를 참조로 저장하는 것보다 약 8배 더 오래 걸립니다. 그러므로 성능 의존 코드에서,
좁은 루프나 `Class.RunService.Heartbeat` 및 `Class.RunService.PreRender`와 관련된 함수 내에서
호출하는 것을 피해야 합니다. 대신, 결과를 변수에 저장하거나
`Class.Instance.ChildAdded|ChildAdded` 또는 `Class.Instance:WaitForChild()|WaitForChild()`를 사용하여
지정한 이름의 자식이 사용 가능해질 때를 파악하는 것을 고려하십시오.

Instance:FindFirstChild

지정한 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.

Instance

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