[task] | two_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnBeginPlay() 내에서 UseCustomScript가 false일 때와 LocalPlayer가 아닐 때 각각 어떤 처리가 수행되며, 초기화 순서는 어떻게 되나요? [answer] | `OnBeginPlay()` 메서드 내에서의 처리 흐름은 다음과 같습니다. **1. `UseCustomScript`가 `false`일 때** `self.Entity.PlayerControllerComponent.UseCustomScript` 값이 `false`인 경우, 해당 메서드는 즉시 `return`하여 이후의 모든 초기화 로직을 수행하지 않습니다. 즉, 커스텀 스크립트 기반의 컨트롤러 초기화가 전혀 일어나지 않습니다. **2. `LocalPlayer`가 아닐 때** `UseCustomScript`가 `true`인 경우, 다 [followup] | InitKeys()에서 키 매핑을 할 때 actionKeys와 interactionKeys의 구조 차이가 무엇이고, InitHoldActions()에서 특정 액션을 누락하면 어떤 문제가 발생하나요? [followup_answer] | **1. `actionKeys`와 `interactionKeys`의 구조 차이** `InitKeys()` 메서드에서 두 테이블의 값(value) 타입이 다릅니다. * **`actionKeys`**: 키(`KeyboardKey`)를 키로 사용하고, 해당 키가 트리거하는 **액션 이름(문자열)**을 값으로 사용합니다. * 예: `actionKeys[KeyboardKey.Space] = "Jump"` * 이는 특정 키를 눌렀을 때 "Jump"라는 이름의 액션이 실행됨을 의미합니다. * **`interact [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | OnBeginPlay() 함수 내에서 LocalPlayer 확인 전후로 수행되는 초기화 로직의 순서와 조건을 4단계 번호 목록으로 정리해 주세요. [answer] | 제공된 문서의 `OnBeginPlay()` 코드와 설명을 바탕으로 초기화 로직의 순서와 조건을 4단계로 정리하면 다음과 같습니다. 1. **커스텀 스크립트 사용 여부 확인**: `self.Entity.PlayerControllerComponent.UseCustomScript` 프로퍼티가 `false`인지 확인합니다. 만약 `false`이면 함수를 즉시 종료하고 나머지 초기화 과정을 수행하지 않습니다. 2. **LocalPlayer 확인 및 클라이언트 전용 초기화**: 현재 엔티티가 `_UserService.LocalPlayer`인 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | InitKeys()에서 매핑된 키보드 입력과 액션 이름의 대응 관계를 키보드 키, 액션 이름, 해당 키가 속한 테이블(ActionKeys 또는 InteractionKeys) 3열 표로 작성해 주세요. [answer] | `InitKeys()` 메서드에서 정의된 키보드 입력과 액션 이름의 대응 관계는 다음과 같습니다. | 키보드 키 | 액션 이름 | 속한 테이블 | | :--- | :--- | :--- | | `KeyboardKey.Space` | `"Jump"` | `ActionKeys` | | `KeyboardKey.LeftAlt` | `"Jump2"` | `ActionKeys` | | `KeyboardKey.W` | `"MoveUp"` | `ActionKeys` | | `KeyboardKey.S` | `"MoveDown"` | `ActionK [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] | `ActionKeys`, `ActionConditions`, `HoldActions` 테이블 프로퍼티들은 각각 어떤 용도로 구분해서 사용해야 하나요? [answer] | 제공된 참고 문서에는 `ActionKeys`, `ActionConditions`, `HoldActions` 프로퍼티의 선언만 포함되어 있으며, 각 테이블이 어떤 용도로 구분되어 사용되는지에 대한 설명이나 코드 예제가 없습니다. 따라서 제공된 문서만으로는 이 세 가지 프로퍼티의 구체적 용도 차이를 설명할 수 없습니다. [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] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `CanControl` 메서드가 `false`를 반환하는 조건을 2문장 이내로 설명하세요. [answer] | `CanControl` 메서드는 `self.IsValid`가 `false`이거나 `self.IsMapMoving`이 `true`일 때 `false`를 반환합니다. [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] | CacheComponents 메서드에서 캐시되는 컴포넌트 변수 6개를 표로 정리해서, 변수명과 접근하는 엔티티 프로퍼티를 매칭시켜 주세요. [answer] | `CacheComponents` 메서드에서 캐시되는 6개의 컴포넌트 변수와 해당 변수가 참조하는 엔티티 프로퍼티는 다음과 같습니다. | 캐시 변수명 | 접근하는 엔티티 프로퍼티 | | :--- | :--- | | `self.StateComponent` | `entity.StateComponent` | | `self.MovementComponent` | `entity.MovementComponent` | | `self.PlayerControllerComponent` | `entity.PlayerControllerComponent` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void CacheComponents() { local entity = self.Entity self.StateComponent = entity.StateComponent self.MovementComponent = entity.MovementComponent self.PlayerControllerComponent = entity.PlayerControllerComponent self.RigidbodyComponent = entity.RigidbodyCompone
[task] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarStateAnimationComponent의 기존 기본 State Key가 아닌 새로운 Key에 BodyAction을 연결하여, 기본 PlayRate 값과 충돌하지 않도록 독립적인 재생 속도를 설정하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에 따르면, `AvatarStateAnimationComponent`의 `StateToAvatarBodyActionSheet`에 새로운 Key를 추가하고, 해당 Key에 BodyAction과 PlayRate를 연결하는 과정은 에디터(에디트 모드)에서 수행하는 설정 단계입니다. 문서에는 이 연결 과정을 수행하기 위한 **mLua 스크립트 코드(API)** 가 제공되어 있지 않습니다. 또한 `AvatarStateAnimationComponent`에 접근하여 런타임에 Key를 추가하거나 BodyAction을 연결하는 m [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 제작한 BodyAction은 AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet의 **Key**에 등록해 사용해야 합니다. 기본적으로 AvatarStateAnimationComponent에는 메이플스토리 원작과 동일한 움직임을 구현한 Key들이 지정되어 있습니다. 만약 이 기존 Key에서 AvatarBodyAction을 제작한 BodyAction으로 연결할 경우 크리에이터의 예상과 다르게 동작할 수 있습니다. 기본 State와 연결된 BodyAction에 맞는 PlayRate
[task] | two_turn [pass] | ⏳ 미판정 [title] | Lazy Map [question] | LazyMap 맵의 엔티티를 직접 참조하여 텔레포트하는 스크립트 작성 시 서버 메모리 관리 관점에서 주의해야 할 점이 무엇인가요? [answer] | LazyMap 맵의 엔티티를 직접 참조하여 텔레포트하는 스크립트 작성 시 서버 메모리 관리 관점에서 가장 주의해야 할 점은 **참조 시점에 맵이 즉시 생성되므로, 불필요한 시점에 참조를 하지 않도록 해야 한다는 것**입니다. LazyMap은 서버 시작 시 생성되지 않고, 특정 조건(유저 상호작용, 스크립트 호출 등)에서 동적으로 생성됩니다. `_EntityService:GetEntityByPath` 등으로 LazyMap의 엔티티를 직접 참조하는 순간 해당 맵이 서버 메모리에 로드됩니다. 따라서 다음 사항에 유의해야 합니다. 1. [followup] | `[server only]` 환경에서 `_EntityService:GetEntityByPath` 호출 후 `_TeleportService:TeleportToEntity`를 실행하는 코드에서, LazyMap 생성과 텔레포트 실행 간의 타이밍 문제나 에러 발생 시점을 방지하기 위한 최적화된 코드 구조를 제시해 주세요. [followup_answer] | LazyMap 생성과 텔레포트 실행 간의 타이밍 문제나 에러 발생 시점을 방지하기 위한 최적화된 코드 구조는 **엔티티 참조 후 유효성 검증을 수행하고, 검증 통과 시에만 텔레포트를 실행하는 것**입니다. `_EntityService:GetEntityByPath` 호출 시 LazyMap이 동적으로 생성되지만, 경로가 잘못되었거나 맵 로드에 실패한 경우 `nil`을 반환할 수 있습니다. 이 상태에서 `_TeleportService:TeleportToEntity`를 호출하면 런타임 에러가 발생할 수 있으므로, 반환된 엔티티가 `nil [scores] | [judge_reason] | [source_doc] | 월드의 규모가 커질수록 서버 메모리 관리와 성능 최적화가 필요합니다. LazyMap을 사용하면 맵을 동적으로 생성하고, 서버 자원을 효율적으로 관리할 수 있습니다. ## LazyMap LazyMap은 서버가 처음 시작될 때 맵이 생성되지 않고, 특정 상황에서 동적으로 지연 생성되는 맵을 뜻합니다. LazyMap을 적절하게 활용하면 서버 메모리 점유율을 낮추고, 연산 처리 자원을 최적화할 수 있습니다. LazyMap은 주로 처음부터 생성될 필요 없는 특수한 맵에 적용해 사용할 수 있습니다. 반대로 모든 월드 유저가 반드시 거치는
[task] | single_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | framedelay와 TriggerTime의 단위가 모두 초인데, 이벤트가 프레임 중간에 정확히 언제 발동되는지 계산하려면 어떤 식으로 접근해야 하나요? [answer] | `framedelay`와 `TriggerTime` 모두 단위가 초(second)로 동일합니다. 이벤트가 해당 프레임 내에서 정확히 언제 발동되는지 확인하려면, 해당 프레임의 시작 시점을 기준으로 `TriggerTime` 값을 직접 비교하면 됩니다. 구체적인 계산 및 접근 방식은 다음과 같습니다. 1. **프레임 시작 시점 기준**: 특정 프레임(예: `frameindex: 0`)이 재생되기 시작하는 순간을 시간 기준 `0`으로 봅니다. 2. **TriggerTime 확인**: 해당 프레임의 `eventdatas` 배열 안에 [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] | two_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarActionEditor를 통해 BodyAction과 AvatarAction을 조합하여 크리에이터만의 애니메이션을 만드는 기본 원리가 궁금합니다. [answer] | AvatarActionEditor를 통한 애니메이션 제작의 기본 원리는 메이플스토리 월드가 제공하는 기본 BodyAction의 프레임을 재구성하여 새로운 동작을 만드는 것입니다. 이 과정은 크게 두 단계, 즉 **BodyAction**과 **AvatarAction**의 조합으로 이루어집니다. ### 1. BodyAction (동작의 묶음) BodyAction은 최종적으로 스크립트에서 제어하거나 플레이어가 실행하는 하나의 애니메이션 단위를 의미합니다. * **여러 AvatarAction 조합:** 하나의 BodyAction 안에 [followup] | BodyAction에 여러 개의 AvatarAction을 추가했을 때 월드 플레이 중 무작위로 재생되는 메커니즘과, 이를 방지하거나 특정 순서로 재생하도록 설정하는 방법이 있나요? [followup_answer] | 참고 문서에 따르면, BodyAction의 Recipe에 여러 개의 AvatarAction을 추가한 경우 월드 플레이 중에는 **무작위로 재생**됩니다. 문서에는 이를 방지하거나 특정 순서로 재생하도록 설정하는 방법에 대한 정보가 제공되지 않습니다. 따라서 현재 AvatarActionEditor 기능으로는 무작위 재생 메커니즘을 변경하거나 순서 재생을 설정할 수 있는 방법에 대해 확인할 수 없습니다. [scores] | [judge_reason] | [source_doc] | AvatarActionEditor를 활용해 메이플스토리 월드에서 제공하는 BodyAction의 프레임들을 재구성해 크리에이터 만의 BodyAction을 만들 수 있습니다. ##### 참고 가이드 * [아바타 애니메이션 제어하기 ](/docs?postId=820) * [ActionSheet로 아바타 애니메이션 손쉽게 제어하기](/docs?postId=545) ## AvatarActionEditor 소개 메이플스토리 월드는 메이플스토리의 기본 BodyAction을 제공하고 있습니다.AvatarActionEditor에서는 스크립트에
[task] | two_turn [pass] | ⏳ 미판정 [title] | Lazy Map [question] | 인스턴스 맵에 IsLazyMap을 true로 설정했을 때의 동작 방식과, 정적 맵에서 LazyMap을 참조할 때 이벤트 함수 호출 순서가 뒤쳐지는 문제를 해결하는 방법은? [answer] | ## 1. 인스턴스 맵에 `IsLazyMap`을 `true`로 설정했을 때의 동작 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. `IsLazyMap` 값을 `true`로 설정하더라도, 해당 맵은 **인스턴스 맵으로만 동작**하며 LazyMap의 특성(로드 지연, 삭제 불가 등)은 적용되지 않습니다. 즉, 인스턴스 맵은 항상 정적 맵과 동일한 생명주기(서버 시작 시 초기화 및 로드)를 따릅니다. --- ## 2. 정적 맵에서 LazyMap 참조 시 이벤트 함수 호출 순서 문제 ### 문제 원인 [followup] | 정적 맵의 OnBeginPlay()에서 LazyMap 엔티티를 참조하는 코드와, 의존성 순서를 보장하기 위한 최적화 팁은? [followup_answer] | ## 정적 맵의 `OnBeginPlay()`에서 LazyMap 엔티티 참조 시 주의사항 LazyMap에 포함된 스크립트의 `OnInitialize()`, `OnMapEnter()`, `OnBeginPlay()`는 서버 시작 시점이 아닌, **LazyMap이 실제로 로드되는 시점**에 호출됩니다. 따라서 정적 맵의 `OnBeginPlay()`에서 LazyMap 엔티티를 참조하면, LazyMap이 아직 로드되지 않았거나 로드 중이어서: 1. 엔티티를 찾지 못하거나 2. 찾더라도 LazyMap의 이벤트 함수가 후순위로 처리되어 의도하 [scores] | [judge_reason] | [source_doc] | - **생성된 LazyMap 삭제 불가능**: 한 번 생성된 LazyMap은 삭제할 수 없습니다. LazyMap이 생성되고 나면 기존 정적 맵과 동일하게 작동합니다. - **인스턴스 맵 제외**: 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. 만약 `IsLazyMap` 값을 `true`로 설정했더라도 인스턴스 맵으로만 동작합니다. - **시간 계산 변경**: LazyMap에서 `TimerService`를 사용해 시간을 계산할 경우 맵 로드 시점에 따라 시간 계산이 달라질 수 있습니다. 예를 들어
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | PlayerController를 커스텀할 때 `IsValid` 프로퍼티의 초기값이 false인 이유는 무엇이며, 언제 true로 변경되는지 궁금합니다. [answer] | 제시된 참고 문서에는 `IsValid` 프로퍼티의 초기값이 `false`인 이유와 `true`로 변경되는 시점에 대한 정보가 포함되어 있지 않습니다. 문서에는 `Property` 블록에서 `boolean IsValid = false`로 선언되는 것과, `CanControl()` 및 `OnControlEnabled(boolean enabled)` 메서드 내에서 `self.IsValid`의 값을 확인하는 로직만 제시되어 있을 뿐, 어떤 조건에서 `true`로 설정되는지 설명하고 있지 않습니다. [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] | Lazy Map [question] | LazyMap이 동적으로 생성되는 시점 중 `PortalComponent` 링크와 `TeleportService` 호출 시 서버 자원이 할당되는 순서와 차이는 무엇인가요? [answer] | LazyMap의 동적 생성 시점과 서버 자원 할당에 대해 `PortalComponent` 링크와 `TeleportService` 호출은 모두 "유저가 해당 맵으로 이동하는 행위"를 트리거로 하지만, 자원 할당이 발생하는 구체적인 시점과 메커니즘에 차이점이 있습니다. **1. `PortalComponent` 링크 시** * **트리거 시점:** 유저가 포탈(포탈 컴포넌트가 적용된 엔티티)을 **이용하는 순간**입니다. * **자원 할당 순서:** 유저의 물리적 상호작용(포탈 터치 등)이 감지된 직후, 서버가 즉시 해당 Laz [followup] | `_TeleportService:TeleportToMapPosition` 실행 시 LazyMap이 생성되지 않고 이동이 실패하는 예외 상황이 있는지, 그리고 `_EntityService:GetEntityByPath`를 통한 직접 참조가 맵 생성을 트리거하는 메커니즘을 설명해 주세요. [followup_answer] | 제시된 참고 문서에는 `_TeleportService:TeleportToMapPosition` 실행 시 LazyMap이 생성되지 않고 이동이 실패하는 구체적인 예외 상황(에러 코드, 실패 조건 등)에 대한 설명이 포함되어 있지 않습니다. 따라서 해당 예외 상황에 대해서는 답변할 수 없습니다. 다만, `_EntityService:GetEntityByPath`를 통한 직접 참조가 맵 생성을 트리거하는 메커니즘은 다음과 같습니다. **`_EntityService:GetEntityByPath`를 통한 LazyMap 생성 메커니즘** [scores] | [judge_reason] | [source_doc] | 월드의 규모가 커질수록 서버 메모리 관리와 성능 최적화가 필요합니다. LazyMap을 사용하면 맵을 동적으로 생성하고, 서버 자원을 효율적으로 관리할 수 있습니다. ## LazyMap LazyMap은 서버가 처음 시작될 때 맵이 생성되지 않고, 특정 상황에서 동적으로 지연 생성되는 맵을 뜻합니다. LazyMap을 적절하게 활용하면 서버 메모리 점유율을 낮추고, 연산 처리 자원을 최적화할 수 있습니다. LazyMap은 주로 처음부터 생성될 필요 없는 특수한 맵에 적용해 사용할 수 있습니다. 반대로 모든 월드 유저가 반드시 거치는
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 커스텀 스크립트를 활성화했는데도 기존 기본 조작이 계속 동작하거나, 커스텀 조작이 전혀 반응하지 않을 때 가장 먼저 확인해야 할 설정은 무엇인가요? [answer] | 커스텀 스크립트를 활성화했는데도 기존 기본 조작이 계속 동작하거나, 커스텀 조작이 전혀 반응하지 않을 때 가장 먼저 확인해야 할 설정은 **DefaultPlayer**에 있는 **PlayerControllerComponent**의 **`UseCustomScript`** 프로퍼티 값입니다. 커스텀 컨트롤러를 동작시키려면 다음 두 가지 조건을 모두 충족해야 합니다. 1. **DefaultPlayer**에 제작한 커스텀 컴포넌트(예: `CustomPlayerControllerComponent`)가 추가되어 있어야 합니다. 2. * [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `StateComponent`, `PlayerControllerComponent`, `MovementComponent` 등 여러 컴포넌트 참조 프로퍼티는 스크립트 내에서 어떻게 초기화하거나 할당해야 하나요? [answer] | 제공된 참고 문서에는 `StateComponent`, `PlayerControllerComponent`, `MovementComponent` 등 컴포넌트 참조 프로퍼티를 직접 초기화하거나 할당하는 코드 예제가 포함되어 있지 않습니다. 문서에는 해당 프로퍼티들이 `nil`로 선언되어 있고, `OnMapEnter` 이벤트 핸들러 내에서 `MapComponent`만 `enteredMap` 인자를 통해 할당되는 과정이 보여줄 뿐, 다른 컴포넌트들은 어떻게 값이 채워지는지에 대한 설명이 없습니다. 따라서 문서 근거만으로 이 프로퍼티들의 초 [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] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarStateAnimationComponent의 OnEnd 이벤트를 수신하여 _TimerService:SetTimerOnce를 사용해 0.5초 후 특정 Entity를 소멸시키는 스크립트를 작성해줘. [answer] | 제공된 문서에 따르면, AvatarAction Editor에서 설정할 수 있는 `OnEnd` 이벤트는 **프레임 재생 시점을 구분하는 용도로만 사용되며 스크립트에서 직접 조작할 수 없습니다.** 또한, 스크립트에서 해당 시점에 이벤트를 발생시키고자 한다면 `EventType`을 직접 만들어 프로퍼티를 연결해야 한다고 명시되어 있습니다. 문서에는 `AvatarStateAnimationComponent`가 `OnEnd` 시점을 감지하기 위해 스크립트로 수신하는 구체적인 이벤트 핸들러(예: `HandleAvatarStateAnimati [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 새로운 AvatarAction를 생성하고 나만의 애니메이션을 만들 수 있습니다. 제작한 애니메이션은 반드시 **변경 내용 저장**버튼을 눌러야 변경 사항이 반영됩니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/1784886390520e79ed180f8ac4c86bf631d0f46bc4403.png "2") | 번호| 이름 | 설명 | | --- | --- | --- | || AvatarAction 목록 | 메이플스토리 월드에서 제공하는 기본 AvatarAction 프
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `HorizontalInput`과 `VerticalInput` 값이 0으로 초기화되는 상황에서, 키 입력에 따라 이 값들이 어떻게 갱신되는지 로직을 설명해 주세요. [answer] | 제공된 참고 문서에는 `HorizontalInput`과 `VerticalInput` 프로퍼티가 `0`으로 초기화되는 정의만 포함되어 있으며, 키 입력에 따라 이 값들이 어떻게 갱신되는지에 대한 구체적인 로직이나 코드가 설명되어 있지 않습니다. 문서에는 `ActionKeys`, `InputKeys`, `PressedKeys` 등의 테이블 프로퍼티가 정의되어 있고, `OnControlEnabled` 메서드에서 키 상태(`PressedKeys`)를 확인하여 `StateComponent`의 상태를 변경하는 로직이 일부 확인되지만, `Ho [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] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarAction의 Flip 프로퍼티가 true일 때만 _SpawnService:SpawnByModelId를 호출해 특정 좌표에 아이템을 생성하는 로직을 포함하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서에는 `AvatarAction`의 `Flip` 프로퍼티가 애니메이션 프레임의 Y축 뒤집기 용도임을 명시하고 있으나, **mLua 스크립트에서 `AvatarAction`의 `Flip` 프로퍼티 값을 직접 참조하거나 판별하는 API(예: `self.Entity.AvatarActionComponent.Flip`)에 대한 설명이 없습니다.** 또한, `AvatarAction`의 `Flip` 상태 변화에 따라 자동으로 스크립트가 실행되는 이벤트 핸들러(예: `HandleAvatarActionFlipChangedEvent`) [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 새로운 AvatarAction를 생성하고 나만의 애니메이션을 만들 수 있습니다. 제작한 애니메이션은 반드시 **변경 내용 저장**버튼을 눌러야 변경 사항이 반영됩니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/1784886390520e79ed180f8ac4c86bf631d0f46bc4403.png "2") | 번호| 이름 | 설명 | | --- | --- | --- | || AvatarAction 목록 | 메이플스토리 월드에서 제공하는 기본 AvatarAction 프
[task] | two_turn [pass] | ⏳ 미판정 [title] | Background Editor [question] | Background Editor에서 제공하는 배경 템플릿을 수정하거나 새로운 배경을 직접 제작할 때 어떤 절차와 기능들이 있나요? [answer] | Background Editor는 메이플스토리 월드(MSW)에서 제공하는 배경 템플릿을 수정하거나 새로운 배경을 직접 제작하는 도구입니다. 주요 진입 방법과 기능 절차는 다음과 같습니다. ### 1. Background Editor 진입 방법 * **Resource Storage 경로**: `Resource Storage` > `Background Templates` > 컨텍스트 메뉴에서 `Make Background` 선택 * **Windows 메뉴 경로**: `Windows` > `Background Editor` # [followup] | Background Editor의 'Piece' 목록 순서와 실제 배경 렌더링 순서(Z값, IsFront)가 다른 이유와 배치 우선순위 결정 기준이 무엇인가요? [followup_answer] | Background Editor의 **Piece 목록 순서**와 실제 **배경 렌더링 순서**는 서로 무관합니다. ### 1. Piece 목록 순서 * **정렬 기준**: Piece 목록은 **이름을 기준으로 내림차순**으로 정렬됩니다. * **렌더링과의 관계**: 이 목록의 순서는 실제 배경이 렌더링되는 순서와 아무런 관련이 없습니다. ### 2. 실제 배경 렌더링(배치) 우선순위 결정 기준 실제로 배경이 어떻게 그려지는지(배치 우선순위)는 다음 두 가지 속성으로 결정됩니다. 1. **IsFront (Renderin [scores] | [judge_reason] | [source_doc] | Background Editor를 활용해 MSW에서 제공하는 배경 템플릿을 수정하거나, 직접 배경을 제작할 수 있습니다. ##### 참고 가이드 * [배경 설정하기](/docs?postId=768) ## Background Editor 소개 Background Editor에서 메이플스토리 월드에서 제공하는 배경 템플릿을 크리에이터의 필요에 따라 수정하거나, 새로운 배경을 만들 수 있습니다. Background Editor에 진입하는 방법은 다음과 같습니다. - Resource Storage - Background Templa
[task] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | StateComponent 의 HitEvent 핸들러를 커스텀하여 "HIT" 상태로 변경하는 [client only] 스크립트를 작성해줘 [answer] | StateComponent의 기본 HitEvent 핸들러를 제거하고, HitEvent가 발생하면 커스텀 함수를 통해 "HIT" 상태로 변경되도록 설정하는 `[client only]` 메서드입니다. ```lua Method: [client only] void InitStateComponentEventHandler() { local stateComponent = self.Entity.StateComponent if stateComponent == nil then return end [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] | `InitStateComponentEventHandler` 메서드 구현 코드를 주석으로 설명만 포함하여 출력하세요. [answer] | ```lua Method: [client only] void InitStateComponentEventHandler() { -- Entity의 StateComponent를 참조합니다. local stateComponent = self.Entity.StateComponent -- StateComponent가 존재하지 않으면 함수를 종료합니다. if stateComponent == nil then return end -- 기존에 연결된 HitEvent 핸들러를 [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] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 키 입력 상태를 관리하기 위해 KeyStateEnum과 KeyInfo StructType을 분리해서 만드는 이유는 무엇인가요? [answer] | 키 입력 상태를 관리하기 위해 `KeyStateEnum`과 `KeyInfo` StructType을 분리해서 만드는 이유는 **데이터의 역할과 구조를 명확히 구분**하기 위함입니다. 1. **KeyStateEnum (상태 정의)** * 키가 현재 어떤 상태에 있는지(없음, 차단됨, 눌림, 유지됨)를 나타내는 **상수(Enumeration) 값**을 정의하는 용도로 사용됩니다. * 문서 예시에서 `None`, `Block`, `KeyDown`, `KeyHold`를 각각 `0`, `1`, `2`, `3`으로 매핑 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | two_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarAction JSON 파일의 `Frames` 배열에서 각 프레임의 기본 속성 필드들은 어떤 의미로 사용되나요? [answer] | AvatarAction JSON 파일의 `Frames` 배열 내 각 프레임 객체에는 아래 기본 속성 필드가 포함되어 있으며, 각각의 의미는 다음과 같습니다. * **defined_actionname**: 정의된 액션의 이름을 나타냅니다. * **frameindex**: 해당 프레임의 리소스 인덱스를 나타냅니다. * **framedelay**: 프레임의 재생 시간을 나타내며, 단위는 초입니다. * **move_x**: X축 방향의 이동 값을 나타냅니다. * **move_y**: Y축 방향의 이동 값을 나타냅니다. [followup] | `framedelay`와 `TriggerTime`의 단위가 모두 초임에도 불구하고, 특정 프레임에서 `eventdatas`가 비어 있을 경우와 `EventId`가 `codeblock://...` 형식이 아닌 다른 값을 가질 수 있는 예외 케이스는 무엇인가요? [followup_answer] | 제공된 문서에는 `framedelay`와 `TriggerTime`의 단위가 초임을 명시하고 있지만, `eventdatas`가 비어 있을 경우나 `EventId`가 `codeblock://...` 형식이 아닌 다른 값을 가질 수 있는 예외 케이스에 대한 정보는 포함되어 있지 않습니다. 문서에서 확인할 수 있는 사실은 `eventdatas`가 "선택 항목"이라는 점이며, `EventId`는 단순히 "이벤트 식별자"로만 설명되어 구체적인 형식 제약이나 예외 상황에 대한 설명은 없습니다. [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] | SideviewbodyComponent 가 다른 컴포넌트들과 달리 대소문자 표기가 다른 이유는 무엇인가요? [answer] | 참고 문서에 제시된 mLua 예제 코드에서 `SideviewbodyComponent`는 소문자 'b'로 표기되어 있습니다. 이는 `RigidbodyComponent`(대문자 'B')나 `KinematicbodyComponent`(소문자 'b')와 같이 다른 컴포넌트 이름들과 비교했을 때, `Sideview` 뒤에 오는 `body` 부분의 대소문자 표기가 다른 컴포넌트들과 일치하지 않는 것으로 보입니다. 하지만, 제공된 참고 문서에는 이러한 대소문자 표기가 다른 구체적인 이유나 명명 규칙에 대한 설명이 포함되어 있지 않습니다. 따라 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void CacheComponents() { local entity = self.Entity self.StateComponent = entity.StateComponent self.MovementComponent = entity.MovementComponent self.PlayerControllerComponent = entity.PlayerControllerComponent self.RigidbodyComponent = entity.RigidbodyCompone
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CacheComponents 함수의 본문 코드만 출력하고, 각 변수 할당 과정에 대한 설명은 Lua 주석(-- )으로만 작성해 주세요. [answer] | ```lua local entity = self.Entity -- self.Entity를 통해 현재 스크립트가 부착된 엔티티 객체를 참조합니다. self.StateComponent = entity.StateComponent -- 엔티티의 상태 관리 컴포넌트를 참조하여 상태 변경을 제어할 수 있도록 저장합니다. self.MovementComponent = entity.MovementComponent -- 엔티티의 이동 로직을 담당하는 컴포넌트를 참조하여 이동 제어가 가능하도록 저장합니다. self.PlayerControllerC [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void CacheComponents() { local entity = self.Entity self.StateComponent = entity.StateComponent self.MovementComponent = entity.MovementComponent self.PlayerControllerComponent = entity.PlayerControllerComponent self.RigidbodyComponent = entity.RigidbodyCompone
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | `RemoveActionKey`와 `RemoveAllActionKeyByActionName` 메서드에서 `IsHoldAction` 체크 후 `InputKeys`를 정리하는 로직이 왜 필요한지 3문장 이내로 설명하세요. [answer] | `IsHoldAction` 체크는 해당 액션이 키를 계속 누르고 있는 동안 지속되는 방식인지 확인하기 위함입니다. 홀드 액션의 경우 키가 매핑에서 제거되었음에도 불구하고 `InputKeys`에 눌린 상태가 남아있으면 액션이 계속 실행되는 오류가 발생하기 때문입니다. 따라서 이 로직은 키 매핑이 해제될 때 관련 입력 상태도 즉시 정리하여 입력이 정상적으로 종료되도록 보장합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 기존 컴포넌트와 동일한 인터페이스의 Action, Condition을 관리할 수 있는 메소드를 만들어봅시다. - `GetActionName()`: 키에 매핑된 액션 이름을 반환합니다. - `SetActionKey()`: 키에 액션 이름을 매핑합니다. - `RemoveActionKey()`: 특정 키의 매핑을 제거합니다. - `RemoveAllActionKeyByActionName()`: 특정 액션에 매핑된 모든 키를 제거합니다. - `AddCondition()`: 액션 실행 조건 함수를 추가합니다. - `RemoveAllCondi
[task] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | CustomPlayerActionEvent에 PlayerEntity와 ActionName 프로퍼티를 포함시켜야 하는 이유는 무엇인가요? [answer] | `CustomPlayerActionEvent`에 `PlayerEntity`와 `ActionName` 프로퍼티를 포함시키는 이유는, 커스텀 컨트롤러가 어떤 플레이어가 어떤 액션을 요청했는지를 정확히 식별하고 처리하기 위해서입니다. 구체적인 이유는 다음과 같습니다: 1. **`PlayerEntity`의 필요성**: * 메이플스토리 월드에는 여러 명의 플레이어가 동시에 존재할 수 있습니다. * 이벤트가 발생했을 때, 해당 액션(예: 공격, 점프 등)을 요청한 **구체적인 플레이어 엔티티**를 알아야만 해당 플레 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe
[task] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | 아바타 액션 프레임의 `framedelay` 값이 0.1초 미만인 경우에만 `_UserService`의 `HandleUserEnterEvent` 이벤트 핸들러에서 `log`를 출력하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서에는 `framedelay` 값과 `_UserService`의 `HandleUserEnterEvent` 이벤트를 연결하거나, 특정 프레임 조건에 따라 로그를 출력하도록 하는 로직을 구현하는 API나 메서드가 포함되어 있지 않습니다. 문서에는 `AvatarAction` JSON 파일의 구조(필드 정의)와 `UserService` 이벤트 핸들러의 기본 사용 예제만 제시되어 있을 뿐, 아바타 액션 프레임 데이터를 스크립트 런타임에서 직접 읽거나 조건부로 제어하는 API가 없습니다. 따라서 요청하신 조건(`framedel [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] | PlayerControllerComponent 를 직접 조작할 때 KinematicbodyComponent 와 RigidbodyComponent 중 어떤 것을 우선적으로 확인해야 하는지 판단 기준은 무엇인가요? [answer] | 참고 문서에는 `PlayerControllerComponent`를 직접 조작할 때 `KinematicbodyComponent`와 `RigidbodyComponent` 중 어떤 것을 우선적으로 확인해야 하는지에 대한 **판단 기준이 명시되어 있지 않습니다.** 문서에 제공된 정보로는 다음만 알 수 있습니다: 1. `CacheComponents()` 메서드에서 `RigidbodyComponent`와 `KinematicbodyComponent` 모두 엔티티의 컴포넌트로 캐시할 수 있습니다. 2. `OnControlEnabled(fa [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | [client only] void CacheComponents() { local entity = self.Entity self.StateComponent = entity.StateComponent self.MovementComponent = entity.MovementComponent self.PlayerControllerComponent = entity.PlayerControllerComponent self.RigidbodyComponent = entity.RigidbodyCompone
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | PassByCondition 함수가 반환하는 true/false의 의미와 조건 목록이 비어있거나 nil일 때의 동작을 2문장 이내로 설명하세요. [answer] | `PassByCondition`은 해당 액션의 조건 목록이 비어 있거나 nil인 경우, 그리고 모든 조건 함수가 true를 반환하는 경우에만 true를 반환합니다. 즉, 조건이 없거나 모든 조건을 통과해야만 true가 되고, 하나라도 실패하면 false를 반환합니다. [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