[task] | extract_knowledge [title] | StateSet Debugger [category] | Guides [rephrased] | # StateSet Debugger 테스트 플레이 중 발생한 상태 전이 기록을 확인하고 분석하는 도구입니다. 이 절에서는 StateSet Debugger의 개념, UI 구성 요소, 그리고 사용 시 주의할 사항을 설명합니다. ## 1. 개념 StateSet Debugger는 테스트 플레이 세션 동안 발생한 State Set의 상태 전이 이력을 시각적으로 기록합니다. * **기록 범위:** Client와 Server 실행 공간별로 분리하여 기록됩니다. * **순서:** 시간 순으로 기록됩니다. * **제한:** 최대 [original] | 테스트 플레이 중 발생한 상태 전이 기록입니다. 히스토리는 Client, Server로 나누어 기록되고, 시간 순으로 기록됩니다. 최대 **100개**까지 기록되며, 테스트 플레이가 종료되면 상태 전이 기록은 **삭제**됩니다. 필요한 경우 JSON으로 내보내어 보관할 수 있습니다. 로컬화된 엔티티는 서버 공간의 상태가 없으므로, 서버 탭으로 전환하면 히스토리 대신 서버 상태가 없다는 안내 문구가 표시됩니다. >**Tip** > 히스토리 기록 여부는 메이커의 **Edit - Preferences - 만들기 - 테스트 플레이 - S [chunk_id] | Guides:1405:1
[task] | knowledge_list [title] | StateSet Debugger [category] | Guides [rephrased] | 제시된 문서 내용만을 기반으로 StateSet Debugger의 핵심 사실을 정리한 목록입니다. 1. **State Name 표시 규칙 (이벤트 계열)**: Step이 `OnEnter`, `OnUpdate`, `OnExit` 중 하나인 경우, State Name 필드에는 해당 이벤트가 호출된 시점의 상태 이름이 표시됩니다. 2. **State Name 표시 규칙 (변경 계열)**: Step이 `CurrentStateName`인 경우, State Name 필드에는 `CurrentStateName` 프로퍼티가 변경된 후의 상태 이름이 [original] | **State Name**은 Step의 종류에 따라 다르게 표시됩니다. - Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우에는 이벤트가 호출된 상태의 이름이 StateName에 나타납니다. - Step이 `CurrentStateName`인 경우에는 CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 StateName에 나타납니다. #### Remark Remark는 프로퍼티 수정 원인과 조건에 의한 전이인 경우 그와 관련된 추가 정보입니다. Step의 종류에 따라 다르게 표시됩니다. [chunk_id] | Guides:1405:2
[task] | wikipedia [title] | BehaviourTree Debugger [category] | Guides [rephrased] | # BehaviourTree Debugger BehaviourTree Debugger는 테스트 플레이 환경에서 실행 중인 AIComponent의 행동 트리가 어떻게 변화하는지 추적하고, 잠재적인 문제의 원인을 파악하기 위한 도구입니다. ## 참고 자료 * [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) * [행동 트리 노드 만들기](/docs?postId=1155) * [AIComponent API Reference](/apiReference/Components/AIComponen [original] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a [chunk_id] | Guides:1406:0
[task] | wikipedia [title] | StateSet Debugger [category] | Guides [rephrased] | # 게임 로직 StateSet Debugger 본 섹션은 `StateSet` 컴포넌트의 상태 전이 히스토리를 기록하고 분석하는 **StateSet Debugger**의 동작 방식과 데이터 내보내기 기능을 설명합니다. ## State Name 표시 규칙 디버거의 `State Name` 필드는 현재 기록 중인 `Step`의 종류에 따라 다른 값이 표시됩니다. * **이벤트 호출 시 (`OnEnter`, `OnUpdate`, `OnExit`)**: 해당 이벤트가 호출된 시점의 상태 이름이 표시됩니다. * **상태 변경 시 [original] | **State Name**은 Step의 종류에 따라 다르게 표시됩니다. - Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우에는 이벤트가 호출된 상태의 이름이 StateName에 나타납니다. - Step이 `CurrentStateName`인 경우에는 CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 StateName에 나타납니다. #### Remark Remark는 프로퍼티 수정 원인과 조건에 의한 전이인 경우 그와 관련된 추가 정보입니다. Step의 종류에 따라 다르게 표시됩니다. [chunk_id] | Guides:1405:2
[task] | diverse_qa [title] | StateSet Debugger [category] | Guides [rephrased] | 질문: Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우 State Name 필드에는 어떤 값이 표시됩니까? 답변: 이벤트가 호출된 상태의 이름이 State Name에 나타납니다. 질문: Step이 `CurrentStateName`인 경우 State Name 필드에는 어떤 값이 표시됩니까? 답변: CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 State Name에 나타납니다. 질문: Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우 Remark 필드에는 어떤 [original] | **State Name**은 Step의 종류에 따라 다르게 표시됩니다. - Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우에는 이벤트가 호출된 상태의 이름이 StateName에 나타납니다. - Step이 `CurrentStateName`인 경우에는 CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 StateName에 나타납니다. #### Remark Remark는 프로퍼티 수정 원인과 조건에 의한 전이인 경우 그와 관련된 추가 정보입니다. Step의 종류에 따라 다르게 표시됩니다. [chunk_id] | Guides:1405:2
[task] | extract_knowledge [title] | BehaviourTree Debugger [category] | Guides [rephrased] | # BehaviourTree Debugger 기록 및 내보내기 ## 개념 설명 BehaviourTree Debugger는 행동 트리의 실행 과정을 기록하여 분석할 수 있는 도구입니다. 기록은 틱(Tick) 단위로 묶이며, 노드가 실행된 순서대로 저장됩니다. 각 기록은 노드의 진입(`Enter`) 또는 종료(`Exit`) 이벤트를 포함합니다. 특히 `Exit` 단계에서는 노드의 최종 실행 상태(`Status`)가 함께 기록됩니다. ## API 및 데이터 형식 사용법 기록을 중지한 후, 축적된 데이터를 JSON 파일로 내보낼 수 있 [original] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J [chunk_id] | Guides:1406:1
[task] | extract_knowledge [title] | BehaviourTree Debugger [category] | Guides [rephrased] | # BehaviourTree Debugger BehaviourTree Debugger는 테스트 플레이 환경에서 실행 중인 `AIComponent`의 행동 트리(Behaviour Tree) 변화를 시각적으로 추적하고, AI 동작의 문제 원인을 파악하기 위한 도구입니다. ## 개념 설명 BehaviourTree Debugger는 특정 엔티티에 고정되어 동작합니다. 한 번 디버거 창을 열면, 다른 엔티티를 선택해도 디버거의 대상이 바뀌지 않습니다. 새로운 엔티티의 AI를 디버깅하려면 해당 엔티티를 선택하여 다시 디버거를 열어야 합니 [original] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a [chunk_id] | Guides:1406:0
[task] | diverse_qa [title] | BehaviourTree Debugger [category] | Guides [rephrased] | 질문: BehaviourTree Debugger는 어떤 환경에서만 사용할 수 있는가? 답변: BehaviourTree Debugger는 테스트 플레이 환경에서만 사용할 수 있으며, 그 외 환경에서는 Behaviour Tree Debugger 버튼이 노출되지 않습니다. 질문: AIComponent의 UpdateAuthority 값이 Server일 때, BehaviourTree Debugger를 열기 위해 어떤 창을 통해 접근해야 하는가? 답변: UpdateAuthority 값이 Server인 경우 Server Hierarchy 창을 [original] | BehaviourTree Debugger를 활용해 테스트 플레이 환경에서 실행되고 있는 AIComponent의 행동 트리의 변화를 추적하고 문제 원인을 파악할 수 있습니다. ##### 참고 가이드 - [BehaviourTree 에디터로 AI 만들기](/docs?postId=1399) - [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference - [AIComponent](/apiReference/Components/AIComponent) - [UpdateAuthorityType](/a [chunk_id] | Guides:1406:0
[task] | diverse_qa [title] | BehaviourTree Debugger [category] | Guides [rephrased] | 질문: 기록을 중지한 뒤, 그동안 쌓인 기록을 어떤 형식의 파일로 내보낼 수 있나요? 답변: JSON 파일로 내보낼 수 있습니다. 질문: BehaviourTree Debugger의 기록은 어떤 기준으로 묶이며, 어떤 순서로 기록되나요? 답변: 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 질문: 노드의 단계가 '진입'인 경우 Phase 필드에는 어떤 값이 기록되나요? 답변: `Enter`로 기록됩니다. 질문: 노드의 단계가 '종료'인 경우 Phase 필드에는 어떤 값이 기록되나요? 답변: `Exit`로 기록됩니 [original] | 기록을 중지한 뒤, 그동안 쌓인 기록을 JSON 파일로 내보낼 수 있습니다. 기록은 한 틱을 기준으로 묶이고, 실행된 순서대로 기록됩니다. 노드의 단계가 진입인 경우 Phase가 `Enter`, 종료인 경우 Phase가 `Exit`로 기록됩니다. JSON 파일 형식은 아래와 같습니다. | 필드 | 설명 | | --- | --- | | EntityId | 디버깅 대상 엔티티의 Id입니다. | | AuthorityType | 행동 트리가 실행되는 공간입니다. Client, Server로 구분됩니다. | | ExportedAt | J [chunk_id] | Guides:1406:1
[task] | extract_knowledge [title] | StateSet Debugger [category] | Guides [rephrased] | # StateSet Debugger StateSet Debugger는 `StateComponent`의 상태 전이와 이벤트를 시각적으로 추적하고 분석하는 도구입니다. 이 절에서는 디버거가 표시하는 `State Name`과 `Remark` 필드의 의미, 그리고 상태 전이 히스토리를 JSON 형식으로 내보내는 방법에 대해 설명합니다. ## 1. 개념 설명 ### 1.1 State Name `State Name`은 로그의 `Step` 종류에 따라 다른 값을 가집니다. * **`Step`이 `OnEnter`, `OnUpdate`, [original] | **State Name**은 Step의 종류에 따라 다르게 표시됩니다. - Step이 `OnEnter`, `OnUpdate`, `OnExit`인 경우에는 이벤트가 호출된 상태의 이름이 StateName에 나타납니다. - Step이 `CurrentStateName`인 경우에는 CurrentStateName 프로퍼티가 변경된 후의 상태 이름이 StateName에 나타납니다. #### Remark Remark는 프로퍼티 수정 원인과 조건에 의한 전이인 경우 그와 관련된 추가 정보입니다. Step의 종류에 따라 다르게 표시됩니다. [chunk_id] | Guides:1405:2