← 목록

mLua · Nemotron SDG 질문-응답 (SFT)

총 21,567개 · 페이지 708/719
🔀 랜덤
불러오는 중…

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | PlayerController 스크립트의 Property 블록에 선언된 변수 10개를 이름과 타입만 포함하여 2열 표로 정리하세요. [answer] | | 이름 | 타입 | | :--- | :--- | | IsValid | boolean | | ActionKeys | table | | ActionConditions | table | | HoldActions | table | | InteractionKeys | table | | InputKeys | table | | PressedKeys | table | | HorizontalInput | number | | VerticalInput | number | | IsMapMoving | boolean | [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] | AvatarAction Editor [question] | 'framedelay'와 'TriggerTime'이 모두 초 단위로 정의되어 있을 때, 특정 프레임에서 이벤트가 발화되는 시점 계산 로직을 단계별 번호 목록으로 작성하세요. [answer] | `framedelay`와 `TriggerTime`이 모두 초 단위로 정의되어 있으므로, 특정 프레임에서 이벤트가 발화되는 시점을 계산하는 로직은 다음과 같습니다. 1. **프레임 시작 시점 계산**: 해당 프레임의 `frameindex`와 이전에 재생된 모든 프레임의 `framedelay` 합산 값을 구하여, 해당 프레임이 시작되는 절대 시간(초)을 계산합니다. * 계산식: `프레임 시작 시점 = (프레임 인덱스 - 1) * framedelay` (첫 번째 프레임인 경우 0) 2. **이벤트 트리거 시점 확인**: [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] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | KeyStateEnum, KeyInfo, CustomPlayerActionEvent에 정의된 프로퍼티의 이름과 타입을 표로 정리하세요. [answer] | 참고 문서에 정의된 `KeyStateEnum`, `KeyInfo`, `CustomPlayerActionEvent`의 프로퍼티 이름과 타입은 다음과 같습니다. | 타입 (Type) | 프로퍼티 이름 (Name) | 기본값 (Default) | | :--- | :--- | :--- | | **KeyStateEnum** | | | | integer | None | 0 | | integer | Block | 1 | | integer | KeyDown | 2 | | integer | KeyHold | 3 | | **KeyInfo** | | [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] | 기존 기본 State Key에 직접 BodyAction을 연결했을 때 PlayRate 차이로 인해 예상과 다른 동작이 발생하는 원인과 해결 방법을 알려주세요 [answer] | 기존 기본 State Key에 직접 BodyAction을 연결했을 때 예상과 다른 동작이 발생하는 원인은 기본 State와 연결된 BodyAction에 이미 특정한 **PlayRate** 값이 지정되어 있기 때문입니다. 크리에이터가 새로 제작한 BodyAction은 일반적으로 전체 재생 시간을 PlayRate 1로 기준으로 계산됩니다. 그러나 기존 기본 Key는 원작 메이플스토리의 움직임에 맞춰 이미 다른 PlayRate 값이 설정되어 있어, 새 BodyAction을 그대로 연결하면 애니메이션의 전체 재생 속도가 의도하지 않게 빨 [followup] | AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet에 새로운 Key를 추가하고 BodyAction을 연결하는 구체적인 4단계 절차와 PlayRate 값 지정 시 주의사항은 무엇인가요? [followup_answer] | AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet에 새로운 Key를 추가하고 BodyAction을 연결하는 구체적인 4단계 절차는 다음과 같습니다. 1. **DefaultPlayer**를 선택합니다. 2. **AvatarStateAnimationComponent - StateToAvatarBodyActionSheet**에서 새로운 **Key**를 추가합니다. 3. AvatarBodyAction에서 제작한 **BodyAction**을 지정합니다. 4. **PlayRat [scores] | [judge_reason] | [source_doc] | 제작한 BodyAction은 AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet의 **Key**에 등록해 사용해야 합니다. 기본적으로 AvatarStateAnimationComponent에는 메이플스토리 원작과 동일한 움직임을 구현한 Key들이 지정되어 있습니다. 만약 이 기존 Key에서 AvatarBodyAction을 제작한 BodyAction으로 연결할 경우 크리에이터의 예상과 다르게 동작할 수 있습니다. 기본 State와 연결된 BodyAction에 맞는 PlayRate

[task] | single_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | 기존 기본 State Key에 직접 BodyAction을 연결했는데 동작이 이상해서, 왜 PlayRate 때문인 건지 원리를 알고 싶어요. [answer] | 기존 기본 State Key에 직접 크리에이터가 제작한 BodyAction을 연결했을 때 동작이 이상하게 보이는 주된 원인은 **기본 State에 이미 지정되어 있는 PlayRate 값** 때문입니다. **원리 설명:** 1. **기본 State의 PlayRate 고정:** 메이플스토리 원작과 동일한 움직임을 구현한 기본 State들은 해당 애니메이션에 맞춰 최적화된 `PlayRate` 값이 미리 지정되어 있습니다. 2. **PlayRate의 역할:** `PlayRate`는 AvatarBodyAction의 전체 재생 속도를 결 [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] | AvatarAction Editor [question] | BodyAction의 이름은 50자까지 가능하다는 제약 사항과, 제작한 BodyActions를 JSON 파일로 내보내거나 불러오는 기능이 궁금합니다. [answer] | BodyAction의 이름은 최대 50자까지 입력할 수 있습니다. 또한, AvatarActionEditor의 BodyAction 목록 영역에서 제공하는 기능을 통해 제작한 BodyActions를 JSON 파일 형태로 내보내거나, 기존에 만든 JSON 파일을 불러올 수 있습니다. [followup] | JSON 파일을 불러오거나 내보낼 때 파일 형식이나 인코딩에 대한 제한이 있으며, 대용량 BodyAction을 관리할 때 발생하는 예외 상황이나 최적화 팁이 있나요? [followup_answer] | 제공된 참고 문서에는 JSON 파일의 구체적인 형식이나 인코딩 제한 사항, 대용량 BodyAction 관리 시 발생하는 예외 상황, 또는 최적화 팁에 대한 정보가 포함되어 있지 않습니다. 문서에는 "제작한 BodyActions를 JSON 파일로 내보내거나, 불러올 수 있다"는 기능의 존재만 명시되어 있을 뿐, 기술적 세부 사항이나 성능 관련 가이드는 언급되어 있지 않습니다. [scores] | [judge_reason] | [source_doc] | AvatarActionEditor를 활용해 메이플스토리 월드에서 제공하는 BodyAction의 프레임들을 재구성해 크리에이터 만의 BodyAction을 만들 수 있습니다. ##### 참고 가이드 * [아바타 애니메이션 제어하기 ](/docs?postId=820) * [ActionSheet로 아바타 애니메이션 손쉽게 제어하기](/docs?postId=545) ## AvatarActionEditor 소개 메이플스토리 월드는 메이플스토리의 기본 BodyAction을 제공하고 있습니다.AvatarActionEditor에서는 스크립트에

[task] | code [pass] | ⏳ 미판정 [title] | Lazy Map [question] | LazyMap 로드 시점에 `OnBeginPlay()`에서 `TimerService`를 활용해 일정 시간 후 몬스터를 소환하는 스크립트를 작성해줘 [answer] | LazyMap 환경에서 `OnBeginPlay()`는 맵이 실제로 로드되는 시점에 호출됩니다. 따라서 `TimerService`를 사용하여 일정 시간 후 몬스터를 소환하는 로직은 해당 시점을 기준으로 정확하게 동작합니다. 참고 문서에 따르면, LazyMap의 `TimerService` 사용 시 맵 로드 시점에 따라 시간 계산이 달라질 수 있으므로, `OnBeginPlay()` 내에서 타이머를 설정하는 것이 권장되는 방식입니다. 아래는 요청하신 내용을 구현한 mLua 스크립트입니다. ```lua Property: [None] n [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | - **생성된 LazyMap 삭제 불가능**: 한 번 생성된 LazyMap은 삭제할 수 없습니다. LazyMap이 생성되고 나면 기존 정적 맵과 동일하게 작동합니다. - **인스턴스 맵 제외**: 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. 만약 `IsLazyMap` 값을 `true`로 설정했더라도 인스턴스 맵으로만 동작합니다. - **시간 계산 변경**: LazyMap에서 `TimerService`를 사용해 시간을 계산할 경우 맵 로드 시점에 따라 시간 계산이 달라질 수 있습니다. 예를 들어 

[task] | two_turn [pass] | ⏳ 미판정 [title] | Lazy Map [question] | DynamicMapService를 통해 LazyMap을 동적 맵으로 생성 및 삭제하는 과정과, 로컬워크스페이스에서 MAP File의 DynamicLoading 값을 512로 설정할 때의 유의 사항을 알려주세요. [answer] | DynamicMapService를 사용하여 LazyMap을 동적 맵으로 생성하고 삭제하는 과정 및 로컬워크스페이스 설정 시 유의 사항은 다음과 같습니다. ### 1. DynamicMapService를 통한 LazyMap 생성 및 삭제 `DynamicMapService`를 사용하면 **원본 맵을 로드하지 않은 상태**에서 LazyMap을 동적 맵으로 생성하고, 이후 이를 삭제할 수 있습니다. * **생성**: 원본 맵 데이터가 서버 메모리에 로드되어 있지 않더라도, `DynamicMapService`를 통해 해당 LazyMa [followup] | 로컬워크스페이스 환경에서 다수의 맵을 한 번에 LazyMap으로 지정하기 위해 MAP File JSON 구조를 어떻게 수정해야 하며, 이 설정이 원본 맵 로드와 동적 맵 생성에 미치는 영향을 설명해 주세요. [followup_answer] | 로컬워크스페이스 환경에서 다수의 맵을 한 번에 LazyMap으로 지정하기 위한 MAP File 수정 방법과 그 영향은 다음과 같습니다. ### 1. MAP File JSON 구조 수정 방법 로컬워크스페이스를 사용하는 월드의 MAP File에서 **`DynamicLoading`** 값을 **`512`**로 수정해야 합니다. 이 값을 설정하면 해당 맵들이 LazyMap으로 지정되어 동적 로딩 대상이 됩니다. 아래는 `DynamicLoading`을 `512`로 설정한 MAP File의 JSON 구조 예시입니다. ```json { [scores] | [judge_reason] | [source_doc] | 스크립트의 프로퍼티 또는 이벤트로 참조할 때 동적으로 맵이 생성됩니다. **월드 초기화 시점**: 정적 맵에서 LazyMap의 엔티티를 프로퍼티나 이벤트로 직접 참조하는 스크립트가 있다면, 해당 LazyMap은 서버 초기화 시점에 함께 로드됩니다. **월드 플레이 중**: 월드 플레이 중 LazyMap이 생성될 때 그 안의 참조 대상인 다른 LazyMap도 함께 생성됩니다. 예를 들어 LazyMap1이 생성될 때 LazyMap1에 LazyMap2를 참조하는 프로퍼티나 이벤트를 가진 스크립트가 있다면 LazyMap2도 LazyMa

[task] | code [pass] | ⏳ 미판정 [title] | Lazy Map [question] | LazyMap이 로드될 때 `OnMapEnter()` 이벤트 핸들러를 통해 `_UserService`의 `HandleUserEnterEvent` 대신 사용자 입장 처리 로직을 실행하는 스크립트를 작성해줘 [answer] | LazyMap 관련 참고 문서에 따르면, `OnMapEnter()`은 서버의 이벤트 **함수(Function)**이며, `HandleUserEnterEvent`처럼 `UserService`의 **이벤트 핸들러(Event Handler)**가 아닙니다. 질문에서 요구하신 "`HandleUserEnterEvent` **대신** 사용자 입장 처리 로직을 실행"하는 부분은 mLua의 구조상 `HandleUserEnterEvent`를 없애거나 대체하는 것이 아니라, **LazyMap이 로드되는 시점에 기존에 입장해 있던 유저들을 순회하여 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | - **생성된 LazyMap 삭제 불가능**: 한 번 생성된 LazyMap은 삭제할 수 없습니다. LazyMap이 생성되고 나면 기존 정적 맵과 동일하게 작동합니다. - **인스턴스 맵 제외**: 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. 만약 `IsLazyMap` 값을 `true`로 설정했더라도 인스턴스 맵으로만 동작합니다. - **시간 계산 변경**: LazyMap에서 `TimerService`를 사용해 시간을 계산할 경우 맵 로드 시점에 따라 시간 계산이 달라질 수 있습니다. 예를 들어 

[task] | two_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarAction Editor에서 애니메이션 프레임을 편집하고 저장하는 기본 작업 흐름은 어떻게 되나요? [answer] | AvatarAction Editor에서 애니메이션 프레임을 편집하고 저장하는 기본 작업 흐름은 다음과 같습니다. 1. **AvatarAction 생성 및 선택**: 새로운 AvatarAction를 생성하거나, 기존 목록에서 사용할 애니메이션을 선택합니다. 2. **프레임 편집**: 프레임 편집창에서 애니메이션 프레임의 순서를 조정합니다. 프레임은 왼쪽에서 오른쪽으로 순차적으로 재생되며, Play Type에 따라 재생 방식이 결정됩니다. 3. **프레임 프로퍼티 설정**: 각 프레임의 세부 설정을 변경합니다. * ` [followup] | 미리보기에서 확인한 PlayType 값이 실제 게임에 저장되지 않는다는 점과, 변경 내용 저장 버튼을 누르지 않으면 반영되지 않는 구체적인 예외 상황은 무엇인가요? [followup_answer] | 제공된 참고 문서에 따르면, 구체적인 예외 상황이나 저장되지 않는 다른 특별한 조건은 명시되어 있지 않습니다. 문서에 언급된 내용은 다음과 같습니다. 1. **PlayType 값 저장 불가**: 미리보기 공간에서 PlayType 값을 변경해 확인해도, 해당 값은 저장되지 않습니다. 2. **변경 내용 저장 필수**: AvatarAction Editor에서 제작한 애니메이션의 변경 사항은 반드시 **변경 내용 저장** 버튼을 눌러야만 실제로 반영됩니다. 따라서 문서에서 확인 가능한 내용은 "미리보기에서 PlayType을 변경하 [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] | AvatarAction Editor [question] | flip 값이 true일 때 move_x의 방향도 자동으로 반전되는지, 아니면 따로 설정해야 하는지 궁금합니다. [answer] | 제공된 문서에는 `flip` 필드가 "좌우 반전 여부"임을 명시하고 있으며, `move_x` 필드는 "X축 이동 값"으로 정의되어 있습니다. 그러나 두 값 간의 연동 관계(즉, `flip`이 `true`일 때 `move_x`가 자동으로 부호가 바뀌는지 여부)에 대한 설명은 문서에 포함되어 있지 않습니다. 따라서 `flip` 값이 `true`일 때 `move_x`의 방향이 자동으로 반전되는지, 아니면 개발자가 별도로 값을 설정해야 하는지는 확인할 수 없습니다. [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] | AvatarAction Editor [question] | Frames 배열에서 frameindex가 건너뛰는 경우(예: 0, 1, 3) 재생이 어떻게 처리되는지, 에러가 나는지 알려주세요. [answer] | 제공된 문서에는 `Frames` 배열의 `frameindex`가 연속되지 않고 건너뛰는 경우(예: 0, 1, 3)에 대한 재생 처리 방식이나 에러 발생 여부에 대한 정보가 포함되어 있지 않습니다. 문서에는 `frameindex`가 "프레임 리소스 인덱스"임을 명시하고 있을 뿐, 비연속 인덱스 입력 시 시스템이 어떻게 동작하는지(예: 누락된 프레임 무시, 에러 발생, 보간 처리 등)에 대한 설명은 없습니다. [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] | code [pass] | ⏳ 미판정 [title] | Lazy Map [question] | 정적 맵의 `OnBeginPlay()`에서 LazyMap 엔티티를 `_EntityService:GetEntityByPath`로 참조하여 초기화 처리를 지연시키는 스크립트를 작성해줘 [answer] | LazyMap은 정적 맵과 다르게 **서버 시작 시점이 아닌, 맵이 실제로 로드되는 시점**에 `OnInitialize()`, `OnMapEnter()`, `OnBeginPlay()` 등 초기화 이벤트가 호출됩니다. 또한 정적 맵에서 LazyMap을 참조할 경우, LazyMap의 이벤트 함수가 후순위로 처리될 수 있으므로 순환 참조나 연속적인 참조 구조는 권장되지 않습니다. 요청하신 대로 정적 맵의 `OnBeginPlay()`에서 `_EntityService:GetEntityByPath`를 사용해 LazyMap 엔티티를 참조하고, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | - **생성된 LazyMap 삭제 불가능**: 한 번 생성된 LazyMap은 삭제할 수 없습니다. LazyMap이 생성되고 나면 기존 정적 맵과 동일하게 작동합니다. - **인스턴스 맵 제외**: 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. 만약 `IsLazyMap` 값을 `true`로 설정했더라도 인스턴스 맵으로만 동작합니다. - **시간 계산 변경**: LazyMap에서 `TimerService`를 사용해 시간을 계산할 경우 맵 로드 시점에 따라 시간 계산이 달라질 수 있습니다. 예를 들어 

[task] | two_turn [pass] | ⏳ 미판정 [title] | Lazy Map [question] | LazyMap 설정 시 로비 맵과 특수 맵의 적용 기준 및 서버 메모리 최적화 효과에 대해 설명해 주세요. [answer] | LazyMap은 서버 메모리 관리와 성능 최적화를 위해 맵을 동적으로 생성하는 기능입니다. 월드의 규모가 커질수록 서버 자원을 효율적으로 관리할 수 있도록 도와줍니다. **적용 기준** * **특수 맵:** 처음부터 생성될 필요가 없는 특수한 맵에는 LazyMap을 적용하여 사용하는 것이 권장됩니다. * **로비 맵:** 모든 월드 유저가 반드시 거치는 로비 같은 맵에는 LazyMap으로 설정하지 않는 것이 권장됩니다. **서버 메모리 최적화 효과** * 서버가 처음 시작될 때 맵이 생성되지 않고, 필요할 때 동적으로 [followup] | 로비 맵에 LazyMap을 적용했을 때 발생할 수 있는 문제점과, `IsLazyMap` 프로퍼티 설정 후 실제 맵이 생성되는 구체적인 시점(포탈, 텔레포트, 직접 참조)별 차이점을 코드 예시와 함께 알려 주세요. [followup_answer] | ### 로비 맵에 LazyMap 적용 시 문제점 모든 월드 유저가 반드시 거치는 로비 맵에는 LazyMap으로 설정하지 않는 것이 권장됩니다. 로비 맵에 LazyMap을 적용하면 서버 시작 시점에 맵이 생성되지 않아, 유저가 접속하거나 이동하는 등의 상호작용이 발생하는 순간까지 맵이 로드되지 않습니다. 이로 인해 필수적인 진입 지점인 로비가 지연 생성되는 문제를 초래할 수 있으며, 서버 메모리 최적화의 이점을 얻기보다 초기 접속 경험 저하와 불필요한 지연이 발생할 수 있습니다. ### IsLazyMap 설정 후 맵 생성 시점별 [scores] | [judge_reason] | [source_doc] | 월드의 규모가 커질수록 서버 메모리 관리와 성능 최적화가 필요합니다. LazyMap을 사용하면 맵을 동적으로 생성하고, 서버 자원을 효율적으로 관리할 수 있습니다. ## LazyMap LazyMap은 서버가 처음 시작될 때 맵이 생성되지 않고, 특정 상황에서 동적으로 지연 생성되는 맵을 뜻합니다. LazyMap을 적절하게 활용하면 서버 메모리 점유율을 낮추고, 연산 처리 자원을 최적화할 수 있습니다. LazyMap은 주로 처음부터 생성될 필요 없는 특수한 맵에 적용해 사용할 수 있습니다. 반대로 모든 월드 유저가 반드시 거치는

[task] | two_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | 프레임에 연결할 수 있는 이벤트 타입(OnStart, OnValue, OnEnd)의 차이점과, 스크립트에서 직접 조작할 수 없는 이유에 대해 자세히 설명해 주세요. [answer] | 아바타 액션(AvatarAction) 프레임에 연결할 수 있는 이벤트 타입은 `OnStart`, `OnValue`, `OnEnd` 세 가지로, 각각 프레임 재생의 특정 시점을 구분하는 용도로만 사용됩니다. **1. 이벤트 타입별 차이점** * **OnStart**: 해당 프레임이 재생되는 **첫 시점**을 의미합니다. * **OnValue**: 해당 프레임이 재생되는 **동안**(과정)을 의미합니다. 주로 캐릭터가 특정 자세를 취하고 있는 동안 키 입력을 막아 공격이나 피격 판정을 정밀하게 처리하는 용도로 활용됩니다. * [followup] | OnValue 이벤트를 사용하여 키 입력을 막아 공격 판정을 정밀하게 처리하기 위해, 직접 만든 EventType을 생성하고 프로퍼티를 연결하는 구체적인 코드 작성 예시는 무엇인가요? [followup_answer] | 참고 문서에 따르면, `OnValue` 시점에 이벤트를 발생시키기 위해 직접 만든 `EventType`을 생성하고 프로퍼티를 연결하는 **mLua 스크립트 코드 예시는 제공되지 않습니다.** 문서에는 다음과 같은 사실만 명시되어 있습니다. 1. **EventType 생성 및 연결 절차**: * Workspace에서 `Create EventType`를 선택해 새로운 EventType을 생성합니다. * 생성한 EventType에 프로퍼티를 추가하고 이름을 변경합니다. * AvatarAction Ed [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] | AvatarAction Editor [question] | AvatarAction의 각 프레임에 이벤트 프로퍼티(EventType)를 연결하여 재생 시작, 중간, 마지막 시점에 이벤트를 발생시키는 구체적 사용법이 궁금합니다. [answer] | 제공된 문서에는 AvatarAction의 프레임에 이벤트 프로퍼티(EventType)를 연결할 수 있다는 기능의 **개요**만 언급되어 있습니다. 구체적으로 어떤 EventType이 존재하는지, UI에서 어떤 항목을 선택해야 하는지, 또는 해당 이벤트를 스크립트에서 어떻게 수신하고 처리하는지(예: 특정 Event Handler 시그니처나 API)에 대한 **상세한 사용법 및 코드 예제는 문서에 없습니다.** 문서에 명시된 정보에 따르면: 1. **AvatarAction**을 프레임 단위로 선택해 조합할 수 있습니다. 2. 각 [followup] | 프레임 재생 중 특정 시점에 이벤트가 발생했을 때 스크립트로 이펙트를 재생하거나 조작을 막기 위해 mLua에서 어떤 이벤트 핸들러를 구현해야 하는지 코드 예시를 보여주세요. [followup_answer] | 제공된 참고 문서에는 AvatarAction의 프레임 재생 시점에 `EventType`을 이용해 이벤트를 발생시킬 수 있다는 기능 설명만 포함되어 있으며, 해당 이벤트를 mLua 스크립트에서 수신하기 위한 **구체적인 이벤트 핸들러 시그니처(함수 이름, 파라미터)나 API 명세는 없습니다.** 문서에는 "이벤트 프로퍼티를 연결해 사용할 수 있습니다"라고만 기술되어 있고, 실제 스크립트 연동 코드 예제나 이벤트 타입 목록이 제공되지 않았습니다. 따라서 문서에 근거하여 정확한 mLua 이벤트 핸들러 코드를 작성할 수 없습니다. 정확 [scores] | [judge_reason] | [source_doc] | AvatarActionEditor를 활용해 메이플스토리 월드에서 제공하는 BodyAction의 프레임들을 재구성해 크리에이터 만의 BodyAction을 만들 수 있습니다. ##### 참고 가이드 * [아바타 애니메이션 제어하기 ](/docs?postId=820) * [ActionSheet로 아바타 애니메이션 손쉽게 제어하기](/docs?postId=545) ## AvatarActionEditor 소개 메이플스토리 월드는 메이플스토리의 기본 BodyAction을 제공하고 있습니다.AvatarActionEditor에서는 스크립트에

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | InitHoldActions()에서 holdActions 테이블에 true 값으로 등록되는 액션 이름만 코드 블록 안에 줄바꿈으로 나열해 주세요. [answer] | ```lua MoveUp MoveDown MoveLeft MoveRight Jump Jump2 ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 컴포넌트를 초기화할 수 있도록 아래 5가지 메소드를 추가하고, 아래와 같이 작성합니다. `UseCustomScript`가 `false`이면 초기화하지 않으며, LocalPlayer인 경우에만 키 매핑, Hold 액션 설정, 이벤트 핸들러 등록, 컴포넌트 캐싱을 수행합니다. - `OnBeginPlay()`: 컴포넌트 초기화의 진입점으로 키, 핸들러, 컴포넌트를 설정하고 StateComponent의 HitEventHandler를 재정의합니다. - `InitKeys()`: 액션 키와 상호작용 키의 기본 매핑을 등록합니다. - `Init

[task] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet에 새로운 Key를 추가하고, 해당 Key에 제작한 BodyAction과 PlayRate 값을 설정하는 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `AvatarStateAnimationComponent`의 `StateToAvatarBodyActionSheet`에 Key를 추가하고 BodyAction 및 PlayRate를 설정하는 **mLua 스크립트 코드**나 관련 **API(메서드/프로퍼티)** 명세가 포함되어 있지 않습니다. 문서에는 다음과 같은 **에디터 기반 설정 절차**만 설명되어 있습니다: 1. `DefaultPlayer` 선택 2. `AvatarStateAnimationComponent` - `StateToAvatarBodyActionSh [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 제작한 BodyAction은 AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet의 **Key**에 등록해 사용해야 합니다. 기본적으로 AvatarStateAnimationComponent에는 메이플스토리 원작과 동일한 움직임을 구현한 Key들이 지정되어 있습니다. 만약 이 기존 Key에서 AvatarBodyAction을 제작한 BodyAction으로 연결할 경우 크리에이터의 예상과 다르게 동작할 수 있습니다. 기본 State와 연결된 BodyAction에 맞는 PlayRate

[task] | single_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarAction JSON에서 Data의 Key를 NewAvatarAction으로 고정해야 하는지, 아니면 원하는 액션 이름으로 자유롭게 변경해도 되는지 확인하고 싶습니다. [answer] | `AvatarAction` JSON 파일에서 `Data` 객체의 Key는 `NewAvatarAction`으로 고정되어야 하는 것이 아닙니다. 문서에 따르면 `Data`는 **AvatarAction 이름을 Key로 갖는 Dictionary**입니다. 따라서 `NewAvatarAction`, `NewBodyAction`, `NewBodyAction_1` 등처럼 원하는 액션 이름을 자유롭게 Key로 사용할 수 있습니다. 예를 들어, 아래 JSON 구조에서 `Data` 안의 Key는 개발자가 정의한 액션 이름을 그대로 사용합니다: ` [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] | code [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | Entity의 StateComponent, MovementComponent, PlayerControllerComponent, RigidbodyComponent, KinematicbodyComponent, SideviewbodyComponent를 CacheComponents() 메서드에서 캐싱하는 스크립트를 작성해줘 [answer] | 요청하신 대로 `Entity`의 각 컴포넌트를 `CacheComponents()` 메서드에서 캐싱하는 스크립트입니다. ```lua Property: [None] StateComponent StateComponent = nil [None] MovementComponent MovementComponent = nil [None] PlayerControllerComponent PlayerControllerComponent = nil [None] RigidbodyComponent RigidbodyComponent = nil [None] K [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] | AvatarAction의 Delay 프로퍼티 값을 1.0초로 설정하고, OnStart 이벤트 시점에 self.Entity.TransformComponent.Position의 Y값을 5.0만큼 증가시키는 스크립트를 작성해줘. [answer] | 요청하신 작업은 두 가지 단계로 이루어집니다. 1. **AvatarAction Editor 설정**: 특정 프레임의 `Delay` 프로퍼티를 `1.0`으로 설정하고, `OnStart` 이벤트에 스크립트에서 처리할 수 있는 `EventType`을 연결해야 합니다. (참고: AvatarAction의 기본 `OnStart` 이벤트는 스크립트에서 직접 조작할 수 없으므로, `Workspace - MyDesk - Create Scripts - Create EventType`을 통해 커스텀 이벤트를 생성하여 연결해야 합니다.) 2. ** [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] | code [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | AvatarAction의 OnValue 이벤트 발생 시점에 _UserService를 통해 접속된 모든 유저에게 "공격 판정 중"이라는 메시지를 log로 출력하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서를 확인한 결과, 요청하신 스크립트를 작성할 수 없습니다. 이유는 다음과 같습니다. 1. **OnValue 이벤트의 직접 조작 불가**: 문서에 명시된 바와 같이, `OnStart`, `OnValue`, `OnEnd` 이벤트는 "프레임 재생 시점을 구분하는 용도로만 사용되며 **스크립트에서 직접 조작할 수는 없습니다**"라고 규정되어 있습니다. 2. **대체 방법의 한계**: 문서에서는 해당 시점에 이벤트를 발생시키고자 한다면 **EventType**을 직접 만들고 생성한 프로퍼티를 연결해야 한다고 안내하고 [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] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 커스텀 PlayerControllerComponent를 생성하기 위한 Workspace 내 경로와 생성 단계를 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua -- 1. Logic 생성 -- 경로: Workspace - MyDesk - Create Scripts - Create Logic -- 이름: KeyStateEnum Property: [None] integer None = 0 [None] integer Block = 1 [None] integer KeyDown = 2 [None] integer KeyHold = 3 -- 2. StructType 생성 -- 경로: Workspace - MyDesk - Create Scripts - Create StructType -- [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe

[task] | two_turn [pass] | ⏳ 미판정 [title] | Lazy Map [question] | LazyMap에서 TimerService를 사용할 때 시간 계산이 달라지는 구체적인 예시와 코드 작성 방법은? [answer] | LazyMap에서 `TimerService`를 사용할 때 시간 계산이 달라지는 핵심 원인은 **LazyMap이 서버 시작 시점에 바로 로드되지 않고, 실제 로드되는 시점에 초기화 함수가 호출되기 때문**입니다. 정적 맵은 서버가 시작되면 즉시 로드되므로 `OnBeginPlay()`와 같은 초기화 시점이 서버 시작 시각과 거의 일치합니다. 하지만 LazyMap은 사용자의 진입이나 참조 등 특정 조건이 충족되어 맵이 실제로 로드되는 시점에야 비로소 `OnBeginPlay()`, `OnInitialize()` 등이 실행됩니다. 따라서 [followup] | OnBeginPlay()에서 5초 후 몬스터를 소환하는 TimerService 코드와, 맵 로드 지연에 따른 시간 차이 방지 방안은? [followup_answer] | LazyMap에서 `OnBeginPlay()`를 기준으로 5초 후 몬스터를 소환하는 `TimerService` 사용 코드와, 맵 로드 지연으로 인한 시간 차이 문제를 방지하기 위한 설계 원칙은 다음과 같습니다. ### 1. LazyMap에서 5초 후 몬스터 소환 코드 LazyMap은 실제 로드되는 시점에 `OnBeginPlay()`가 호출되므로, 아래 코드는 **맵이 로드된 후** 5초가 지나면 실행됩니다. ```lua Property: [None] number SpawnDelay = 5 Method: [server only [scores] | [judge_reason] | [source_doc] | - **생성된 LazyMap 삭제 불가능**: 한 번 생성된 LazyMap은 삭제할 수 없습니다. LazyMap이 생성되고 나면 기존 정적 맵과 동일하게 작동합니다. - **인스턴스 맵 제외**: 인스턴스 맵(Instance Map)은 LazyMap으로 설정할 수 없습니다. 만약 `IsLazyMap` 값을 `true`로 설정했더라도 인스턴스 맵으로만 동작합니다. - **시간 계산 변경**: LazyMap에서 `TimerService`를 사용해 시간을 계산할 경우 맵 로드 시점에 따라 시간 계산이 달라질 수 있습니다. 예를 들어 

[task] | single_turn [pass] | ⏳ 미판정 [title] | AvatarAction Editor [question] | eventdatas는 선택 항목이라고 하는데, 특정 프레임에 이벤트를 여러 개 걸고 싶을 때 배열 구조상 지원되나요? [answer] | 네, `eventdatas`는 배열(list) 구조로 정의되어 있어 특정 프레임에 이벤트를 여러 개 걸 수 있습니다. 문서에 따르면 `eventdatas` 필드는 "프레임 이벤트 목록"이며, 각 이벤트 항목은 `EventId`, `TriggerTime`, `EventType`를 갖습니다. 따라서 하나의 프레임 객체 내 `eventdatas` 배열에 중괄호 `{}`로 구분된 객체를 여러 개 나열하면 됩니다. 아래는 특정 프레임에 두 개의 이벤트를 동시에 등록하는 구조의 예시입니다. ```lua { "Data": { " [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] | 커스텀 PlayerController 만들기 [question] | PlayerController 스크립트에서 정의된 Property 목록과 각 변수의 타입 및 초기값에 대해 설명해 주세요. [answer] | PlayerController 스크립트에서 정의된 Property 목록은 다음과 같습니다. 각 변수는 `[None]` 속성을 가지며, 지정된 타입과 초기값을 갖습니다. ```lua Property: [None] boolean IsValid = false [None] table ActionKeys = {} [None] table ActionConditions = {} [None] table HoldActions = {} [None] table InteractionKeys = {} [None] table InputKeys = {} [ [followup] | `HoldActions`와 `InteractionKeys` 테이블은 어떤 구조로 데이터를 저장해야 하며, `IsMapMoving` 플래그는 어떤 조건에서 `true`로 설정되나요? [followup_answer] | 제공된 참고 문서에는 `HoldActions`와 `InteractionKeys` 테이블의 내부 데이터 구조(키-값 매핑 방식, 저장되는 구체적인 내용 등)에 대한 설명이 포함되어 있지 않습니다. 문서에는 이 변수들이 `table` 타입으로 초기값이 빈 테이블 `{}`인 Property로 선언되어 있다는 사실만 확인할 수 있습니다. `IsMapMoving` 플래그는 `OnMapLeave` 메서드가 호출될 때 `true`로 설정됩니다. 이는 엔티티가 맵을 나갈 때 컨트롤러의 입력을 비활성화하기 위해 사용됩니다. ```lua Meth [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] | DefaultPlayer에 커스텀 컨트롤러를 적용하려면 어떤 순서로 설정해야 하며, 기존 PlayerControllerComponent와 충돌하지 않으려면 어떤 프로퍼티를 변경해야 하나요? [answer] | DefaultPlayer에 커스텀 컨트롤러를 적용하고 기존 PlayerControllerComponent와 충돌하지 않도록 하려면 다음 순서로 설정해야 합니다. 1. **컴포넌트 추가**: 제작한 `CustomPlayerControllerComponent`를 `DefaultPlayer` 엔티티에 추가합니다. 2. **기존 컴포넌트 비활성화**: `DefaultPlayer`에 이미 존재하는 `PlayerControllerComponent`를 선택한 뒤, 해당 컴포넌트의 **`UseCustomScript`** 프로퍼티를 `true`로 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Playe

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | self.Entity 를 통해 접근되는 6개의 컴포넌트 프로퍼티 이름을 한 줄에 하나씩 단계별 번호 목록으로 나열해 주세요. [answer] | 1. StateComponent 2. MovementComponent 3. PlayerControllerComponent 4. RigidbodyComponent 5. KinematicbodyComponent 6. SideviewbodyComponent [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] | single_turn [pass] | ⏳ 미판정 [title] | 커스텀 PlayerController 만들기 [question] | 네이티브 PlayerControllerComponent의 기능을 일부만 수정해서 쓰고 싶을 때, 커스텀 컴포넌트를 새로 만드는 것 대신 어떤 두 가지 대안 방법이 있나요? [answer] | 네이티브 PlayerControllerComponent의 기능을 일부만 수정하여 사용하려면, 커스텀 컴포넌트를 새로 만드는 대신 다음과 같은 두 가지 대안 방법을 활용할 수 있습니다. 1. **컴포넌트 확장 (Inheritance)** PlayerControllerComponent를 상속받아 주요 메서드들을 `override`하여 기능을 재정의합니다. 이렇게 하면 기존 네이티브 컴포넌트의 기본 동작은 유지하면서 특정 부분만 원하는 대로 수정할 수 있습니다. 2. **액션 키 분리 (Action Key Separation)* [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] | BodyAction JSON에서 core_action_name이 null인 상태를 감지하여 미할당된 BodyAction으로 처리하는 유효성 검사 로직을 구현하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에는 BodyAction JSON의 구조와 필드 설명만 포함되어 있으며, `core_action_name`이 `null`인 경우를 감지하는 구체적인 mLua 스크립트 API나 JSON 파싱 함수, 그리고 유효성 검사 로직을 위한 특정 이벤트 핸들러가 문서에 명시되어 있지 않습니다. 문서에서 확인 가능한 정보에 따르면, `core_action_name` 필드는 연결된 AvatarAction 이름을 의미하며, `null`은 미할당된 상태를 의미합니다. 또한 BodyAction과 AvatarAction은 각각 별도의 J [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 제작한 BodyAction은 AvatarStateAnimationComponent의 StateToAvatarBodyActionSheet의 **Key**에 등록해 사용해야 합니다. 기본적으로 AvatarStateAnimationComponent에는 메이플스토리 원작과 동일한 움직임을 구현한 Key들이 지정되어 있습니다. 만약 이 기존 Key에서 AvatarBodyAction을 제작한 BodyAction으로 연결할 경우 크리에이터의 예상과 다르게 동작할 수 있습니다. 기본 State와 연결된 BodyAction에 맞는 PlayRate

← → 방향키로 페이지 이동 · 숫자 입력 후 Enter로 점프