[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | @Sync 속성을 적용한 number 타입 Speed 프로퍼티를 정의하고, OnUpdate 메서드에서 매 프레임마다 Speed 값을 1씩 증가시키는 스크립트를 작성해줘 [answer] | 요청하신 `@Sync` 속성이 적용된 `number` 타입 `Speed` 프로퍼티와, 매 프레임마다 `Speed` 값을 1씩 증가시키는 `OnUpdate` 메서드를 포함한 mLua 스크립트입니다. ```lua Property: [Sync] number Speed = 0 Method: [server only] void OnUpdate(number delta) { self.Speed = self.Speed + 1 } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니
[task] | single_turn [pass] | ⏳ 미판정 [title] | RateLimitService 활용하기 [question] | RateLimitService의 이벤트 핸들러에서 ProfileCode로 유저를 조회하기 위해 _UserService:GetUserByProfileCode를 사용해야 하는 이유와, 여기서 user.Nickname을 로그에 출력하는 과정의 의미를 알려 주세요. [answer] | `RateLimitService`의 이벤트 핸들러에서 `_UserService:GetUserByProfileCode`를 사용하고 `user.Nickname`을 로그에 출력하는 과정의 의미는 다음과 같습니다. **1. `ProfileCode`를 이용해 유저를 조회해야 하는 이유** `RateLimitService`가 서버 함수 호출 제한이 초과되었다고 발생시키는 `ServerFunctionRateLimitEvent` 이벤트에는 `UserId`가 아닌 `ProfileCode`가 파라미터로 전달됩니다. * **이벤트 파라미터의 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 유저가 입장하면 PlayerComponent의 `MoveToMapPosition()` 함수를 제한할 수 있도록 아래와 같이 작성합니다. 1. **Workspace - MyDesk - Create Scripts - Create Logic**을 선택해 **RateLimitLogic**을 생성합니다. 2. 유저가 월드에 입장하면 PlayerComponent의 `MoveToMapPosition()` 함수의 사용량을 제한하도록 `SetServerFunctionRateLimitForComponent()` 함수를 활용합니다. 토큰 수는 2,
[task] | two_turn [pass] | ⏳ 미판정 [title] | mLua [question] | Return Annotation, Deprecated, Sealed, Description Annotation의 기본 문법과 적용 대상이 무엇인지? [answer] | mLua에서 사용할 수 있는 각 어노테이션(Annotation)의 기본 문법과 적용 대상은 다음과 같습니다. **1. Return Annotation** * **문법**: `---@return TYPE` * **적용 대상**: 함수 정의문, 메소드 정의문 * **설명**: 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있게 합니다. 복수의 값을 반환할 경우 쉼표로 구분하여 지정할 수 있습니다. ```lua ---@return Entity local function TestFunction(test [followup] | Return Annotation으로 함수 반환 타입을 지정할 때, 여러 값을 반환하는 경우의 정확한 문법 예시는 무엇이며 Deprecated Annotation은 어떤 정의문에 사용할 수 있는가? [followup_answer] | Return Annotation으로 여러 값을 반환하는 경우의 문법과 Deprecated Annotation의 적용 대상은 다음과 같습니다. **1. Return Annotation: 여러 값 반환 시 문법** 여러 값을 반환하는 경우, 반환 타입을 쉼표(`,`)로 구분하여 지정합니다. ```lua ---@return Entity, string local function TestFunction(testParamA, testParamB) return self.Entity, "strValue" end ``` **2. Dep [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu
[task] | single_turn [pass] | ⏳ 미판정 [title] | Play [question] | 시뮬레이터 아이콘이 보여주는 테스트 중 화면비 정보와 가상의 플레이어 추가 기능은 어떤 차이가 있나요? [answer] | 시뮬레이터 아이콘과 가상의 플레이어 추가 기능은 테스트 목적과 동작 방식에서 명확한 차이가 있습니다. **1. 시뮬레이터 (Simulator)** * **기능:** 현재 테스트 중인 클라이언트의 **화면비(Aspect Ratio) 정보**를 시각적으로 나타냅니다. * **목적:** 특정 기기나 해상도 환경에서 월드가 어떻게 보이는지 확인하기 위한 **디스플레이/렌더링 관련 정보 제공** 기능입니다. * **특징:** 실제 플레이어의 수나 네트워크 상태에는 영향을 주지 않으며, 단순히 현재 테스트 세션의 화면 설정을 보여 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 테스트 시 Play 창에서 사용할 수 있는 기능이 변경됩니다. | 아이콘 | 이름 | 설명 | | --- | --- | --- | | - | 시뮬레이터 | 테스트 중인 화면비 정보를 나타냅니다. | | - | 테스트 플레이 언어 | 테스트 중인 언어 설정을 나타냅니다. 테스트 중에는 언어 변경은 불가능합니다.| | ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/storage/icons/common/icon_latency_01.png "latency") | 성능 통계 |플레이
[task] | two_turn [pass] | ⏳ 미판정 [title] | mLua [question] | MaxLength 어노테이션은 어떤 상황에서 사용되며, string 타입 프로퍼티의 길이를 제한하는 방식은 무엇인가요? [answer] | MaxLength 어노테이션은 MSW 메이커의 프로퍼티 에디터에서 **string 타입의 프로퍼티**에 최대 입력 길이를 지정할 때 사용합니다. 이는 사용자가 편집기에서 해당 프로퍼티에 값을 입력할 때 허용되는 문자 수를 제한하는 역할을 합니다. 사용 방법은 string 타입 프로퍼티 선언부 앞에 `@MaxLength(integer)` 형태로 적어 원하는 최대 길이를 정수로 지정하면 됩니다. 예를 들어, 프로퍼티에 최대 5자까지만 입력 가능하도록 제한하려면 다음과 같이 작성합니다. ```lua @MaxLength(5) prop [followup] | MaxLength(5)를 적용한 string 프로퍼티에 6자 이상의 값을 할당할 경우 발생하는 예외 처리나 에러 메시지는 어떻게 되나요? [followup_answer] | 제공된 참고 문서에는 `MaxLength(5)`를 적용한 string 프로퍼티에 제한을 초과하는 값을 할당했을 때 발생하는 예외 처리나 에러 메시지에 대한 정보가 없습니다. 문서에는 `MaxLength` 어노테이션이 "MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정"한다고만 설명되어 있으며, 이는 편집기에서의 입력 제한 기능을 의미합니다. 런타임 시 코드에서 직접 값을 할당할 때 발생하는 동작이나 오류 처리 방식에 대해서는 언급되지 않았습니다. [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | 함수 매개변수의 타입을 지정하는 @param 어노테이션은 함수 정의문 바로 위에만 적어야 하나요? [answer] | 아니요, `---@param` 어노테이션은 함수 정의문 바로 위에만 적을 필요는 없습니다. 참고 문서의 사용 예시에서 볼 수 있듯이, 매개변수의 수만큼 여러 줄에 걸쳐 `---@param` 어노테이션을 나열하여 사용할 수 있습니다. 각 어노테이션은 대상 함수의 매개변수 이름과 그 타입을 지정하며, 이들을 함수 정의문 앞에 배치하면 됩니다. 예를 들어 두 개의 매개변수를 가진 함수의 경우 다음과 같이 작성합니다: ```lua ---@param testParamA Entity ---@param testParamB integer l [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | @ExecSpace("Server")과 같은 Attribute에 인수를 전달하는 문법과, 인수 없이 사용하는 Attribute의 문법 차이는 무엇인가요? [answer] | mLua에서 Attribute(속성)는 `@AttributeName` 형식으로 사용되며, 인수가 있는 경우와 없는 경우의 문법 차이는 다음과 같습니다. **1. 인수 없이 사용하는 Attribute 문법** 인수가 필요 없는 Attribute는 단순히 `@AttributeName`으로만 작성합니다. 예를 들어, 프로퍼티에 동기화 여부를 지정하는 `Sync` Attribute는 다음과 같이 사용합니다. ```lua @Sync property string NewValue = nil ``` 또한 실제 메이플스토리 월드 스크립트 형식 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3을 mLua 프로퍼티와 함수 매개변수로 선언할 때 권장하는 타입과 어노테이션 예시를 코드 블록으로만 출력하세요. [answer] | ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewMethod(any vt) -- ... end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3의 Static 프로퍼티를 안전하게 복제하여 사용하는 코드만 출력하되, 원본 참조 위험성을 설명하는 주석을 포함하세요. [answer] | ```lua -- FastVector3의 Static 프로퍼티(예: FastVector3.zero)에 직접 접근하면 원본의 참조를 반환합니다. -- 이 참조를 통해 프로퍼티 값을 수정하면 FastVector3.zero 자체의 값이 영구적으로 변경되는 위험이 있습니다. -- 따라서 Static 프로퍼티를 안전하게 사용하기 위해서는 반드시 Clone() 함수를 호출하여 독립된 복제본을 생성해야 합니다. local safeVector = FastVector3.zero:Clone() safeVector.x = 1 ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은
[task] | code [pass] | ⏳ 미판정 [title] | VS Code: mLua Extension [question] | LocalWorkspace 기반의 로컬 월드 폴더에서 mLua 스크립트를 작성하고, VS Code의 Document Symbol 기능을 활용해 스크립트 내의 Property, Method, Event Handler 구조를 한눈에 파악할 수 있도록 OnBeginPlay()에서 log()로 자기 자신의 스크립트 이름을 출력하는 간단한 초기화 스크립트를 작성해줘. [answer] | VS Code의 **mLua Extension**을 설치하고, `File - Open Folder`를 통해 로컬에 내려받은 월드 폴더를 열면 `Document Symbol` 기능을 사용할 수 있습니다. 이 기능은 문서 내의 심볼(Property, Method, Event Handler 등)을 목록으로 표시하여 스크립트 구조를 빠르게 파악할 수 있게 도와줍니다. 요청하신 대로 `OnBeginPlay()`에서 `log()`로 자기 자신의 스크립트 이름을 출력하는 간단한 초기화 스크립트는 다음과 같습니다. ```lua Method: [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 LocalWorkspace와 ExtendedScriptFormat을 사용하는 크리에이터는 메이플스토리 월드에서 제공하는 mLua VS Code Extension을 활용하여 스크립트를 효율적으로 작성할 수 있습니다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua](/docs?postId=1287) [공동 제작](/docs/?postId=670) # mLua VS Code Exten
[task] | single_turn [pass] | ⏳ 미판정 [title] | RateLimitService 활용하기 [question] | RateLimitLogic 스크립트를 생성할 때 Workspace의 MyDesk 경로 내 Create Logic 메뉴를 선택해야 하는 이유와, 이 로직이 유저 입장 시점에 PlayerComponent의 특정 함수에만 적용되는 구조를 자세히 설명해 주세요. [answer] | RateLimitLogic 스크립트를 생성할 때 Workspace의 MyDesk 경로 내 Create Logic 메뉴를 선택해야 하는 이유는, 이 스크립트가 월드의 특정 영역(Workspace)과 연결된 로직(Logic)으로 등록되어야 `_RateLimitService`를 통해 서버 함수 호출 제한을 올바르게 설정할 수 있기 때문입니다. 참고 문서에서는 `Workspace - MyDesk - Create Scripts - Create Logic` 경로를 통해 `RateLimitLogic`을 생성하는 과정을 명시하고 있으며, 이는 해 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 유저가 입장하면 PlayerComponent의 `MoveToMapPosition()` 함수를 제한할 수 있도록 아래와 같이 작성합니다. 1. **Workspace - MyDesk - Create Scripts - Create Logic**을 선택해 **RateLimitLogic**을 생성합니다. 2. 유저가 월드에 입장하면 PlayerComponent의 `MoveToMapPosition()` 함수의 사용량을 제한하도록 `SetServerFunctionRateLimitForComponent()` 함수를 활용합니다. 토큰 수는 2,
[task] | two_turn [pass] | ⏳ 미판정 [title] | Play [question] | Play 창에서 시뮬레이터의 화면비(PC, Mobile, Free) 설정 방식과 각 모드별 동작 원리를 알고 싶습니다. [answer] | Play 창에서 시뮬레이터의 화면비를 설정하려면 Play 창 상단에 노출된 **시뮬레이터** 아이콘을 통해 모드를 선택하면 됩니다. 기본값은 PC이며, 각 모드의 동작 원리는 다음과 같습니다. * **PC**: FHD 해상도(1920x1080)를 기준으로 동작하며, 화면 비율은 16:9로 고정되어 있습니다. * **Mobile**: 다양한 모바일 기기의 화면비에 맞춰 Scene과 Play의 크기를 조정합니다. 테스트 중에도 설정된 화면비가 유지되며, Safe Area를 활성화할 수 있습니다. * **Free**: Pla [followup] | Mobile 모드의 Safe Area 활성화 기능은 구체적으로 어떤 영역을 보호하며, Free 모드에서 Play 창 크기를 조절할 때 화면비가 어떻게 결정되는지 설명해 주세요. [followup_answer] | 참고 문서에는 Mobile 모드의 Safe Area가 구체적으로 어떤 영역을 보호하는지에 대한 상세 설명이 없습니다. 문서에는 단순히 Mobile 모드에서 "Safe Area를 활성화할 수 있습니다"라는 언급만 존재할 뿐, 보호 대상 영역에 대한 정보는 제공되지 않습니다. Free 모드에서 Play 창 크기를 조절할 때 화면비는 **Play의 창 크기를 기준으로** 결정됩니다. 즉, 사용자가 Play 창 자체의 크기를 자유롭게 조절하면 그에 맞춰 시뮬레이터의 화면비가 설정됩니다. [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 제작한 월드를 테스트할 수 있는 Play 창에 대해 알아봅시다. #### 참고 가이드 * [Scene](/docs/?postId=1152) * [Workspace](/docs/?postId=121) * [Hierarchy](/docs/?postId=453) * [프로퍼티 에디터](/docs/?postId=1087) * [UI 에디터 활용과 제어](/docs/?postId=120) # Play Play 창은 만든 월드를 테스트할 때 사용합니다. **[시작]** 버튼을 눌러 플레이 테스트를 실행했을 때만
[task] | two_turn [pass] | ⏳ 미판정 [title] | Play [question] | Play 창은 Scene 창과 카메라가 동기화되지 않는다고 했는데, Scene에서 클라이언트 부분을 변경하면 Play 창에 반영되는 원리와 그 범위는 무엇인가요? [answer] | Play 창은 Scene 창과 독립된 카메라로 동작하기 때문에, 화면 이동(카메라 위치나 시점)이 동기화되지 않습니다. 그러나 Scene 창에서 **클라이언트 부분**을 변경하면 Play 창에 그 변경 사항이 반영됩니다. 이는 Play 창이 편집 상태의 Scene과 완전히 분리된 별개의 인스턴스가 아니라, 클라이언트 로직과 UI 등 클라이언트 측 요소에 대한 실시간 변경을 반영하도록 설계되어 있기 때문입니다. 따라서 클라이언트 관련 설정이나 컴포넌트 값을 Scene에서 수정하면, 테스트 중인 Play 창에서도 해당 변경이 즉시 적 [followup] | 클라이언트 부분이 아닌 서버 로직이나 다른 엔티티의 변경 사항도 Play 창에 실시간으로 반영되는지, 그리고 반영되지 않는 경우의 예시를 알려주세요. [followup_answer] | 제공된 참고 문서에는 "Scene에서 클라이언트 부분을 변경하면, Play 창에도 반영됩니다"라고만 명시되어 있으며, 서버 로직이나 다른 엔티티의 변경 사항이 Play 창에 실시간으로 반영되는지에 대한 구체적인 정보나 반영되지 않는 경우의 예시는 포함되어 있지 않습니다. 따라서 문서의 내용만으로는 서버 로직 변경 사항의 반영 여부나 예시를 확인하기 어렵습니다. [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 제작한 월드를 테스트할 수 있는 Play 창에 대해 알아봅시다. #### 참고 가이드 * [Scene](/docs/?postId=1152) * [Workspace](/docs/?postId=121) * [Hierarchy](/docs/?postId=453) * [프로퍼티 에디터](/docs/?postId=1087) * [UI 에디터 활용과 제어](/docs/?postId=120) # Play Play 창은 만든 월드를 테스트할 때 사용합니다. **[시작]** 버튼을 눌러 플레이 테스트를 실행했을 때만
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | 여러 값을 반환하는 함수에서 `---@return`으로 타입을 지정할 때, 쉼표로 구분하는 방식이 맞나요? [answer] | 네, 맞습니다. 여러 값을 반환하는 함수에서 `---@return`으로 타입을 지정할 때는 쉼표(,)로 구분합니다. 예를 들어, `Entity` 타입과 `string` 타입 두 값을 반환하는 함수라면 다음과 같이 작성합니다. ```lua ---@return Entity, string local function TestFunction(testParamA, testParamB) return self.Entity, "strValue" end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3이 Vector3과 다른 5가지 핵심 특징을 나열하되, 각 특징을 1문장 이내로 요약하여 5줄의 번호 목록으로 정리하세요. [answer] | 1. `FastVector3`은 Lua Table로 구현되어 `Vector3`보다 가볍고 유연합니다. 2. `FastVector3`은 `Vector3`의 모든 프로퍼티와 함수를 지원하며 `Vector3`으로 자동 변환됩니다. 3. `FastVector3`은 동기화를 지원하지 않아 다른 공간 실행 함수의 매개변수로 사용할 수 없습니다. 4. `FastVector3`은 8 Byte 실수형을 사용해 `Vector3`(4 Byte)과 유효 범위 및 연산 결과가 다릅니다. 5. `FastVector3`은 static 프로퍼티 접근 시 원본 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3과 Vector3의 데이터 타입 차이(바이트 수)와 이로 인한 연산 결과 차이를 비교하여 표로 정리하세요. [answer] | FastVector3과 Vector3의 데이터 타입 차이와 연산 결과 차이는 다음과 같습니다. | 구분 | FastVector3 | Vector3 | | :--- | :--- | :--- | | **실수형 값 크기** | 8 Byte | 4 Byte | | **연산 결과 차이** | 8 Byte 실수형을 사용하므로 유효 범위가 넓고, Vector3(4 Byte)과 비교할 때 연산 결과가 달라질 수 있습니다. | 4 Byte 실수형을 사용하므로 FastVector3보다 유효 범위가 좁습니다. | 이러한 차이로 인해 두 타입을 상호 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3에 정적 프로퍼티와 인스턴스 메서드를 추가하는 확장 코드를 주석으로 설명만 포함하여 출력하세요. [answer] | `FastVector3`에 정적 프로퍼티와 인스턴스 메서드를 추가하는 확장 코드입니다. ```lua -- static 프로퍼티 추가 FastVector3.two = FastVector3(2, 2, 2) -- 함수 추가 local v3mt = getmetatable(FastVector3.zero) v3mt.NewFunction = function(self) -- ... end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | 스크립트를 Component로 지정할 때 @Component와 @Item 중 어떤 것을 선택해야 하는지 구별하는 기준이 무엇인가요? [answer] | 제공된 참고 문서에 따르면, 스크립트를 특정 타입으로 지정할 때 선택하는 기준은 **스크립트가 어떤 역할을 수행하는지**에 따라 결정됩니다. 1. **`@Component` 사용 기준**: * 스크립트를 **Component**로 지정할 때 사용합니다. * 적용 대상은 스크립트이며, 매개 변수는 없습니다. * 예시: `script NewComponent extends Component` 2. **`@Item` 사용 기준**: * 스크립트를 **ItemType**으로 지정할 때 사용합 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e
[task] | two_turn [pass] | ⏳ 미판정 [title] | mLua [question] | @Component, @Event, @Item 등 스크립트 타입을 지정하는 Attribute들은 각각 어떤 역할을 하며, 이 Attribute가 없는 경우 스크립트는 어떻게 동작하나요? [answer] | 제공된 참고 문서에는 `@Component`, `@Event`, `@Item` 등 Attribute들이 각각 어떤 구체적인 역할을 수행하는지(예: 컴포넌트 로직 실행, 이벤트 정의, 아이템 데이터 구조 등)에 대한 설명이 포함되어 있지 않습니다. 문서에는 해당 Attribute들이 각각 `Component`, `EventType`, `ItemType`으로 스크립트를 지정한다는 문구와 사용 예제 코드만 제시되어 있습니다. 또한, 이 Attribute가 없는 경우 스크립트가 어떻게 동작하는지에 대한 정보도 문서에 명시되어 있지 않습니 [followup] | @Component와 @State를 함께 사용할 수 있는지, 또는 서로 충돌하는 경우의 코드 예시와 오류 상황은 어떻게 되나요? [followup_answer] | 제공된 참고 문서에는 `@Component`와 `@State`를 함께 사용할 수 있는지 여부에 대한 정보나, 두 Attribute가 충돌할 경우의 코드 예시 및 오류 상황에 대한 설명이 포함되어 있지 않습니다. 문서에는 각 Attribute가 개별적으로 스크립트를 특정 타입으로 지정한다는 내용과 사용 예제만 제시되어 있습니다. * **@Component**: 스크립트를 `Component`로 지정 * **@State**: 스크립트를 `StateType`으로 지정 따라서 제공된 문서를 근거로 두 Attribute의 동시 [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e
[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | @ExecSpace("Server") 속성을 적용한 OnBeginPlay 메서드에서 _TimerService:SetTimerOnce를 호출하여 5초 후 log("Hello")를 출력하는 스크립트를 작성해줘 [answer] | mLua 스크립트 형식(메이플스토리 월드 메이커 스크립트 형식)에 따라, `OnBeginPlay` 메서드에 `@ExecSpace("Server")` 속성을 적용하고 `_TimerService:SetTimerOnce`를 호출하여 5초 후 로그를 출력하는 스크립트는 다음과 같습니다. ```lua Property: Method: [Server Only] void OnBeginPlay() { _TimerService:SetTimerOnce(function() log("Hello") end, 5) } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3이 Vector3보다 최적화에 유리한 근본적인 이유를 2문장 이내로 설명해 주세요. [answer] | FastVector3은 값을 생성하거나 읽을 때 참조 객체를 생성하지 않기 때문에, Vector3 대비 메모리 사용량과 처리 시간을 크게 줄일 수 있습니다. 이로 인해 잦은 좌표 연산이 발생하는 월드 최적화에서 성능 저하를 방지하는 근본적인 이점이 있습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 최적화를 위해 `Vector3` 대신 `FastVector3`을 사용하는 이유는 값을 생성하거나, 읽어올 때 **참조 객체를 생성하지 않기 때문**입니다. `Vector3`의 경우 Lua 스크립트에서 사용하기 위해 참조 객체가 필요합니다. 메이플스토리 월드의 `Vector3` 객체를 사용하면 참조 객체가 자동으로 생성, 파괴됩니다. 그러나 이 과정에서 처리 시간이 길어지고 메모리 사용량이 증가해 최적화가 필요하게 됩니다. ```lua -- Position 값을 읽어올 때 참조 객체가 생성됨 local position = self
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | `---@description` 어노테이션을 메소드 정의문에 적용하면 툴팁에 어떤 형태로 설명이 표시되나요? [answer] | `---@description` 어노테이션은 메소드 정의문에 적용했을 때, 해당 메소드에 대한 설명이 툴팁에 표시됩니다. 문서에는 구체적인 툴팁 UI 레이아웃이나 시각적 형태(예: 굵은 글씨, 색상 등)에 대한 설명은 없으며, 단순히 "툴팁에 표시할 설명을 작성할 수 있다"고만 명시되어 있습니다. 아래는 메소드 정의문에 `---@description`을 적용한 예시입니다. ```lua Method: [server only] ---@description "이 메소드는 아이템을 생성하는 기능입니다." void CreateNewIt [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu
[task] | two_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3을 mLua 프로퍼티나 함수 매개변수로 사용할 때 어떤 타입과 어노테이션을 적용해야 하는지 알려주세요 [answer] | `FastVector3`은 mLua에서 프로퍼티 타입이나 함수 매개변수로 직접 지정할 수 없습니다. 따라서 프로퍼티나 매개변수로 사용할 때는 반드시 `any` 또는 `table` 타입을 선언해야 하며, mLua에서는 `any` 타입과 함께 어노테이션을 사용하는 것이 권장됩니다. 프로퍼티 선언 시에는 `---@type FastVector3` 어노테이션을 추가하고 타입을 `any`로 지정합니다. 함수 매개변수를 사용할 때는 `---@param vt FastVector3` 어노테이션을 추가하고 매개변수 타입을 `any`로 지정해야 합니 [followup] | FastVector3에 static 프로퍼티나 메서드를 확장할 때 metatable을 어떻게 조작해야 하는지 코드 예시를 보여주세요 [followup_answer] | FastVector3에 static 프로퍼티를 추가하려면 `FastVector3` 테이블에 직접 값을 할당하면 됩니다. 메서드(함수)를 확장할 때는 `FastVector3` 인스턴스(예: `FastVector3.zero`)의 metatable을 가져와서 해당 metatable에 함수를 추가하는 방식으로 조작합니다. ```lua -- static 프로퍼티 추가 FastVector3.two = FastVector3(2, 2, 2) -- 함수 추가 local v3mt = getmetatable(FastVector3.zero) v3mt [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM
[task] | two_turn [pass] | ⏳ 미판정 [title] | Play [question] | 테스트 중 가상의 클라이언트를 추가하여 멀티 테스트를 진행하는 방법과, 이 상태에서 성능 통계(FPS, 메모리)가 어떻게 측정되는지 궁금합니다. [answer] | 테스트 중 가상의 클라이언트를 추가하여 멀티 테스트를 진행하는 구체적인 방법(버튼 위치, 클릭 절차 등)에 대한 상세 설명은 제공된 문서에 포함되어 있지 않습니다. 문서에는 "테스트 중 가상의 클라이언트를 추가해 멀티 테스트를 진행할 수 있습니다"라는 사실만 언급되어 있으며, 구체적인 조작법은 명시되어 있지 않습니다. 성능 통계(FPS, 메모리)에 관해서는 Play 창 상단의 아이콘 중 **성능 통계** 기능을 활성화하면 플레이 중인 월드의 FPS와 메모리 정보를 실시간으로 확인할 수 있습니다. 이는 가상의 클라이언트를 추가한 상 [followup] | 가상의 클라이언트를 여러 대 추가했을 때 성능 통계에 미치는 영향과, 테스트 중 언어 변경이 불가능한 이유 및 제한 사항을 코드나 설정값으로 어떻게 처리해야 하는지 알려주세요. [followup_answer] | **1. 가상의 클라이언트 추가 시 성능 통계에 미치는 영향** 제공된 문서에는 가상의 클라이언트를 여러 대 추가했을 때 성능 통계(FPS, 메모리)에 구체적으로 어떤 수치적 변화나 부하가 발생하는지에 대한 상세 설명은 포함되어 있지 않습니다. 문서에서 확인할 수 있는 정보는 다음과 같습니다. * **성능 통계 기능**: Play 창 상단의 '성능 통계' 아이콘을 활성화하면, 현재 플레이 중인 월드의 FPS와 메모리 정보를 실시간으로 확인할 수 있습니다. * **멀티 테스트 지원**: 테스트 중 가상의 클라이언트를 추가하여 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 제작한 월드를 테스트할 수 있는 Play 창에 대해 알아봅시다. #### 참고 가이드 * [Scene](/docs/?postId=1152) * [Workspace](/docs/?postId=121) * [Hierarchy](/docs/?postId=453) * [프로퍼티 에디터](/docs/?postId=1087) * [UI 에디터 활용과 제어](/docs/?postId=120) # Play Play 창은 만든 월드를 테스트할 때 사용합니다. **[시작]** 버튼을 눌러 플레이 테스트를 실행했을 때만
[task] | single_turn [pass] | ⏳ 미판정 [title] | 비정상 거래 대응 가이드 [question] | 플랫폼 운영정책 4번 조항에서 말하는 '이용제한' 조치가 구체적으로 어떤 형태로 적용되는지 알고 싶은데, 판매 수익 차감 외 다른 제재도 있나요? [answer] | 제공된 참고 문서에는 플랫폼 운영정책 4번 조항의 '이용제한' 조치가 구체적으로 어떤 형태로 적용되는지에 대한 세부 내용(예: 계정 정지 기간, 기능 제한 범위 등)이 명시되어 있지 않습니다. 문서에서는 비정상 거래로 인한 피해 발생 시 "플랫폼에서의 관리 조치에 따라 **판매 수익이 차감되거나 마이너스 수익이 발생할 수 있다**"는 사실만 언급하고 있으며, 그 외의 다른 제재 사항에 대해서는 설명하지 않습니다. 구체적인 이용제한 조치는 플랫폼 운영정책 원문(링크된 페이지)을 직접 확인하셔야 합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상
[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | `---@return Entity`처럼 특정 타입만 지정했는데 실제로는 문자열도 함께 반환하는 경우 어노테이션을 어떻게 수정해야 할까요? [answer] | `---@return` 어노테이션에서 복수 개의 값을 반환하는 경우, 반환 타입을 쉼표(,)로 구분하여 나열하면 됩니다. 따라서 `Entity`와 `string`을 함께 반환한다면 다음과 같이 수정해야 합니다. ```lua ---@return Entity, string ``` **수정 전 (오류 또는 불완전한 어노테이션)** ```lua ---@return Entity local function TestFunction() return self.Entity, "strValue" end ``` **수정 후 (올바른 어노테 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu
[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3이 참조 객체 생성을 줄이는 이유와 메모리 정리 과정을 단계별 번호 목록으로 정리하세요. [answer] | FastVector3을 효율적으로 사용하는 이유와 메모리 정리 과정은 다음과 같습니다. **FastVector3이 참조 객체 생성을 줄이는 이유** 메이플스토리 월드에서 Lua 스크립트(Native 타입)에 접근할 때, 참조되는 객체가 파괴되지 않도록 보호하기 위해 참조 객체가 생성됩니다. `FastVector3` 타입을 사용하면 이러한 불필요한 참조 객체 생성을 줄일 수 있어 메모리 사용 효율을 높일 수 있습니다. **메모리 정리 과정 (단계별)** 1. 참조 객체의 사용이 끝나면, 먼저 **Lua Garbage Collect [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM
[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | @ExecSpace("Client") 속성을 적용한 OnBeginPlay 메서드에서 _UserService 서비스를 통해 현재 사용자 정보 조회 후 log에 출력하는 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `@ExecSpace` Attribute의 문법과 `OnBeginPlay` 메서드 사용 예시가 포함되어 있으나, `_UserService` 서비스의 구체적인 API(메서드 이름, 반환 타입, 파라미터)에 대한 정보는 포함되어 있지 않습니다. 따라서 `_UserService`를 통해 사용자 정보를 조회하는 정확한 코드(`_UserService:GetCurrentUser()` 등)는 문서에 근거하여 작성할 수 없습니다. 문서에 명시된 `@ExecSpace("Client")` Attribute와 `OnBeginP [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니
[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | `@Component` 어노테이션을 적용하여 `Component`를 상속받는 스크립트를 작성하고, `@MaxLength(10)` 어노테이션을 가진 `string` 타입 프로퍼티를 정의해 주십시오. [answer] | `@Component` 어노테이션을 적용하여 `Component`를 상속받는 스크립트와 `@MaxLength(10)` 속성이 있는 `string` 타입 프로퍼티를 정의하는 예시는 다음과 같습니다. ```lua @Component script NewComponent extends Component @MaxLength(10) property string TestValue = "test" end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e
[task] | single_turn [pass] | ⏳ 미판정 [title] | 비정상 거래 대응 가이드 [question] | 거래 제한 기간을 아이템 설명에 명시해야 한다는데, 이 제한 기간은 언제부터 시작되는 건가요? [answer] | 제공된 문서에는 거래 제한 기간이 구체적으로 언제부터 시작되는지(예: 아이템 획득 시점, 구매 완료 시점, 또는 다른 특정 이벤트 발생 시점)에 대한 정확한 기준이 명시되어 있지 않습니다. 문서에서는 단순히 "거래 이용 시 대기 시간" 또는 "거래 후 판매 대금 획득 시 대기 시간"을 추가할 경우, 거래의 투명성을 위해 **각 재화의 설명에 거래 제한 기간을 함께 명시해 주어야 한다**는 원칙만 안내하고 있을 뿐, 그 제한 기간의 시작 시점에 대한 정의는 찾아볼 수 없습니다. 따라서 해당 제한 기간의 시작 시점은 크리에이터가 설 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상