[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | 디버거에서 Server와 Client 상태 배지가 분리되어 보일 때와 로컬화된 엔티티에서 Client만 표시될 때의 차이는 무엇인가요? [answer] | StateSet Debugger의 상태 그래프 영역에서 Server와 Client 배지가 분리되어 보이는 경우와 로컬화된 엔티티에서 Client만 표시되는 경우는 엔티티의 실행 공간(Execution Space) 구성에 따른 차이입니다. **1. Server와 Client 배지가 분리되어 보이는 경우** * **원인:** 해당 엔티티는 Server와 Client 양쪽에서 모두 StateSet이 실행되고 있으며, 두 실행 공간의 현재 상태(State)가 **다름**을 의미합니다. * **표시 방식:** 노드 위에 Server [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | StateSet Debugger는 테스트 플레이 환경에서 실행되고 있는 StateSet의 내부 상황을 시각적으로 추적할 수 있도록 도와주는 도구입니다. ##### 참고 가이드 - [타입의 이해](/docs/docs-1038{target}) - [StateSet 제어하기](/docs/docs-1398{target}) ##### 참고 API Reference - [StateComponent](/apiReference/Components/StateComponent{target}) ## StateSet Debugger 소개 Stat
[task] | instruction_following [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | 디버거의 주요 UI 요소 6가지를 단계별 번호 목록으로 나열하되, 각 항목 뒤에 설명은 주석으로만 표기하세요. [answer] | ```lua 1. 엔티티 이름 -- 디버깅 대상인 엔티티의 이름과 실행 공간입니다. 2. 기록 -- 기록을 실행하고, 중지하는 버튼입니다. 3. JSON 내보내기 -- 히스토리를 JSON 파일로 내보낼 수 있습니다. 4. Blackboard -- 행동 트리의 변수와 현재 값을 확인할 수 있습니다. 패널을 접었다 펼쳤을 때 최신 값으로 갱신됩니다. 5. Inspector -- 선택한 노드의 프로퍼티와 현재 값을 확인할 수 있습니다. 노드를 다시 클릭했을 때만 값이 갱신됩니다. 6. 상태 그래프 영역 -- 행동 트리의 구조를 확인할 수 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 폰트 [question] | TextComponent 는 커스텀 폰트를 지원하지 않으므로 TextRendererComponent 로 대체하여 Font 프로퍼티를 설정하는 스크립트를 작성해줘 [answer] | `TextComponent`는 커스텀 폰트를 지원하지 않으므로, 커스텀 폰트를 적용하려면 `TextRendererComponent`를 사용해야 합니다. 참고 문서에 따르면, `TextRendererComponent`는 커스텀 폰트를 사용할 수 있는 컴포넌트 중 하나이며, 해당 컴포넌트의 **Font** 프로퍼티에서 선택한 폰트를 적용할 수 있습니다. 아래는 엔티티의 `TextRendererComponent`에 텍스트와 커스텀 폰트를 설정하는 스크립트 예시입니다. ```lua Property: [None] Entity Targe [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **Font Group** 탭에서는 언어별로 서로 다른 폰트를 하나의 그룹으로 묶어, 클라이언트 언어 설정에 맞는 폰트가 자동으로 적용되도록 만들 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/178403001449300fda3d4d8254d438f113d670d408f8a.png "2") | 번호 | 이름 | 설명 | | --- | --- | --- | | ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/stor
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | GetVelocity 메소드가 현재 맵 모드에 맞는 물리 컴포넌트에서 속도를 반환한다고 하는데, IsOnGround 메소드와 동일한 방식으로 맵 모드를 확인해야 하는 이유가 무엇인가요? [answer] | 메이플스토리 월드에서는 맵의 구조 방식(타일맵 모드)에 따라 플레이어의 물리적 이동과 상태 판정을 처리하는 컴포넌트가 다릅니다. `IsOnGround`와 `GetVelocity` 메소드가 동일한 방식으로 맵 모드를 확인해야 하는 이유는 다음과 같습니다: 1. **물리 컴포넌트 불일치 방지**: * `TileMapMode.MapleTile` (메이플 타일) 모드는 `RigidbodyComponent`를 사용해야 정확한 지면 판정과 속도를 반환합니다. * `TileMapMode.RectTile` (직사각형 타 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 상태 전환 메소드 플레이어의 지면 상태와 이동 속도를 확인하여 상태를 전환하도록 아래 3가지 메소드를 추가하고, 아래와 같이 작성합니다. - `CheckGroundMoveOrFall()`: 지면 여부와 이동 속도를 확인하여 상태를 전환합니다. 지면에 있고 이동 중이면 MOVE 상태로, 지면에 없고 IDLE 상태면 FALL 상태로 전환합니다. - `IsOnGround()`: 현재 맵 모드에 맞는 물리 컴포넌트를 통해 플레이어가 지면에 있는지 확인합니다. - `GetVelocity()`: 현재 맵 모드에 맞는 물리 컴포넌트
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | 여러 개의 엔티티에서 동시에 상태 전이를 확인하고 싶을 때 StateSet Debugger를 어떻게 활용해야 하나요? [answer] | StateSet Debugger를 사용하여 여러 엔티티에서 동시에 상태 전이를 확인하려면, 각 엔티티에 대해 개별적으로 디버거 창을 열어야 합니다. 구체적인 사용 방법은 다음과 같습니다. 1. **테스트 플레이 실행**: 먼저 테스트 플레이 환경을 시작합니다. StateSet Debugger는 테스트 플레이 환경에서만 사용 가능하며, 테스트 플레이가 종료되면 디버거와 기록된 히스토리가 자동으로 삭제됩니다. 2. **엔티티 선택 및 디버거 열기**: 디버깅이 필요한 첫 번째 엔티티를 선택합니다. 이후 프로퍼티 창에서 `Stat [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | StateSet Debugger는 테스트 플레이 환경에서 실행되고 있는 StateSet의 내부 상황을 시각적으로 추적할 수 있도록 도와주는 도구입니다. ##### 참고 가이드 - [타입의 이해](/docs/docs-1038{target}) - [StateSet 제어하기](/docs/docs-1398{target}) ##### 참고 API Reference - [StateComponent](/apiReference/Components/StateComponent{target}) ## StateSet Debugger 소개 Stat
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 폰트 [question] | 월드당 커스텀 폰트 등록 개수 제한과 로컬스페이스 사용 시 폰트 이름 중복 또는 제한 초과 상황에서 폰트 로드되지 않는 원인과 우선순위는 어떻게 되나요? [answer] | 월드당 커스텀 폰트로 등록할 수 있는 최대 개수는 **10개**입니다. 로컬스페이스를 사용하는 월드는 폰트 데이터를 직접 만들 수 있기 때문에 폰트 이름이 중복되거나 등록 개수 제한(10개)을 초과하는 상황이 발생할 수 있습니다. 이러한 경우, 해당 조건에 해당하는 폰트들은 **로드되지 않습니다**. 폰트 이름 중복 시 우선순위는 다음과 같습니다. * 폰트 그룹 이름과 단일 폰트 이름이 중복되는 경우, **폰트 그룹**이 우선 적용됩니다. [followup] | 폰트 그룹 이름과 단일 폰트 이름이 중복되는 경우 어떤 쪽이 우선 적용되며, 로컬스페이스에서 폰트 개수 제한을 초과했을 때 특정 폰트가 로드되지 않는 현상을 해결하려면 어떻게 해야 하나요? [followup_answer] | 폰트 그룹 이름과 단일 폰트 이름이 중복되는 경우, **폰트 그룹**이 우선 적용됩니다. 로컬스페이스에서 폰트 개수 제한(월드당 10개)을 초과했거나 폰트 이름이 중복되어 특정 폰트가 로드되지 않는 현상을 해결하기 위해서는, 직접 만든 폰트 데이터를 확인하여 **중복되는 폰트 이름을 수정**하거나 **총 등록 폰트 개수를 10개 이하로 조정**해야 합니다. 참고 문서에는 구체적인 해결 절차나 API가 명시되어 있지 않으므로, `Panels - Custom Font Group` 패널에서 폰트 목록을 검토하여 중복 이름이 없도록 변 [scores] | [judge_reason] | [source_doc] | 제작한 월드의 분위기와 어울리는 폰트를 추가해 월드의 텍스트에 적용할 수 있습니다. 폰트를 리소스 스토리지에 등록하고, 커스텀 폰트 그룹창에서 월드에 사용할 폰트를 묶는 방법에 대해 알아봅시다. ## 리소스 스토리지에 폰트 추가 월드에서 폰트를 사용하기 위해서는 먼저 리소스 스토리지에 폰트를 등록해야 합니다. 폰트 등록 시 이름은 **알파벳 대소문자, `_`, `-`, 숫자** 조합만 가능합니다. 리소스 스토리지에 업로드할 폰트의 저작권과 사용 범위를 반드시 확인한 후 등록하길 권장합니다. 폰트 파일 등록 방법은 아래와 같습니
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | StateSet Debugger에서 서버 탭을 눌렀는데 상태 전이 히스토리가 안 보이고 서버 상태가 없다는 안내 문구만 뜨는데, 이건 로컬화된 엔티티라서 그런 건가요? [answer] | 네, 로컬화된 엔티티이기 때문입니다. 로컬화된 엔티티는 서버 공간의 상태 정보가 존재하지 않기 때문에, StateSet Debugger에서 서버 탭으로 전환하면 상태 전이 히스토리 대신 "서버 상태가 없다"는 안내 문구가 표시됩니다. 이는 버그가 아니라 로컬화된 엔티티의 특성상 발생하는 정상적인 동작입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | Step이 CurrentStateName일 때 State Name에 표시되는 값과, OnEnter일 때 표시되는 값의 차이는 무엇인가요? [answer] | Step의 종류에 따라 `State Name`에 표시되는 값의 시점과 의미가 다릅니다. **`CurrentStateName`일 때** * **표시 값:** `CurrentStateName` 프로퍼티가 **변경된 후**의 상태 이름 * **의미:** 상태가 실제로 바뀐 시점의 새로운 상태를 나타냅니다. * **특징:** `Remark` 필드에 프로퍼티가 수정된 원인(초기화, 동기화, 조건에 의한 전이, 네이티브 전이, 스크립트 전이 등)이 함께 표시됩니다. **`OnEnter`일 때** * **표시 값:** 이벤트가 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **State Name**은 Step의 종류에 따라 다르게 표시됩니다. - Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우에는 이벤트가 호출된 상태의 이름이 StateName에 나타납니다. - Step이 `CurrentStateName`인 경우에는 CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 StateName에 나타납니다. #### Remark Remark는 프로퍼티 수정 원인과 조건에 의한 전이인 경우 그와 관련된 추가 정보입니다. Step의 종류에 따라 다르게 표시됩니다.
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | 테스트 플레이를 마치고 다시 들어갔더니 이전에 쌓여 있던 상태 전이 기록이 전부 사라졌는데, 이걸 미리 JSON으로 백업해두지 않으면 영구 삭제되는 건가요? [answer] | 네, 테스트 플레이가 종료되면 상태 전이 기록은 자동으로 삭제되므로, 미리 JSON으로 내보내어 보관하지 않으면 해당 기록은 영구적으로 사라집니다. StateSet Debugger의 히스토리는 테스트 플레이 세션 동안만 유지되며, 테스트 플레이가 끝나면 기록이 지워지는 것이 기본 동작입니다. 따라서 중요한 상태 전이 로그를 확인하거나 분석해야 한다면, 테스트 플레이 중 'JSON 내보내기' 기능을 사용하여 파일로 저장해 두어야 합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | self.MapComponent 의 TileMapMode 가 MapleTile, RectTile, SideViewRectTile 중 무엇인지에 따라 각각 self.RigidbodyComponent, self.KinematicbodyComponent, self.SideviewbodyComponent 의 IsOnGround 메소드를 호출하여 지면 여부를 반환하는 IsOnGround 메소드를 작성해줘 [answer] | 사용자가 요청한 `IsOnGround` 메서드는 현재 맵 모드(`TileMapMode`)에 따라 해당하는 물리 컴포넌트를 선택하여 `IsOnGround()`를 호출하는 로직을 포함해야 합니다. 제공된 참고 문서에 있는 `IsOnGround` 메서드 구현은 이 요구사항과 정확히 일치합니다. 해당 로직은 `self.MapComponent.TileMapMode` 값을 확인하여: 1. `TileMapMode.MapleTile` 이면 `self.RigidbodyComponent:IsOnGround()` 2. `TileMapMode.Rect [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 상태 전환 메소드 플레이어의 지면 상태와 이동 속도를 확인하여 상태를 전환하도록 아래 3가지 메소드를 추가하고, 아래와 같이 작성합니다. - `CheckGroundMoveOrFall()`: 지면 여부와 이동 속도를 확인하여 상태를 전환합니다. 지면에 있고 이동 중이면 MOVE 상태로, 지면에 없고 IDLE 상태면 FALL 상태로 전환합니다. - `IsOnGround()`: 현재 맵 모드에 맞는 물리 컴포넌트를 통해 플레이어가 지면에 있는지 확인합니다. - `GetVelocity()`: 현재 맵 모드에 맞는 물리 컴포넌트
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CheckGroundMoveOrFall 메서드에서 ATTACK 상태가 아닌 경우에만 MOVE 상태로 전환하는 조건이 있는 이유는 무엇이며, ATTACK 중 이동이 허용되지 않는 구체적 시나리오는 어떤 것인가요? [answer] | `CheckGroundMoveOrFall` 메서드에서 ATTACK 상태가 아닌 경우에만 MOVE 상태로 전환하는 조건은, 캐릭터가 공격 동작을 수행하는 동안에는 이동 상태(MOVE)로 전환되지 않도록 하기 위함입니다. 이는 공격 애니메이션이나 로직이 완료될 때까지 캐릭터의 상태가 ATTACK으로 유지되도록 제어하여, 공격 도중 우발적으로 이동 상태가 덮어쓰기 되는 것을 방지하기 위한 것입니다. 참고 문서에는 ATTACK 중 이동이 허용되지 않는 구체적인 시나리오(예: 특정 스킬 쿨타임, 공격 판정 지속 시간 등)에 대한 설명은 포 [followup] | ATTACK 상태 중 이동 입력이 들어왔을 때 상태가 즉시 해제되는지, 아니면 공격 애니메이션이 끝나야만 MOVE로 전환되는지 확인하는 코드 예시를 작성해 주세요. [followup_answer] | 제공된 참고 문서에는 ATTACK 상태가 해제되는 조건(공격 애니메이션 완료 시점, 특정 타이머, 이벤트 등)에 대한 API나 코드가 포함되어 있지 않습니다. 문서에 제시된 `CheckGroundMoveOrFall` 메서드는 단순히 현재 상태가 ATTACK이 아닐 때만 MOVE로 전환하도록 막고 있을 뿐, ATTACK 상태에서 어떤 조건으로 상태가 해제되는지 정의하지 않습니다. 따라서 ATTACK 상태 중 이동 입력이 들어왔을 때 상태가 즉시 해제되는지, 아니면 애니메이션이 끝나야만 전환되는지를 확인하는 구체적인 코드 예시를 제공 [scores] | [judge_reason] | [source_doc] | #### 상태 전환 메소드 플레이어의 지면 상태와 이동 속도를 확인하여 상태를 전환하도록 아래 3가지 메소드를 추가하고, 아래와 같이 작성합니다. - `CheckGroundMoveOrFall()`: 지면 여부와 이동 속도를 확인하여 상태를 전환합니다. 지면에 있고 이동 중이면 MOVE 상태로, 지면에 없고 IDLE 상태면 FALL 상태로 전환합니다. - `IsOnGround()`: 현재 맵 모드에 맞는 물리 컴포넌트를 통해 플레이어가 지면에 있는지 확인합니다. - `GetVelocity()`: 현재 맵 모드에 맞는 물리 컴포넌트
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CheckGroundMoveOrFall 메소드에서 velocity와 비교할 때 사용하는 epsilon 값은 0.00001로 설정되어 있는데, 이 값을 더 크게 또는 작게 설정하면 어떤 문제가 발생할 수 있나요? [answer] | `CheckGroundMoveOrFall` 메소드에서 `epsilon`(0.00001)은 플레이어가 실제로 이동하고 있는지 판단하기 위한 임계값(threshold)입니다. `GetVelocity()`가 반환하는 이동 속도가 이 `epsilon`보다 클 때만 `MOVE` 상태로 전환됩니다. 이 값을 변경할 경우 다음과 같은 문제가 발생할 수 있습니다. **1. Epsilon 값을 더 크게 설정할 경우 (예: 0.1, 1.0 등)** * **느린 이동 시 IDLE 상태 유지:** 플레이어가 아주 천천히 이동하더라도 속도가 `eps [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 상태 전환 메소드 플레이어의 지면 상태와 이동 속도를 확인하여 상태를 전환하도록 아래 3가지 메소드를 추가하고, 아래와 같이 작성합니다. - `CheckGroundMoveOrFall()`: 지면 여부와 이동 속도를 확인하여 상태를 전환합니다. 지면에 있고 이동 중이면 MOVE 상태로, 지면에 없고 IDLE 상태면 FALL 상태로 전환합니다. - `IsOnGround()`: 현재 맵 모드에 맞는 물리 컴포넌트를 통해 플레이어가 지면에 있는지 확인합니다. - `GetVelocity()`: 현재 맵 모드에 맞는 물리 컴포넌트
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | StateSet Debugger의 로그 개수가 100개 제한이라는데, 100개를 초과하면 가장 오래된 기록부터 자동으로 삭제되는 건가요? [answer] | 네, 맞습니다. StateSet Debugger는 최대 100개까지 상태 전이 기록을 저장합니다. 기록된 로그의 개수가 100개를 초과하면, 가장 오래된 기록부터 자동으로 삭제되어 항상 최신 100개의 기록만 유지됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 폰트 [question] | Custom Font Group 패널의 Font 탭에서 단일 폰트를 추가할 때 RUID 지정 방법과 Regular, Bold 폰트 리소스를 설정하는 구체적인 과정은 무엇인가요? [answer] | Custom Font Group 패널의 Font 탭에서 단일 폰트를 추가하고 RUID를 지정하는 과정은 다음과 같습니다. 1. **Panels - Custom Font Group** 메뉴로 이동하여 **Font** 탭을 선택합니다. 2. **Font Name** 입력란에 추가할 폰트의 이름을 입력합니다. 3. **폰트 리소스 RUID** 항목에서 폰트 파일을 지정합니다. 이 단계에서 **Regular**와 **Bold** 각각에 해당하는 리소스를 설정할 수 있습니다. * RUID 값을 직접 텍스트로 입력하거나, 리 [followup] | 리소스 피커 버튼을 통해 RUID를 지정하는 방법과, Regular 및 Bold 각각에 대한 폰트 리소스 RUID를 어떻게 입력하고 확인하는지 단계별로 설명해 주세요. [followup_answer] | 리소스 피커 버튼을 통해 RUID를 지정하고 Regular 및 Bold 폰트 리소스를 설정하는 단계는 다음과 같습니다. 1. **Panels - Custom Font Group** 메뉴로 이동하여 **Font** 탭을 선택합니다. 2. **Font Name** 입력란에 추가할 폰트의 이름을 입력합니다. 3. **폰트 리소스 RUID** 항목에서 **Regular**와 **Bold** 각각에 해당하는 리소스를 설정합니다. * **리소스 피커 사용:** 해당 항목의 리소스 피커 버튼을 누릅니다. * **리소 [scores] | [judge_reason] | [source_doc] | 제작한 월드의 분위기와 어울리는 폰트를 추가해 월드의 텍스트에 적용할 수 있습니다. 폰트를 리소스 스토리지에 등록하고, 커스텀 폰트 그룹창에서 월드에 사용할 폰트를 묶는 방법에 대해 알아봅시다. ## 리소스 스토리지에 폰트 추가 월드에서 폰트를 사용하기 위해서는 먼저 리소스 스토리지에 폰트를 등록해야 합니다. 폰트 등록 시 이름은 **알파벳 대소문자, `_`, `-`, 숫자** 조합만 가능합니다. 리소스 스토리지에 업로드할 폰트의 저작권과 사용 범위를 반드시 확인한 후 등록하길 권장합니다. 폰트 파일 등록 방법은 아래와 같습니
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | self.MapComponent가 nil인 경우와 각 TileMapMode에 해당하는 컴포넌트가 nil인 경우의 오류 처리 방식이 동일한지, 그리고 이렇게 설계된 의도는 무엇인가요? [answer] | 제시된 코드 예시를 분석하면, `self.MapComponent`가 `nil`인 경우와 각 `TileMapMode`에 해당하는 물리 컴포넌트가 `nil`인 경우의 오류 처리 방식은 **동일합니다.** ### 1. 오류 처리 방식의 동일성 두 경우 모두 **에러를 발생시키지 않고 함수를 안전하게 종료하며 기본값(`0`)을 반환**하는 방식으로 처리됩니다. * **`self.MapComponent`가 `nil`인 경우:** ```lua local mapComponent = self.MapComponent i [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] number GetVelocity() { local mapComponent = self.MapComponent if mapComponent == nil then return 0 end local timeMapMode = mapComponent.TileMapMode if timeMapMode == TileMapMode.MapleTile then local comp = self.RigidbodyComponent if comp
[task] | single_turn [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | 메이커에서 Edit - Preferences 경로를 통해 StateSet Debugger Recording 옵션을 꺼두었는데, 이 상태에서 테스트 플레이를 하면 히스토리가 전혀 기록되지 않나요? [answer] | 네, `Edit - Preferences - 만들기 - 테스트 플레이 - StateSet Debugger Recording` 옵션을 꺼둔 상태에서는 테스트 플레이 중 상태 전이 히스토리가 기록되지 않습니다. 해당 옵션이 비활성화되어 있을 경우 StateSet Debugger의 히스토리 창에는 기록 대신 안내 문구가 표시됩니다. 따라서 옵션이 켜져 있어야만 Client 또는 Server 탭에서 상태 전이 기록을 확인하거나 JSON으로 내보낼 수 있습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S
[task] | code [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | StateComponent 를 가진 로컬화된 엔티티의 경우 Client 상태만 표시되는 특성을 이용하여, OnBeginPlay 에서 실행 공간이 Client 인지 확인하고 해당 상태만 추적하도록 설정하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에 따르면, StateSet Debugger는 **StateSet Editor에서 제작한 StateSet을 StateComponent에 지정했을 때만** 사용할 수 있으며, 이 도구는 테스트 플레이 환경에서 StateSet의 내부 상태 전이를 시각적으로 추적하는 용도입니다. 문서에는 StateSet Debugger가 로컬화된 엔티티의 경우 **Client 상태만 표시**된다고 명시되어 있습니다. 하지만 이 특성을 이용하여 `OnBeginPlay`에서 실행 공간을 확인하고 상태 추적을 설정하는 **mLua 스크립트 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | StateSet Debugger는 테스트 플레이 환경에서 실행되고 있는 StateSet의 내부 상황을 시각적으로 추적할 수 있도록 도와주는 도구입니다. ##### 참고 가이드 - [타입의 이해](/docs/docs-1038{target}) - [StateSet 제어하기](/docs/docs-1398{target}) ##### 참고 API Reference - [StateComponent](/apiReference/Components/StateComponent{target}) ## StateSet Debugger 소개 Stat
[task] | instruction_following [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | BehaviourTree Debugger의 JSON 파일 구조에서 최상위 필드와 `Ticks` 배열 내부의 필드 명세표를 표로 정리하세요. [answer] | BehaviourTree Debugger에서 내보내는 JSON 파일의 필드 명세는 다음과 같습니다. ### 최상위 필드 | 필드 | 설명 | | --- | --- | | `EntityId` | 디버깅 대상 엔티티의 Id입니다. | | `AuthorityType` | 행동 트리가 실행되는 공간입니다. `Client`, `Server`로 구분됩니다. | | `ExportedAt` | JSON 파일이 내보내진 날짜와 시간입니다. | | `RecordTime` | 기록이 이루어진 시간입니다. 단위는 초입니다. | | `Count` | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | BehaviourTree Debugger에서 기록을 내보낸 JSON 파일에 Status 필드가 항상 표시되는 건가요? [answer] | 아니요, `Status` 필드는 항상 표시되지 않습니다. `Status` 필드는 노드의 `Phase` 값이 `Exit`인 경우에만 기록됩니다. 즉, 노드가 진입하는 순간(`Phase`가 `Enter`)에는 `Status` 정보가 포함되지 않으며, 노드가 종료되는 순간(`Phase`가 `Exit`)에만 실행 결과(`Running`, `Success`, `Failure` 중 하나)가 기록됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | instruction_following [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | BehaviourTree Debugger에서 기록된 데이터를 JSON 형식으로 표현할 때, `Tick` 42번 틱에서 `Selector` 노드가 `Enter`와 `Exit` 단계로 실행된 예를 코드만 출력하고 필드 설명은 주석으로 작성하세요. [answer] | ```lua -- EntityId: 디버깅 대상 엔티티의 Id입니다. -- AuthorityType: 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. -- ExportedAt: JSON 파일이 내보내진 날짜와 시간입니다. -- RecordTime: 기록이 이루어진 시간입니다. 단위는 초입니다. -- Count: 기록의 개수입니다. -- Ticks: 틱별 기록 목록입니다. -- Tick: 기록이 발생한 틱 번호입니다. -- Records: 해당 틱에서 실행된 노드 기록 목록입니다. -- Dep [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | code [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | StateSet Debugger의 기록 기능은 메이커 인터페이스의 설정과 UI 조작 대상이며, 제공된 문서에는 해당 디버거 기능을 제어하거나 데이터를 직접 처리하는 mLua 스크립트 API(메서드, 이벤트 핸들러, 서비스)가 정의되어 있지 않으므로, 주어진 문서 정보만으로는 해결할 수 있는 mLua 코딩 과제를 작성할 수 없습니다. [answer] | StateSet Debugger는 메이플스토리 월드 메이커의 테스트 플레이 환경에서 상태 전이 기록을 시각적으로 확인하고 관리하기 위한 **UI 도구**입니다. 제공된 문서에 따르면, StateSet Debugger의 기록 시작/중지, JSON 내보내기, 히스토리 삭제, 검색 등 모든 조작은 메이커 인터페이스를 통해 수행되며, 이를 제어하거나 데이터에 접근하기 위한 mLua 스크립트 API(메서드, 이벤트 핸들러, 서비스)는 정의되어 있지 않습니다. 따라서 StateSet Debugger의 기록 기능을 직접 제어하거나 그 데이터를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S
[task] | two_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | BehaviourTree Debugger에서 기록을 JSON 파일로 내보내는 과정과 생성된 JSON의 구조에 대해 알려줘 [answer] | BehaviourTree Debugger에서 기록을 JSON 파일로 내보내는 과정과 생성된 JSON 파일의 구조는 다음과 같습니다. ### 1. JSON 파일 내보내기 과정 1. **기록 시작**: BehaviourTree Debugger를 통해 엔티티의 행동 트리 실행을 기록합니다. 2. **기록 중지**: 원하는 시점에 기록을 중지합니다. 3. **내보내기**: 중지된 후, 그동안 쌓인 기록을 JSON 파일 형식으로 내보냅니다. 기록은 **한 틱(Tick)**을 기준으로 묶이며, 노드가 실행된 순서대로 기록됩니다. # [followup] | JSON 내 'Status' 필드는 언제 기록되며, 'Phase' 값이 'Exit'일 때만 기록된다는 점의 구체적인 예외 상황은 무엇인가? [followup_answer] | BehaviourTree Debugger의 JSON 기록에서 `Status` 필드의 기록 조건과 예외 상황에 대해 설명합니다. ### 1. `Status` 필드의 기록 조건 `Status` 필드는 **`Phase` 값이 `Exit`일 때만** 기록됩니다. * `Phase`가 `Enter`인 경우: `Status` 필드는 기록되지 않습니다. * `Phase`가 `Exit`인 경우: `Status` 필드가 기록되며, 그 값은 `Running`, `Success`, `Failure` 중 하나가 됩니다. 이는 노드가 진입(Ent [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | Blackboard 패널을 접었다 펼쳤을 때와 Inspector에서 노드를 다시 클릭했을 때 값 갱신 방식이 왜 다른 건가요? [answer] | BehaviourTree Debugger의 Blackboard 패널과 Inspector 패널은 값을 갱신하는 시점이 다릅니다. Blackboard 패널은 행동 트리의 변수와 현재 값을 보여주는 영역으로, 패널을 접었다가 다시 펼쳤을 때 자동으로 최신 값으로 갱신됩니다. 즉, 사용자가 패널을 다시 열기만 하면 그 시점의 가장 최신인 Blackboard 변수 값들을 확인할 수 있습니다. 반면, Inspector 패널은 선택한 특정 노드의 프로퍼티와 현재 값을 보여주는 영역입니다. 이 패널은 패널을 접었다 펼치는 것만으로 값이 갱신되 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | 내보낸 JSON에서 Ticks 배열 안의 Records가 한 틱 기준이 아니라 노드 실행 순서대로만 정렬되는 걸로 보이는데, 틱 번호가 다른 기록들이 섞여 나올 수 있나요? [answer] | 아니요, 틱 번호가 다른 기록들이 섞여 나올 수 없습니다. 기록은 한 틱을 기준으로 묶이며, 실행된 순서대로 기록됩니다. 따라서 내보낸 JSON 파일의 `Ticks` 배열은 각 요소를 하나의 틱으로 구성하며, 해당 틱 내에서 실행된 모든 노드 기록(`Records`)만 그 틱의 배열 안에 포함됩니다. 다른 틱에 해당하는 기록은 같은 `Records` 배열에 섞이지 않고, 반드시 다른 틱 번호를 가진 별도의 객체로 구분됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | 새로운 엔티티를 디버깅하려고 다른 엔티티를 선택했는데 기존에 열린 창이 그대로 유지되는데, 새 대상을 보기 위해 어떻게 해야 하나요? [answer] | 기존에 열린 Behaviour Tree Debugger 창은 최초에 선택한 대상 엔티티에 고정되어 있어서, 다른 엔티티를 선택해도 창 내부의 디버깅 대상이 바뀌지 않습니다. 새로운 엔티티를 디버깅하려면 아래 순서대로 진행해야 합니다. 1. 디버깅하려는 **새로운 대상 엔티티**를 선택합니다. 2. 해당 엔티티의 `AIComponent`의 `UpdateAuthority` 값에 맞는 Hierarchy 창(서버 측이면 Server Hierarchy, 클라이언트 측이면 Hierarchy)을 확인합니다. 3. 프로퍼티 창의 `AIC [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | Phase가 Exit일 때만 기록된다는 설명이 있는데, 노드가 실패(Failure)한 경우에도 반드시 Exit 단계 기록이 남나요? [answer] | 네, 노드가 실패(Failure)한 경우에도 반드시 Exit 단계 기록이 남습니다. Phase가 `Exit`로 기록되는 것은 노드가 진입(Enter) 이후 어떤 상태로든 종료될 때 발생하며, 종료 시점의 상태(Status)에 따라 `Success`, `Failure`, `Running` 중 하나로 기록됩니다. 따라서 실패로 종결된 노드도 `Phase`가 `Exit`인 기록이 생성되고, 해당 기록의 `Status` 필드에 `Failure` 값이 저장됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | 기록된 JSON 파일에서 Count 값과 실제 Ticks 배열 안에 있는 Records의 총 개수가 일치하지 않을 때 어떤 원인이 있을까요? [answer] | 제공된 참고 문서에는 `Count` 필드가 "기록의 개수"로 정의되어 있고, JSON 구조에서 `Ticks` 배열 안의 `Records`가 실제 노드 진입/종료 기록을 담고 있다고 설명되어 있습니다. 하지만 문서에는 **`Count` 값과 실제 `Records` 총 개수가 일치하지 않는 경우의 원인이나 처리 로직에 대한 정보가 전혀 없습니다.** 따라서 제공된 문서 범위 내에서 그 원인을 설명할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | single_turn [pass] | ⏳ 미판정 [title] | BehaviourTree Debugger [question] | AuthorityType 값이 Client로 나와서 클라이언트에서만 실행되는 트리를 디버깅 중인데, 서버에서 실행되는 트리는 어떻게 기록하나요? [answer] | BehaviourTree Debugger는 행동 트리가 실행되는 공간(AuthorityType)에 따라 기록을 구분합니다. 클라이언트에서 실행되는 트리를 디버깅하면 `AuthorityType` 값이 `Client`로 기록되며, 서버에서 실행되는 트리를 디버깅하면 `AuthorityType` 값이 `Server`로 기록됩니다. 따라서 서버에서 실행되는 트리를 기록하려면, 해당 트리가 서버 공간에서 실행되도록 설정한 상태로 BehaviourTree Debugger의 기록 기능을 사용하시면 됩니다. 내보낸 JSON 파일의 `Author [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J
[task] | code [pass] | ⏳ 미판정 [title] | StateSet Debugger [question] | StateComponent 를 가진 엔티티가 테스트 플레이 중 StateSet Debugger 를 통해 추적되도록 하기 위해, OnBeginPlay 시점과 OnUpdate 주기로 현재 상태 변화를 log 로 출력하는 스크립트를 작성해줘 [answer] | StateSet Debugger는 테스트 플레이 환경에서 StateComponent를 가진 엔티티를 선택하고 프로퍼티 창의 `Open StateSetDebugger` 버튼을 눌러 시각적으로 추적하는 도구이며, 코드에서 직접 디버거를 열거나 제어하는 API는 문서에 존재하지 않습니다. 하지만 요청하신 대로 `OnBeginPlay` 시점과 `OnUpdate` 주기에서 현재 상태(`CurrentStateName`)를 확인하고 `log`로 출력하는 스크립트는 다음과 같이 작성할 수 있습니다. ```lua Method: [server o [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | StateSet Debugger는 테스트 플레이 환경에서 실행되고 있는 StateSet의 내부 상황을 시각적으로 추적할 수 있도록 도와주는 도구입니다. ##### 참고 가이드 - [타입의 이해](/docs/docs-1038{target}) - [StateSet 제어하기](/docs/docs-1398{target}) ##### 참고 API Reference - [StateComponent](/apiReference/Components/StateComponent{target}) ## StateSet Debugger 소개 Stat
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | IsOnGround 메서드가 맵 모드(TileMapMode)에 따라 다른 물리 컴포넌트(RigidbodyComponent, KinematicbodyComponent, SideviewbodyComponent)를 호출하는 구조인데, 맵 모드가 변경되는 순간 컴포넌트 참조가 실패하거나 nil이 되는 예외 상황을 어떻게 방지할 수 있나요? [answer] | 제시된 참고 문서에는 `IsOnGround()` 메서드가 현재 `MapComponent.TileMapMode` 값에 따라 `RigidbodyComponent`, `KinematicbodyComponent`, `SideviewbodyComponent` 중 하나를 선택하여 `IsOnGround()`를 호출하는 구조만 설명하고 있습니다. 문서에 따르면, 맵 모드 변경 시점에 컴포넌트 참조가 `nil`이 되거나 실패하는 예외 상황을 방지하기 위한 **추가적인 안전장치 코드(예: 맵 모드 변경 이벤트 리스너, 컴포넌트 재조회 로직 등)** [followup] | 맵 모드 변경 시점(self.MapComponent.TileMapMode 변경 감지)에 물리 컴포넌트 참조를 재설정하거나, nil 체크 로직을 강화하여 안전성을 높이는 mLua 코드 수정 예시를 보여 주세요. [followup_answer] | 제시된 참고 문서에는 `IsOnGround()` 메서드 내부에서 각 물리 컴포넌트가 `nil`인지 확인하는 로직이 포함되어 있으나, **맵 모드(`TileMapMode`)가 변경되는 시점을 감지하여 물리 컴포넌트 참조를 재설정하거나 갱신하는 메서드, 이벤트 핸들러, 또는 관련 API는 문서에 존재하지 않습니다.** 따라서 문서에 근거하여 맵 모드 변경 감지 및 컴포넌트 재설정 코드를 작성할 수 없습니다. 문서에 명시된 내용만을 바탕으로 할 때, 안전성을 높일 수 있는 유일한 방법은 이미 제공된 `IsOnGround()` 코드처럼 [scores] | [judge_reason] | [source_doc] | #### 상태 전환 메소드 플레이어의 지면 상태와 이동 속도를 확인하여 상태를 전환하도록 아래 3가지 메소드를 추가하고, 아래와 같이 작성합니다. - `CheckGroundMoveOrFall()`: 지면 여부와 이동 속도를 확인하여 상태를 전환합니다. 지면에 있고 이동 중이면 MOVE 상태로, 지면에 없고 IDLE 상태면 FALL 상태로 전환합니다. - `IsOnGround()`: 현재 맵 모드에 맞는 물리 컴포넌트를 통해 플레이어가 지면에 있는지 확인합니다. - `GetVelocity()`: 현재 맵 모드에 맞는 물리 컴포넌트