mLua · MSW 문서 원문 (API+가이드)

[category] | Misc [section] | [title] | Vector2 [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/Vector2 [text] | 2차원 벡터입니다. # Properties - **float x** 벡터의 x축 원소입니다. - **float y** 벡터의 y축 원소입니다. - **Vector2 down [Static] [ReadOnly] [HideFromInspector]** Vector2(0, -1)을 간단히 사용할 수 있습니다. - **Vector2 left [Static] [ReadOnly] [HideFromInspector]** Vector2(-1, 0)을 간단히 사용할 수 있습니다. - **Vector2 negativeInfinity [

[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 충돌 [title] | 엔티티의 충돌 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=175 [text] | # 학습 과정 소개 충돌 이벤트와 충돌 처리 방법에 대해 알아봅시다. ##### 참고 가이드 [Event System](https://mod-developers.nexon.com/docs?postId=73) [Entity Event System](https://mod-developers.nexon.com/docs?postId=176) # 충돌 **충돌**이란 충돌체를 포함하는 엔티티'의 충돌 영역이 서로 교차하는 것을 말합니다. 엔티티에 [TriggerComponent](/apiReference/Components/TriggerCo

[category] | Enums [section] | [title] | LeaderboardResultCode [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/LeaderboardResultCode [text] | 리더보드 관련 요청 처리 결과를 나타냄니다. # Members | 이름 | 값 | 설명 | |---|---|---| | Unknown | -1 | 알 수 없는 오류가 발생했습니다. | | Ok | 0 | 요청 처리에 성공했습니다. | | InvalidEnvironment | 1000000 | 현재 실행 환경에서는 사용할 수 없습니다. | | InternalError | 1000001 | 내부 시스템 오류가 발생했습니다. | | BadRequest | 1000002 | 잘못된 요청입니다. | | TooManyLeaderboard |

[category] | Misc [section] | [title] | List<V> [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/List-1 [text] | 동적 크기를 가지는 배열입니다. 1부터 시작하는 인덱스로 요소에 접근할 수 있으며 데이터 추가, 제거, 검색 기능을 제공합니다. 배열에 추가할 수 있는 데이터 타입을 V로 표현합니다. # Properties - **number Count [ReadOnly]** List에 포함된 요소의 개수를 가져옵니다. # Methods - **boolean Contains(V item)** List에 포함된 요소 수를 가져옵니다. - **number IndexOf(V item)** List에서 처음 나오는 요소의 인덱스를 반환합니다.

[category] | Components [section] | [title] | PixelGUIRendererComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/PixelGUIRendererComponent [text] | 픽셀 값을 지정해 원하는 스프라이트를 UI에 그릴 수 있는 기능을 제공합니다. 크기는 16x16 이하로 사용하는 것을 권장합니다. # Properties - **int32 Height [ReadOnly]** 스프라이트의 세로 길이입니다. - **boolean IgnoreMapLayerCheck** SortingLayer에 Map Layer 이름을 지정했을 때 자동 치환을 수행하지 않습니다. - **int32 OrderInLayer** 같은 Layer 내의 우선순위를 결정합니다. 수가 클수록 앞에 보입니다. - **bool

[category] | Events [section] | [title] | EntityPreInitSyncEvent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Events/EntityPreInitSyncEvent [text] | 엔티티의 InitSync가 시작되기 이전 발생하는 이벤트입니다. 이 Event는 아래 API에 의해 발생합니다. * MODEntity <img src="https://img.shields.io/static/v1?label=Space&message=Server&color=c4a484" alt="custom" title="Server에서 이벤트가 발생합니다." data-nodeid="4"> # Properties ##### inherited from EntityEventType: - **Entity Entity** 이벤트를

[category] | Enums [section] | [title] | ColliderType [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/ColliderType [text] | 충돌체 모양을 나타냅니다. # Members | 이름 | 값 | 설명 | |---|---|---| | Undefined | 0 | 현재는 사용되지 않습니다. | | Box | 1 | 직사각형 충돌체를 나타냅니다. | | Circle | 2 | 원형 충돌체를 나타냅니다. | | Polygon | 3 | 다각형 충돌체를 나타냅니다. | # Methods - **ColliderType CastFrom(number value) [Static]** 숫자를 해당 타입으로 변환합니다. - **ColliderType CastFrom(stri

[category] | Misc [section] | [title] | FreeformTypeOverlayLightInfo [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/FreeformTypeOverlayLightInfo [text] | 맵에 스폰할 Freeform 타입의 광원 정보입니다. # Properties - **Color Color** 광원의 색상입니다. - **float FalloffDistance** 광원이 Freeform 타입일 때, 빛이 FreeformPoints로부터 얼마나 뻗어 나갈지 결정합니다. 값이 클수록 크기가 커집니다. - **float FalloffIntensity** 광원이 사라지는 곡선의 부드러움을 조절합니다. 값이 클수록 광원의 경계선이 흐릿하고 부드러워 보입니다. 값이 작을수록 광원의 경계선이 날카롭고 또렷하게 보입니다

[category] | Events [section] | [title] | UserKickEvent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Events/UserKickEvent [text] | 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. 이 Event는 아래 API에 의해 발생합니다. * UserService <img src="https://img.shields.io/static/v1?label=Space&message=Server&color=c4a484" alt="custom" title="Server에서 이벤트가 발생합니다." data-nodeid="4"> # Properties - **KickReason KickReason** 추방 사유입니다. - **string ProfileCode*

[category] | Guides [section] | 기본 제작 가이드 > 게임 서비스 > 로컬라이징 [title] | 자동 번역 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1072 [text] | # 학습 과정 소개 메이플스토리 월드에서는 크리에이터가 지원하지 않은 언어의 자동 번역 기능을 지원합니다. 이 기능을 통해 크리에이터는 번역 부담을 덜고, 다양한 언어 사용자들은 보다 편하게 월드를 즐길 수 있습니다. 이번 과정에서는 자동 번역 기능 작동 방식과 설정 방법을 알아봅시다. ##### 참고 가이드 [WorldConfig](/docs?postId=1101) [로컬라이징의 이해](/docs/?postId=951) [포맷에 맞게 로컬라이징하기](/docs/?postId=968) ##### 참고 API Reference [

[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 > 이벤트 [title] | InputService를 활용한 입력과 액션 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=209 [text] | # 학습 과정 소개 모든 게임은 유저의 입력과 입력에 대한 피드백으로 게임이 진행됩니다. 메이플스토리 월드에서는 InputService를 통해 유저의 입력에 대한 액션을 제어할 수 있습니다. 이번 과정에서는 유저의 입력이 발생했을 때의 액션을 추가하는 방법을 알아보겠습니다. # 참고 가이드 [Event System](https://mod-developers.nexon.com/docs?postId=73) [Entity Event System](https://mod-developers.nexon.com/docs?postId=176)

[category] | Enums [section] | [title] | TransitionType [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/TransitionType [text] | 버튼의 전환 효과를 지정합니다. 상태에 따라 다른 효과를 지정할 수 있습니다. # Members | 이름 | 값 | 설명 | |---|---|---| | None | 0 | 버튼 전환 효과를 사용하지 않습니다. | | ColorTint | 1 | 버튼 상태가 바뀔 때 지정된 색상으로 변경합니다. | | SpriteSwap | 2 | 버튼 상태가 바뀔 때 지정된 버튼 이미지로 변경합니다. | # Methods - **TransitionType CastFrom(number value) [Static]** 숫자를 해당 타입으로 변환

[category] | Guides [section] | 응용 제작 가이드 [title] | NPC 대화창 만들기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=74 [text] | # 학습 과정 소개 이번 과정에서는 NPC들의 대화를 표현하기 위한 대화창을 제작해볼 것입니다. UI 편집기를 이용해 대화창을 구성하고 데이터 테이블에 데이터를 세팅 후 스크립트를 이용해 호출할 것입니다. 과정의 진행 순서는 다음과 같습니다. 1. UI 디자인 2. 데이터 테이블 추가 3. 스크립트 제작 제작 예시는 다음과 같습니다. ![example](https://mod-file.dn.nexoncdn.co.kr/bbs/165690897977350020568198c48719639694105dfebca.gif "example

[category] | Misc [section] | [title] | ReadOnlyList<V> [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/ReadOnlyList-1 [text] | 동적 크기를 가지는 배열입니다. 1부터 시작하는 인덱스로 요소에 접근할 수 있으며 데이터 추가, 제거, 검색 기능을 제공합니다. 배열에 추가할 수 있는 데이터 타입을 V로 표현합니다. # Properties - **number Count [ReadOnly]** List에 포함된 요소의 개수를 가져옵니다 # Methods - **boolean Contains(V item)** List에 요소가 있는지 여부를 확인합니다. - **number IndexOf(V item)** 요소를 처음부터 검색해, List에서 처음으로 발견

[category] | Misc [section] | [title] | TimeSpan [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/TimeSpan [text] | 시간 간격을 나타냅니다. # Properties - **int32 Days** TimeSpan의 일 구성 요소입니다. - **integer Elapsed** TimeSpan을 구성하는 밀리초 단위의 정수입니다. - **int32 Hours** TimeSpan의 시간 구성 요소입니다. - **int32 Milliseconds** TimeSpan의 밀리초 구성 요소입니다. - **int32 Minutes** TimeSpan의 분 구성 요소입니다. - **int32 Seconds** TimeSpan의 초 구성 요소입

[category] | Components [section] | [title] | BackgroundComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/BackgroundComponent [text] | 맵의 배경을 변경하고 관리합니다. 단일 색상 배경, 메이플스토리 배경, 웹 이미지 배경, 그라데이션 배경을 사용할 수 있습니다. # Properties - **Color BottomColor [Sync] [ReadOnly]** 그라데이션 배경의 최하단 색상 값입니다. - **boolean FitWithAspect [Sync]** Type이 Sprite일 때 배경의 이미지가 잘리지 않고 카메라 영역에 맞춰지도록 비율을 유지하며 크기를 조정합니다. - **string MaterialId [Sync]** 렌더러에 적용할 머티리

[category] | Events [section] | [title] | EntityPreTransformInitEvent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Events/EntityPreTransformInitEvent [text] | 엔티티의 Transform 초기화 이전 발생하는 이벤트입니다. 이 Event는 아래 API에 의해 발생합니다. * MODEntity <img src="https://img.shields.io/static/v1?label=Space&message=Server,Client&color=c4a484" alt="custom" title="Server, Client에서 이벤트가 발생합니다." data-nodeid="4"> # Properties ##### inherited from EntityEventType: - **Entity En

[category] | Events [section] | [title] | WebViewClickedEvent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Events/WebViewClickedEvent [text] | 웹뷰에 클릭을 입력했을 때 발생하는 이벤트입니다. 이 Event는 아래 API에 의해 발생합니다. * WebViewComponent <img src="https://img.shields.io/static/v1?label=Space&message=Client&color=c4a484" alt="custom" title="Client에서 이벤트가 발생합니다." data-nodeid="4"> # Properties - **Vector2 NormalizedPosition** 클릭이 발생한 위치를 0에서 1의 범위로 정규화시킨 값입니다

[category] | Services [section] | [title] | InputService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/InputService [text] | 유저의 입력과 관련된 기능을 제공합니다. # Methods - **void CursorLockMode(CursorLockMode lockMode) [ClientOnly]** 마우스 커서 조작 방식을 제어합니다. Windows PC 환경만 지원합니다. - **CursorLockMode GetCursorLockMode() [ClientOnly]** 마우스 커서 제어 방식을 반환합니다. Windows PC 환경만 지원합니다. - **Vector2 GetCursorPosition() [ClientOnly]** 커서의 현재 위치

[category] | Guides [section] | 기본 제작 가이드 > 게임 로직/시스템 [title] | 스크린샷 촬영 및 공유하기 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=756 [text] | # 학습 과정 소개 `ScreenshotService`를 통해 화면을 캡처하고 이미지 파일을 저장하는 방법을 살펴봅시다. 추가로 모바일에서 스크린샷을 저장한 뒤 공유하는 방법도 알아봅시다. ##### 참고 API Reference [ScreenshotService](/apiReference?postId=807) [MobileShareService](/apiReference/Services/MobileShareService) # ScreenshotService `ScreenshotService`를 활용하면 PC나 모바일에서 메이플

[category] | Misc [section] | [title] | CollisionGroup [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/CollisionGroup [text] | 충돌 그룹을 나타냅니다. # Properties - **string Id [ReadOnly]** 이 충돌 그룹의 식별자입니다. # Methods - **table<CollisionGroup> GetCollideGroups()** 이 충돌 그룹과 충돌하는 충돌 그룹들을 테이블로 얻어옵니다. # Examples 충돌 그룹을 다루는 예제입니다. ```lua local trigger = self.Entity.TriggerComponent local group = trigger.CollisionGroup log (group)

[category] | Guides [section] | 기본 제작 가이드 > 시작하기 > 개념 이해 [title] | 맵 레이어 [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=53 [text] | # 학습 과정 소개 맵 레이어를 사용해 더욱 입체적으로 게임 화면을 디자인할 수 있습니다. 맵 레이어 창 구성을 살펴보고 활용하는 방법을 알아봅니다. 레이어 순서를 이해하고 레이어를 크리에이터의 게임에 맞게 활용할 수 있습니다. # 맵 레이어 위치 맵 레이어 창은 기본 패널 설정 기준, 중앙 하단에 위치합니다. 작업 편의를 위해 탭을 닫은 후 다시 불러올 때는 **Panels - Map Layer**을 선택해 불러올 수 있습니다. | 메이커 화면 기본 위치 | Panels - Map Layer | | ------------ |

[category] | Events [section] | [title] | HitEvent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Events/HitEvent [text] | 엔티티가 피격되었을 때 발생하는 이벤트입니다. 이 Event는 아래 API에 의해 발생합니다. * HitComponent <img src="https://img.shields.io/static/v1?label=Space&message=Server,Client&color=c4a484" alt="custom" title="Server, Client에서 이벤트가 발생합니다." data-nodeid="4"> # Properties - **Vector2 AttackCenter** 공격이 이루어진 중점입니다. - **Entity Att

[category] | Enums [section] | [title] | PreserveSpriteType [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/PreserveSpriteType [text] | 이미지의 비율, 크기, 피봇 보존 방식을 정의합니다. # Members | 이름 | 값 | 설명 | |---|---|---| | None | 0 | 보존을 설정하지 않습니다. UITransformComponent의 RectSize에 따라 크기가 설정됩니다. | | AspectOnly | 1 | 원본 이미지의 비율을 유지하며 크기를 보정하고, 위치를 설정합니다. | | NativeSize | 2 | 원본 이미지의 크기를 그대로 사용하며 위치를 설정합니다. | # Methods - **PreserveSpriteType CastFrom

[category] | Enums [section] | [title] | SpriteAnimPlayerState [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/SpriteAnimPlayerState [text] | 애니메이션의 재생 상태를 나타냅니다. # Members | 이름 | 값 | 설명 | |---|---|---| | Invalid | 0 | 유효하지 않은 상태입니다. | | Idle | 1 | 유휴 상태입니다. | | Playing | 2 | 재생 상태입니다. | | Paused | 3 | 멈춤 상태입니다. | | Disabled | 4 | 비활성 상태입니다. | # Methods - **SpriteAnimPlayerState CastFrom(number value) [Static]** 숫자를 해당 타입으로 변환합니다. - **

[category] | Misc [section] | [title] | SharedVariableKeyInfo [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/SharedVariableKeyInfo [text] | 공유 변수를 식별하는 데 사용하는 정보입니다. # Properties - **string ETag** 변수를 업데이트 할 때 현재 DB에 저장된 값과 같을 경우에만 실제로 업데이트를 수행합니다. 여러 곳에서 동시에 업데이트를 시도했을 때 동시 다발적 덮어쓰기 현상을 막는데 유용하게 사용됩니다. nil이나 빈 문자열을 주면 무조건 업데이트를 수행합니다. 변수가 업데이트 되면 새로운 ETag가 만들어집니다. - **string Name** 변수 이름입니다. # Constructors - **SharedVariableKeyInf

[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] | Enums [section] | [title] | SpriteDrawMode [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Enums/SpriteDrawMode [text] | 스프라이트를 그리는 방식입니다. # Members | 이름 | 값 | 설명 | |---|---|---| | Simple | 0 | 기본 그리기 방식입니다. | | Sliced | 1 | 스프라이트에 슬라이스 영역을 적용하여 그립니다. | | Tiled | 2 | 스프라이트를 반복해 그립니다. | # Methods - **SpriteDrawMode CastFrom(number value) [Static]** 숫자를 해당 타입으로 변환합니다. - **SpriteDrawMode CastFrom(string value) [Static

[category] | Guides [section] | 응용 제작 가이드 > 상점과 인벤토리 [title] | 8. 상점 로직 만들기Ⅰ [url] | https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1115 [text] | # 상점 로직 작성 1. **Workspace - MyDesk - Create Scripts - Create Logic**을 선택해 새로운 `Shop` 로직을 생성합니다. 2. `Buy()`함수를 생성해 itemId에 해당하는 상품을 itemCount만큼 구매하고, 메소를 차감하도록 작성합니다. ```lua Method: [server] void Buy (string itemId, integer itemCount) { -- itemId에 해당하는 상품을 itemCount만큼 구매하