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

[category] | Services [section] | [title] | UserService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/UserService [text] | 유저 관련 기능을 제공합니다. # Properties - **Entity LocalPlayer [ReadOnly]** 내 유저 엔티티입니다. 클라이언트에서만 사용 가능합니다. - **ReadOnlyDictionary<string, Entity> UserEntities [ReadOnly]** 모든 유저 엔티티 목록입니다. key는 유저 Id, value는 유저 엔티티입니다. - **ReadOnlyDictionary<string, User> Users [ReadOnly]** 모든 유저 정보 목록입니다. key는 유저 Id,

[category] | Services [section] | [title] | EditorService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/EditorService [text] | 에디터 스크립트 관련 기능을 제공합니다. # Methods - **void CloneSelectedEntity()** 선택된 엔티티를 복제합니다. - **void CreateMap(func<string> callback)** 맵을 생성합니다. callback으로 생성된 맵의 Id를 전달받습니다. - **void CreateSelectedModel(Vector2 position, boolean select = true)** 선택된 모델을 position에 생성합니다. - **void CreateSelectedModel(Ve

[category] | Services [section] | [title] | EntityService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/EntityService [text] | 엔티티와 관련된 여러 기능을 제공합니다. # Methods - **void Destroy(Entity entity)** 엔티티를 파괴합니다. - **void Destroy(Entity entity, float delaySeconds)** 엔티티를 delaySeconds(초) 후 파괴합니다. - **table<Entity> GetEntitiesByPath(string worldPath)** worldPath에 해당하는 경로의 엔티티를 반환합니다. - **table<Entity> GetEntitiesByTag(string t

[category] | Services [section] | [title] | CameraService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/CameraService [text] | 카메라 관련 기능을 제공합니다. # Properties - **float currentZoomRatio [ReadOnly]** 현재 줌 비율입니다. - **float TransitionBlendTime** 카메라 전환 시 블렌드 시간이 얼마나 걸릴지를 정의합니다. - **CameraBlendType TransitionBlendType** 카메라 전환 시의 애니메이션 블랜드 타입을 정의합니다. # Methods - **CameraComponent GetCurrentCameraComponent() [ClientOnly]**

[category] | Services [section] | [title] | TeleportService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/TeleportService [text] | Entity를 특정 위치로 이동시키는 기능과 유저를 다른 월드 인스턴스로 워프시키는 기능을 제공합니다. # Methods - **void ClearReservation() [Server]** 예약된 텔레포트들을 취소합니다. - **void ClearReservation(Entity messageOwnerEntity = nil) [Deprecated] [Server]** 더는 사용하지 않는 함수입니다. 다른 ClearReservation() 함수를 사용하세요. - **WarpRecord GetWarpRecord(string u

[category] | Services [section] | [title] | SoundService [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Services/SoundService [text] | 소리 관련 기능을 제공합니다. # Methods - **boolean IsPlayBGM() [ClientOnly]** 배경음악이 재생 중인지를 반환합니다. - **void LoadSound(string id) [ClientOnly]** 음원을 불러옵니다. - **void PauseBGM() [Client]** 재생 중인 배경음악을 일시 정지합니다. - **void PauseBGM(Entity messageOwnerEntity = nil) [Client]** 재생 중인 배경음악을 일시 정지합니다. - **void Pau

[category] | Misc [section] | [title] | Entity [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Misc/Entity [text] | MSW 내에서 존재하는 객체입니다. # Properties - **ReadOnlyList<Entity> Children [ReadOnly]** 엔티티의 자식 리스트입니다. - **Entity CurrentMap** 엔티티가 속한 맵입니다. - **string CurrentMapName [ReadOnly]** 엔티티가 속한 맵의 이름입니다. - **Entity CurrentWorld** 엔티티가 속한 월드 Entity입니다. - **boolean Enable** 엔티티가 활성화되어 있는지 여부입니다. - **bool

[category] | Components [section] | [title] | AvatarBodyActionSelectorComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AvatarBodyActionSelectorComponent [text] | 아바타의 몸통 Action을 선택해 적용시키는 컴포넌트입니다. # Properties - **MapleAvatarBodyActionState ActionState** 현재 Action 상태입니다. - **ReadOnlyDictionary<MapleAvatarBodyActionState, ReadOnlyList<MapleAvatarActionStateElement>> StateActionDic [ReadOnly] [HideFromInspector]** 상태에 대한 정보값입니다. 추후 개선될 예정입니다. ##### inheri

[category] | Components [section] | [title] | CustomFootholdComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/CustomFootholdComponent [text] | 사용자 정의 발판을 만드는 기능을 제공합니다. 발판의 모양과 속성을 설정할 수 있습니다 # Properties - **SyncList<List<Vector2>> edgeLists [Sync]** 발판을 나타냅니다. 하나의 발판은 여러 개의 연결점으로 구성됩니다. - **float FootholdDrag [Sync]** RigidbodyComponent가 포함된 엔티티가 발판 위에 있을 때 적용되는 마찰력입니다. 값이 클수록 빠르게 감속합니다. - **float FootholdForce [Sync]** RigidbodyCo

[category] | Components [section] | [title] | ChatComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/ChatComponent [text] | 플레이어끼리 소통을 할 수 있는 채팅 기능을 지원해주는 컴포넌트입니다. # Properties - **float ChatEmotionDuration** 아바타 감정 표현 지속 시간을 설정합니다. - **boolean EnableVoiceChat [MakerOnly]** 보이스 채팅 버튼의 표시 및 사용 여부를 설정합니다. - **boolean Expand** 채팅창을 펼칠 수 있는 기능입니다. - **boolean HideWorldChatButton [MakerOnly]** 월드 채팅 버튼을 숨기는 기능입니다. - *

[category] | Components [section] | [title] | CanvasGroupComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/CanvasGroupComponent [text] | 자식 UI Entity의 공통 속성을 한 곳에서 제어할 수 있는 기능을 제공합니다. # Properties - **boolean BlocksRaycasts** true로 설정할 경우 자식 UI는 화면 터치 또는 마우스 클릭 입력을 받을 수 있습니다. 뒤에 가려진 UI는 입력을 받지 못합니다. - **float GroupAlpha** 자식 UI의 투명도를 설정합니다. 0 이상, 1 이하의 값을 설정할 수 있습니다. - **boolean Interactable** 자식 UI의 상호작용 가능 여부를 설정합니다. false로 설

[category] | Components [section] | [title] | AvatarFaceActionSelectorComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AvatarFaceActionSelectorComponent [text] | 아바타의 얼굴 Action을 선택해 적용시키는 컴포넌트입니다. # Properties - **MapleAvatarFaceActionState ActionState** 현재 Action 상태입니다. - **float BlinkInterval** 눈 깜빡임의 시간 간격으로, 초 단위를 사용합니다. - **ReadOnlyDictionary<MapleAvatarFaceActionState, ReadOnlyList<MapleAvatarActionStateElement>> StateActionDic [ReadOnly] [HideFrom

[category] | Components [section] | [title] | AIChaseComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AIChaseComponent [text] | 플레이어나 다른 엔티티를 추적하는 AI입니다. StateComponent가 없다면 자동으로 추가됩니다. # Properties - **float DetectionRange** 추적 감지 거리입니다. 대상의 거리가 이보다 멀어지면 추적을 중단하고, 가까워지면 다시 추적을 시작합니다. - **boolean IsChaseNearPlayer** 값이 true인 경우 DetectionRange 프로퍼티 값 내에서 가장 가까운 플레이어를 자동으로 추적합니다. TargetEntityRef 프로퍼티 또는 SetTarget(Entity) 함

[category] | Components [section] | [title] | FootholdComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/FootholdComponent [text] | 맵의 모든 발판을 관리합니다. 발판은 RigidbodyComponent와 상호작용합니다. # Properties ##### inherited from Component: - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enable이 false라면 false를 반환합니다.

[category] | Components [section] | [title] | ClimbableComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/ClimbableComponent [text] | 등반 액션을 할 수 있는 영역을 지정합니다. # Properties - **boolean AllowHorizontalMove** 자유로운 등반 이동 여부를 설정합니다. true일 경우 X, Y 축 모두 이동 가능합니다. - **Vector2 BoxOffset [Sync]** 엔티티를 기준으로 충돌체 직사각형의 중심점 위치를 설정합니다. IsUseDefaultObjectBoxSize를 false로 설정해 BoxOffset을 적용할 수 있습니다. - **Vector2 BoxSize [Sync]** 충돌체 직사각형의 너비와 높

[category] | Components [section] | [title] | DamageSkinComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/DamageSkinComponent [text] | 대미지를 시각적으로 표현하는 대미지 스킨을 구성합니다. 대미지 스킨의 형식은 공격자 엔티티의 DamageSkinSettingComponent에서 지정합니다. # Properties ##### inherited from Component: - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일

[category] | Components [section] | [title] | ButtonComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/ButtonComponent [text] | UI 버튼 기능을 제공합니다. # Properties - **TransitionColorSet Colors [HideFromInspector]** 버튼의 상태별 색상을 정의합니다. - **boolean IgnoreMapLayerCheck [Sync]** SortingLayer에 Map Layer 이름을 지정했을 때 자동 치환을 수행하지 않습니다. - **TransitionRUIDSet ImageRUIDs [HideFromInspector]** 버튼의 상태별 이미지를 정의합니다. - **KeyboardKey KeyCode*

[category] | Components [section] | [title] | AttackComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AttackComponent [text] | HitComponent와 연동해 공격 기능을 구현할 수 있는 인터페이스를 제공합니다. # Properties ##### inherited from Component: - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enable이 false라면 false를 반환합니다. -

[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] | Components [section] | [title] | Component [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/Component [text] | 모든 컴포넌트의 부모 컴포넌트입니다. 컴포넌트 기본 기능을 제공합니다. # Properties - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enable이 false라면 false를 반환합니다. - **Entity Entity [ReadOnly]** 이 컴포넌트를 소유

[category] | Components [section] | [title] | SliderComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/SliderComponent [text] | 최소, 최대 범위 내에서 값을 설정하고, 해당 값을 그래픽으로 나타냅니다. # Properties - **SliderDirection Direction** 최솟값에서 최댓값이 그래픽으로 나타낼 방향을 설정합니다. - **Color FillRectColor** Value를 그래픽으로 나타낼 영역의 색상입니다. - **DataRef FillRectImageRUID** Value를 그래픽으로 나타낼 영역의 이미지 RUID입니다. - **RectOffset FillRectPadding** Value를 그래픽으로 나타낼 영역의

[category] | Components [section] | [title] | AIWanderComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AIWanderComponent [text] | 주변을 배회하는 AI입니다. StateComponent가 없다면 자동으로 추가됩니다. # Properties ##### inherited from AIComponent: - **string BehaviourTreeId [ReadOnly]** 행동 트리 엔트리의 고유 식별자입니다. - **Blackboard BlackBoard [ReadOnly]** AI 행동 트리에서 사용하는 데이터 저장소입니다. 키-값 쌍으로 데이터를 관리하며 행동 트리 노드 간 데이터를 공유합니다. - **boolean IsLegacy [ReadOnl

[category] | Components [section] | [title] | PortalComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/PortalComponent [text] | 포탈 기능을 제공합니다. 포탈의 충돌 속성을 설정하고 목적지 포탈을 연결할 수 있습니다. # Properties - **Vector2 BoxOffset [Sync]** 엔티티를 기준으로 충돌체 직사각형의 중심점 위치를 설정합니다. - **Vector2 BoxSize [Sync]** 충돌체 직사각형의 너비와 높이를 지정합니다. - **CollisionGroup CollisionGroup [ReadOnly] [HideFromInspector]** Portal의 충돌 그룹입니다. - **boolean IsLegacy [Read

[category] | Components [section] | [title] | HitComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/HitComponent [text] | 엔티티의 충돌 영역을 설정하고, AttackComponent의 공격을 받았을 때 피격 동작을 구현할 수 있는 인터페이스를 제공합니다. # Properties - **Vector2 BoxOffset [Deprecated] [Sync]** IsLegacy가 true인 이전 시스템에서 사용할 수 있습니다. 엔티티를 기준으로 충돌체 직사각형의 중심점 위치를 설정합니다. - **Vector2 BoxSize [Sync]** 직사각형 충돌체의 너비와 높이를 지정합니다. - **float CircleRadius [Sync]** 원형 충

[category] | Components [section] | [title] | HitEffectSpawnerComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/HitEffectSpawnerComponent [text] | 엔티티에 피격 이벤트가 발생했을 때 피격 이펙트를 출력합니다. # Properties ##### inherited from Component: - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enable이 false라면 false를 반환합니다. - **Entity Ent

[category] | Components [section] | [title] | MapLayerComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/MapLayerComponent [text] | 맵의 레이어별 정보를 관리합니다. # Properties - **boolean IsVisible [ReadOnly] [HideFromInspector]** 레이어의 렌더링 여부를 나타냅니다. false일 경우 메이커 씬에서 보이지 않습니다. - **int32 LayerSortOrder [ReadOnly]** 레이어의 우선순위 순서입니다. 값이 작을수록 하위 레이어로, 뒤에 그려집니다. - **boolean Locked [ReadOnly] [HideFromInspector]** 레이어가 잠겨 있는지를 나타냅니다. 잠겨 있으

[category] | Components [section] | [title] | DirectionSynchronizerComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/DirectionSynchronizerComponent [text] | 부모 엔티티의 방향을 따라갑니다. 부모 엔티티에서 ChangedLookAtEvent가 발생할 경우 현재 엔티티의 방향도 변경됩니다. # Properties ##### inherited from Component: - **boolean Enable [Sync]** 컴포넌트 활성화 여부를 확인합니다. - **boolean EnableInHierarchy [ReadOnly] [HideFromInspector]** 계층 구조상에서 이 컴포넌트가 Enable 상태인지를 반환합니다. Enable이 true일지라도 엔티티의 Enabl

[category] | Components [section] | [title] | AvatarRendererComponent [url] | https://maplestoryworlds-creators.nexon.com/ko/apiReference/Components/AvatarRendererComponent [text] | 아바타 형태의 엔티티를 렌더링합니다. # Properties - **boolean IgnoreMapLayerCheck [Sync]** SortingLayer에 Map Layer 이름을 지정했을 때 자동 치환을 수행하지 않습니다. - **string MaterialId [Sync]** 렌더러에 적용할 머티리얼의 Id를 지정합니다. - **int32 OrderInLayer** 같은 Layer 내의 우선순위를 결정합니다. 수가 클수록 앞에 보입니다. - **float PlayRate [Sync]** 아바타 애니메이션의 재생