[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | Play [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1280 [text] | # 학습 과정 소개 제작한 월드를 테스트할 수 있는 Play 창에 대해 알아봅시다. #### 참고 가이드 * [Scene](/docs/?postId=1152) * [Workspace](/docs/?postId=121) * [Hierarchy](/docs/?postId=453) * [프로퍼티 에디터](/docs/?postId=1087) * [UI 에디터 활용과 제어](/docs/?postId=120) # Play Play 창은 만든 월드를 테스트할 때 사용합니다. **[시작]** 버튼을 눌러 플레이 테스트를 실행했을 때만 활성화
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | mLua [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1287 [text] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니다.
[category] | Guides [section] | 제작 시 준수 사항 [title] | 비정상 거래 대응 가이드 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1299 [text] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상
[category] | Guides [section] | Effective MSW [title] | FastVector3을 활용한 월드 최적화 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1300 [text] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은 다음과
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 개념 이해 [title] | 로컬화된 Entity [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1301 [text] | # 학습 과정 소개 클라이언트에서만 생성되는 로컬화된 엔티티에 대해 알아봅시다. ##### 참고 가이드 [서버와 클라이언트](/docs?postId=207) [예시로 알아보는 서버 검증](/docs?postId=1084) [패킷 변조 대비하기](/docs?postId=1102) [Effective MSW 2](/docs/?postId=560) # 로컬화된 엔티티 **로컬화된 엔티티(Localized Entity)**란 클라이언트에서만 생성되는 엔티티를 의미합니다. Hierarchy 창에서는 ![[object Object]](ht
[category] | Guides [section] | 기본 제작 가이드 > 게임 서비스 > 유료화 [title] | 월드코인 정산 비율 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1302 [text] | # 학습 과정 소개 이번 과정에서는 크리에이터가 판매한 월드 상품과 아바타 상품(‘크리에이터 제작 콘텐츠’를 의미하며 이하 ‘CGC 상품’)이 어떻게 수익으로 전환되는지 알아봅시다. 메이플스토리 월드에서 CGC 상품을 판매하시면 일정한 정산 비율을 거쳐 크리에이터 수익으로 적립해 드립니다. 자세한 정산 비율은 아래 항목을 참고해 주세요. # 월드코인 정산 비율 메이플스토리 월드는 CGC 상품 판매 금액의 65%를 공제한 후, 35%를 USD로 크리에이터님께 정산해 드립니다. 자세한 정산 비율은 아래 그래프를 참고해 주세요. *
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | 월드 출시하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1321 [text] | # 학습 과정 소개 월드 출시를 위해 준비해야 할 항목들을 알아봅시다. # 월드 출시 월드 출시의 최종 목표는 모든 유저에게 월드를 공개하는 것입니다. 그러나 제작 중인 월드를 곧바로 모두에게 공개하는 것은 위험하므로 단계별로 출시를 진행하기를 권장합니다. 메이플스토리 월드에서의 출시는 3단계로 나눌 수 있습니다. 먼저 제작 중인 월드를 **비공개**로 출시해 데이터 저장, 월드 워프 등의 구현한 기능이 정상 동작하는지 확인합니다. 여러 번의 비공개 출시와 테스트를 거쳐 월드를 완성했다면, 두 번째 단계로 **공개 예정** 출시를
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 게임 로직 [title] | 동적으로 맵 생성, 파괴하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1322 [text] | # 학습 과정 소개 맵을 동적으로 생성, 파괴하는 방법을 알아봅시다. ##### 참고 가이드 * [월드 인스턴스](/docs?postId=984) * [인스턴스 맵 만들기](/docs/?postId=540) * [DynamicMapService](/apiReference/Services/DynamicMapService) * [DynamicMapResultCode](/apiReference/Enums/DynamicMapResultCode) # 원본 맵 원본 맵이란 크리에이터가 메이커에서 생성한 맵으로, 스크립트로 별도의 호출을 하
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | VS Code: Debugger for mLua [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1323 [text] | # 학습 과정 소개 mLua Debugger VS Code Extension을 설치해 제작 중인 월드를 VS Code에서 디버깅해봅시다. ##### 참고 가이드 * [스크립트 디버그](/docs?postId=202%7B%22target%22:%22_blank%22%7D) * [LocalWorkspace](/docs?postId=1165%7B%22target%22:%22_blank%22%7D) * [mLua VS Code Extension](/docs/?postId=1209%7B%22target%22:%22_blank%22%7D)
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | 모델 에디터 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1324 [text] | # 학습 과정 소개 모델의 특성을 활용하면 월드를 보다 효율적으로 제작할 수 있습니다. 모델을 편집할 수 있는 모델 에디터에 대해 알아봅시다. # 모델 에디터 소개 모델 에디터를 활용해 모델을 더욱 효율적으로 생성하고, 편집할 수 있습니다. 모델 에디터로 진입하면 맵이나 UIGroup에서 편집하던 내용과는 독립된 공간에서 모델만을 자유롭게 편집할 수 있습니다. 모델 에디터를 사용하는 동안 맵 편집과 테스트 플레이는 불가능해집니다. #### 모델 에디터 진입하기 모델 에디터로 진입하게 되면 Scene 패널이 변경되고, Hierar
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | 그룹 생성과 멤버 관리 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1325 [text] | # 학습 과정 소개 월드를 함께 만들기 위해서는 그룹에 가입해야 합니다. 그룹을 만들어 팀원들과 함께 월드를 만들 수 있습니다. 협동한다면 내가 잘하는 것에 집중할 수 있고, 새로운 영감이나 번뜩이는 아이디어를 떠올릴 수도 있습니다. 세상에 선보이고 싶은, 아름답고 재미있는 월드를 **함께 만들 사람**을 찾아 그룹에 초대해 봅시다. # 그룹 관리 소개 메이플스토리 월드 클라이언트와 [공식 홈페이지](https://maplestoryworlds.nexon.com/)에서 그룹을 생성하고, 멤버를 관리할 수 있습니다. #### 그룹
[category] | Guides [section] | 기본 제작 가이드 > UI [title] | 리치 텍스트 사용하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1327 [text] | ## 학습 과정 소개 리치 텍스트를 사용할 수 있는 컴포넌트와 태그를 알아봅시다. ##### 참고 가이드 * [말풍선 만들기](/docs?postId=119) * [TextRendererComponent](/apiReference/Components/TextRendererComponent) * [TextGUIRendererComponent](/apiReference/Components/TextGUIRendererComponent) * [ChatBalloonComponent](/apiReference/Components/Chat
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 메이커 사용 [title] | 패키지 스토리지 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1328 [text] | # 학습 과정 소개 메이플스토리 월드에서 제공하는 패키지와 크리에이터가 생성한 패키지를 저장하고, 관리할 수 있는 패키지 스토리지에 대해 알아봅시다. ##### 참고 가이드 * [패키지의 활용](/docs?postId=647) # 패키지 카테고리 패키지 스토리지란 개인, 그룹, 메이플스토리 월드가 만든 패키지를 저장하는 보관소입니다. 패키지는 총 두 종류로 나뉩니다. * **내 패키지**: 개인 제작 월드인 경우 개인이 만든 패키지만 보입니다. 그룹 제작 월드인 경우 그룹에서 만든 패키지만 보입니다. * **MSW 패키지**:
[category] | Guides [section] | 기본 제작 가이드 > 객체 표현 > 스프라이트/애니메이션 [title] | Skeleton 리소스 활용하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1343 [text] | # 학습 과정 소개 크리에이터가 제작한 **Skeleton** 리소스를 사용해 메이플스토리 월드에서 다양한 애니메이션을 재생할 수 있습니다. # Skeleton 리소스 등록하기 **Spine 4.1**로 제작된 리소스만 메이플스토리 월드에 Skeleton 리소스로 추가 가능합니다. Resource Storage에 Skeleton을 추가하기 위해서는 한 폴더에 임포트하고자 하는 **png, atlas, skel** 파일이 있어야 하고, 그 외에 다른 파일이 포함되면 안 됩니다. ![[object Object]](https://mo
[category] | Guides [section] | 기본 제작 가이드 > 연출 > 카메라 [title] | 화면 전환 효과 재생하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1345 [text] | # **학습 과정 소개** 맵 이동할 때 부드러운 화면 전환 연출 기능을 제공하는 **ScreenTransitionService**에 대해 알아봅시다. 한 맵에서 다른 맵으로 이동할 때 전환 효과를 사용하면 플레이어가 명확하게 맵이 달라졌음을 인지할 수 있게 됩니다. ### Fade In, Fade Out **Fade In과 Fade Out**은 맵 이동 시에 사용하는 연출입니다. 두 효과는 화면의 투명도를 조절해 점점 어두워지거나 밝아지다가 새로운 장면이 나타납니다. Fade In/Out 효과 재생과 재생 중단 시점에는 시작,
[category] | Guides [section] | 기본 제작 가이드 > 연출 > 광원 [title] | 오버레이 라이트 제어하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1346 [text] | # 학습 과정 소개 Overlay Light를 사용하면 월드에 광원을 만들고, 여러 개의 광원을 겹쳐서 사용할 수 있습니다. **OverlayLightComponent, OverlayLightService**를 활용해 월드에서 다양한 모양의 광원을 만들 수 있습니다. # Overlay Light 확인하기 #### Scene에서 확인하기 **Overlay Light (Scene-Only)** 버튼을 활성화해 Scene에서 Overlay Light를 확인할 수 있습니다. 를 참고하세요. ![[object Object]](https:
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > MCP [title] | MSW MCP [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1368 [text] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 충돌 [title] | Physics Owner 지정하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1369 [text] | 메이플스토리 월드에서의 기본적인 물리 연산 방식에 대해 알아봅시다. Physics Owner를 변경했을 때의 변화에 대해서도 알아봅시다. ##### 참고 가이드 [물리 사용하기](/docs?postId=757) ## 기본 물리 연산 방식 메이플스토리 월드는 최적화된 환경을 제공하기 위해 접속한 클라이언트 중 하나를 물리 연산의 주체로 임의 선정합니다. 임의로 선정된 클라이언트를 **Host Client**라고 칭합니다. 이 Host Client가 연산한 결괏값을 서버가 받아 온 뒤, 모든 클라이언트에게 전달해 동기화합니다.(`T
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 게임 로직 [title] | 클라이언트의 TimeScale 조정하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1370 [text] | [UtilLogic](/apiReference/Logics/UtilLogic)의 `SetClientTimeScale()`를 사용해 클라이언트의 애니메이션 재생 속도, 이동 속도, 물리의 속도를 제어할 수 있습니다. 이 메소드를 활용해 카메라 효과를 조절하거나, 애니메이션 재생 속도를 제어해 더욱 몰입감 있는 월드를 제작할 수 있습니다. ##### 참고 가이드 * [UtilLogic](/apiReference/Logics/UtilLogic) ## SetClientTimeScale `SetClientTimeScale()`를 사용해
[category] | Guides [section] | 기본 제작 가이드 > 데이터 > DB [title] | DataStorage 사용량 제한 활용하기 2 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1372 [text] | # 학습 과정 소개 DataStorage를 효율적으로 활용하지 않으면 사용량 제한에 도달해 데이터 저장, 조회에 실패해 데이터를 관리에 어려움을 겪을 수 있습니다. DataStorage의 사용량을 효과적으로 관리하는 방법에 대해 알아봅시다. ##### 가이드 * [DataStorage 사용량 제한 알아보기](https://maplestoryworlds-creators.nexon.com/ko/docs/?postId=1044) * [DataStorage 사용량 제한 활용하기](https://maplestoryworlds-creator
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > MCP [title] | AI 스킬 셋 설치 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1373 [text] | ## 사전 준비 AI 스킬 셋을 사용하려면 몇 가지 사전 준비가 필요합니다. - 크리에이터의 월드가 **LocalWorkspace, ExtendedScriptFormat**을 모두 활성화한 상태여야 합니다. - [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code) 등 크리에이터가 사용할 AI 에이전트가 **설치, 구독**된 상태여야 합니다. - macOS의 경우
[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > MCP [title] | AI ToolKit [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1374 [text] | 메이플스토리 월드에서 제공하는 AI ToolKit 기능을 활성화하면 간단한 명령을 통해 월드를 제작할 수 있습니다. AI ToolKit을 사용하기 위해서는 사전 준비 단계와 별도의 AI 에이전트 구독이 필요합니다. ## 로컬 워크스페이스 AI ToolKit을 사용하기 위해서는 반드시 **로컬 워크스페이스와 ExtendedScriptFormat**을 사용해야 합니다. 로컬 워크스페이스에 대한 내용은 [LocalWorkspace](docs/?postId=1165) 가이드를 참고하세요. AI ToolKit은 AI ToolKit Set
[category] | Guides [section] | 기본 제작 가이드 > 게임 서비스 [title] | 월드 유저 제재 관리 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1376 [text] | 월드가 인기가 많아지고, 많은 이들이 플레이를 하다 보면 월드의 규칙을 위반하는 유저가 나타날 수 있습니다. 많은 유저가 즐겁게 월드를 즐길 수 있도록 크리에이터는 그 유저를 적절하게 제재해야 합니다. 메이플스토리 월드에서는 월드 인사이트의 PlayerBan과 UserService의 메소드를 활용해 유저를 특정 기간 혹은 영구 제재할 수 있습니다. [월드 인사이트](https://maplestoryworlds-insight.nexon.com/worlds)를 통해 유저 제재 시, 월드에서 제재된 상태의 유저가 메이플스토리 월드를 탈퇴
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 게임 로직 [title] | StateSet 제어하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1398 [text] | StateSet은 엔티티의 상태를 제어할 때 사용합니다. StateSet Editor를 활용하면 보다 간편하게 상태 머신의 흐름을 시각적으로 구성할 수 있습니다. ##### 참고 가이드 * [타입의 이해](/docs?postId=1038) * [엔티티의 상태 제어하기](/docs?postId=686) ##### 참고 API Reference * [StateComponent](/apiReference/Components/StateComponent) * [StateChangeEvent](/apiReference/Events/State
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 게임 로직 [title] | BehaviourTree Editor로 행동 트리 만들기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1399 [text] | 행동 트리 구조를 손쉽게 구성할 수 있는 **BehaviourTree Editor**의 사용 방법을 알아봅시다. 에디터를 활용하면 스크립트로 노드를 결합하지 않아도 노드를 배치하고 선으로 연결해 시각적으로 행동 트리를 제작할 수 있습니다. ##### 참고 가이드 * [행동 트리를 활용한 AI 만들기](/docs?postId=562) * [행동 트리 노드 만들기](/docs?postId=1155) ##### 참고 API Reference * [AIComponent](/apiReference/Components/AIComponent
[category] | Guides [section] | 기본 제작 가이드 > UI [title] | Background Editor [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1400 [text] | Background Editor를 활용해 MSW에서 제공하는 배경 템플릿을 수정하거나, 직접 배경을 제작할 수 있습니다. ##### 참고 가이드 * [배경 설정하기](/docs?postId=768) ## Background Editor 소개 Background Editor에서 메이플스토리 월드에서 제공하는 배경 템플릿을 크리에이터의 필요에 따라 수정하거나, 새로운 배경을 만들 수 있습니다. Background Editor에 진입하는 방법은 다음과 같습니다. - Resource Storage - Background Templat
[category] | Guides [section] | 기본 제작 가이드 > 보안 및 최적화 [title] | Lazy Map [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1401 [text] | 월드의 규모가 커질수록 서버 메모리 관리와 성능 최적화가 필요합니다. LazyMap을 사용하면 맵을 동적으로 생성하고, 서버 자원을 효율적으로 관리할 수 있습니다. ## LazyMap LazyMap은 서버가 처음 시작될 때 맵이 생성되지 않고, 특정 상황에서 동적으로 지연 생성되는 맵을 뜻합니다. LazyMap을 적절하게 활용하면 서버 메모리 점유율을 낮추고, 연산 처리 자원을 최적화할 수 있습니다. LazyMap은 주로 처음부터 생성될 필요 없는 특수한 맵에 적용해 사용할 수 있습니다. 반대로 모든 월드 유저가 반드시 거치는 로
[category] | Guides [section] | 기본 제작 가이드 > 객체 표현 > 아바타 [title] | AvatarAction Editor [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1402 [text] | AvatarActionEditor를 활용해 메이플스토리 월드에서 제공하는 BodyAction의 프레임들을 재구성해 크리에이터 만의 BodyAction을 만들 수 있습니다. ##### 참고 가이드 * [아바타 애니메이션 제어하기 ](/docs?postId=820) * [ActionSheet로 아바타 애니메이션 손쉽게 제어하기](/docs?postId=545) ## AvatarActionEditor 소개 메이플스토리 월드는 메이플스토리의 기본 BodyAction을 제공하고 있습니다.AvatarActionEditor에서는 스크립트에서
[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 게임 로직 [title] | 커스텀 PlayerController 만들기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1403 [text] | PlayerControllerComponent 대신, 크리에이터의 월드 특성에 맞는 조작과 입력 방식을 가진 커스텀 컨트롤러를 직접 만들 수 있습니다. 이 가이드에서는 CustomPlayerControllerComponent를 만드는 예시를 하나 소개합니다. 예시 외에 크리에이터의 의도에 따라 다른 움직임을 구현할 수도 있습니다. ##### 참고 가이드 - [플레이어 설정과 제어](/docs/?postId=547) - [캐릭터 초기 속성 편집](/docs/?postId=48) ### UseCustomScript 사용 Player