[task] | single_turn [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 클라이언트에서 실행되는 OnBeginPlayClient에서 Tween 애니메이션이 종료된 후 Entity의 TweenFloatingComponent를 활성화하는 이유는 무엇인가요? [answer] | `OnBeginPlayClient`에서 Tween 애니메이션이 종료된 후 `self.Entity.TweenFloatingComponent.Enable = true`로 활성화하는 이유는, 아이템이 낙하하여 지면에 닿은 시점부터 **가벼운 부유(플로팅) 효과**를 시작하기 위해서입니다. 구체적인 동작 흐름은 다음과 같습니다. 1. **낙하 애니메이션 실행:** 아이템이 생성되면 `DropTweenTime` 동안 위로 떠오르다가 다시 아래로 떨어지는 이동(`MoveOffset`) Tween이 실행됩니다. 2. **낙하 완료 시점: [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] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 로그 Log 기능을 사용하여 월드 진입 시 사용자 ID(User ID)와 함께 메시지를 출력하는 Event Handler를 포함하는 스크립트를 작성해줘 [answer] | `UserService`가 전송하는 `UserEnterEvent`를 처리하는 이벤트 핸들러를 사용하여, 사용자가 월드에 진입할 때 `UserId`와 함께 메시지를 로그에 출력하는 스크립트입니다. ```lua Event Handler: [service: UserService] HandleUserEnterEvent(UserEnterEvent event) { local UserId = event.UserId log("User entered: " .. UserId) } ``` [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] | 인벤토리 UI 스크립트 작성하기 [question] | UIItemSlot 스크립트의 SetData 메서드에서 _DataService:GetTable("UserItemDataSet")을 조회하여 ItemIndex 에 해당하는 "IconRUID" 값을 가져와 img_slot 자식 엔티티의 SpriteGUIRendererComponent.ImageRUID 에 할당하고, item_count 자식 엔티티의 TextComponent.Text 에 ItemCount 를 문자열로 변환하여 표시하며, ItemCount 가 0보다 크면 SetEnable(true) 를 호출하고 아니면 SetEnable(f [answer] | 요청하신 로직은 `UIItemSlot` 컴포넌트의 `SetData` 메서드 안에 구현됩니다. `_DataService`를 통해 아이템 아이콘 정보를 조회하고, 자식 엔티티의 스프라이트와 텍스트를 갱신하며, 아이템 개수에 따라 슬롯의 가시성을 제어하는 구조입니다. ```lua Property: [None] number ItemIndex = 0 [None] number ItemCount = 0 Method: void SetData(number itemIndex, number itemCount) { -- 슬롯에 아이템 정보를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## UIItemSlot 스크립트 ```lua Property: [None] number ItemIndex = 0 [None] number ItemCount = 0 Method: void SetData(number itemIndex, number itemCount) { -- 슬롯에 아이템 정보를 설정함 self.ItemIndex = itemIndex self.ItemCount = itemCount local imageEntity = self.Entity:GetChildByName("img_sl
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 실행 공간 제어 Execution Space Setting 규칙에 따라 서버에서만 실행되도록 설정된 [server only] 메서드에서 _TimerService로 타이머를 설정하는 스크립트를 작성해줘 [answer] | `[server only]` 실행 공간으로 설정된 메서드에서 `_TimerService`를 사용하여 타이머를 설정하는 스크립트입니다. ```lua Method: [server only] void OnBeginPlay() { _TimerService:SetTimerOnce(function() log("타이머가 종료되었습니다.") end, 5.0) } ``` [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] | 아이템 드롭 시 Tween 애니메이션이 끝난 후에도 캐릭터가 아이템을 줍지 못하는 원인이 무엇인가요? [answer] | 아이템 드롭 시 Tween 애니메이션이 끝난 후에도 캐릭터가 아이템을 줍지 못하는 원인은 **`OnBeginPlayServer()`에서 `TriggerComponent`를 활성화하는 타이밍이 클라이언트에서 Tween이 끝나는 시점과 정확히 일치하지 않기 때문**입니다. 문서에서 제시된 코드를 보면 다음과 같은 차이가 있습니다. 1. **클라이언트 (`OnBeginPlayClient`)**: Tween 전체 시간(`DropTweenTime`) 동안 애니메이션이 실행되며, Tween이 끝나야 `TweenFloatingCompone [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] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 정적 룸과 인스턴스 룸의 개념적 차이는 무엇이며, 일반적으로 말하는 '룸'은 어느 쪽을 지칭하나요? [answer] | 룸(Room)은 월드 인스턴스 하위에 구성된 맵들의 집합체입니다. 룸은 **정적 룸**과 **인스턴스 룸**으로 나뉩니다. 일반적으로 말하는 '룸'은 **정적 룸**을 지칭합니다. [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] | 인벤토리 UI 스크립트 작성하기 [question] | 인벤토리 버튼 클릭 시 self.Entity.Enable = true로 패널을 열도록 구현했는데, CloseButton 연결 로직에서 비슷한 방식으로 Enable을 false로 설정하는 것이 왜 가능한지, 그리고 이 방식과 SetEnable(false)를 사용하는 방식의 차이점은 무엇인가요? [answer] | 제공된 참고 문서의 코드를 분석하면, 인벤토리 패널의 열림과 닫힘을 제어하는 방식은 **`self.Entity.Enable` 프로퍼티 직접 할당**과 **`SetEnable` 메서드 호출**의 두 가지로 나뉘며, 문서상으로는 이 두 가지 모두 사용 가능합니다. ### 1. `self.Entity.Enable = true/false` 사용 가능 여부 참고 문서의 `OnBeginPlay` 메서드에서 인벤토리 버튼(`inventoryButton`)의 클릭 이벤트 핸들러(`openFunc`) 내부에서 다음과 같이 코드가 작성되어 있습니다 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua Property: [None] Entity itemUI = nil [None] Entity scrollView = nil [None] SyncTable<string, Entity> SlotItems [None] string inventoryBtnPath = "/ui/DefaultGroup/RPGButtons/btn_inventory" Method: [client only] void OnBeginPlay { self.itemUI =_EntityService:GetEntityByPath(self.Entity
[task] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | HandleTriggerEnterEvent 이벤트 핸들러에서 아이템 획득 처리가 완료된 후 self.Entity:Destroy()를 호출하여 해당 아이템 엔티티가 월드에서 제거되도록 구현하는 스크립트를 작성해줘 [answer] | `HandleTriggerEnterEvent` 이벤트 핸들러 내에서 충돌한 플레이어의 인벤토리를 확인하고, 해당 플레이어의 인벤토리에 아이템을 추가한 뒤 `self.Entity:Destroy()`를 호출하여 아이템 엔티티를 제거하는 스크립트입니다. 참고 문서에 제시된 `LiteInventory`와 `ModifyItem` 방식을 사용하여, 충돌한 엔티티가 인벤토리를 가지고 있는지 확인한 후 아이템 개수를 변경하고 엔티티를 파괴하는 로직을 구현했습니다. ```lua Event Handler: [server only] [self] H [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ```lua [server only] [self] HandleTriggerEnterEvent(TriggerEnterEvent event) { -- Parameters local TriggerBodyEntity = event.TriggerBodyEntity -------------------------------------------------------- --아이템 엔티티와 충돌한 엔티티의 인벤토리를 받고, 인벤토리가 없으면 리턴 local
[task] | single_turn [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | HandleTriggerEnterEvent 핸들러에서 LiteInventory 프로퍼티가 nil인 경우를 검사하는 것이 필수적인 이유는 무엇인가요? [answer] | `HandleTriggerEnterEvent` 핸들러에서 `LiteInventory` 프로퍼티가 `nil`인 경우를 검사하는 것은, 트리거에 진입한 엔티티가 반드시 아이템을 받을 수 있는 사용자(플레이어)가 아닐 수 있기 때문입니다. 몬스터, NPC, 또는 아이템을 드롭할 수 없는 다른 객체들이 트리거 영역에 들어올 경우, 해당 엔티티에는 `LiteInventory` 프로퍼티가 존재하지 않습니다. 이 상태에서 `inventory:ModifyItem(...)` 같은 메서드를 호출하면 스크립트 오류가 발생하여 서버 로직이 중단될 수 [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] | 네이티브 API와 스크립트 API의 차이는 무엇이며, 크리에이터가 직접 생성할 수 있는 것은 어느 쪽인가요? [answer] | 네이티브 API와 스크립트 API의 차이와 크리에이터의 생성 권한은 다음과 같습니다. **1. 네이티브 API (Native API)** * **정의:** 메이플스토리 월드 엔진 내부에 이미 존재하는 API입니다. * **크리에이터 생성 여부:** 크리에이터가 직접 생성할 수 **없습니다.** **2. 스크립트 API (Script API)** * **정의:** 크리에이터가 직접 생성하는 API입니다. * **크리에이터 생성 여부:** 크리에이터가 직접 생성할 수 **있습니다.** 따라서 크리에이터가 직접 생성할 [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] | 플레인 스크립트(Plain Script)와 플레인 텍스트 모드(Plain Text Mode)의 차이점을 2열 3행 표로 정리하세요. [answer] | 플레인 스크립트와 플레인 텍스트 모드의 차이점을 정리하면 다음과 같습니다. | 구분 | 플레인 스크립트 (Plain Script) | 플레인 텍스트 모드 (Plain Text Mode) | | :--- | :--- | :--- | | **정의** | 크리에이터가 **Create Script** 메뉴를 클릭하여 생성하는 스크립트 | 스크립트 에디터에서 Script API를 메타 데이터까지 모두 텍스트 형태로 보는 모드 | | **역할** | 실제 게임 로직을 작성하고 실행하기 위한 스크립트 파일 생성 | 작성된 스크립트의 내부 구조 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 파티클 Particle 눈이나 비, 먼지 같은 다수의 작은 입자 **참고 |** [파티클](/docs/?postId=764) ##### 프로파일러 Profiler 최적화 작업을 손쉽게 진행할 수 있도록 돕는 툴 ##### 프로퍼티 Property 각 컴포넌트의 세부 사항을 설정하는 요소 엔티티별로 다른 값을 가질 수 있음 **참고 |** [프로퍼티](/docs/?postId=205) ##### 프로필 ID Profile ID \#으로 시작하는 ID로 계정 별로 고유함 ##### 프로필 이름 Profile Name
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | 플레이어와 오브젝트 간 거리에 따라 PixelateSize가 변화하는 수식과 그 적용 방식을 3문장 이내로 요약하세요. [answer] | 플레이어와 오브젝트 사이의 2D 거리를 계산하여 16을 곱한 값에 16을 더한 결과로 `PixelateSize`를 산출합니다. 이 값을 테이블로 구성한 뒤 `_MaterialService:ChangeMaterialProperty` 메서드를 호출해 머티리얼 프로퍼티를 갱신합니다. 해당 로직은 `OnUpdate` 함수 내에서 **client only** 실행 공간으로 설정하여 클라이언트 사이드에서 실시간으로 처리됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트를 활용해 월드 플레이 도중 머티리얼 프로퍼티를 제어할 수 있습니다. 예제를 통해 머티리얼 프로퍼티 제어 방법을 살펴봅시다. 1. "기본" 템플릿으로 월드를 생성합니다. 2. 맵에 상호 작용할 오브젝트를 배치합니다. 예제에서는 **Preset List - Object - object-273**을 사용했습니다. 그리고 **object-273**의 이름을 **StarTree**로 변경합니다. 3. **Workspace - MyDesk**의 콘텍스트 메뉴에서 **Create Material*
[task] | single_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | Shader Picker 창에서 특정 컴포넌트를 선택하면 어떤 정보를 확인할 수 있나요? [answer] | Shader Picker 창에서 특정 컴포넌트를 선택하면, 해당 렌더러 컴포넌트에서 사용할 수 있는 셰이더 종류를 확인할 수 있습니다. 일부 렌더러 컴포넌트는 사용할 수 있는 셰이더가 제한되어 있기 때문에, 이 필터를 통해 지원되는 셰이더 목록을 확인하는 것이 좋습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | OnUpdate 함수의 코드만 출력하되, 설명은 주석으로만 작성하세요. [answer] | ```lua [client only] void OnUpdate (number delta) { local playerWorldPosition = _UserService.LocalPlayer.TransformComponent.WorldPosition local targetScreenPos = _UILogic:WorldToScreenPosition(Vector2(playerWorldPosition.x, playerWorldPosition.y)) targetScreenPos.x = targetScreenPos.x / _UILogic [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트를 활용해 월드 플레이 도중 머티리얼 프로퍼티를 제어할 수 있습니다. 예제를 통해 머티리얼 프로퍼티 제어 방법을 살펴봅시다. 1. "기본" 템플릿으로 월드를 생성합니다. 2. 맵에 상호 작용할 오브젝트를 배치합니다. 예제에서는 **Preset List - Object - object-273**을 사용했습니다. 그리고 **object-273**의 이름을 **StarTree**로 변경합니다. 3. **Workspace - MyDesk**의 콘텍스트 메뉴에서 **Create Material*
[task] | single_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | SpriteRendererComponent 외에 머티리얼을 적용할 수 있는 다른 렌더러 컴포넌트들이 어떤 제한사항이 있나요? [answer] | 머티리얼은 SpriteRendererComponent를 포함한 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 적용 방법은 SpriteRendererComponent에 머티리얼을 적용하는 것과 동일합니다. 다만, 일부 렌더러 컴포넌트에서는 사용할 수 있는 셰이더의 종류가 제한됩니다. 특정 컴포넌트별로 허용되는 셰이더를 확인하려면 Shader Picker 창의 필터에서 해당 컴포넌트를 선택하면 됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | number MaxParticleCount = 100 프로퍼티를 가진 파티클 스크립트를 작성해줘 [answer] | 제공된 참고 문서에는 `number MaxParticleCount = 100` 프로퍼티를 선언하는 문법 자체는 예제에서 확인되지만, 파티클(Particle) 컴포넌트나 파티클을 제어하는 구체적인 API(메서드, 이벤트 핸들러 등)는 정의되어 있지 않습니다. 따라서 요청하신 `MaxParticleCount` 프로퍼티만 포함하는 최소한의 스크립트 구조만 작성할 수 있으며, 파티클의 실제 동작(재생, 정지, 속성 변경 등)을 제어하는 코드는 문서에 해당 API가 없어 추가할 수 없습니다. ```lua Property: [None] n [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 파티클 Particle 눈이나 비, 먼지 같은 다수의 작은 입자 **참고 |** [파티클](/docs/?postId=764) ##### 프로파일러 Profiler 최적화 작업을 손쉽게 진행할 수 있도록 돕는 툴 ##### 프로퍼티 Property 각 컴포넌트의 세부 사항을 설정하는 요소 엔티티별로 다른 값을 가질 수 있음 **참고 |** [프로퍼티](/docs/?postId=205) ##### 프로필 ID Profile ID \#으로 시작하는 ID로 계정 별로 고유함 ##### 프로필 이름 Profile Name
[task] | single_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 메이커에서 엔티티의 렌더링 방식을 제어하는 머티리얼(Material)과 셰이더(Shader)는 각각 어떤 역할을 하나요? [answer] | 메이플스토리 월드에서 엔티티의 렌더링 방식을 제어하는 머티리얼(Material)과 셰이더(Shader)의 역할은 다음과 같습니다. **머티리얼 (Material)** * 다양한 프로퍼티를 통해 엔티티가 렌더링될 방법을 나타내는 객체입니다. * 즉, 머티리얼은 엔티티의 외관(색상, 투명도, 질감 등)을 정의하는 설정 집합으로, 엔티티가 화면에 어떻게 그려질지를 결정하는 상위 개념의 객체입니다. **셰이더 (Shader)** * 물체를 렌더링할 때 사용되는 코드 또는 스크립트입니다. * 셰이더는 실제 렌더링 과정에 적 [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] | string CurrentProfileName = "" 프로퍼티를 가진 프로필 정보 관리 스크립트를 작성해줘 [answer] | 메이플스토리 월드의 용어 사전에 따르면, 프로필 이름(Profile Name)은 사용자가 변경할 수 있으며 다른 유저와 중복될 수 있는 정보입니다. 하지만 제공된 참고 문서에는 `string CurrentProfileName` 프로퍼티를 설정하거나 프로필 이름을 실시간으로 가져오는 데 사용되는 구체적인 mLua API(예: `UserService`의 특정 메서드)가 명시되어 있지 않습니다. 따라서 요청하신 `string CurrentProfileName = ""` 프로퍼티를 가진 스크립트 구조는 작성해 드릴 수 있으나, 이 프로퍼 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 파티클 Particle 눈이나 비, 먼지 같은 다수의 작은 입자 **참고 |** [파티클](/docs/?postId=764) ##### 프로파일러 Profiler 최적화 작업을 손쉽게 진행할 수 있도록 돕는 툴 ##### 프로퍼티 Property 각 컴포넌트의 세부 사항을 설정하는 요소 엔티티별로 다른 값을 가질 수 있음 **참고 |** [프로퍼티](/docs/?postId=205) ##### 프로필 ID Profile ID \#으로 시작하는 ID로 계정 별로 고유함 ##### 프로필 이름 Profile Name
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 엔티티와 컴포넌트의 관계가 어떻게 정의되는지, 그리고 일반 엔티티의 위치를 알려주세요 [answer] | 엔티티(Entity)는 메이플스토리 월드 내에 존재하는 객체로, 여러 컴포넌트(Component)의 집합체로 정의됩니다. 컴포넌트는 특정 엔티티의 구성 요소로, 각각의 기능을 담당하며 엔티티에 부착되어 엔티티의 동작을 구현합니다. 일반 엔티티(Common Entity)는 **Hierarchy - World** 하위에 포함된 특수 엔티티입니다. [followup] | MapComponent의 InstanceMap 체크 여부에 따라 정적 맵과 인스턴스 맵이 어떻게 구분되는지 구체적으로 설명해 주세요. [followup_answer] | MapComponent의 InstanceMap 체크 여부에 따라 맵이 정적 맵(Static Map)과 인스턴스 맵(Instance Map)으로 구분됩니다. 1. **정적 맵 (Static Map)** - **설정 방법**: MapComponent에서 `InstanceMap`을 체크하지 않은 경우. - **특징**: 월드에 존재하는 맵은 기본적으로 정적 맵으로 설정되어 있습니다. - **소속**: 정적 룸(Static Room)에 생성되며, 정적 룸에는 정적 맵만 포함될 수 있습니다. 정적 룸은 월드 인스턴스가 생성 [scores] | [judge_reason] | [source_doc] | ##### 아틀라스 Atlas 한 장의 이미지에 여러 개의 스프라이트가 함께 있는 이미지 ##### 아틀라스 언패커 Atlas Unpacker 아틀라스를 크리에이터가 개별의 스프라이트로 자르고 편집해 저장하는 툴 ##### 어노테이션 Annotation 코드에 추가하여 사용하는 일종의 메타 데이터 **참고 |** [Annotation 활용하기](/docs/?postId=824) ##### 엔티티 Entity 메이플스토리 월드 내에 존재하는 객체로 여러 컴포넌트의 집합체 **참고 |** [엔티티](/docs/?postId=54)
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | SpriteRendererComponent 외의 다른 렌더러 컴포넌트에서 머티리얼을 사용할 때 셰이더 제한 사항을 확인하는 방법을 2문장 이내로 설명해 주세요. [answer] | 일부 렌더러 컴포넌트에서는 사용할 수 있는 셰이더 종류가 제한됩니다. 각 컴포넌트별로 허용되는 셰이더를 확인하려면 Shader Picker 창의 필터에서 해당 컴포넌트를 선택하면 됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | single_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | Material02의 Entry ID를 스크립트에 입력할 때 어떤 형식으로 작성해야 하나요? [answer] | Material02의 Entry ID를 스크립트에 입력할 때는 `material://` 뒤에 Entry ID를 붙이는 형식(`"material://Entry ID"`)으로 작성해야 합니다. 예를 들어, Entry ID가 `123456789`라면 아래처럼 입력합니다. ```lua self.Entity.SpriteRendererComponent:ChangeMaterial("material://123456789") ``` 이때 `Entry ID`는 실제 머티리얼의 고유 식별자 값을 그대로 복사해 붙여넣어야 합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | string PresetId = "default" 프로퍼티를 가진 프리셋 적용 스크립트를 작성해줘 [answer] | 제시된 참고 문서에는 "Preset(프리셋)"이라는 용어와 "Preset List"에 개별 프리셋이 있다는 설명만 존재합니다. 프리셋을 스크립트 내에서 적용하는 구체적인 API(예: `ApplyPreset` 메서드 등)나 `string` 타입의 프리셋 ID 프로퍼티를 사용하여 프리셋을 변경하는 코딩 방법은 문서에 포함되어 있지 않습니다. 따라서 주어진 문서 범위 내에서 `string PresetId = "default"` 프로퍼티를 가진 스크립트만 작성할 수 있으며, 이를 통해 실제로 프리셋을 적용하는 로직은 문서에 없는 API이 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ##### 파티클 Particle 눈이나 비, 먼지 같은 다수의 작은 입자 **참고 |** [파티클](/docs/?postId=764) ##### 프로파일러 Profiler 최적화 작업을 손쉽게 진행할 수 있도록 돕는 툴 ##### 프로퍼티 Property 각 컴포넌트의 세부 사항을 설정하는 요소 엔티티별로 다른 값을 가질 수 있음 **참고 |** [프로퍼티](/docs/?postId=205) ##### 프로필 ID Profile ID \#으로 시작하는 ID로 계정 별로 고유함 ##### 프로필 이름 Profile Name
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 용어 사전 [question] | 모델 Model 정보를 기반으로 _SpawnService를 호출하여 지정된 좌표에 엔티티를 생성하는 Method를 구현한 스크립트를 작성해줘 [answer] | 모델(Model)은 메이커에서 엔티티의 컴포넌트와 프로퍼티 정보를 담은 판본입니다. `_SpawnService`의 `SpawnByModelId` 메서드를 사용하면 이 모델 ID를 기반으로 특정 좌표에 엔티티를 생성할 수 있습니다. 아래는 지정된 모델 ID와 좌표를 프로퍼티로 설정하고, `OnBeginPlay` 시점에 엔티티를 생성하는 스크립트 예시입니다. ```lua Property: [None] number modelId = 100 [None] Vector3 spawnPosition = Vector3(0, 0, 0) [None [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # ㄱ ##### 계층 구조 Hierarchy 제작 중인 월드의 현황을 계층 구조로 확인할 수 있는 창 복잡하게 구성한 맵의 엔티티를 체계적으로 관리할 때 사용 **World, common, maps, ui**를 포함함 **참고 |** [Hierarchy](/docs/?postId=453) # ㄴ ##### 네이티브 API Native API 크리에이터는 생성할 수 없는 메이플스토리 월드 엔진 내의 API # ㄷ ##### 데이터 에디터 Data Editor 메이커에서 데이터 셋을 편집할 수 있는 에디터 **참고 |**
[task] | two_turn [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | SpriteRendererComponent 외에도 다른 렌더러 컴포넌트에서 머티리얼을 적용할 때 셰이더 종류에 제한이 있는지, 그리고 각 컴포넌트별로 지원되는 셰이더를 확인하는 방법은 무엇인가요? [answer] | 네, SpriteRendererComponent 외에도 다른 렌더러 컴포넌트에서 머티리얼을 적용할 때 사용할 수 있는 셰이더 종류가 제한될 수 있습니다. 각 컴포넌트별로 지원되는 셰이더를 확인하는 방법은 다음과 같습니다. 1. **Shader Picker** 창을 엽니다. 2. Shader Picker 창 내의 **필터**에서 해당 렌더러 컴포넌트를 선택합니다. 이렇게 필터링하면, 선택한 컴포넌트에서 실제로 사용할 수 있는 셰이더 목록만 표시되므로 지원 여부를 쉽게 확인할 수 있습니다. [followup] | SpriteRendererComponent에 적용된 머티리얼을 스크립트로 교체하고 싶을 때, TriggerEnterEvent를 통해 ChangeMaterial 메서드를 호출하여 Entry ID로 머티리얼을 변경하는 구체적인 코드 예제를 작성해 주세요. [followup_answer] | SpriteRendererComponent에 적용된 머티리얼을 스크립트로 교체하는 예제는 다음과 같습니다. 이 예제에서는 엔티티에 `TriggerComponent`와 스크립트 컴포넌트가 추가되어 있고, 교체할 새 머티리얼(예: Rainbow 셰이더를 사용한 Material02)의 **Entry ID**가 준비된 상태라고 가정합니다. ```lua Event Handler: [self] HandleTriggerEnterEvent(TriggerEnterEvent event) { --------------- Native Even [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | TriggerEnterEvent 핸들러 내에서 ChangeMaterial 메서드를 호출할 때 사용하는 URL 형식과 그 의미를 코드 주석 형식으로만 출력해 주세요. [answer] | ```lua -- "material://" : 머티리얼 리소스 접근을 위한 고정 URL 스키마 -- "{Entry ID}" : Workspace에서 해당 머티리얼의 Entry ID를 복사한 값 -- 전체 형식: "material://{Entry ID}" ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 머티리얼은 **SpriteRendererComponent** 외의 다른 여러 가지 렌더러 컴포넌트에서 사용할 수 있습니다. 이를 통해 크리에이터는 시각적으로 다채롭고 색다른 나만의 월드를 구현할 수 있습니다. 이번 과정에서는 여러 컴포넌트에서 어떻게 머티리얼을 사용하는지 알아보겠습니다. 또한 예제를 통해 스크립트로 머티리얼을 제어하는 방법도 살펴보겠습니다. # 여러 가지 컴포넌트에서 머티리얼 사용하기 머티리얼은 다양한 렌더러 컴포넌트에서 사용할 수 있습니다. 사용 방법은 **SpriteRendererComp
[task] | code [pass] | ⏳ 미판정 [title] | 인벤토리 UI 스크립트 작성하기 [question] | UIItemSlot 스크립트의 HandleButtonClickEvent 핸들러에서 self.ItemIndex 가 0이 아닌 경우에만 실행되도록 조건문을 설정하고, 이후 아이템 사용 로직을 처리하는 TODO 부분을 채워주는 구조를 작성해줘 [answer] | 제시된 문서의 `UIItemSlot` 스크립트 구조를 기반으로, `HandleButtonClickEvent` 핸들러에서 `self.ItemIndex` 가 0이 아닌 경우에만 실행되도록 조건문을 설정하고, 이후 아이템 사용 로직을 처리하는 `TODO` 부분을 채워주는 구조의 코드를 작성했습니다. 문서에 명시된 `SetData`와 `SetCount` 메서드 및 프로퍼티 정의는 유지하며, 이벤트 핸들러 부분의 `-- TODO: item logic` 영역을 실제 로직 처리 구조로 대체했습니다. ```lua Property: [None] [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## UIItemSlot 스크립트 ```lua Property: [None] number ItemIndex = 0 [None] number ItemCount = 0 Method: void SetData(number itemIndex, number itemCount) { -- 슬롯에 아이템 정보를 설정함 self.ItemIndex = itemIndex self.ItemCount = itemCount local imageEntity = self.Entity:GetChildByName("img_sl
[task] | two_turn [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | OnBeginPlay()에서 IsClient() 분기를 사용하는 이유와, 서버에서 _TimerService:SetTimerOnce를 사용할 때 DropTweenTime + 0.1의 0.1초 지연은 어떤 역할을 합니까? [answer] | `OnBeginPlay()`에서 `IsClient()` 분기를 사용하는 이유는 클라이언트와 서버에서 수행해야 할 작업이 서로 다르기 때문입니다. * **클라이언트 (`OnBeginPlayClient`)**: 아이템이 위로 붕 떠서 내려오는 시각적 연출(Tween)을 담당합니다. `_TweenLogic:MoveOffset`을 사용하여 화면에서 보이는 애니메이션을 처리합니다. * **서버 (`OnBeginPlayServer`)**: 아이템 획득 로직을 담당합니다. 시각적 연출이 끝날 때까지 캐릭터와 충돌(Trigger)이 발생 [followup] | 서버와 클라이언트 간 동기화 문제로 인해 TriggerComponent가 너무 일찍 활성화되면 어떤 문제가 발생하며, 이를 방지하기 위해 타이머 값을 조정해야 하는 경우를 설명해 주세요. [followup_answer] | 서버와 클라이언트 간 동기화 문제로 인해 `TriggerComponent`가 너무 일찍 활성화되면 다음과 같은 문제가 발생합니다. 1. **시각적 연출과 로직 불일치**: 클라이언트에서는 아이템이 아직 위로 떠 있거나 아래로 내려오는 Tween 애니메이션이 진행 중이지만, 서버에서는 이미 `TriggerComponent`가 활성화되어 아이템 획득이 가능해진 상태가 됩니다. 2. **유저 경험(UX) 저하**: 유저 입장에서는 화면에 아직 떠 있는 아이템을 캐릭터가 지나치기만 해도 인벤토리에 들어가는 것처럼 보일 수 있습니다. [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] | code [pass] | ⏳ 미판정 [title] | 아이템 스크립트 작성하기 [question] | 서버 실행 시 드롭 트윈 시간(DropTweenTime)에 0.1초를 더한 시간만큼 타이머를 설정하여 트리거 컴포넌트를 활성화하는 OnBeginPlayServer 메서드를 작성해줘. [answer] | 요청하신 `OnBeginPlayServer` 메서드입니다. ```lua Method: void OnBeginPlayServer() { _TimerService:SetTimerOnce(function() self.Entity.TriggerComponent.Enable = true end, self.DropTweenTime + 0.1) } ``` [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] | code [pass] | ⏳ 미판정 [title] | 머티리얼 응용하기 [question] | StarTree 엔티티에 MaterialTest 컴포넌트를 적용하여, _UserService 로 조회한 로컬 플레이어와 _MaterialService 로 제어하는 NewMaterial 의 PixelateSize 프로퍼티를 플레이어와 오브젝트 사이의 거리 기반으로 변경하는 스크립트를 작성해줘. [answer] | 요청하신 **StarTree** 엔티티에 적용할 **MaterialTest** 스크립트는 아래와 같습니다. 이 스크립트는 클라이언트에서 실행되며(`[client only]`), 매 프레임(`OnUpdate`)마다 로컬 플레이어와 스크립트가 부착된 엔티티(`self.Entity`) 사이의 2D 거리를 계산합니다. 계산된 거리를 기반으로 `PixelateSize` 값을 결정하고, `_MaterialService:ChangeMaterialProperty`를 통해 지정된 머티리얼의 프로퍼티를 변경합니다. **주의사항:** 1. 코드 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트를 활용해 월드 플레이 도중 머티리얼 프로퍼티를 제어할 수 있습니다. 예제를 통해 머티리얼 프로퍼티 제어 방법을 살펴봅시다. 1. "기본" 템플릿으로 월드를 생성합니다. 2. 맵에 상호 작용할 오브젝트를 배치합니다. 예제에서는 **Preset List - Object - object-273**을 사용했습니다. 그리고 **object-273**의 이름을 **StarTree**로 변경합니다. 3. **Workspace - MyDesk**의 콘텍스트 메뉴에서 **Create Material*
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬라이징의 이해 [question] | `LocalizationService`가 클라이언트 언어를 기반으로 처리하는 대상과 서버가 클라이언트로 전송해야 하는 데이터의 차이를 3문장 이내로 설명하세요. [answer] | `LocalizationService`는 클라이언트의 언어 설정을 기반으로 텍스트나 어셋을 해당 언어에 맞게 변환하여 제공합니다. 서버는 로컬라이징된 메시지 자체를 직접 발송하는 대신 로컬라이징 키(Localizing Key)만 클라이언트로 전송해야 합니다. 클라이언트는 수신된 키를 바탕으로 자신의 언어 설정에 맞는 실제 텍스트를 출력합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 크리에이터가 제작한 월드를 다양한 지역의 유저들이 즐길 수 있도록 하려면 로컬라이징 과정은 필수적입니다. `LocalizationService`는 클라이언트의 언어를 기반으로 텍스트나 어셋 등을 해당 언어에 맞게 제공할 수 있도록 도와줍니다. 이번 과정에서는 로컬라이징의 개념을 살펴보고 `LocalizationService`를 사용해 텍스트를 번역하는 방법을 알아봅시다. ##### 참고 가이드 [포맷에 맞게 로컬라이징하기](docs/?postId=968) [자동 번역](docs/?postId=1072) [Lo