[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 동기화 Synchronization 개념을 활용해 서버와 클라이언트 간 위치 데이터를 실시간으로 맞춰주는 [Sync] 프로퍼티를 가진 스크립트를 작성해줘 [answer] | 메이플스토리 월드의 동기화(Synchronization)는 서버와 클라이언트 간에 데이터 전송 방식을 통해, 각각의 실행 공간에 존재하는 같은 이름의 프로퍼티를 같은 값으로 맞춰주는 기능입니다. 이를 활용하여 위치 데이터를 실시간으로 공유하기 위해 `[Sync]` 속성을 가진 `Vector3` 타입의 프로퍼티를 정의하고, 서버에서 위치를 업데이트하면 클라이언트에서도 자동으로 해당 값이 반영됩니다. 아래는 서버에서 특정 위치를 계산하여 `[Sync]` 프로퍼티에 저장하고, 클라이언트에서는 그 값을 읽어 엔티티의 위치를 변경하는 스크 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # ㄱ ##### 계층 구조 Hierarchy 제작 중인 월드의 현황을 계층 구조로 확인할 수 있는 창 복잡하게 구성한 맵의 엔티티를 체계적으로 관리할 때 사용 **World, common, maps, ui**를 포함함 **참고 |** [Hierarchy](/docs/?postId=453) # ㄴ ##### 네이티브 API Native API 크리에이터는 생성할 수 없는 메이플스토리 월드 엔진 내의 API # ㄷ ##### 데이터 에디터 Data Editor 메이커에서 데이터 셋을 편집할 수 있는 에디터 **참고 |**
[task] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 초기 아이템 인덱스를 1001로 설정하고, 스프라이트 렌더러의 아이콘 RUID를 데이터 서비스에서 조회하여 적용하는 InitItem 메서드를 구현하는 스크립트를 작성해줘. [answer] | 초기 아이템 인덱스를 1001로 설정하고, 데이터 서비스에서 아이콘 RUID를 조회하여 스프라이트 렌더러에 적용하는 `InitItem` 메서드가 포함된 스크립트입니다. ```lua Property: [Sync] number ItemIndex = 1001 Method: void InitItem(number itemIndex) { self.ItemIndex = itemIndex local sprite = self.Entity.SpriteRendererComponent local itemDataSet = _Da [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua Property: [Sync] number ItemIndex = 0 [Sync] number DropTweenTime = 0.8 Method: void InitItem(number itemIndex) { self.ItemIndex = itemIndex local sprite = self.Entity.SpriteRendererComponent local itemDataSet = _DataService:GetTable("UserItemDataSet") local ruid = itemDataS
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | 스크립트 적용 전까지 필요한 머티리얼 생성 및 연결 단계를 표로 정리하세요. [answer] | 스크립트를 작성하기 전에 머티리얼을 생성하고 오브젝트에 연결해야 합니다. 아래 표에 스크립트 적용 전까지 수행해야 할 절차가 정리되어 있습니다. | 단계 | 작업 내용 | | :--- | :--- | | 1 | "기본" 템플릿으로 월드를 생성합니다. | | 2 | 맵에 상호 작용할 오브젝트를 배치합니다. (예: Preset List - Object - object-273) | | 3 | 배치한 오브젝트(예: object-273)의 이름을 변경합니다. (예: StarTree) | | 4 | **Workspace - MyDesk**의 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트를 활용해 월드 플레이 도중 머티리얼 프로퍼티를 제어할 수 있습니다. 예제를 통해 머티리얼 프로퍼티 제어 방법을 살펴봅시다. 1. "기본" 템플릿으로 월드를 생성합니다. 2. 맵에 상호 작용할 오브젝트를 배치합니다. 예제에서는 **Preset List - Object - object-273**을 사용했습니다. 그리고 **object-273**의 이름을 **StarTree**로 변경합니다. 3. **Workspace - MyDesk**의 콘텍스트 메뉴에서 **Create Material*
[task] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 클라이언트 실행 시 1.1 높이로 점프 후 낙하하는 트윈 시퀀스를 수행하고, 애니메이션 완료 시 트윈 플로팅 컴포넌트를 활성화하는 OnBeginPlayClient 메서드를 작성해줘. [answer] | 제공된 참고 문서에 있는 `OnBeginPlayClient` 메서드와 동일한 로직을 구현한 코드입니다. ```lua Method: [client only] void OnBeginPlayClient() { local totalTweenTime = self.DropTweenTime local jumpHeight = 1.1 local tween = _TweenLogic:MoveOffset(self.Entity, Vector2(0, jumpHeight), totalTweenTime / 2, EaseType.QuadE [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua Property: [Sync] number ItemIndex = 0 [Sync] number DropTweenTime = 0.8 Method: void InitItem(number itemIndex) { self.ItemIndex = itemIndex local sprite = self.Entity.SpriteRendererComponent local itemDataSet = _DataService:GetTable("UserItemDataSet") local ruid = itemDataS
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 이벤트(Event), 이벤트 센더, 이벤트 핸들러의 개념적 차이를 용어 사전 기준으로 정리해 주세요 [answer] | 메이플스토리 월드 용어 사전 기준으로 이벤트, 이벤트 센더, 이벤트 핸들러의 개념적 차이는 다음과 같습니다. **1. 이벤트 (Event)** * **정의**: 로직 상에서 어떤 사건의 발생을 의미합니다. * **특징**: 이벤트의 종류를 식별하는 정보와 추가 정보를 포함하고 있는 자료형입니다. 즉, "무슨 일이 일어났는가"를 나타내는 데이터 단위입니다. **2. 이벤트 센더 (Event Sender)** * **정의**: 이벤트를 발송하는 객체입니다. * **역할**: 이벤트의 발생원(발신자) 역할을 수행합니다. [followup] | 어노테이션(Annotation)을 코드에 추가할 때 메타 데이터로 활용하는 구체적인 방법과 참고 링크의 내용을 연결해 설명해 주세요. [followup_answer] | 제공된 참고 문서에는 어노테이션(Annotation)이 "코드에 추가하여 사용하는 일종의 메타 데이터"라는 정의와 함께 [Annotation 활용하기](/docs/?postId=824)에 대한 참고 링크가 포함되어 있습니다. 그러나 제공된 용어 사전 문서 자체에는 **어노테이션을 코드에 추가하는 구체적인 문법, 사용법, 또는 `Annotation 활용하기` 링크에 포함된 세부적인 예제나 설명 내용이 포함되어 있지 않습니다.** 따라서 주어진 참고 문서만으로는 어노테이션을 구체적으로 어떻게 작성하고 활용하는지, 그리고 해당 링크의 [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | single_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | 스크립트로 엔티티의 머티리얼을 실시간으로 교체하려면 어떤 함수와 인자를 사용해야 하나요? [answer] | 엔티티의 머티리얼을 스크립트로 실시간으로 교체하려면 `SpriteRendererComponent`의 `ChangeMaterial` 함수를 사용합니다. **함수 및 인자** * **함수**: `SpriteRendererComponent:ChangeMaterial` * **인자**: 교체할 머티리얼의 Entry ID를 `"material://Entry ID"` 형식의 문자열로 전달합니다. **사용 예시** 아래 코드는 트리거 영역에 다른 엔티티가 들어올 때(`TriggerEnterEvent`) 해당 엔티티의 스프라이트 렌더러 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 워크스페이스의 BaseEnvironment에 있는 NativeScripts와 MyDesk에 있는 커스텀 스크립트 중 충돌이 발생했을 때 어느 쪽이 우선 적용되는지 알고 싶어요. [answer] | 제공된 참고 문서에는 워크스페이스(Workspace)의 구조(BaseEnvironment, MyDesk)와 NativeScripts, NativeModel의 존재에 대한 정보만 포함되어 있으며, NativeScripts와 커스텀 스크립트 간의 충돌 발생 시 어느 쪽이 우선 적용되는지에 대한 정책이나 우선순위 규칙에 대한 내용은 언급되어 있지 않습니다. 따라서 주어진 정보만으로는 충돌 시 우선 적용되는 스크립트를 판단할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 트리거 엔터 이벤트 발생 시 대상 엔티티의 라이트 인벤토리(LiteInventory)에 ItemIndex에 해당하는 아이템 1개를 추가하고, 현재 엔티티를 파괴하는 HandleTriggerEnterEvent 이벤트 핸들러를 작성해줘. [answer] | 트리거 엔터 이벤트가 발생하면 `event.TriggerBodyEntity`를 통해 대상 엔티티를 가져오고, 해당 엔티티의 `LiteInventory` 컴포넌트가 존재하는지 확인합니다. 인벤토리가 존재하면 `ModifyItem` 메서드를 사용하여 `self.ItemIndex`에 해당하는 아이템 1개를 추가한 뒤, 현재 엔티티(`self.Entity`)를 `Destroy` 메서드로 제거합니다. ```lua Property: [Sync] number ItemIndex = 0 Event Handler: [server only] [se [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua Property: [Sync] number ItemIndex = 0 [Sync] number DropTweenTime = 0.8 Method: void InitItem(number itemIndex) { self.ItemIndex = itemIndex local sprite = self.Entity.SpriteRendererComponent local itemDataSet = _DataService:GetTable("UserItemDataSet") local ruid = itemDataS
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 아틀라스 언패커로 자른 개별 스프라이트를 다시 원본 아틀라스 형태로 합쳐서 사용하는 방법이 있는지, 아니면 항상 개별 이미지로만 관리해야 하는지 궁금해요. [answer] | 제공된 참고 문서에는 '아틀라스 언패커(Atlas Unpacker)'가 아틀라스를 개별 스프라이트로 자르고 편집해 저장하는 툴임을 정의하고 있을 뿐, 자른 개별 스프라이트를 다시 원본 아틀라스 형태로 합치는 기능이나 방법에 대한 설명이 없습니다. 따라서 주어진 문서 범위 내에서는 아틀라스를 다시 합쳐서 사용하는 방법을 확인할 수 없으며, 문서에 명시된 기능은 오직 아틀라스를 개별 스프라이트로 분리하는 것뿐입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | two_turn [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 몬스터 처치 시 드롭되는 아이템에 붕 뜨는 연출과 획득 로직을 구현하려면 어떤 구성이 필요합니까? [answer] | 몬스터 처치 시 드롭되는 아이템에 붕 뜨는 연출과 획득 로직을 구현하려면, `Model_Item`에 `TweenFloatingComponent`를 추가하고 `Item` 스크립트에서 클라이언트와 서버 역할을 분리하여 처리하는 구성이 필요합니다. 구체적인 구현 단계와 전체 스크립트는 다음과 같습니다. ### 1. 구성 요소 설정 * **모델 설정**: `Model_Item`에 `TweenFloatingComponent`를 추가합니다. * **프로퍼티 추가**: `Item` 스크립트에 아이템 드롭 연출 시간(`DropTween [followup] | _TweenLogic:MoveOffset으로 연출을 만드는 중, TweenFloatingComponent 활성화 시점과 TriggerComponent 활성화 시점의 차이는 무엇입니까? [followup_answer] | 참고 문서에 따르면 `_TweenLogic:MoveOffset`으로 만드는 드롭 연출(위로 붕 뜨고 내려오는 과정)이 완료된 후, 클라이언트와 서버에서 각각 다른 컴포넌트를 활성화하도록 처리합니다. 두 컴포넌트의 활성화 시점과 목적은 다음과 같이 다릅니다. **1. TweenFloatingComponent 활성화 시점 (클라이언트)** * **시점:** 위로 올라가는 1차 투인(`MoveOffset`)과 내려오는 2차 투인(`MoveOffset`)이 **모두 끝난 직후**입니다. * **코드 위치:** `OnBeginPla [scores] | [judge_reason] | [source_doc] | 1. **Model_Item**에 **TweenFloatingComponent**를 추가합니다. 각 프로퍼티는 아래와 같이 설정합니다. 2. **Item** 스크립트를 열고 **number** 타입의 새 프로퍼티 **DropTweenTime**을 추가합니다. ```lua Property: [Sync] number ItemIndex = 0 -- 추가 [Sync] number DropTweenTime = 0.8 ``` 3. `OnBeginP
[task] | single_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | 플레이어와 충돌 시 머티리얼이 바뀌도록 하려면 어떤 컴포넌트와 이벤트 핸들러를 조합해야 하나요? [answer] | 플레이어와 충돌 시 엔티티의 머티리얼을 교체하려면 **TriggerComponent**와 **SpriteRendererComponent**를 조합하여 사용해야 합니다. 1. **TriggerComponent**: 플레이어 캐릭터와의 충돌(트리거 진입)을 감지하기 위해 엔티티에 추가해야 합니다. 2. **SpriteRendererComponent**: 실제로 머티리얼이 적용되고 변경되는 렌더러 컴포넌트입니다. 이 두 컴포넌트가 준비되면, `HandleTriggerEnterEvent` 이벤트 핸들러를 사용하여 충돌 시 머티리얼을 변 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | 로컬라이징에서 문화권에 따라 달라지는 날짜 표기법과 숫자 표기법의 예시를 2행의 표로 정리하세요. [answer] | | 구분 | 예시 | | :--- | :--- | | 날짜 표기법 | 한국: 2023/01/31 (연/월/일), 미국/캐나다: 01/31/2023 (월/일/년), 기타 문화권: 31/01/2023 (일/월/년) | | 숫자 표기법 | 한국/미국/캐나다: 1,234,567.89 (천 단위 쉼표, 소수점 마침표), 프랑스/독일/오스트리아: 1.234.567,89 (천 단위 마침표, 소수점 쉼표), 기타 문화권: 1 234 567.89 (천 단위 공백) | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 크리에이터가 제작한 월드를 다양한 지역의 유저들이 즐길 수 있도록 하려면 로컬라이징 과정은 필수적입니다. `LocalizationService`는 클라이언트의 언어를 기반으로 텍스트나 어셋 등을 해당 언어에 맞게 제공할 수 있도록 도와줍니다. 이번 과정에서는 로컬라이징의 개념을 살펴보고 `LocalizationService`를 사용해 텍스트를 번역하는 방법을 알아봅시다. ##### 참고 가이드 [포맷에 맞게 로컬라이징하기](docs/?postId=968) [자동 번역](docs/?postId=1072) [Lo
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | LocaleDataSet에 'UI_Hello' 키가 매핑된 경우, 한국어와 영어 환경에서 각각 출력되는 텍스트를 단계별 번호 목록으로 나열해 주세요. [answer] | LocaleDataSet에 `UI_Hello` 키가 매핑된 경우, 환경별 출력 텍스트는 다음과 같습니다. 1. 한국어 환경: 안녕하세요! 2. 영어 환경: Hello! [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | LocaleDataSet을 활용해 간단한 방법으로 텍스트를 번역해 봅시다. 1. UI 에디터에서 텍스트 엔티티를 추가합니다. 추가한 텍스트 엔티티의 **TextComponent**에서 프로퍼티를 아래와 같이 수정합니다. | 컴포넌트 | 프로퍼티 | 값 | | :---------------------------: | :------: | :---: | | @cols=1:@rows=3:TextComponent | FontSize | 50 | |
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | TextComponent에서 로컬라이징을 활성화하기 위해 설정해야 하는 프로퍼티와 값 3가지를 표로 정리해서 답변해 주세요. [answer] | TextComponent에서 로컬라이징을 활성화하기 위해 설정해야 하는 프로퍼티와 값은 다음과 같습니다. | 프로퍼티 | 값 | | :--- | :--- | | Text | UI_Hello | | IsLocalizationKey | True | | FontSize | 50 | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | LocaleDataSet을 활용해 간단한 방법으로 텍스트를 번역해 봅시다. 1. UI 에디터에서 텍스트 엔티티를 추가합니다. 추가한 텍스트 엔티티의 **TextComponent**에서 프로퍼티를 아래와 같이 수정합니다. | 컴포넌트 | 프로퍼티 | 값 | | :---------------------------: | :------: | :---: | | @cols=1:@rows=3:TextComponent | FontSize | 50 | |
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | Workspace의 구조에서 BaseEnvironment, MyDesk, DefaultPlayer가 각각 어떤 역할을 하며 리소스 관리는 어떻게 이루어지는지 설명해 주세요 [answer] | Workspace는 메이커에서 폴더 형식으로 리소스를 관리하는 공간입니다. 이 구조는 크게 **BaseEnvironment**, **MyDesk**, 그리고 작업 편의를 위해 포함된 **DefaultPlayer**로 구성됩니다. 각 요소의 역할과 리소스 관리 방식은 다음과 같습니다. **1. BaseEnvironment** * **역할:** 메이플스토리 월드에서 기본적으로 제공하는 네이티브 리소스가 모여 있는 공간입니다. * **내용:** `NativeScripts`와 `NativeModel`이 이곳에 포함되어 있어, 개 [followup] | 인스턴스 룸과 정적 룸의 생성 방식 차이를 비교하고, 인스턴스 룸에 포함될 수 있는 맵의 제한 사항을 알려주세요. [followup_answer] | 인스턴스 룸과 정적 룸은 생성 시점과 조건에 따라 명확히 구분됩니다. **생성 방식 차이** * **정적 룸 (Static Room)** * 월드 인스턴스가 생성되면 **무조건** 생성되는 룸입니다. * 즉, 월드 서버가 구동되는 시점에 기본으로 활성화되는 공간입니다. * **인스턴스 룸 (Instance Room)** * 서버 인스턴스에서 **동적으로** 생성되는 룸입니다. * 정적 룸과 달리 서버 구동 시점에 즉시 생성되는 것이 아니라, 필요에 따라 서버가 실시간으로 생성하 [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | OnBeginPlayServer() 함수 내에서 _TimerService:SetTimerOnce(function() self.Entity.TriggerComponent.Enable = true end, self.DropTweenTime + 0.1)을 호출하여 연출 종료 후 서버에서 TriggerComponent를 활성화하는 로직을 작성해줘 [answer] | 요청하신 로직은 `OnBeginPlayServer()` 함수 내에서 `_TimerService:SetTimerOnce`를 사용하여 `DropTweenTime`보다 0.1초 뒤에 `TriggerComponent`를 활성화하는 것입니다. 참고 문서에 기반한 mLua 스크립트는 다음과 같습니다. ```lua Method: [server only] void OnBeginPlayServer() { -- Tween이 끝난 후에 TriggerComponent 활성화 _TimerService:SetTimerOnce(functio [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 1. **Model_Item**에 **TweenFloatingComponent**를 추가합니다. 각 프로퍼티는 아래와 같이 설정합니다. 2. **Item** 스크립트를 열고 **number** 타입의 새 프로퍼티 **DropTweenTime**을 추가합니다. ```lua Property: [Sync] number ItemIndex = 0 -- 추가 [Sync] number DropTweenTime = 0.8 ``` 3. `OnBeginP
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | 문서 예제에 사용된 NPC 두 명의 Entity Name과 그에 대응하는 LocaleDataSet의 Key 값을 표로 정리하세요. [answer] | NPC 두 명의 Entity Name과 LocaleDataSet의 Key 값은 다음과 같습니다. | NPC | Entity Name | LocaleDataSet Key | | :--- | :---: | :--- | | Stan | Stan | UI_TEXT_NPC_Stan | | Rina | Rina | UI_TEXT_NPC_Rina | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TextComponent**의 텍스트는 **IsLocalizationKey**로 간단하게 번역 여부를 설정할 수 있지만 그 외의 텍스트를 번역해야 하거나, 스크립트에서 번역을 제어할 때는 `GetText()` 함수를 활용합니다. `GetText()` 함수는 번역 테이블의 **Key**열에서 인수(argument)로 받은 키와 같은 값을 가진 행을 찾아 해당 행에서 클라이언트 언어 코드와 동일한 열의 텍스트 값을 반환합니다. 간단한 예제를 통해 클라이언트의 언어 설정별 텍스트 출력 방법을 알아봅시다. 맵에 2명의 NPC를 배치하
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | UI 에디터에서 텍스트 엔티티의 언어 설정을 변경하고 테스트하기 위한 조작 순서를 5문장 이내로 설명해 주세요. [answer] | UI 에디터에서 텍스트 엔티티를 추가하고 TextComponent의 Text 값을 로컬라이징 키로 설정한 뒤 IsLocalizationKey를 True로 변경합니다. LocaleDataSet을 생성해 해당 키에 대한 한국어 및 영어 번역 문구를 입력합니다. 클라이언트 언어 설정이 한국어인 상태로 시작 버튼을 눌러 "안녕하세요!"가 출력되는지 확인합니다. 상단 메뉴에서 언어 설정을 한국어에서 영어로 변경합니다. 다시 시작 버튼을 누르면 텍스트가 영어인 "Hello!"로 변경되어 출력되는 것을 확인합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | LocaleDataSet을 활용해 간단한 방법으로 텍스트를 번역해 봅시다. 1. UI 에디터에서 텍스트 엔티티를 추가합니다. 추가한 텍스트 엔티티의 **TextComponent**에서 프로퍼티를 아래와 같이 수정합니다. | 컴포넌트 | 프로퍼티 | 값 | | :---------------------------: | :------: | :---: | | @cols=1:@rows=3:TextComponent | FontSize | 50 | |
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 임베디드 서버에서 테스트할 때 정적 룸과 인스턴스 룸 중 어느 쪽에서 테스트해야 실제 서버 환경과 가장 유사한 결과를 볼 수 있을까요? [answer] | 임베디드 서버에서 테스트할 때 **인스턴스 룸**에서 테스트해야 실제 서버 환경과 가장 유사한 결과를 볼 수 있습니다. 그 이유는 다음과 같습니다: 1. **인스턴스 룸의 동적 생성 특성**: 인스턴스 룸은 서버 인스턴스에서 **동적으로 생성**되는 룸입니다. 실제 운영 서버에서도 유저가 맵에 입장하거나 특정 조건이 충족될 때 인스턴스 룸과 인스턴스 맵이 동적으로 생성되므로, 이 과정이 포함된 테스트가 실제 환경에 가깝습니다. 2. **정적 룸의 차이**: 정적 룸은 월드 인스턴스가 생성되면 **무조건** 생성되는 룸입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 월드 제작 중 스크립트 에디터에서 코드 작성 시 시그니처 헬퍼와 같은 스크립트 어시스트 기능을 활용하는 구체적인 이점은 무엇인가요? [answer] | 메이플스토리 월드의 스크립트 에디터에서 시그니처 헬퍼와 같은 스크립트 어시스트 기능을 활용하면 다음과 같은 구체적인 이점을 얻을 수 있습니다. **1. 함수 파라미터 작성 효율 향상 (시그니처 헬퍼)** * **기능:** 함수의 매개 변수(Parameter)를 채우는 데 도움을 줍니다. * **이점:** 복잡한 함수를 호출할 때 필요한 인자의 순서나 타입을 즉시 파악할 수 있어, 매개 변수 누락이나 잘못된 순서로 전달하는 실수를 방지합니다. 이는 디버깅 시간을 줄여주는 핵심적인 이점입니다. **2. 코드 작성 속도 및 정 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # ㄱ ##### 계층 구조 Hierarchy 제작 중인 월드의 현황을 계층 구조로 확인할 수 있는 창 복잡하게 구성한 맵의 엔티티를 체계적으로 관리할 때 사용 **World, common, maps, ui**를 포함함 **참고 |** [Hierarchy](/docs/?postId=453) # ㄴ ##### 네이티브 API Native API 크리에이터는 생성할 수 없는 메이플스토리 월드 엔진 내의 API # ㄷ ##### 데이터 에디터 Data Editor 메이커에서 데이터 셋을 편집할 수 있는 에디터 **참고 |**
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 서버와 클라이언트 간에 프로퍼티 값을 자동으로 맞춰주는 동기화(Synchronization) 기능이 제대로 작동하지 않을 때 실행 공간 설정에서 확인해야 할 점은 무엇인가요? [answer] | 서버와 클라이언트 간에 프로퍼티 값이 자동으로 맞춰지지 않을 때, 실행 공간(Execution Space) 설정에서 확인해야 할 핵심 사항은 해당 프로퍼티가 **동기화(Synchronization) 대상**으로 올바르게 지정되었는지입니다. 메이플스토리 월드의 동기화 기능은 서버와 클라이언트 각각의 실행 공간에 존재하는 **같은 이름의 프로퍼티**를 같은 값으로 맞추는 방식입니다. 따라서 동기화가 작동하지 않는다면 아래 사항을 체크해야 합니다. 1. **프로퍼티의 동기화 속성 확인**: 동기화 대상이 되는 프로퍼티는 선언 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # ㄱ ##### 계층 구조 Hierarchy 제작 중인 월드의 현황을 계층 구조로 확인할 수 있는 창 복잡하게 구성한 맵의 엔티티를 체계적으로 관리할 때 사용 **World, common, maps, ui**를 포함함 **참고 |** [Hierarchy](/docs/?postId=453) # ㄴ ##### 네이티브 API Native API 크리에이터는 생성할 수 없는 메이플스토리 월드 엔진 내의 API # ㄷ ##### 데이터 에디터 Data Editor 메이커에서 데이터 셋을 편집할 수 있는 에디터 **참고 |**
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | `OnBeginPlay()` 함수 내의 로컬라이징 처리 코드만 출력하고, 각 줄의 역할을 주석으로만 설명하세요. [answer] | ```lua [client only] void OnBeginPlay() { -- Stan 엔티티의 이름 태그 컴포넌트 이름 속성에 "UI_TEXT_NPC_Stan" 키로 번역된 텍스트를 설정 self.Stan.NameTagComponent.Name = _LocalizationService:GetText("UI_TEXT_NPC_Stan") -- Rina 엔티티의 이름 태그 컴포넌트 이름 속성에 "UI_TEXT_NPC_Rina" 키로 번역된 텍스트를 설정 self.Rina.NameTagComponent.Na [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TextComponent**의 텍스트는 **IsLocalizationKey**로 간단하게 번역 여부를 설정할 수 있지만 그 외의 텍스트를 번역해야 하거나, 스크립트에서 번역을 제어할 때는 `GetText()` 함수를 활용합니다. `GetText()` 함수는 번역 테이블의 **Key**열에서 인수(argument)로 받은 키와 같은 값을 가진 행을 찾아 해당 행에서 클라이언트 언어 코드와 동일한 열의 텍스트 값을 반환합니다. 간단한 예제를 통해 클라이언트의 언어 설정별 텍스트 출력 방법을 알아봅시다. 맵에 2명의 NPC를 배치하
[task] | single_turn [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | 클라이언트 언어 설정에 맞춰 텍스트를 번역하기 위해 먼저 생성해야 하는 데이터셋의 이름은 무엇인가요? [answer] | 클라이언트 언어 설정에 맞춰 텍스트를 번역하기 위해 먼저 생성해야 하는 데이터셋의 이름은 **LocaleDataSet**입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 크리에이터가 제작한 월드를 다양한 지역의 유저들이 즐길 수 있도록 하려면 로컬라이징 과정은 필수적입니다. `LocalizationService`는 클라이언트의 언어를 기반으로 텍스트나 어셋 등을 해당 언어에 맞게 제공할 수 있도록 도와줍니다. 이번 과정에서는 로컬라이징의 개념을 살펴보고 `LocalizationService`를 사용해 텍스트를 번역하는 방법을 알아봅시다. ##### 참고 가이드 [포맷에 맞게 로컬라이징하기](docs/?postId=968) [자동 번역](docs/?postId=1072) [Lo
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 정적 맵과 인스턴스 맵의 차이를 MapComponent의 InstanceMap 체크 여부로만 구분하는 건지, 실제 월드에서 생성되는 방식에 차이가 있는지 알고 싶어요. [answer] | 참고 문서에 따르면 정적 맵과 인스턴스 맵의 차이는 단순히 `MapComponent`의 `InstanceMap` 체크 여부뿐만 아니라, 실제 월드에서 생성되는 방식(룸의 종류)에 근본적인 차이가 있습니다. 구체적인 차이는 다음과 같습니다. **1. 생성 방식 및 포함되는 룸** * **정적 맵(Static Map):** 월드 인스턴스가 생성되면 무조건 생성되는 **정적 룸(Static Room)**에 포함됩니다. 월드에 존재하는 맵은 기본적으로 정적 맵으로 설정되어 있습니다. * **인스턴스 맵(Instance Map): [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | code [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | _LocalizationService:TranslateText("key") 로 서버에서 전송한 로컬라이징 키를 클라이언트에서 해당 언어의 텍스트로 변환해 UI에 출력하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에는 `_LocalizationService:TranslateText("key")`라는 API가 존재하지 않습니다. 따라서 이 함수를 사용하여 스크립트를 작성하는 것은 불가능합니다. 문서에서 확인할 수 있는 텍스트 변환(로컬라이징) 방법은 다음과 같습니다: 1. **기본 클라이언트 언어 기반 텍스트 가져오기:** `_LocalizationService:GetText("키")` 또는 `_LocalizationService.LocalTranslator:GetText("키")`를 사용합니다. 2. **특정 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 크리에이터가 제작한 월드를 다양한 지역의 유저들이 즐길 수 있도록 하려면 로컬라이징 과정은 필수적입니다. `LocalizationService`는 클라이언트의 언어를 기반으로 텍스트나 어셋 등을 해당 언어에 맞게 제공할 수 있도록 도와줍니다. 이번 과정에서는 로컬라이징의 개념을 살펴보고 `LocalizationService`를 사용해 텍스트를 번역하는 방법을 알아봅시다. ##### 참고 가이드 [포맷에 맞게 로컬라이징하기](docs/?postId=968) [자동 번역](docs/?postId=1072) [Lo
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 워크스페이스(Workspace)의 MyDesk 폴더에 저장된 리소스를 참조하여 엔티티(Entity)를 생성하고, 생성된 엔티티에 컴포넌트(Component)를 추가하여 OnBeginPlay()에서 초기화 과정을 log()로 기록하는 스크립트를 작성해줘 [answer] | 제시된 참고 문서에는 워크스페이스(Workspace)의 구조(특히 `MyDesk` 폴더)와 엔티티, 컴포넌트의 개념적 정의만 포함되어 있으며, **리소스를 참조하여 엔티티를 생성하거나 컴포넌트를 추가하는 구체적인 API(예: `Spawn`, `AddComponent` 등)에 대한 설명은 포함되어 있지 않습니다.** 따라서 제공된 문서 근거만으로는 실제 동작하는 스크립트 코드를 작성할 수 없습니다. 문서에 없는 API를 지어내지 않기 때문에, 요청하신 기능에 대한 코드 예시를 제공할 수 없음을 알려드립니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 엔티티(Entity)에 스크립트 컴포넌트를 적용하여 OnBeginPlay() 생명주기 메서드에서 log() 함수를 사용해 "스크립트 시작" 메시지를 출력하고, OnUpdate()에서 매 프레임마다 log()를 통해 현재 상태를 기록하는 스크립트를 작성해줘 [answer] | 요청하신 대로 `OnBeginPlay()`에서 시작 메시지를 출력하고, `OnUpdate()`에서 매 프레임마다 현재 상태를 기록하는 스크립트를 작성했습니다. mLua는 Lua 5.3 기반이므로, 함수 본문은 Lua 문법을 따르며 선언부는 C# 스타일의 타입 표기를 사용합니다. ```lua Property: [None] number frameCount = 0 Method: [server only] void OnBeginPlay() { log("스크립트 시작") } [server only] void OnUpdate(nu [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | 서버에서 로컬라이징 키를 사용해 텍스트를 전송하는 방식에 대해 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua Property: [None] string LocalizationKey = "greeting_message_key" Method: [server only] void SendLocalizedTextToUser(Entity userEntity) { -- 서버에서는 로컬라이징된 텍스트 문자열이 아닌 로컬라이징 키(Localizing Key)를 전송해야 합니다. -- 클라이언트는 이 키를 받아서 자신의 언어 설정에 맞는 번역된 텍스트로 출력합니다. -- 참고: 문서에는 특정 'SendText' 또는 'S [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 크리에이터가 제작한 월드를 다양한 지역의 유저들이 즐길 수 있도록 하려면 로컬라이징 과정은 필수적입니다. `LocalizationService`는 클라이언트의 언어를 기반으로 텍스트나 어셋 등을 해당 언어에 맞게 제공할 수 있도록 도와줍니다. 이번 과정에서는 로컬라이징의 개념을 살펴보고 `LocalizationService`를 사용해 텍스트를 번역하는 방법을 알아봅시다. ##### 참고 가이드 [포맷에 맞게 로컬라이징하기](docs/?postId=968) [자동 번역](docs/?postId=1072) [Lo
[task] | single_turn [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 서버와 클라이언트에서 동시에 실행되는 OnBeginPlay에서 IsClient 함수를 사용하여 분기 처리를 하는 대신 서버 전용 메서드로 분리하는 것이 왜 권장되는가요? [answer] | mLua에서는 `OnBeginPlay`와 같은 표준 생명주기 메서드가 서버와 클라이언트 양쪽에서 동시에 실행됩니다. 이때 `self:IsClient()`를 사용하여 코드 내부에서 분기 처리하는 것보다, 서버 전용 메서드와 클라이언트 전용 메서드로 로직을 분리하는 것이 권장되는 이유는 다음과 같습니다. **1. 실행 공간(Execution Space) 명시와 API 안전성** mLua API는 특정 실행 공간(서버 또는 클라이언트)에서만 작동하도록 설계된 경우가 많습니다. 예를 들어, 아이템 획득 로직에 사용되는 `_EntitySe [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua Property: [Sync] number ItemIndex = 0 [Sync] number DropTweenTime = 0.8 Method: void InitItem(number itemIndex) { self.ItemIndex = itemIndex local sprite = self.Entity.SpriteRendererComponent local itemDataSet = _DataService:GetTable("UserItemDataSet") local ruid = itemDataS
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | 플레이어 충돌 시 머티리얼을 교체하는 예제에서 필요한 컴포넌트 추가 및 이벤트 핸들러 코드 작성 단계를 단계별 번호 목록으로 정리해 주세요. [answer] | 플레이어 충돌 시 머티리얼을 교체하는 예제에서 필요한 컴포넌트 추가 및 이벤트 핸들러 코드 작성 단계는 다음과 같습니다. 1. 새 머티리얼을 만들고 이름에 **Material01**을 입력합니다. 2. **Scene**에 원하는 엔티티(예: Preset List - npc-964)를 배치합니다. 3. 해당 엔티티의 프로퍼티 에디터에서 **SpriteRendererComponent - MaterialID**를 설정하여 **Material01**을 선택합니다. 4. **Material01**의 프로퍼티 에디터에서 **Shader - [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp