[task] | extract_knowledge [title] | 에디터 서비스의 활용 [category] | Guides [rephrased] | # 에디터 타입 UI 구성 및 활용 ## 1. 개념 설명 `UIGroupComponent`의 `GroupType` 속성을 `EditorType`으로 설정하면, 해당 UI 그룹은 월드 플레이 상태나 월드 편집 상태(에디터 모드)에서만 표시되고 기능이 작동합니다. 일반 플레이 모드에서는 이 UI가 보이지 않습니다. 에디터 모드에서 UI를 통해 다른 엔티티의 프로퍼티를 수정하거나 API를 호출할 수 있습니다. 이때 주의할 점은 프로퍼티 저장 방식의 차이입니다. * **월드 플레이 중:** 플레이 종료 후 메이커로 복귀하면 프로퍼 [original] | UIGroupComponent의 **GroupType**을 변경해 에디터 타입의 UI를 구성할 수 있습니다. 에디터 타입 UI는 월드를 플레이하거나, 월드를 편집 중인 상태에서만 확인 및 기능 작동이 가능합니다. 간단한 예시를 통해 확인해보겠습니다. 1. UI 에디터를 엽니다. 2. 새로운 UIGroup을 추가합니다. 3. 추가한 UIGroup을 선택합니다. 4. 프로퍼티 에디터에서 UIGroupComponent의 GroupType을 **EditorType**으로 변경합 [chunk_id] | Guides:646:1
[task] | distill [title] | 배지 등록하기 [category] | Guides [rephrased] | # 아이템 배지 등록하기 배지는 크리에이터가 설정한 미션 달성 시 유저가 획득하는 업적입니다. 달성 목표 제시 및 수집 욕구 촉발 용도로 활용됩니다. ## 등록 방법 및 필수 항목 메이플스토리 월드 공식 홈페이지 또는 메이커(`Panels - Badge Viewer` > `Create New Badge`)에서 등록 가능합니다. 두 환경 모두 절차와 입력 항목이 동일합니다. | 항목 | 설명 및 제약 | | --- | --- | | **배지 등급** | `노멀`(획득 쉬움), `레어`(획득 어려움), `에픽`(획득 매우 어려움 [original] | # 학습 과정 소개 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. # 배지 등록하기 배지를 등록하는 방법은 두 가지입니다. 메이플스토리 월드 [공식 홈페이지](https://maplestoryworlds.nexon.com/) 혹은 메이커 내에서 등록이 가능합니다. 등록 화면과 절차는 동일하므로 크리에이터가 선호하는 곳에서 배지를 등록할 수 있습니다. [chunk_id] | Guides:656:0
[task] | diverse_qa [title] | 패키지의 활용 [category] | Guides [rephrased] | 질문: 메이플스토리 월드의 패키지 기능은 Workspace의 어떤 엔트리를 하나로 묶어 공유할 수 있게 해주나요? 답변: Workspace의 모델, 스크립트 컴포넌트, 데이터 셋과 같은 엔트리를 하나의 파일로 묶어 외부로 공유할 수 있습니다. 질문: 패키지 내보내기 및 불러오기 창에서 내용을 확인하는 두 가지 방식은 무엇인가요? 답변: 폴더 구조와 계층 구조 형태로 내용을 확인할 수 있습니다. 질문: 패키지 내보내기 창에서 '폴더 구조'는 엔트리를 어떻게 표시하나요? 답변: Workspace의 구조 대로 엔트리를 보여줍니다. [original] | # 학습 과정 소개 메이플스토리 월드에서는 Workspace의 모델, 스크립트 컴포넌트, 데이터 셋과 같은 엔트리를 하나의 파일로 묶어 외부로 공유할 수 있는 패키지 기능을 제공하고 있습니다. Workspace의 엔트리를 패키지 파일로 내보내거나, 패키지 파일을 월드에 불러오는 방법에 대해 알아봅니다. # 패키지 소개 패키지는 특정 엔트리를 묶은 파일입니다. 패키지 파일을 이용해 제작한 월드의 일부를 외부와 공유하거나, 타인이 공유한 패키지를 내 월드에 사용할 수 있습니다. 패키지 내보내기, 불러오기 창에서는 폴더 구조와 계층 [chunk_id] | Guides:647:0
[task] | distill [title] | 배지 등록하기 [category] | Guides [rephrased] | # 아이템 배지 등록하기 ## 배지 상태 배지는 총 5가지 상태로 구분됩니다. 메이커 테스트 시 모든 상태에서 획득 가능하지만, 실제 월드에서 획득하려면 상태가 **획득 가능**이어야 합니다. | 상태 | 설명 및 동작 규칙 | | --- | --- | | **미출시** | 출시 여부 '미출시' 설정 시. 판매 기간에도 웹/클라이언트 노출 불가, 획득 불가, 보유 리스트 확인 불가. | | **획득 대기** | 획득 기간 시작일 이전 등록 상태. 출시 상태일 경우 획득 시작일에 맞춰 자동으로 **획득 가능**으로 변경. | | [original] | 배지의 상태는 총 5개로 구분됩니다. 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 월드에서 실제로 획득하기 위해서는 배지의 상태가 **획득 가능**이어야 합니다. | 이름 | 설명 | | --- | --- | | 미출시 | 출시 여부를 '미출시'로 설정한 상태입니다. 판매 기간이 되어도 월드 웹 배지 페이지나 클라이언트 내에서도 노출되지 않고 획득도 불가합니다. 플레이어가 보유한 배지도 리스트에서 확인이 불가합니다.| | 획득 대기 | 획득 기간의 시작일 이전에 등록이 완료된 상태로 시작일에 맞춰 자동으로 획득 가 [chunk_id] | Guides:656:1
[task] | knowledge_list [title] | 패키지의 활용 [category] | Guides [rephrased] | 제시된 문서에 포함된 핵심 사실은 다음과 같습니다. 1. 메이플스토리 월드에서 제공하는 네이티브 스크립트와 네이티브 모델은 패키지로 내보낼 수 없습니다. 2. 네이티브 모델 자체에 새로운 컴포넌트를 추가하거나 네이티브 모델을 확장한 경우, 해당 모델은 패키지로 내보낼 수 없습니다. 3. 패키지로 내보내기 시 모든 정보가 복제되지 않아, 확장 모델이 상속받은 네이티브 모델의 추가 컴포넌트(예: ComponentA)가 다른 월드에 존재하지 않을 경우 의도대로 동작하지 않을 수 있기 때문입니다. 4. 확장한 네이티브 엔트리는 패키지로 [original] | 메이플스토리 월드에서 제공하는 **네이티브 스크립트와 네이티브 모델**은 패키지로 내보낼 수 없습니다. 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 그 네이티브 모델을 확장한 경우 또한 패키지로 내보낼 수 없습니다. 패키지를 불러올 때 모든 정보를 불러올 수 없기 때문입니다. 예를 들어 네이티브 모델에 ComponentA를 추가하고 이를 확장한 모델을 만들었다고 생각해 봅시다. 이 확장한 모델은 ComponentA를 상속받게 됩니다. 모델B를 다른 월드에서 불러올 때 새로운 월드에는 ComponentA가 포함된 네이티브 [chunk_id] | Guides:647:1
[task] | extract_knowledge [title] | 패키지의 활용 [category] | Guides [rephrased] | # 메이플스토리 월드 패키지 활용 가이드 ## 1. 개념 설명 메이플스토리 월드(MapleStory Worlds)의 **패키지(Package)** 기능은 Workspace 내의 모델(Model), 스크립트 컴포넌트, 데이터 셋 등 다양한 엔트리를 단일 파일로 묶어 외부로 공유하거나 다른 월드에 가져오는 것을 가능하게 하는 기능입니다. 패키지 내보내기 및 불러오기 창에서는 패키지 내용을 두 가지 방식으로 확인할 수 있습니다. * **폴더 구조**: Workspace의 실제 디렉터리 구조와 동일하게 엔트리를 표시합니다. * [original] | # 학습 과정 소개 메이플스토리 월드에서는 Workspace의 모델, 스크립트 컴포넌트, 데이터 셋과 같은 엔트리를 하나의 파일로 묶어 외부로 공유할 수 있는 패키지 기능을 제공하고 있습니다. Workspace의 엔트리를 패키지 파일로 내보내거나, 패키지 파일을 월드에 불러오는 방법에 대해 알아봅니다. # 패키지 소개 패키지는 특정 엔트리를 묶은 파일입니다. 패키지 파일을 이용해 제작한 월드의 일부를 외부와 공유하거나, 타인이 공유한 패키지를 내 월드에 사용할 수 있습니다. 패키지 내보내기, 불러오기 창에서는 폴더 구조와 계층 [chunk_id] | Guides:647:0
[task] | distill [title] | 패키지의 활용 [category] | Guides [rephrased] | # 메이커 사용 패키지의 활용 ## 패키지 내보내기 제한 및 규칙 패키지는 **네이티브 스크립트**와 **네이티브 모델**을 포함할 수 없습니다. 또한, 네이티브 모델에 새 컴포넌트를 추가하거나 이를 확장한 모델 역시 내보낼 수 없습니다. * **제한 원인**: 다른 월드로 패키지를 가져올 때, 대상 월드에 해당 네이티브 모델의 컴포넌트(예: `ComponentA`)가 존재하지 않아 의도하지 않은 결과가 발생하기 때문입니다. * **예외**: **확장한 네이티브 엔트리**는 패키지로 내보낼 수 있습니다. 확장 엔트리가 원 [original] | 메이플스토리 월드에서 제공하는 **네이티브 스크립트와 네이티브 모델**은 패키지로 내보낼 수 없습니다. 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 그 네이티브 모델을 확장한 경우 또한 패키지로 내보낼 수 없습니다. 패키지를 불러올 때 모든 정보를 불러올 수 없기 때문입니다. 예를 들어 네이티브 모델에 ComponentA를 추가하고 이를 확장한 모델을 만들었다고 생각해 봅시다. 이 확장한 모델은 ComponentA를 상속받게 됩니다. 모델B를 다른 월드에서 불러올 때 새로운 월드에는 ComponentA가 포함된 네이티브 [chunk_id] | Guides:647:1
[task] | knowledge_list [title] | 배지 등록하기 [category] | Guides [rephrased] | * 배지의 상태는 총 5가지로 구분되며, 메이커에서 테스트 시에는 모든 상태에서 획득이 가능하지만, 실제 월드에서 획득하려면 상태가 **획득 가능**이어야 합니다. * **미출시** 상태는 출시 여부를 '미출시'로 설정한 상태로, 판매 기간이 도래해도 월드 웹 배지 페이지나 클라이언트 내 노출이 되지 않으며 획득이 불가하고 플레이어가 보유한 배지도 리스트에서 확인되지 않습니다. * **획득 대기** 상태는 획득 기간의 시작일 이전에 등록이 완료된 상태로, 출시 상태에서 획득 기간을 지정하면 획득 시작일에 맞춰 자동으로 **획득 가능 [original] | 배지의 상태는 총 5개로 구분됩니다. 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 월드에서 실제로 획득하기 위해서는 배지의 상태가 **획득 가능**이어야 합니다. | 이름 | 설명 | | --- | --- | | 미출시 | 출시 여부를 '미출시'로 설정한 상태입니다. 판매 기간이 되어도 월드 웹 배지 페이지나 클라이언트 내에서도 노출되지 않고 획득도 불가합니다. 플레이어가 보유한 배지도 리스트에서 확인이 불가합니다.| | 획득 대기 | 획득 기간의 시작일 이전에 등록이 완료된 상태로 시작일에 맞춰 자동으로 획득 가 [chunk_id] | Guides:656:1
[task] | wikipedia [title] | 배지 등록하기 [category] | Guides [rephrased] | ## 아이템 배지 등록하기 메이플스토리 월드(MapleStory Worlds)에서 아이템 배지는 총 5가지의 상태로 관리됩니다. 메이커(Maker) 환경에서 테스트를 수행하는 경우, 배지의 상태와 무관하게 모든 배지를 획득할 수 있습니다. 그러나 실제 월드(World) 환경에서 플레이어가 배지를 획득하려면 배지의 상태가 **획득 가능**으로 설정되어 있어야 합니다. 배지의 상태별 정의와 동작은 다음과 같습니다. 첫째, **미출시** 상태는 출시 여부를 '미출시'로 설정한 경우를 의미합니다. 이 상태에서는 판매 기간이 도래하더라 [original] | 배지의 상태는 총 5개로 구분됩니다. 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 월드에서 실제로 획득하기 위해서는 배지의 상태가 **획득 가능**이어야 합니다. | 이름 | 설명 | | --- | --- | | 미출시 | 출시 여부를 '미출시'로 설정한 상태입니다. 판매 기간이 되어도 월드 웹 배지 페이지나 클라이언트 내에서도 노출되지 않고 획득도 불가합니다. 플레이어가 보유한 배지도 리스트에서 확인이 불가합니다.| | 획득 대기 | 획득 기간의 시작일 이전에 등록이 완료된 상태로 시작일에 맞춰 자동으로 획득 가 [chunk_id] | Guides:656:1
[task] | wikipedia [title] | 패키지의 활용 [category] | Guides [rephrased] | # 메이커 사용 패키지의 활용 메이플스토리 월드(MapleStory Worlds)에서 제공하는 네이티브 스크립트와 네이티브 모델은 패키지로 내보낼 수 없습니다. 또한, 네이티브 모델 자체에 새로운 컴포넌트를 추가하거나 네이티브 모델을 확장한 경우에도 패키지로 내보내는 것이 불가능합니다. 이는 패키지를 불러오는 과정에서 모든 정보를 완전히 복원할 수 없기 때문입니다. 예를 들어, 네이티브 모델에 `ComponentA`를 추가하고 이를 기반으로 확장된 모델을 생성했다고 가정해 보겠습니다. 이 확장된 모델은 `ComponentA`를 [original] | 메이플스토리 월드에서 제공하는 **네이티브 스크립트와 네이티브 모델**은 패키지로 내보낼 수 없습니다. 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 그 네이티브 모델을 확장한 경우 또한 패키지로 내보낼 수 없습니다. 패키지를 불러올 때 모든 정보를 불러올 수 없기 때문입니다. 예를 들어 네이티브 모델에 ComponentA를 추가하고 이를 확장한 모델을 만들었다고 생각해 봅시다. 이 확장한 모델은 ComponentA를 상속받게 됩니다. 모델B를 다른 월드에서 불러올 때 새로운 월드에는 ComponentA가 포함된 네이티브 [chunk_id] | Guides:647:1
[task] | wikipedia [title] | 패키지의 활용 [category] | Guides [rephrased] | # 메이플스토리 월드 메이커 사용 패키지의 활용 메이플스토리 월드(MapleStory Worlds)는 Workspace 내의 모델, 스크립트 컴포넌트, 데이터셋 등 다양한 엔트리를 하나의 파일로 묶어 외부로 공유할 수 있는 패키지 기능을 제공합니다. 이 문서는 Workspace의 엔트리를 패키지 파일로 내보내는 방법과, 외부에서 공유받은 패키지 파일을 자신의 월드에 불러오는 방법에 대한 학습 과정을 소개합니다. ## 패키지 개요 패키지는 특정 엔트리들을 묶은 파일 형식입니다. 이 파일을 통해 제작 중인 월드의 일부를 타인과 공 [original] | # 학습 과정 소개 메이플스토리 월드에서는 Workspace의 모델, 스크립트 컴포넌트, 데이터 셋과 같은 엔트리를 하나의 파일로 묶어 외부로 공유할 수 있는 패키지 기능을 제공하고 있습니다. Workspace의 엔트리를 패키지 파일로 내보내거나, 패키지 파일을 월드에 불러오는 방법에 대해 알아봅니다. # 패키지 소개 패키지는 특정 엔트리를 묶은 파일입니다. 패키지 파일을 이용해 제작한 월드의 일부를 외부와 공유하거나, 타인이 공유한 패키지를 내 월드에 사용할 수 있습니다. 패키지 내보내기, 불러오기 창에서는 폴더 구조와 계층 [chunk_id] | Guides:647:0
[task] | diverse_qa [title] | 패키지의 활용 [category] | Guides [rephrased] | 질문: 메이플스토리 월드에서 네이티브 스크립트와 네이티브 모델을 패키지로 내보낼 수 있나요? 답변: 네이티브 스크립트와 네이티브 모델은 패키지로 내보낼 수 없습니다. 질문: 네이티브 모델에 새로운 컴포넌트를 추가하거나 모델을 확장한 경우 패키지로 내보낼 수 있나요? 답변: 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 또는 그 네이티브 모델을 확장한 경우 패키지로 내보낼 수 없습니다. 질문: 네이티브 모델을 확장한 모델이 패키지로 내보내기를 불가능하게 만드는 원인은 무엇인가요? 답변: 패키지를 불러올 때 모든 정보를 불러 [original] | 메이플스토리 월드에서 제공하는 **네이티브 스크립트와 네이티브 모델**은 패키지로 내보낼 수 없습니다. 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 그 네이티브 모델을 확장한 경우 또한 패키지로 내보낼 수 없습니다. 패키지를 불러올 때 모든 정보를 불러올 수 없기 때문입니다. 예를 들어 네이티브 모델에 ComponentA를 추가하고 이를 확장한 모델을 만들었다고 생각해 봅시다. 이 확장한 모델은 ComponentA를 상속받게 됩니다. 모델B를 다른 월드에서 불러올 때 새로운 월드에는 ComponentA가 포함된 네이티브 [chunk_id] | Guides:647:1
[task] | diverse_qa [title] | 배지 등록하기 [category] | Guides [rephrased] | 질문: 배지의 상태는 총 몇 개로 구분되는가? 답변: 배지의 상태는 총 5개로 구분됩니다. 질문: 메이커에서 배지를 테스트할 때 상태에 따라 획득이 제한되는가? 답변: 아니오, 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 질문: 월드에서 실제로 배지를 획득하기 위해 배지 상태는 어떻게 되어야 하는가? 답변: 월드에서 실제로 획득하기 위해서는 배지의 상태가 '획득 가능'이어야 합니다. 질문: '미출시' 상태의 배지는 판매 기간이 되어도 클라이언트 내 배지 페이지에 노출되는가? 답변: 아니오, '미출시' 상태로 설 [original] | 배지의 상태는 총 5개로 구분됩니다. 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 월드에서 실제로 획득하기 위해서는 배지의 상태가 **획득 가능**이어야 합니다. | 이름 | 설명 | | --- | --- | | 미출시 | 출시 여부를 '미출시'로 설정한 상태입니다. 판매 기간이 되어도 월드 웹 배지 페이지나 클라이언트 내에서도 노출되지 않고 획득도 불가합니다. 플레이어가 보유한 배지도 리스트에서 확인이 불가합니다.| | 획득 대기 | 획득 기간의 시작일 이전에 등록이 완료된 상태로 시작일에 맞춰 자동으로 획득 가 [chunk_id] | Guides:656:1
[task] | knowledge_list [title] | 배지 등록하기 [category] | Guides [rephrased] | 제시된 문서에는 mLua 스크립트 API(함수, 메서드, 이벤트 핸들러 등)에 대한 기술적 정의가 포함되어 있지 않습니다. 따라서 요청하신 "API 이름·매개변수·반환 타입·동기화/서버·클라이언트 제약"을 명시하는 항목은 원문에 존재하지 않으며, 지어낼 수 없습니다. 대신, 문서에 명시된 **배지(Badge) 시스템의 기능적 사실과 설정 항목**들을 빠짐없이 추출하여 목록으로 정리합니다. ### 배지 시스템 핵심 사실 목록 1. 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적이며, 유저의 달성 [original] | # 학습 과정 소개 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. # 배지 등록하기 배지를 등록하는 방법은 두 가지입니다. 메이플스토리 월드 [공식 홈페이지](https://maplestoryworlds.nexon.com/) 혹은 메이커 내에서 등록이 가능합니다. 등록 화면과 절차는 동일하므로 크리에이터가 선호하는 곳에서 배지를 등록할 수 있습니다. [chunk_id] | Guides:656:0
[task] | distill [title] | 헤어 만들기 [category] | Guides [rephrased] | # 헤어 아이템 제작 가이드 ## 개요 및 준비 * **난이도**: 복잡한 구조로, 바지·신발 제작 후 도전 권장. * **필요 도구**: Adobe Photoshop. * **소스 파일**: `Avatar_Hair.psd` 다운로드 필수. * **추천 해상도**: 아바타 발 기준 최대 **120x120** 픽셀 이내. * **헤어 종류**: 짧은 헤어, 긴 헤어. ## 시트 구조 및 규칙 시트는 **회색 레이어(잠김/수정 불가)**와 **노란색 레이어(작업 영역)**로 구성됩니다. > **주의**: 모든 레이 [original] | # 학습 과정 소개 헤어 제작 방법을 알아봅시다. 기본 헤어의 색상을 변경하거나, 새롭게 그릴 수 있습니다. 헤어는 복잡한 구조로 바지나 신발 아이템 제작에 익숙해진 후 작업하는 걸 권장합니다. [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D)을 참고해 아바타의 기본 개념을 먼저 숙지하길 바랍니다. # 사전 준비 아이템 제작을 위해선 Adobe Photoshop이 필요합니다. 해당 소프트웨어를 설치한 후 아래 파일을 받아 엽니다. $$attachFile [chunk_id] | Guides:657:0
[task] | wikipedia [title] | 배지 등록하기 [category] | Guides [rephrased] | # 배지 등록하기 배지(Badge)는 크리에이터가 정의한 특정 미션을 달성했을 때 이용자가 획득할 수 있는 업적 시스템입니다. 이 시스템은 이용자가 달성해야 할 목표를 명확히 제시하거나, 수집 욕구를 자극하여 월드에 대한 지속적인 관심을 유도하는 목적으로 활용됩니다. ## 등록 방법 및 필수 입력 항목 배지는 메이플스토리 월드 공식 홈페이지(https://maplestoryworlds.nexon.com/) 또는 메이커(Maker) 환경 내에서 등록할 수 있습니다. 두 플랫폼의 등록 화면과 절차는 동일하므로, 크리에이터의 선호에 [original] | # 학습 과정 소개 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. # 배지 등록하기 배지를 등록하는 방법은 두 가지입니다. 메이플스토리 월드 [공식 홈페이지](https://maplestoryworlds.nexon.com/) 혹은 메이커 내에서 등록이 가능합니다. 등록 화면과 절차는 동일하므로 크리에이터가 선호하는 곳에서 배지를 등록할 수 있습니다. [chunk_id] | Guides:656:0
[task] | knowledge_list [title] | 헤어 만들기 [category] | Guides [rephrased] | 제시된 문서에는 mLua 스크립트 언어, API 명세, 코드 예제, 함수 매개변수, 반환 타입, 또는 서버/클라이언트 동기화 제약 사항이 포함되어 있지 않습니다. 문서는 **메이플스토리 월드 아바타 아이템(헤어) 제작을 위한 그래픽 에셋(PSD) 작업 가이드**로, 소프트웨어 도구(Adobe Photoshop), 파일 구조(레이어/폴더), 그리고 이미지 제작 규격에 대한 정보만 담고 있습니다. 따라서 요청하신 "mLua API 이름·매개변수·반환 타입·동기화/서버·클라이언트 제약을 명시한 핵심 사실"은 원문에 존재하지 않습니다. [original] | # 학습 과정 소개 헤어 제작 방법을 알아봅시다. 기본 헤어의 색상을 변경하거나, 새롭게 그릴 수 있습니다. 헤어는 복잡한 구조로 바지나 신발 아이템 제작에 익숙해진 후 작업하는 걸 권장합니다. [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D)을 참고해 아바타의 기본 개념을 먼저 숙지하길 바랍니다. # 사전 준비 아이템 제작을 위해선 Adobe Photoshop이 필요합니다. 해당 소프트웨어를 설치한 후 아래 파일을 받아 엽니다. $$attachFile [chunk_id] | Guides:657:0
[task] | extract_knowledge [title] | 배지 등록하기 [category] | Guides [rephrased] | # 아이템 배지 상태 및 등록 규칙 ## 개념 설명 메이플스토리 월드의 아이템 배지 시스템은 배지의 현재 상황을 나타내는 5가지 상태로 구분됩니다. 각 상태는 플레이어의 획득 가능성 및 클라이언트 내 노출 여부에 직접적인 영향을 미칩니다. 1. **미출시**: 출시 여부 설정이 '미출시'인 상태입니다. 판매 기간이 도래했더라도 월드 웹 배지 페이지나 클라이언트에서 노출되지 않으며, 획득이 불가능합니다. 이미 배지를 보유한 플레이어의 경우에도 리스트에서 해당 배지가 확인되지 않습니다. 2. **획득 대기**: 획득 기간의 시작일 [original] | 배지의 상태는 총 5개로 구분됩니다. 메이커에서 테스트할 때는 모든 상태에서 획득할 수 있습니다. 월드에서 실제로 획득하기 위해서는 배지의 상태가 **획득 가능**이어야 합니다. | 이름 | 설명 | | --- | --- | | 미출시 | 출시 여부를 '미출시'로 설정한 상태입니다. 판매 기간이 되어도 월드 웹 배지 페이지나 클라이언트 내에서도 노출되지 않고 획득도 불가합니다. 플레이어가 보유한 배지도 리스트에서 확인이 불가합니다.| | 획득 대기 | 획득 기간의 시작일 이전에 등록이 완료된 상태로 시작일에 맞춰 자동으로 획득 가 [chunk_id] | Guides:656:1
[task] | diverse_qa [title] | 배지 등록하기 [category] | Guides [rephrased] | 질문: 배지는 무엇을 의미합니까? 답변: 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 질문: 배지는 주로 어떤 용도로 사용됩니까? 답변: 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. 질문: 배지를 등록하는 방법은 총 몇 가지이며, 각각 어디에서 가능한가요? 답변: 배지를 등록하는 방법은 두 가지이며, 메이플스토리 월드 공식 홈페이지 또는 메이커 내에서 등록할 수 있습니다. 질문: 배지를 등록할 [original] | # 학습 과정 소개 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. # 배지 등록하기 배지를 등록하는 방법은 두 가지입니다. 메이플스토리 월드 [공식 홈페이지](https://maplestoryworlds.nexon.com/) 혹은 메이커 내에서 등록이 가능합니다. 등록 화면과 절차는 동일하므로 크리에이터가 선호하는 곳에서 배지를 등록할 수 있습니다. [chunk_id] | Guides:656:0
[task] | extract_knowledge [title] | 에디터 서비스의 활용 [category] | Guides [rephrased] | # 에디터 서비스(EditorService) 활용 가이드 ## 1. 개념 설명 메이플스토리 월드의 스크립트 환경에서는 데이터 접근 및 수정을 위해 **DataService**와 **EditorService**를 함께 사용합니다. * **DataService**: 테이블 형태의 데이터에 접근하여 값을 읽는(`Get`) 기능을 제공합니다. * **EditorService**: 데이터에 접근하여 값을 읽고 쓰는 기능을 제공하며, 특히 데이터를 수정(Insert, Remove, Set)하기 위한 API를 지원합니다. `Spa [original] | **SpawnService**를 이용해 엔티티 배치하거나 프로퍼티 값을 수정해 변경된 값을 저장할 수 있습니다. 프로퍼티의 값을 수정 및 제어할 수 있다는 의미는 많은 정보를 수정할 수 있다는 의미를 내포하나, 복잡한 정보를 저장하기에는 충분하지 않을 수 있습니다. **EditorService**는 데이터에 접근하여 값을 읽고 쓸 수 있는 기능을 제공합니다.아래와 같이 데이터를 구성했다고 가정해보겠습니다. dash의 col3 컬럼의 값을 가져오기 위해 아래와 같이 작성해 활용할 수 있습니다. ```lua local data [chunk_id] | Guides:646:3
[task] | extract_knowledge [title] | 배지 등록하기 [category] | Guides [rephrased] | # 배지 시스템 (Badge System) ## 1. 개념 설명 배지(Badge)는 크리에이터가 설정한 특정 미션을 달성했을 때 이용자가 획득할 수 있는 업적 시스템입니다. 이는 유저의 달성 목표를 시각적으로 제시하거나, 수집 욕구를 자극하여 월드 내 재방문 및 지속적 참여를 유도하는 용도로 사용됩니다. 배지는 다음 세 가지 등급 중 하나로 분류되며, 크리에이터가 난도 기준에 따라 정의합니다. * **노멀 (Normal)**: 획득 난도가 쉬운 업적. * **레어 (Rare)**: 도달 난도가 어려운 업적. * **에 [original] | # 학습 과정 소개 배지는 크리에이터가 설정한 특정 미션을 달성할 때 이용자가 획득할 수 있는 업적을 의미합니다. 배지는 유저의 달성 목표를 보여주기 위해 사용하거나, 수집 욕구를 촉발해 월드를 끊임없이 즐길 수 있게 만드는 용도로 사용합니다. # 배지 등록하기 배지를 등록하는 방법은 두 가지입니다. 메이플스토리 월드 [공식 홈페이지](https://maplestoryworlds.nexon.com/) 혹은 메이커 내에서 등록이 가능합니다. 등록 화면과 절차는 동일하므로 크리에이터가 선호하는 곳에서 배지를 등록할 수 있습니다. [chunk_id] | Guides:656:0
[task] | distill [title] | 헤어 만들기 [category] | Guides [rephrased] | # 헤어 아이템 제작 ## 작업 레이어 아바타 헤어는 다음 3개 레이어에서 이미지 작업을 수행합니다. * `edithere:back_backHair_91`: 기본 헤어 형태 * `edithere:back_backHairBelowCapWide_94`: 모자 아래 넓은 머리 * `edithere:back_backHairBelowCapNarrow_95`: 모자 아래 좁은 머리 ## 제작 단계 1. **기본 형태 그리기**: `edithere:back_backHair_91` 레이어에서 Pencil tool로 검정색으로 기 [original] | edithere:back_backHair_91, edithere:back_backHairBelowCapWide_94, edithere:back_backHairBelowCapNarrow_95 레이어에 이미지 작업을 합니다. 1. edithere:back_backHair_91에 'Pencil tool'로 기본 모양을 검정색으로 그린 뒤 색상을 변경하고, 세부 헤어 모양을 그립니다. 2. edithere:back_backHairBelowCapWide_94 레이어에 눌린 머리를 두상에 맞게 지워줍니다. 3. 2번을 복사하여 edit [chunk_id] | Guides:657:3
[task] | distill [title] | 헤어 만들기 [category] | Guides [rephrased] | # 헤어 아이템 제작 가이드 (아바타) 헤어는 자세별 케이스(`case1`, `case2.front_proneStab`, `case3.back`)로 나뉘며, 각 케이스는 모자 착용 여부(`NoCap`/`WithCap`)에 따라 레이어 구성이 달라집니다. ## 1. case1 (기본 자세) ### NoCap 폴더 (모자 미착용) * **guide_cap_samples**: 기본 헤어(머리 모양 변형 없음)용 모자 샘플. * **edithere:front_hairOverHead_31**: 헤어 앞모습 그리기 레이어. ## [original] | 1. NoCap 폴더 헤어의 앞모습을 그릴 레이어와 모자 샘플을 포함한 폴더입니다. [모자 만들기](/docs?postId=592) vslot의 3번 유형에 해당하는 모자 샘플입니다. * **guide_cap_samples**: 기본 헤어로 머리 모양이 변하지 않는 모자 샘플이 포함되어 있습니다. * **edithere:front_hairOverHead_31**: 헤어의 앞모습을 그릴 수 있는 레이어입니다. 2. WithCap 폴더 모자를 썼을 때 눌리는 헤어의 앞모습을 그릴 레이어와 해당하는 종류의 모자 샘플들이 [chunk_id] | Guides:657:1
[task] | wikipedia [title] | 헤어 만들기 [category] | Guides [rephrased] | # 헤어 만들기 이 문서는 메이플스토리 월드의 아바타 아이템 중 헤어(머리)를 제작하는 방법을 안내합니다. 헤어 아이템은 특정 레이어에 이미지를 배치하고 편집하는 방식으로 제작되며, 주로 `edithere:back_backHair_91`, `edithere:back_backHairBelowCapWide_94`, `edithere:back_backHairBelowCapNarrow_95` 세 가지 레이어를 사용합니다. ## 제작 단계 헤어 아이템의 기본 형태를 만드는 과정은 다음 단계로 진행됩니다. 첫째, `edithere:ba [original] | edithere:back_backHair_91, edithere:back_backHairBelowCapWide_94, edithere:back_backHairBelowCapNarrow_95 레이어에 이미지 작업을 합니다. 1. edithere:back_backHair_91에 'Pencil tool'로 기본 모양을 검정색으로 그린 뒤 색상을 변경하고, 세부 헤어 모양을 그립니다. 2. edithere:back_backHairBelowCapWide_94 레이어에 눌린 머리를 두상에 맞게 지워줍니다. 3. 2번을 복사하여 edit [chunk_id] | Guides:657:3
[task] | wikipedia [title] | 헤어 만들기 [category] | Guides [rephrased] | # 아바타 헤어 아이템 제작 가이드 본 문서는 메이플스토리 월드에서 아바타 헤어 아이템을 제작하는 방법에 대해 설명합니다. 크리에이터는 기존 기본 헤어의 색상을 변경하거나, 새로운 헤어 디자인을 직접 그릴 수 있습니다. 헤어는 구조가 복잡하므로, 바지나 신발 아이템 제작에 익숙해진 이후에 작업을 시작하는 것이 권장됩니다. 시작 전에 [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D) 문서를 참고하여 아바타 시스템의 기초를 숙지하시기 바랍니다. ## 사전 준비 [original] | # 학습 과정 소개 헤어 제작 방법을 알아봅시다. 기본 헤어의 색상을 변경하거나, 새롭게 그릴 수 있습니다. 헤어는 복잡한 구조로 바지나 신발 아이템 제작에 익숙해진 후 작업하는 걸 권장합니다. [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D)을 참고해 아바타의 기본 개념을 먼저 숙지하길 바랍니다. # 사전 준비 아이템 제작을 위해선 Adobe Photoshop이 필요합니다. 해당 소프트웨어를 설치한 후 아래 파일을 받아 엽니다. $$attachFile [chunk_id] | Guides:657:0
[task] | diverse_qa [title] | 헤어 만들기 [category] | Guides [rephrased] | 질문: 헤어 아이템 제작 시 권장되는 최대 해상도(크기)는 얼마인가요? 답변: 헤어는 아바타 발을 기준으로 최대 120x120 안에서 제작하는 것이 권장됩니다. 질문: 헤어 제작에 필요한 소프트웨어는 무엇이며, 어떤 파일을 받아야 하나요? 답변: Adobe Photoshop이 필요하며, 'Avatar_Hair.psd' 파일을 받아 엽니다. 질문: 헤어는 크게 어떤 두 가지 종류로 구분되나요? 답변: 헤어는 짧은 헤어와 긴 헤어로 구분됩니다. 질문: 헤어 제작 시트에서 회색 레이어와 노란색 레이어의 역할은 각각 무엇인가요? 답변 [original] | # 학습 과정 소개 헤어 제작 방법을 알아봅시다. 기본 헤어의 색상을 변경하거나, 새롭게 그릴 수 있습니다. 헤어는 복잡한 구조로 바지나 신발 아이템 제작에 익숙해진 후 작업하는 걸 권장합니다. [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D)을 참고해 아바타의 기본 개념을 먼저 숙지하길 바랍니다. # 사전 준비 아이템 제작을 위해선 Adobe Photoshop이 필요합니다. 해당 소프트웨어를 설치한 후 아래 파일을 받아 엽니다. $$attachFile [chunk_id] | Guides:657:0
[task] | extract_knowledge [title] | 헤어 만들기 [category] | Guides [rephrased] | # 헤어 아이템 제작 가이드 본 절에서는 메이플스토리 월드 아바타 시스템에서 헤어 아이템을 제작하기 위한 시트 구조, 레이어 구성 및 제약 사항을 설명합니다. 헤어는 복잡한 구조를 가지므로, 바지나 신발 아이템 제작에 익숙해진 후 작업하는 것을 권장합니다. ## 1. 개념 및 사전 준비 헤어 아이템은 Adobe Photoshop을 사용하여 `Avatar_Hair.psd` 파일을 기반으로 제작됩니다. 헤어는 크게 **짧은 헤어**와 **긴 헤어**로 구분됩니다. * **크기 제한**: 헤어를 아바타 발을 기준으로 최대 ** [original] | # 학습 과정 소개 헤어 제작 방법을 알아봅시다. 기본 헤어의 색상을 변경하거나, 새롭게 그릴 수 있습니다. 헤어는 복잡한 구조로 바지나 신발 아이템 제작에 익숙해진 후 작업하는 걸 권장합니다. [아바타 아이템 제작의 기본 개념](/docs?postId=588%7B%22target%22:%22_self%22%7D)을 참고해 아바타의 기본 개념을 먼저 숙지하길 바랍니다. # 사전 준비 아이템 제작을 위해선 Adobe Photoshop이 필요합니다. 해당 소프트웨어를 설치한 후 아래 파일을 받아 엽니다. $$attachFile [chunk_id] | Guides:657:0
[task] | knowledge_list [title] | 헤어 만들기 [category] | Guides [rephrased] | 제시된 원문은 메이플스토리 월드(MapleStory Worlds)의 mLua 스크립트 언어나 API 문서가 아닌, **그래픽 에디터(Adobe Animate 등)를 활용한 아바타 헤어 이미지 제작 가이드**입니다. 따라서 요청하신 "mLua API 이름, 매개변수, 반환 타입, 동기화/서버·클라이언트 제약"에 해당하는 기술적 사실은 원문에 존재하지 않습니다. 원문에 명시된 정보만 바탕으로 핵심 사실을 정리하면 다음과 같습니다. 1. 헤어 이미지 작업은 `edithere:back_backHair_91`, `edithere:back [original] | edithere:back_backHair_91, edithere:back_backHairBelowCapWide_94, edithere:back_backHairBelowCapNarrow_95 레이어에 이미지 작업을 합니다. 1. edithere:back_backHair_91에 'Pencil tool'로 기본 모양을 검정색으로 그린 뒤 색상을 변경하고, 세부 헤어 모양을 그립니다. 2. edithere:back_backHairBelowCapWide_94 레이어에 눌린 머리를 두상에 맞게 지워줍니다. 3. 2번을 복사하여 edit [chunk_id] | Guides:657:3
[task] | knowledge_list [title] | 헤어 만들기 [category] | Guides [rephrased] | 제시된 원문은 '아바타 아이템 제작 헤어 만들기'에 관한 **그래픽/에셋 제작 가이드**입니다. 요청하신 조건에 따라, 원문에 명시된 **API, 코드, 서버/클라이언트 실행 공간, 동기화 속성 등 mLua 스크립트 관련 기술적 사실이 존재하지 않습니다.** 따라서 mLua 스크립트 관점의 핵심 사실 추출은 불가능하며, 원문에 포함된 **에셋 레이어 이름 및 그래픽 작업 지침**만 사실 기반으로 정리합니다. 원문에 포함된 에셋/레이어 명칭과 작업 규칙은 다음과 같습니다. 1. `guide_cap_samples` 에셋은 기본 헤어 [original] | 1. NoCap 헤어의 뒷모습을 그릴 수 있는 레이어와 모자 샘플이 포함되어 있습니다. [모자 만들기](/docs?postId=592) vslot의 3번 유형에 해당하는 모자 샘플입니다. * **guide_cap_samples**: 기본 헤어로 머리 모양이 변하지 않는 모자 샘플이 포함되어 있습니다. * **edithere:back_backHair_91**: 헤어의 뒷모습을 그릴 수 있는 레이어입니다. 앞모습에서는 별도의 레이어에 그린 긴 머리를 함께 그려야합니다 2. WithCap 모자를 썼을 때 눌리는 헤어의 [chunk_id] | Guides:657:2
[task] | extract_knowledge [title] | 패키지의 활용 [category] | Guides [rephrased] | # 메이플스토리 월드 패키지 활용 및 가져오기 규칙 ## 1. 개념 설명 메이플스토리 월드에서는 제작된 콘텐츠를 다른 월드에서 재사용하기 위해 **패키지(Package)** 형태로 내보내고 가져오는 기능을 제공합니다. 그러나 모든 콘텐츠가 패키지로 내보내질 수 있는 것은 아니며, **네이티브(Native) 자산**의 특성에 따라 제한이 존재합니다. ### 네이티브 자산의 패키지 내보내기 제한 * **네이티브 스크립트 및 네이티브 모델**: 패키지로 내보낼 수 없습니다. * **네이티브 모델 확장**: 네이티브 모델 자체 [original] | 메이플스토리 월드에서 제공하는 **네이티브 스크립트와 네이티브 모델**은 패키지로 내보낼 수 없습니다. 네이티브 모델 자체에 새로운 컴포넌트를 추가한 경우, 그 네이티브 모델을 확장한 경우 또한 패키지로 내보낼 수 없습니다. 패키지를 불러올 때 모든 정보를 불러올 수 없기 때문입니다. 예를 들어 네이티브 모델에 ComponentA를 추가하고 이를 확장한 모델을 만들었다고 생각해 봅시다. 이 확장한 모델은 ComponentA를 상속받게 됩니다. 모델B를 다른 월드에서 불러올 때 새로운 월드에는 ComponentA가 포함된 네이티브 [chunk_id] | Guides:647:1