[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnMapEnter, OnMapLeave, CanControl, OnControlEnabled 메서드를 구현하여 맵 이동 중 컨트롤을 차단하는 [client only] PlayerController 스크립트를 작성해줘 [answer] | 제공된 문서를 기반으로 `OnMapEnter`, `OnMapLeave`, `CanControl`, `OnControlEnabled` 메서드를 구현하여 맵 이동 중 컨트롤을 차단하는 `[client only]` PlayerController 스크립트를 작성했습니다. 해당 메서드들이 정상적으로 동작하려면 `IsValid`, `IsMapMoving`, `StateComponent`, `MovementComponent`, `PressedKeys` 등의 프로퍼티가 정의되어야 하며, `ResetKeys()` 메서드가 필요합니다. 문서에 명시 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | InitEventHandlers 메서드에서 _InputService의 ConnectEvent 메서드를 사용하여 KeyDownEvent, KeyUpEvent, KeyHoldEvent에 각각 self.OnKeyDown, self.OnKeyUp, self.OnKeyHold 핸들러를 연결하는 스크립트를 작성해줘 [answer] | 참고 문서에 명시된 `InitEventHandlers` 메서드와 `_InputService:ConnectEvent` API를 기반으로 작성한 스크립트입니다. ```lua Method: [client only] void InitEventHandlers() { _InputService:ConnectEvent(KeyDownEvent, self.OnKeyDown) _InputService:ConnectEvent(KeyUpEvent, self.OnKeyUp) _InputService:ConnectEvent(KeyHol [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `KeyInfo` StructType의 `State`와 `Value` 프로퍼티를 초기화하고, `KeyStateEnum`의 값을 참조하여 키 입력 상태를 갱신하는 로직을 구현하는 스크립트를 작성해줘 [answer] | 사용자가 요청한 `KeyInfo` StructType의 초기화와 `KeyStateEnum` 참조를 통한 상태 갱신 로직은, 주어진 참고 문서에 구체적인 함수명이나 이벤트 핸들러(예: 키 입력 감지용 Event Handler)가 명시되어 있지 않습니다. 참고 문서에는 `KeyStateEnum`과 `KeyInfo`의 **정의(Structure/Property)**만 제시되어 있을 뿐, 실제로 키 입력을 감지하여 `State`와 `Value`를 변경하는 **구체적인 구현 코드(예: `HandleKeyDownEvent` 등)는 포함되지 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | InitHoldActions 메서드에서 MoveUp, MoveDown, MoveLeft, MoveRight, Jump, Jump2 액션들을 HoldActions 테이블에 true로 설정하여 누르고 있는 동안 유지되도록 하는 스크립트를 작성해줘 [answer] | `InitHoldActions` 메서드에서 지정된 액션들이 `HoldActions` 테이블에 `true`로 설정되어 누르고 있는 동안 유지되도록 하는 스크립트는 다음과 같습니다. ```lua Method: [client only] void InitHoldActions() { local holdActions = self.HoldActions holdActions["MoveUp"] = true holdActions["MoveDown"] = true holdActions["MoveLeft"] = t [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnBeginPlay에서 PlayerControllerComponent의 UseCustomScript가 true인지 확인하고, LocalPlayer인 경우에만 InitKeys, InitHoldActions, InitEventHandlers, CacheComponents 메서드를 호출하여 초기화하는 스크립트를 작성해줘 [answer] | 사용자가 요청한 `OnBeginPlay` 초기화 로직을 구현한 스크립트입니다. `PlayerControllerComponent.UseCustomScript`가 `true`이고 현재 엔티티가 `_UserService.LocalPlayer`인 경우에만 `InitKeys`, `InitHoldActions`, `InitEventHandlers`, `CacheComponents` 메서드를 호출하도록 작성되었습니다. ```lua Method: [client only] void OnBeginPlay() { local entity = s [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnControlEnabled(false)가 호출될 때 ResetKeys와 MovementComponent:Stop을 실행하는 구체적인 목적은 무엇인가요? [answer] | `OnControlEnabled(false)`가 호출될 때 `ResetKeys()`와 `MovementComponent:Stop()`을 실행하는 구체적인 목적은 **플레이어의 조작 상태를 완전히 초기화하여, 컨트롤이 비활성화된 상태에서도 의도치 않은 이동이나 동작이 발생하지 않도록 차단**하는 것입니다. 구체적인 이유는 다음과 같습니다. 1. **`ResetKeys()` 실행 목적:** * 플레이어는 맵 이동 중 또는 컨트롤이 비활성화된 상태에서 여전히 키를 누르고 있을 수 있습니다. * `PressedK [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnKeyDown 메서드에서 키 입력 처리 순서를 4단계 번호 목록으로 정리해 주세요. [answer] | `OnKeyDown()` 메서드에서 키 입력 처리는 다음 4단계 순서로 진행됩니다. 1. **입력 처리 가능 상태 및 계층 활성화 확인** `CanControl()`과 `EnableInHierarchy`를 검사하여 캐릭터가 조작 가능 상태이고 계층이 활성화되어 있는지 확인합니다. 이 조건을 만족하지 못하면 즉시 반환합니다. 2. **상호작용 및 홀드(Hold) 상태 갱신** 키가 `InteractionKeys`에 해당하면 상호작용 액션을 실행하고, `ActionKeys`에 매핑된 액션 이름(`actionName`)을 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `InitEventHandlers()`에서 `InputService`의 키 입력 이벤트에 연결된 핸들러 메소드를 아래와 같이 작성합니다. - `OnKeyDown()`: 키를 누르는 순간의 입력을 처리하여 액션을 실행하고 입력 상태를 갱신합니다. - `SendActionEventToServer()`: 커스텀 액션 이벤트를 서버로 전송합니다. - `OnKeyUp()`: 키에서 손을 떼는 순간의 입력을 처리하여 관련 상태를 해제합니다. - `OnKeyHold()`: 키를 누르고 있는 동안의 입력 상태를 갱신합니다. - `BlockInp
[task] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | `eventdatas` 목록의 `TriggerTime`이 0.1초를 초과하는 이벤트가 포함된 프레임만 필터링하여, 해당 프레임의 `rotation` 값을 `Property: [Sync] number CurrentRotation` 에 저장하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서에는 `AvatarAction` JSON 파일의 구조와 필드 설명만 포함되어 있습니다. mLua 스크립트 컴포넌트에서 `AvatarAction` JSON 파일을 직접 로드하고 파싱하여 `eventdatas`를 필터링하는 API(예: `LoadAvatarAction`, `GetAvatarActionData` 등)에 대한 정보는 문서에 존재하지 않습니다. 따라서 **기존 API를 지어내지 않고**, 이미 로드된 AvatarAction 데이터를 `table` 형태로 전달받거나, `_DataStorageService` 등 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | AvatarAction JSON 파일의 구조는 아래와 같습니다. ```lua { "Data": { "NewAvatarAction": { "Frames": [ { "defined_actionname": "stand1", "frameindex": 0, "framedelay": 0.156, "move_x": 0, "move_y": -1, "rotation": 0, "flip":
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | HitEvent가 발생했는데 StateComponent의 상태가 "HIT"로 변경되지 않을 때, 어떤 부분을 확인해야 하나요? [answer] | HitEvent가 발생했는데 StateComponent의 상태가 "HIT"로 변경되지 않는다면, 아래 순서로 코드를 점검해야 합니다. 1. **커스텀 이벤트 핸들러 등록 여부 확인** 기본 제공되는 HitEvent 핸들러는 제거되고, 커스텀 핸들러가 등록되어야 상태가 바뀝니다. `InitStateComponentEventHandler()` 메서드가 실행되었는지, 그리고 해당 메서드가 클라이언트 측에서만 실행되는 `[client only]` 속성을 가지고 있는지 확인하세요. 2. **StateComponent 참조 변수 초기 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | `flip` 속성이 true인 프레임의 `frameindex`를 수집하여, `OnBeginPlay()` 메서드에서 `_EntityService:GetEntityByPath`로 특정 엔티티를 가져온 후 해당 엔티티의 `TransformComponent.Position` 을 `move_y` 값만큼 Y축 방향으로 이동시키는 스크립트를 작성해줘. [answer] | 참고 문서에 `flip`, `frameindex`, `move_y` 필드는 AvatarAction JSON 구조에 정의되어 있습니다. 하지만 mLua 스크립트 컴포넌트에서 AvatarAction JSON 파일을 직접 로드하거나 파싱하는 API, 또는 해당 JSON 데이터를 스크립트 프로퍼티로 가져오는 방법이 문서에 제공되지 않았습니다. 따라서 "JSON 파일을 스크립트 내에서 직접 읽어 `flip`이 true인 프레임을 수집하는" 로직을 구현하는 것은 문서에 없는 API를 사용해야 하므로 불가능합니다. 대신, 문서에 정의된 필드 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | AvatarAction JSON 파일의 구조는 아래와 같습니다. ```lua { "Data": { "NewAvatarAction": { "Frames": [ { "defined_actionname": "stand1", "frameindex": 0, "framedelay": 0.156, "move_x": 0, "move_y": -1, "rotation": 0, "flip":
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CacheComponents() 메서드가 컴포넌트 캐싱을 수행한다고 하지만, OnBeginPlay()의 로직 흐름상 이 메서드가 호출되기 전에 StateComponent의 HitEventHandler 재정의가 항상 실행되는 구조인가요? [answer] | 제시된 참고 문서의 `OnBeginPlay()` 코드 구조를 분석하면, `CacheComponents()` 호출 이전에 `StateComponent`의 `HitEventHandler` 재정의가 **항상 실행되는 구조는 아닙니다.** 문서 상단의 설명에서는 "LocalPlayer인 경우에만 ... 컴포넌트 캐싱을 수행"한다고 명시하고 있으며, 실제 `OnBeginPlay()` 함수 코드를 보면 다음과 같은 순서로 실행됩니다. 1. `entity.PlayerControllerComponent.UseCustomScript`가 `fa [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnUpdate(number delta)에서 InputKeys와 PressedKeys 상태를 기반으로 HorizontalInput과 VerticalInput을 계산하고, MovementComponent의 이동 메서드를 호출하여 캐릭터를 이동시키며, SideviewbodyComponent의 방향을 입력 방향에 맞게 설정하는 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `OnUpdate` 내에서 `InputKeys`와 `PressedKeys`를 기반으로 `HorizontalInput`, `VerticalInput`을 계산하는 로직, `MovementComponent`의 구체적인 이동 메서드 호출, 그리고 `SideviewbodyComponent`의 방향 설정 로직에 대한 코드 예제나 API 명세가 포함되어 있지 않습니다. 문서에는 `MovementComponent:Stop()` 호출과 `StateComponent:ChangeState()` 호출만 예시로 나와 있으며, `Mo [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 필요한 Property를 아래와 같이 작성합니다. ```lua Property: [None] boolean IsValid = false [None] table ActionKeys = {} [None] table ActionConditions = {} [None] table HoldActions = {} [None] table InteractionKeys = {} [None] table InputKeys = {} [None] table PressedKeys = {} [None] number HorizontalInput = 0 [No
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CanControl 메서드에서 self.IsValid와 self.IsMapMoving을 함께 검사하는 이유는 무엇이며, 이 중 하나만 검사하면 어떤 오류가 생길 수 있나요? [answer] | `CanControl` 메서드가 `self.IsValid`와 `self.IsMapMoving`을 함께 검사하는 이유는 각각 다른 종류의 '컨트롤 불가 상태'를 포착하기 위해서입니다. **1. `self.IsValid` 검사 이유** * **역할:** 현재 엔티티(플레이어)가 유효한 상태인지 확인합니다. * **필요성:** 엔티티가 삭제되었거나, 스크립트가 비활성화된 상태, 또는 초기화/종료 과정에서 컴포넌트 참조가 끊겨 있을 수 있습니다. * **하나만 검사 시 오류:** `self.IsValid`만 검사하고 `IsMa [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 현재 유지 중인 액션이 있는지 확인하고, 키 입력 상태를 추가 및 제거하는 [client only] 스크립트를 작성해줘. [answer] | 요청하신 기능을 구현하기 위해 `IsHoldAction`, `AddPressedKey`, `RemovePressedKey` 메서드를 포함하는 스크립트를 작성합니다. 해당 메서드들은 모두 `[client only]` 실행 공간에서 동작하며, 내부적으로 `HoldActions` 테이블과 `PressedKeys` 테이블을 관리합니다. ```lua Property: [None] table HoldActions = {} [None] table PressedKeys = {} Method: [client only] void AddPresse [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void RemoveAllConditions(string actionName) { self.ActionConditions[actionName] = nil } [client only] boolean PassByCondition(string actionName) { local funcList = self.ActionConditions[actionName] if funcList == nil then return true end for i = 1, #fu
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 맵 이동 중 플레이어 조작을 막기 위해 OnMapLeave에서 IsMapMoving을 true로 설정했는데, OnMapEnter에서 컨트롤이 다시 활성화되지 않는 이유는 뭘까요? [answer] | 제공된 문서의 코드를 분석했을 때, `OnMapEnter`에서 컨트롤이 활성화되지 않는 이유는 **`OnMapEnter` 메서드가 `enteredMap` 매개변수가 `nil`이 아닌 경우에만 `MapComponent`를 갱신하고 컨트롤을 활성화하기 때문**입니다. 구체적으로 `OnMapEnter`의 로직은 다음과 같습니다: ```lua [client only] void OnMapEnter(Entity enteredMap) { if enteredMap ~= nil then self.MapComponent = [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | IsMapMoving이 true일 때 MapComponent를 사용하여 맵의 이동 속도를 계산하고, 이를 RigidbodyComponent 또는 KinematicbodyComponent의 위치 업데이트에 적용하여 캐릭터가 맵과 함께 이동하게 하는 로직을 OnUpdate(number delta) 내에 구현하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에는 `IsMapMoving`이 `true`일 때 `MapComponent`를 사용하여 맵의 이동 속도를 계산하거나, 이를 `RigidbodyComponent` 또는 `KinematicbodyComponent`의 위치 업데이트에 적용하는 구체적인 API(예: `MapComponent`의 속도 프로퍼티, `RigidbodyComponent`/`KinematicbodyComponent`의 위치 설정 메서드)가 포함되어 있지 않습니다. 문서에는 `IsMapMoving`이 `true`일 경우 `CanControl()`이 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 필요한 Property를 아래와 같이 작성합니다. ```lua Property: [None] boolean IsValid = false [None] table ActionKeys = {} [None] table ActionConditions = {} [None] table HoldActions = {} [None] table InteractionKeys = {} [None] table InputKeys = {} [None] table PressedKeys = {} [None] number HorizontalInput = 0 [No
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `KeyStateEnum`과 `KeyInfo` StructType을 정의할 때, 각 프로퍼티에 `[None]` 어노테이션을 사용하는 이유와, 이 값들을 서버와 클라이언트 간에 동기화해야 하는 경우와 아닌 경우의 구분 기준은 무엇인가요? [answer] | 제공된 참고 문서에는 `KeyStateEnum`과 `KeyInfo` StructType의 프로퍼티에 `[None]` 어노테이션을 사용한 구체적인 이유나, 서버-클라이언트 동기화 구분 기준에 대한 설명이 포함되어 있지 않습니다. 문서에는 해당 로직을 생성할 때 아래처럼 `[None]`을 사용하라는 **구현 예시**만 제시되어 있을 뿐, 그 설계 의도나 동기화 규칙에 대한 기술적 근거는 찾을 수 없습니다. ```lua Property: [None] integer None = 0 [None] integer Block = 1 [None [followup] | `KeyInfo`의 `State`와 `Value`를 클라이언트에서 입력받아 서버로 전송할 때, 데이터 손실이나 지연을 방지하기 위한 mLua 스크립트 코드 예시를 작성해 주세요. [followup_answer] | 제공된 참고 문서에는 `KeyInfo`의 `State`와 `Value`를 클라이언트에서 서버로 전송하는 구체적인 코드 예시나, 데이터 손실 및 지연 방지 기법에 대한 설명이 포함되어 있지 않습니다. 문서에는 `KeyInfo` StructType의 정의만 제시되어 있을 뿐, 이를 어떻게 네트워크 통신에 활용하는지에 대한 구현 예제는 찾을 수 없습니다. ```lua Property: [None] integer State = 0 [None] integer Value = 0 ``` 따라서 제공된 문서 범위 내에서 요청하신 데이터 전송 [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | UseCustomScript가 false일 때 OnBeginPlay()에서 어떤 동작이 수행되며, 이 값이 true로 변경되었을 때 LocalPlayer가 아닌 다른 엔티티의 경우 초기화 흐름이 어떻게 달라지나요? [answer] | 제공된 참고 문서에 근거하여 `UseCustomScript` 플래그에 따른 동작과 초기화 흐름을 설명합니다. **1. `UseCustomScript`가 `false`일 때의 동작** `OnBeginPlay()` 메서드가 실행되면 가장 먼저 `self.Entity.PlayerControllerComponent.UseCustomScript` 값을 확인합니다. 이 값이 `false`인 경우, 함수는 즉시 `return`을 수행하여 종료됩니다. * 이 경우 `IsValid` 플래그 설정, `InitKeys()`, `InitHoldAc [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | PassByCondition 메서드가 액션 실행 조건을 모두 통과하는지 확인한다고 했는데, 조건 함수가 하나도 등록되지 않은 액션은 어떻게 처리되나요? [answer] | 제공된 참고 문서에는 `PassByCondition` 메서드의 정확한 구현 코드나 "조건 함수가 하나도 등록되지 않은 경우"의 구체적인 동작 방식에 대한 설명이 포함되어 있지 않습니다. 문서에는 `PassByCondition`이 "액션에 등록된 조건을 모두 통과하는지 확인한다"는 기능 설명만 있고, 빈 리스트(조건 없음) 상태에서의 반환값(true/false)이나 예외 처리 로직에 대한 정보는 찾을 수 없습니다. 따라서 해당 상황이 어떻게 처리되는지는 문서 근거로 답변할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기존 컴포넌트와 동일한 인터페이스의 Action, Condition을 관리할 수 있는 메소드를 만들어봅시다. - `GetActionName()`: 키에 매핑된 액션 이름을 반환합니다. - `SetActionKey()`: 키에 액션 이름을 매핑합니다. - `RemoveActionKey()`: 특정 키의 매핑을 제거합니다. - `RemoveAllActionKeyByActionName()`: 특정 액션에 매핑된 모든 키를 제거합니다. - `AddCondition()`: 액션 실행 조건 함수를 추가합니다. - `RemoveAllCondi
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | _InputService:ConnectEvent()를 통해 KeyDownEvent, KeyUpEvent, KeyHoldEvent를 연결할 때, OnKeyDown, OnKeyUp, OnKeyHold 핸들러 함수가 정의되어 있지 않으면 어떤 오류가 발생하며, 이 핸들러는 어떤 시점에 등록되어야 하나요? [answer] | 제공된 참고 문서에는 `_InputService:ConnectEvent()`를 사용할 때 핸들러 함수가 정의되어 있지 않을 경우 발생하는 구체적인 오류 메시지나 예외 유형에 대한 정보가 포함되어 있지 않습니다. 또한, 핸들러 함수의 구체적인 코드 정의(함수 본문) 또한 문서에 제시되어 있지 않아, 이 경우의 정확한 동작 방식을 설명할 수 없습니다. 다만, 문서에 명시된 **핸들러 등록 시점**과 **구조**에 대해서는 다음과 같이 설명할 수 있습니다. 1. **등록 시점**: * 핸들러 연결(`_InputServic [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `DefaultPlayer`에 `CustomPlayerControllerComponent`를 추가하고 `PlayerControllerComponent`의 `UseCustomScript` 프로퍼티를 활성화하는 설정 절차를 포함하여 커스텀 컨트롤러 전환 스크립트를 작성해줘 [answer] | `DefaultPlayer`에 커스텀 컨트롤러를 적용하는 과정은 코드 작성 전, 에디터(Workspace)에서의 설정 절차가 선행되어야 합니다. `UseCustomScript` 프로퍼티는 런타임에 코드로 변경하는 것이 아니라, 에디터의 인스펙터에서 직접 설정하는 값입니다. 따라서 요청하신 "커스텀 컨트롤러 전환"을 위한 정확한 절차와, 이 설정을 전제로 동작하는 `CustomPlayerControllerComponent` 스크립트 예시는 다음과 같습니다. ### 1. 에디터 설정 절차 (필수) 커스텀 스크립트가 정상적으로 동작 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | RemoveAllConditions 메서드가 호출될 때 self.ActionConditions[actionName]을 nil로 설정하는 것과, PassByCondition에서 funcList가 nil인 경우 true를 반환하는 것 사이의 연관성을 설명해 주세요 [answer] | `RemoveAllConditions` 메서드와 `PassByCondition` 메서드 사이의 연관성은 **행동 조건(Condition)의 존재 여부를 통한 접근 제어**에 있습니다. 1. **`RemoveAllConditions`의 역할 (상태 초기화/해제)** * 이 메서드는 특정 행동(`actionName`)에 대해 설정되어 있던 모든 조건 함수 목록을 `self.ActionConditions[actionName]`에서 삭제(즉, `nil`로 설정)합니다. * 이는 해당 행동에 대해 더 이상 아무런 제 [followup] | HoldActions와 PressedKeys 테이블은 각각 어떤 상황에서 값이 true/false로 변경되며, IsHoldAction과 AddPressedKey/RemovePressedKey 함수가 서로 어떻게 연동되는지 코드 흐름을 통해 설명해 주세요 [followup_answer] | 제공된 참고 문서의 코드만으로는 `HoldActions`와 `PressedKeys` 테이블이 실제로 **어떤 입력 이벤트(키보드 누름/놓음)에서** 값이 변경되는지(즉, `AddPressedKey`나 `RemovePressedKey`가 어디서 호출되는지)를 알 수 없습니다. 문서에는 해당 함수들의 정의만 존재할 뿐, 이를 호출하는 입력 처리 로직(Event Handler 등)이 포함되어 있지 않습니다. 따라서 문서에 있는 정보만으로 판단할 때, 두 테이블과 함수들의 **연동 관계와 코드 흐름**은 다음과 같이 설명할 수 있습니다. [scores] | [judge_reason] | [source_doc] | [client only] void RemoveAllConditions(string actionName) { self.ActionConditions[actionName] = nil } [client only] boolean PassByCondition(string actionName) { local funcList = self.ActionConditions[actionName] if funcList == nil then return true end for i = 1, #fu
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | IsHoldAction 메서드가 해당 액션이 hold 방식으로 동작하는지 확인한다고 하는데, hold 방식과 tap 방식의 차이는 무엇이며 어떤 상황에서 IsHoldAction이 true를 반환하나요? [answer] | 제시된 참고 문서에는 `IsHoldAction()` 메서드가 "해당 액션이 hold 방식으로 동작하는지 확인한다"는 설명과 함께, `RemoveActionKey` 및 `RemoveAllActionKeyByActionName` 메서드 내에서 해당 메서드가 `true`를 반환할 때 `InputKeys`에서 해당 키 정보를 제거하는 로직만 포함되어 있습니다. 하지만 **hold 방식과 tap 방식의 구체적인 차이점**, 그리고 **`IsHoldAction`이 `true`를 반환하는 정확한 조건(예: 어떤 프로퍼티 값이 설정되었을 때 등 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기존 컴포넌트와 동일한 인터페이스의 Action, Condition을 관리할 수 있는 메소드를 만들어봅시다. - `GetActionName()`: 키에 매핑된 액션 이름을 반환합니다. - `SetActionKey()`: 키에 액션 이름을 매핑합니다. - `RemoveActionKey()`: 특정 키의 매핑을 제거합니다. - `RemoveAllActionKeyByActionName()`: 특정 액션에 매핑된 모든 키를 제거합니다. - `AddCondition()`: 액션 실행 조건 함수를 추가합니다. - `RemoveAllCondi
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | RemoveActionKey를 호출할 때 해당 키가 hold 방식 액션에 매핑되어 있으면 InputKeys에서도 자동으로 삭제되는지, 아니면 수동으로 추가 조치가 필요한지 궁금합니다. [answer] | `RemoveActionKey`를 호출할 때 해당 키가 hold 방식 액션에 매핑되어 있다면, `InputKeys`에서도 자동으로 삭제됩니다. 별도의 수동 조치는 필요하지 않습니다. 제시된 코드에서 `RemoveActionKey` 메서드의 동작을 보면, 키에 매핑된 액션 이름(`actionName`)을 조회한 후, `self:IsHoldAction(actionName)`을 통해 해당 액션이 hold 방식인지 확인합니다. 만약 hold 방식 액션이라면 `self.InputKeys[key] = nil`을 실행하여 입력 기록을 함께 제 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기존 컴포넌트와 동일한 인터페이스의 Action, Condition을 관리할 수 있는 메소드를 만들어봅시다. - `GetActionName()`: 키에 매핑된 액션 이름을 반환합니다. - `SetActionKey()`: 키에 액션 이름을 매핑합니다. - `RemoveActionKey()`: 특정 키의 매핑을 제거합니다. - `RemoveAllActionKeyByActionName()`: 특정 액션에 매핑된 모든 키를 제거합니다. - `AddCondition()`: 액션 실행 조건 함수를 추가합니다. - `RemoveAllCondi
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | BlockInputKey 메서드를 호출하면 특정 키의 입력이 차단 상태로 표시되는데, 이 상태가 해제되는 조건은 무엇인가요? [answer] | 제공된 참고 문서에는 `BlockInputKey()` 메서드를 통해 특정 키의 입력을 차단 상태로 표시하는 기능에 대한 설명만 존재합니다. 문서에는 `BlockInputKey()` 호출 후 해당 차단 상태가 **해제되는 조건이나 메서드(예: UnBlockInputKey 등)에 대한 정보가 포함되어 있지 않습니다.** 따라서 주어진 문서 범위 내에서는 차단 상태 해제 조건을 알 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `InitEventHandlers()`에서 `InputService`의 키 입력 이벤트에 연결된 핸들러 메소드를 아래와 같이 작성합니다. - `OnKeyDown()`: 키를 누르는 순간의 입력을 처리하여 액션을 실행하고 입력 상태를 갱신합니다. - `SendActionEventToServer()`: 커스텀 액션 이벤트를 서버로 전송합니다. - `OnKeyUp()`: 키에서 손을 떼는 순간의 입력을 처리하여 관련 상태를 해제합니다. - `OnKeyHold()`: 키를 누르고 있는 동안의 입력 상태를 갱신합니다. - `BlockInp
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | ActionKeys 테이블에 키를 등록할 때 SetActionKey 메서드를 사용하는데, 이미 동일한 키에 다른 액션이 매핑되어 있으면 어떻게 덮어씌워지나요? [answer] | `SetActionKey` 메서드를 호출하면 기존에 매핑되어 있던 액션 정보는 자동으로 제거되고, 새 액션 이름으로 덮어씌워집니다. 제공된 `SetActionKey` 메서드의 구현 코드를 보면, 매개변수로 전달받은 `key`와 `actionName`을 사용해 `self.ActionKeys[key] = actionName`이라는 구문을 실행합니다. 이는 Lua의 테이블(해시맵) 특성에 따라 해당 `key`에 이미 값이 존재하든 아니든 상관없이, 무조건 새로운 `actionName`으로 값을 치환(overwrite)하는 동작입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기존 컴포넌트와 동일한 인터페이스의 Action, Condition을 관리할 수 있는 메소드를 만들어봅시다. - `GetActionName()`: 키에 매핑된 액션 이름을 반환합니다. - `SetActionKey()`: 키에 액션 이름을 매핑합니다. - `RemoveActionKey()`: 특정 키의 매핑을 제거합니다. - `RemoveAllActionKeyByActionName()`: 특정 액션에 매핑된 모든 키를 제거합니다. - `AddCondition()`: 액션 실행 조건 함수를 추가합니다. - `RemoveAllCondi
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnKeyHold 이벤트 핸들러에서 키 입력이 처리되지 않고 즉시 return되는 조건을 3문장 이내로 요약해 주세요. [answer] | `self:CanControl()`이 거짓이거나 `self.EnableInHierarchy`가 거짓이면 즉시 return됩니다. 키에 매핑된 `actionName`이 없거나 해당 액션이 홀드 액션이 아니면 return됩니다. 해당 키의 상태가 `_KeyStateEnum.Block`으로 설정되어 있으면 return됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void OnKeyHold(KeyHoldEvent evt) { -- Handle key hold events: update hold action state (for keys pressed without keyDown) if not self:CanControl() then return end if not self.EnableInHierarchy then return end local key = evt.key loc
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `CustomPlayerActionEvent`에 `PlayerEntity`와 `ActionName`을 포함시켜 커스텀 액션을 처리하는 방식에서, 이벤트가 발생했을 때 해당 이벤트를 수신하는 Event Handler의 작성법과, 특정 액션 이름에 따라 다른 로직을 분기 처리하는 코드 구조는 어떻게 되나요? [answer] | 커스텀 액션 이벤트(`CustomPlayerActionEvent`)를 처리하는 Event Handler는 `[self]` 실행 공간에 정의되며, 이벤트 인자로 전달되는 `PlayerEntity`와 `ActionName`을 추출하여 특정 액션 이름에 따라 로직을 분기 처리하는 구조를 가집니다. 기본적으로 클라이언트 측에서 이벤트를 수신할 수 있지만, 실제 게임 로직(공격 등)은 서버에서 처리해야 하므로 핸들러 내부에서 `IsClient()` 체크를 수행하여 클라이언트인 경우 즉시 반환하는 것이 일반적입니다. 아래는 `CustomP [followup] | `ActionName`이 "Jump"일 경우 점프 동작을, "Dash"일 경우 대시 동작을 수행하도록 분기하는 mLua 코드 블록을 작성해 주세요. [followup_answer] | `CustomPlayerActionEvent`를 수신하여 `ActionName` 값에 따라 점프와 대시 로직을 분기 처리하는 Event Handler 코드입니다. 참고 문서의 예제와 동일한 형식(`[self]` 핸들러, `IsClient()` 체크, `if-elseif` 분기)을 따릅니다. ```lua Event Handler: [self] HandleCustomPlayerActionEvent(CustomPlayerActionEvent event) { -- 이벤트에서 전달된 파라미터 추출 local PlayerEn [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 기존 HitEventHandler를 제거하고 커스텀 핸들러로 StateComponent 상태를 "HIT"로 변경하는 로직을 구현하려면 어떤 코드를 작성해야 하나요? [answer] | 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록하여 `StateComponent`의 상태를 "HIT"로 변경하는 로직은 다음과 같이 구현합니다. 1. `self.Entity.StateComponent`를 통해 상태 컴포넌트를 가져옵니다. 2. `stateComponent:DisconnectHitEvent()`를 호출하여 기존에 연결된 Hit 이벤트 핸들러를 해제합니다. 3. `self.Entity:ConnectEvent(HitEvent, ...)`를 호출하여 커스텀 함수를 등록합니다. 이 함수 내에서 `st [followup] | `stateComponent:DisconnectHitEvent()` 호출 후 `self.Entity:ConnectEvent`로 등록할 때 `HitEvent`의 인자나 콜백 함수 내부에서 추가적인 처리(예: 데미지 계산, 이펙트 호출)가 필요한 경우 예외 처리와 함께 수정된 코드 예시를 보여주세요. [followup_answer] | 참고 문서에는 `HitEvent` 발생 시 `StateComponent`의 상태를 "HIT"로 변경하는 로직만 포함되어 있으며, 데미지 계산이나 이펙트 호출과 같은 추가적인 처리에 대한 API나 예제가 문서에 존재하지 않습니다. 또한, `ConnectEvent` 콜백 함수 내부의 예외 처리 방식에 대한 문서도 없습니다. 따라서 문서에 기반하여 `HitEvent` 콜백 내에서 상태 변경(`ChangeState("HIT")`) 외에 다른 로직을 추가하는 코드를 작성할 수 없습니다. 문서에 명시된 대로 상태 변경만 수행하는 기존 코드 [scores] | [judge_reason] | [source_doc] | #### 핸들러 메소드 HitEvent 발생 시 StateComponent의 상태를 "HIT"로 변경할 수 있도록 기존 HitEventHandler를 제거하고 커스텀 핸들러를 등록합니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end stat
[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | ActionConditions 테이블의 구조와 PassByCondition 함수의 반환 로직이 어떻게 동작하는지 설명해 주세요 [answer] | `ActionConditions` 테이블과 `PassByCondition` 함수는 액션 실행 전 조건을 검사하기 위해 사용됩니다. ### 1. ActionConditions 테이블 구조 `ActionConditions`는 액션 이름(string)을 키로 가지고, 해당 액션의 조건들을 저장하는 함수 목록(table)을 값으로 갖는 테이블입니다. * **키(Key):** 액션 이름 (예: `"jump"`, `"attack"`) * **값(Value):** 조건을 검사하는 함수(`func`)를 요소로 포함한 테이블(리스트) [followup] | funcList 내부의 func 변수가 nil일 때 continue를 사용하는 이유와, 조건 검사가 실패했을 때 즉시 false를 반환하는 방식에 대해 구체적으로 설명해 주세요 [followup_answer] | `PassByCondition` 함수에서 `funcList` 내부의 `func` 변수가 `nil`일 때 `continue`를 사용하는 이유와, 조건 검사 실패 시 즉시 `false`를 반환하는 방식에 대해 설명합니다. ### 1. func가 nil일 때 continue를 사용하는 이유 `funcList`는 조건 함수들이 저장된 테이블(배열)입니다. `continue` 문을 사용하는 주된 이유는 **메모리 참조의 안전성**과 **불필요한 오류 방지**입니다. * **nil 함수 호출 방지:** Lua에서는 `nil` 값에 대 [scores] | [judge_reason] | [source_doc] | [client only] void RemoveAllConditions(string actionName) { self.ActionConditions[actionName] = nil } [client only] boolean PassByCondition(string actionName) { local funcList = self.ActionConditions[actionName] if funcList == nil then return true end for i = 1, #fu