[task] | extract_knowledge [title] | Skeleton 리소스 활용하기 [category] | Guides [rephrased] | # Skeleton 리소스 활용: 애니메이션 트랙 관리 ## 1. 개념 설명 `SkeletonAnimationClip`은 스키마 기반 애니메이션(Skeleton Animation)의 상세 속성을 정의하는 객체입니다. 이를 통해 애니메이션의 재생 속도, 지연 시간, 전환 효과 등을 제어할 수 있습니다. ### 주요 프로퍼티 | 프로퍼티 | 설명 | 기본값 | | :--- | :--- | :--- | | `Alpha` | 다른 트랙과 섞이는 비율 | 1 | | `Delay` | 애니메이션 재생 시작 전 대기 시간 (초) | - | [original] | `SkeletonAnimationClip`은 애니메이션의 상세 속성을 나타냅니다. 주요 프로퍼티는 아래와 같습니다. 자세한 내용은 [SkeletonAnimationClip](/apiReference/Misc/SkeletonAnimationClip)를 참고하세요. | 이름 | 설명 | | --- | --- | | Alpha | 다른 트랙과 섞이는 비율을 나타냅니다. 기본값은 1입니다. | | Delay | 애니메이션 재생을 시작하기까지 대기하는 시간입니다. 시간은 초 단위입니다. | | MixDuration | 애니메이션이 [chunk_id] | Guides:1343:1
[task] | distill [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원(LitMode) 사용 가이드 ## 1. LitMode 활성화 전제 월드 설정의 **UseLitDefaultMaterial**을 활성화해야 합니다. - 활성화 시 모든 엔티티는 기본 **LitMode: Lit** 상태로 처리되어 광원 영향을 받습니다. - 단, 개별 엔티티나 컴포넌트에 명시적으로 다른 `LitMode`가 지정된 경우, 해당 지정 값이 우선 적용됩니다. - (참고: [WorldConfig](/docs?postId=1101)) ## 2. 광원 적용 방법 (4가지) 1. **LightComponent** 추가 [original] | # 학습 과정 소개 월드에 광원을 적용할 수 있는 방법을 알아봅시다. # LitMode 활성화 **UseLitDefaultMaterial**을 활성화하면 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 이에 따라 엔티티들이 다른 광원으로부터 영향을 받아 표면의 색상과 밝기가 달라지게 됩니다. 그러나 LitMode를 별도로 설정할 수 있는 엔티티의 경우 따로 지정된 LitMode의 값을 따르게 됩니다. [WorldConfig](/docs?postId=1101)를 참고하세요. ![[object Object]](http [chunk_id] | Guides:1347:0
[task] | wikipedia [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어하기 메이플스토리 월드의 `OverlayLightService`는 클라이언트 측에서 자유형(Freeform) 오버레이 라이트를 생성, 설정 및 제거하는 기능을 제공합니다. 이 서비스는 `[client only]` 실행 공간에서 사용 가능하며, 특정 엔티티에 연결된 시각적 광원 효과를 구현하는 데 활용됩니다. ## 광원 생성 및 설정 자유형 오버레이 라이트를 생성하려면 먼저 `_OverlayLightService:SetOverlayLightEnabled(true)`를 호출하여 오버레이 라이트 시스템을 [original] | ```lua [client only] void OnBeginPlay() { _OverlayLightService:SetOverlayLightEnabled(true) -- 생성할 Freeform 타입 광원의 정보를 담을 객체를 생성합니다. local overlayLightInfo = FreeformTypeOverlayLightInfo(self.Entity) -- 광원 모양을 만들 점의 정보들을 입력합니다. local freeformPoints = table.create(4) [chunk_id] | Guides:1346:2
[task] | wikipedia [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어하기 메이플스토리 월드 스크립트에서 광원 오버레이 라이트를 제어하는 방법은 크게 두 가지로 나뉩니다. 하나는 엔티티에 `OverlayLightComponent`를 부여하여 광원을 생성하고 제어하는 방식이며, 다른 하나는 `OverlayLightService`를 직접 호출하여 광원을 제어하는 방식입니다. ## 1. OverlayLightComponent를 사용한 광원 제어 이 방식은 `TransformComponent`만 가진 엔티티를 맵에 생성 및 배치한 뒤, 해당 엔티티에 `OverlayLight [original] | TransformComponent만 가진 엔티티를 생성해 맵에 배치하고, OverlayLightComponent를 활용해 광원을 생성하고, 제어해봅시다. #### 광원 생성하기 1. 새로운 모델을 만들고, **TransformComponent**를 추가합니다. 2. 월드에 진입하면 Spot 타입의 광원이 생성되도록 아래와 같이 작성합니다. ```lua Method: [client only] void OnBeginPlay() { -- Overlay Light를 활성화합니다. _OverlayLightService:Se [chunk_id] | Guides:1346:1
[task] | diverse_qa [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | 질문: `_OverlayLightService:SetOverlayLightEnabled(true)` 함수를 호출하는 목적은 무엇인가요? 답변: 오버레이 라이트 기능을 활성화하기 위함입니다. 질문: 제공된 코드에서 `FreeformTypeOverlayLightInfo` 객체를 생성할 때 어떤 인자를 전달하고 있나요? 답변: `self.Entity`를 인자로 전달하고 있습니다. 질문: `freeformPoints` 테이블에 저장된 `Vector2` 값들은 어떤 역할을 하나요? 답변: 광원의 모양을 결정하는 점들의 좌표 정보를 입력하 [original] | ```lua [client only] void OnBeginPlay() { _OverlayLightService:SetOverlayLightEnabled(true) -- 생성할 Freeform 타입 광원의 정보를 담을 객체를 생성합니다. local overlayLightInfo = FreeformTypeOverlayLightInfo(self.Entity) -- 광원 모양을 만들 점의 정보들을 입력합니다. local freeformPoints = table.create(4) [chunk_id] | Guides:1346:2
[task] | wikipedia [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어하기 Overlay Light는 월드 내 광원을 생성하고, 복수의 광원을 겹쳐서 시각 효과를 구현하는 기능입니다. `OverlayLightComponent`와 `OverlayLightService` API를 활용하여 다양한 형태와 색상의 광원을 제작할 수 있습니다. ## Overlay Light 확인 방법 Overlay Light는 개발 단계의 Scene 뷰와 실제 실행 환경인 Play 모드에서 각각 다른 방식으로 확인해야 합니다. Scene 뷰에서 광원을 확인하려면 에디터의 **Overlay L [original] | # 학습 과정 소개 Overlay Light를 사용하면 월드에 광원을 만들고, 여러 개의 광원을 겹쳐서 사용할 수 있습니다. **OverlayLightComponent, OverlayLightService**를 활용해 월드에서 다양한 모양의 광원을 만들 수 있습니다. # Overlay Light 확인하기 #### Scene에서 확인하기 **Overlay Light (Scene-Only)** 버튼을 활성화해 Scene에서 Overlay Light를 확인할 수 있습니다. #### Play에서 확인하기 월드에 처음 진입해 Ov [chunk_id] | Guides:1346:0
[task] | distill [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원 LitMode와 광원 사용하기 ## SortingLayer 적용 설정 광원이 적용될 SortingLayer 범위를 설정합니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원 적용. * **TargetSortingLayers**: `TargetAllSortingLayers` 비활성화 시 특정 SortingLayer 지정 가능. 각 Layer별 별도 텍스처 생성/렌더링으로 **모바일 성능 저하** 주의. ## LitMode (셰이더 렌더링 방식) 엔티티의 표면 색상과 밝기 [original] | SortingLayer에 광원을 적용 여부를 **TargetAllSortingLayers, TargetSortingLayers**로 설정할 수 있습니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원이 적용됩니다. 이 프로퍼티를 비활성화하면 TargetSortingLayers를 설정할 수 있습니다. * **TargetSortingLayers**: 광원이 적용될 SortingLayer를 크리에이터가 지정할 수 있습니다. SortingLayer마다 별도의 광원 텍스처를 생성하고 렌더링하게 됩 [chunk_id] | Guides:1347:1
[task] | diverse_qa [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | 질문: Overlay Light를 사용하여 월드에 광원을 만들고 겹쳐서 사용할 때 필요한 컴포넌트와 서비스는 무엇인가요? 답변: OverlayLightComponent와 OverlayLightService를 활용해 월드에서 다양한 모양의 광원을 만들 수 있습니다. 질문: Scene에서 Overlay Light를 확인하기 위해 활성화해야 하는 버튼은 무엇인가요? 답변: "Overlay Light (Scene-Only)" 버튼을 활성화해야 Scene에서 Overlay Light를 확인할 수 있습니다. 질문: 월드에 처음 진입하여 P [original] | # 학습 과정 소개 Overlay Light를 사용하면 월드에 광원을 만들고, 여러 개의 광원을 겹쳐서 사용할 수 있습니다. **OverlayLightComponent, OverlayLightService**를 활용해 월드에서 다양한 모양의 광원을 만들 수 있습니다. # Overlay Light 확인하기 #### Scene에서 확인하기 **Overlay Light (Scene-Only)** 버튼을 활성화해 Scene에서 Overlay Light를 확인할 수 있습니다. #### Play에서 확인하기 월드에 처음 진입해 Ov [chunk_id] | Guides:1346:0
[task] | extract_knowledge [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어 Overlay Light는 월드에 광원을 생성하고, 여러 광원을 겹쳐 조합하여 사용할 수 있는 시스템입니다. 이 기능은 `OverlayLightComponent`와 `OverlayLightService`를 통해 구현됩니다. ## 1. 개념 설명 ### 광원 종류 Overlay Light는 용도에 따라 4가지 종류의 광원을 지원합니다. * **Spot**: 원형으로 나타나는 광원입니다. 프로퍼티 값 조정을 통해 원형 모양을 변경할 수 있으며, `TransformComponent.Scale`의 [original] | # 학습 과정 소개 Overlay Light를 사용하면 월드에 광원을 만들고, 여러 개의 광원을 겹쳐서 사용할 수 있습니다. **OverlayLightComponent, OverlayLightService**를 활용해 월드에서 다양한 모양의 광원을 만들 수 있습니다. # Overlay Light 확인하기 #### Scene에서 확인하기 **Overlay Light (Scene-Only)** 버튼을 활성화해 Scene에서 Overlay Light를 확인할 수 있습니다. #### Play에서 확인하기 월드에 처음 진입해 Ov [chunk_id] | Guides:1346:0
[task] | wikipedia [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원 LitMode와 광원 사용하기 메이플스토리 월드(MapleStory Worlds)에서는 `SortingLayer`에 광원을 적용하는 방식을 `TargetAllSortingLayers`와 `TargetSortingLayers` 프로퍼티를 통해 설정할 수 있습니다. `TargetAllSortingLayers`가 활성화된 상태에서는 모든 `SortingLayer`에 광원이 일괄 적용됩니다. 이 프로퍼티를 비활성화하면 `TargetSortingLayers` 프로퍼티를 설정하여 광원이 적용될 `SortingLayer`를 크리에이터 [original] | SortingLayer에 광원을 적용 여부를 **TargetAllSortingLayers, TargetSortingLayers**로 설정할 수 있습니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원이 적용됩니다. 이 프로퍼티를 비활성화하면 TargetSortingLayers를 설정할 수 있습니다. * **TargetSortingLayers**: 광원이 적용될 SortingLayer를 크리에이터가 지정할 수 있습니다. SortingLayer마다 별도의 광원 텍스처를 생성하고 렌더링하게 됩 [chunk_id] | Guides:1347:1
[task] | knowledge_list [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | ```lua -- 이 코드는 문서 내용 요약이며, 실제 실행 가능한 스크립트가 아닙니다. -- mLua API 사용 예시는 원문에 없으므로 생략합니다. ``` 1. `UseLitDefaultMaterial` 옵션을 활성화하면 모든 엔티티는 기본적으로 `LitMode`가 `Lit`인 상태로 처리되며, 이로 인해 엔티티의 표면 색상과 밝기가 주변 광원의 영향을 받아 변화한다. 2. `LitMode`를 별도로 설정할 수 있는 엔티티의 경우, 기본 `Lit` 상태가 아니라 개별적으로 지정된 `LitMode` 값을 우선적으로 따르며, 세부 [original] | # 학습 과정 소개 월드에 광원을 적용할 수 있는 방법을 알아봅시다. # LitMode 활성화 **UseLitDefaultMaterial**을 활성화하면 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 이에 따라 엔티티들이 다른 광원으로부터 영향을 받아 표면의 색상과 밝기가 달라지게 됩니다. 그러나 LitMode를 별도로 설정할 수 있는 엔티티의 경우 따로 지정된 LitMode의 값을 따르게 됩니다. [WorldConfig](/docs?postId=1101)를 참고하세요. ![[object Object]](http [chunk_id] | Guides:1347:0
[task] | knowledge_list [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | - `TargetAllSortingLayers` 프로퍼티가 활성화된 경우, 광원은 모든 SortingLayer에 적용됩니다. - `TargetAllSortingLayers` 프로퍼티가 비활성화된 경우, 크리에이터는 `TargetSortingLayers` 프로퍼티를 통해 광원이 적용될 특정 SortingLayer를 지정할 수 있습니다. - `TargetSortingLayers` 프로퍼티로 지정된 각 SortingLayer에는 별도의 광원 텍스처가 생성 및 렌더링되며, 이는 모바일 환경에서 성능 저하를 유발할 수 있습니다. - `Lit [original] | SortingLayer에 광원을 적용 여부를 **TargetAllSortingLayers, TargetSortingLayers**로 설정할 수 있습니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원이 적용됩니다. 이 프로퍼티를 비활성화하면 TargetSortingLayers를 설정할 수 있습니다. * **TargetSortingLayers**: 광원이 적용될 SortingLayer를 크리에이터가 지정할 수 있습니다. SortingLayer마다 별도의 광원 텍스처를 생성하고 렌더링하게 됩 [chunk_id] | Guides:1347:1
[task] | distill [title] | MSW MCP [category] | Guides [rephrased] | # MCP (Model Context Protocol) 연동 메이플스토리 월드(MSW)의 MCP를 AI 에이전트(예: VS Code, Cursor, Claude Code)에 연동하면 프롬프트로 월드 제작이 가능합니다. **LocalWorkspace 활성화 필수**입니다. ## 1. MSW MCP (통합 서버) 월드 작업 도구와 정보를 AI에 제공하는 서버 사이드 MCP입니다. * **전송(Transport)**: `http` * **엔드포인트**: `https://msw-mcp.nexon.com/mcp` * **인증 [original] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer [chunk_id] | Guides:1368:0
[task] | diverse_qa [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | 질문: 광원을 생성하기 위해 엔티티에 추가해야 하는 컴포넌트는 무엇인가요? 답변: 광원을 생성하기 위해 엔티티에는 `OverlayLightComponent`를 추가해야 합니다. 질문: `OnBeginPlay` 메서드에서 `[client only]` 태그를 사용하는 이유는 무엇인가요? 답변: 문서의 예제 코드에 따르면, `OverlayLightService`와 `OverlayLightComponent`를 활용한 광원 생성 및 제어는 클라이언트에서만 수행되도록 `[client only]` 태그를 사용하여 지정합니다. 질문: `Spo [original] | TransformComponent만 가진 엔티티를 생성해 맵에 배치하고, OverlayLightComponent를 활용해 광원을 생성하고, 제어해봅시다. #### 광원 생성하기 1. 새로운 모델을 만들고, **TransformComponent**를 추가합니다. 2. 월드에 진입하면 Spot 타입의 광원이 생성되도록 아래와 같이 작성합니다. ```lua Method: [client only] void OnBeginPlay() { -- Overlay Light를 활성화합니다. _OverlayLightService:Se [chunk_id] | Guides:1346:1
[task] | extract_knowledge [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원 LitMode와 SortingLayer 적용 ## 개념 설명 메이플스토리 월드의 광원 시스템은 `LitMode`와 `SortingLayer` 설정을 통해 엔티티의 렌더링 방식을 제어합니다. **LitMode**는 셰이더 렌더링 방식을 결정하는 프로퍼티로, 다음과 같은 세 가지 값을 가집니다. * **Default**: `WorldConfig`의 `UseLitDefaultMaterial` 설정에 따라 셰이더가 자동 결정됩니다. * **Lit**: 광원의 위치, 색상, 강도에 따라 엔티티 표면의 색상과 밝기가 변화 [original] | SortingLayer에 광원을 적용 여부를 **TargetAllSortingLayers, TargetSortingLayers**로 설정할 수 있습니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원이 적용됩니다. 이 프로퍼티를 비활성화하면 TargetSortingLayers를 설정할 수 있습니다. * **TargetSortingLayers**: 광원이 적용될 SortingLayer를 크리에이터가 지정할 수 있습니다. SortingLayer마다 별도의 광원 텍스처를 생성하고 렌더링하게 됩 [chunk_id] | Guides:1347:1
[task] | diverse_qa [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | 질문: SortingLayer에 광원을 적용하는 범위를 설정할 때 사용할 수 있는 프로퍼티는 무엇인가요? 답변: TargetAllSortingLayers와 TargetSortingLayers로 설정할 수 있습니다. 질문: TargetAllSortingLayers 프로퍼티를 활성화하면 어떤 결과가 발생하나요? 답변: 모든 SortingLayer에 광원이 적용됩니다. 질문: TargetAllSortingLayers 프로퍼티를 비활성화해야만 설정할 수 있는 프로퍼티는 무엇인가요? 답변: TargetSortingLayers를 설정할 수 [original] | SortingLayer에 광원을 적용 여부를 **TargetAllSortingLayers, TargetSortingLayers**로 설정할 수 있습니다. * **TargetAllSortingLayers**: 모든 SortingLayer에 광원이 적용됩니다. 이 프로퍼티를 비활성화하면 TargetSortingLayers를 설정할 수 있습니다. * **TargetSortingLayers**: 광원이 적용될 SortingLayer를 크리에이터가 지정할 수 있습니다. SortingLayer마다 별도의 광원 텍스처를 생성하고 렌더링하게 됩 [chunk_id] | Guides:1347:1
[task] | knowledge_list [title] | MSW MCP [category] | Guides [rephrased] | - 메이플스토리 월드에서 제공하는 MCP를 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. - MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하는 AI 에이전트와 연동하여 월드를 제작할 수 있으며, 대표적으로 VS Code, Cursor, Claude Code를 사용할 수 있습니다. - MCP를 지원하고 Bearer 인증 방식을 사용할 수 있다면 MSW MCP와 MSW Maker를 연동할 수 있습니다. - MCP를 사용하기 위해서는 반드시 LocalWorkspace를 활성화해야 합니다. - MSW [original] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer [chunk_id] | Guides:1368:0
[task] | wikipedia [title] | MSW MCP [category] | Guides [rephrased] | # 메이플스토리 월드 MCP 메이플스토리 월드(MapleStory Worlds, MSW)에서 제공하는 MCP(Model Context Protocol)를 설치하면, AI 에이전트를 통해 간단한 프롬프트 입력만으로 월드를 제작할 수 있습니다. 크리에이터는 VS Code, Cursor, Claude Code와 같이 MCP를 지원하는 개발도구를 자신의 AI 에이전트에 연동하여 월드 제작 작업에 활용할 수 있습니다. 또한, MCP 프로토콜과 Bearer 인증 방식을 지원하는 기타 도구들도 MSW MCP 및 MSW Maker MCP를 연동 [original] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer [chunk_id] | Guides:1368:0
[task] | diverse_qa [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | 질문: UseLitDefaultMaterial을 활성화하면 엔티티의 LitMode는 어떤 상태로 간주됩니까? 답변: 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 질문: LitMode를 별도로 설정할 수 있는 엔티티는 어떻게 처리됩니까? 답변: 따로 지정된 LitMode의 값을 따르게 됩니다. 질문: Scene에서 광원이 적용된 모습을 확인하기 위해 활성화해야 하는 버튼은 무엇입니까? 답변: Light 버튼을 활성화해야 합니다. 질문: Scene에서 광원의 모습이 정상적으로 보이려면 맵에 최소 몇 개 이상의 광원이 [original] | # 학습 과정 소개 월드에 광원을 적용할 수 있는 방법을 알아봅시다. # LitMode 활성화 **UseLitDefaultMaterial**을 활성화하면 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 이에 따라 엔티티들이 다른 광원으로부터 영향을 받아 표면의 색상과 밝기가 달라지게 됩니다. 그러나 LitMode를 별도로 설정할 수 있는 엔티티의 경우 따로 지정된 LitMode의 값을 따르게 됩니다. [WorldConfig](/docs?postId=1101)를 참고하세요. ![[object Object]](http [chunk_id] | Guides:1347:0
[task] | extract_knowledge [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어 본 절에서는 `OverlayLightComponent`와 `OverlayLightService`를 사용하여 맵에 광원을 생성하고 제어하는 방법을 다룹니다. ## 1. 개념 설명 메이플스토리 월드에서는 두 가지 방식으로 오버레이 라이트(광원)를 제어할 수 있습니다. 1. **OverlayLightComponent**: 엔티티에 컴포넌트를 추가하여 광원을 생성합니다. 엔티티의 위치(`TransformComponent`)와 연동되어 광원이 이동하거나 회전할 수 있습니다. 2. **OverlayLi [original] | TransformComponent만 가진 엔티티를 생성해 맵에 배치하고, OverlayLightComponent를 활용해 광원을 생성하고, 제어해봅시다. #### 광원 생성하기 1. 새로운 모델을 만들고, **TransformComponent**를 추가합니다. 2. 월드에 진입하면 Spot 타입의 광원이 생성되도록 아래와 같이 작성합니다. ```lua Method: [client only] void OnBeginPlay() { -- Overlay Light를 활성화합니다. _OverlayLightService:Se [chunk_id] | Guides:1346:1
[task] | extract_knowledge [title] | MSW MCP [category] | Guides [rephrased] | # MSW MCP 설치 및 구성 메이플스토리 월드(Worlds)의 MCP(Model Context Protocol)는 AI 에이전트가 월드 작업 도구와 정보를 접근할 수 있도록 하는 인터페이스입니다. MSW MCP를 활용하려면 반드시 **LocalWorkspace**가 활성화되어 있어야 합니다. ## 1. 개념 설명 MSW 플랫폼은 두 가지 종류의 MCP 서버를 제공합니다. 1. **MSW MCP (Server-Side)** * 월드 작업 도구와 정보를 AI에게 제공하는 통합 서버 기반 MCP입니다. * [original] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer [chunk_id] | Guides:1368:0
[task] | wikipedia [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원(LitMode)과 광원 사용하기 메이플스토리 월드에서 광원을 적용하는 방법은 월드 내 엔티티에 빛의 효과와 색상을 부여하여 시각적 연출을 강화하는 데 목적이 있습니다. 본 가이드에서는 광원 시스템의 활성화 조건부터 광원 종류별 특징, 그리고 광원을 월드에 적용하는 구체적인 방법까지 다루며, `LightComponent`의 주요 프로퍼티를 중심으로 설명합니다. ## LitMode 활성화 및 Scene/Play 모드 설정 월드에서 광원 효과를 시각적으로 확인하기 위해서는 먼저 **LitMode** 시스템이 활성화되어 있어 [original] | # 학습 과정 소개 월드에 광원을 적용할 수 있는 방법을 알아봅시다. # LitMode 활성화 **UseLitDefaultMaterial**을 활성화하면 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 이에 따라 엔티티들이 다른 광원으로부터 영향을 받아 표면의 색상과 밝기가 달라지게 됩니다. 그러나 LitMode를 별도로 설정할 수 있는 엔티티의 경우 따로 지정된 LitMode의 값을 따르게 됩니다. [WorldConfig](/docs?postId=1101)를 참고하세요. ![[object Object]](http [chunk_id] | Guides:1347:0
[task] | extract_knowledge [title] | LitMode와 광원 사용하기 [category] | Guides [rephrased] | # 광원(Light)과 LitMode 활용 ## 1. 개념 설명 메이플스토리 월드에서 광원은 엔티티의 표면 색상과 밝기를 변화시키는 시각적 효과를 제공합니다. 광원이 제대로 적용되려면 다음 두 가지 전제 조건이 필요합니다. 1. **LitMode 활성화**: 월드 설정에서 `UseLitDefaultMaterial`이 활성화되어 있어야 합니다. 이 설정이 켜져 있을 경우, 모든 엔티티는 기본적으로 `Lit` 모드로 간주되어 주변 광원의 영향을 받습니다. 단, 개별 엔티티나 컴포넌트에 `LitMode`가 명시적으로 지정된 경우, [original] | # 학습 과정 소개 월드에 광원을 적용할 수 있는 방법을 알아봅시다. # LitMode 활성화 **UseLitDefaultMaterial**을 활성화하면 모든 엔티티는 LitMode가 Lit인 상태로 간주됩니다. 이에 따라 엔티티들이 다른 광원으로부터 영향을 받아 표면의 색상과 밝기가 달라지게 됩니다. 그러나 LitMode를 별도로 설정할 수 있는 엔티티의 경우 따로 지정된 LitMode의 값을 따르게 됩니다. [WorldConfig](/docs?postId=1101)를 참고하세요. ![[object Object]](http [chunk_id] | Guides:1347:0
[task] | diverse_qa [title] | MSW MCP [category] | Guides [rephrased] | 질문: 메이플스토리 월드에서 MCP를 설치하면 어떤 이점이 있나요? 답변: AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. 질문: MCP를 지원하는 대표적인 개발 도구로 어떤 것들이 언급되고 있나요? 답변: VS Code, Cursor, Claude Code가 대표적으로 언급되고 있습니다. 질문: MSW MCP와 MSW Maker를 연동하기 위해 Bearer 인증 방식을 사용하는 도구 외에 추가적으로 필요한 조건은 무엇인가요? 답변: MCP를 지원하는 도구여야 하며, Bearer 인증 방식을 사용할 수 있어야 [original] | 메이플스토리 월드에서 제공하는 MCP들을 설치하면, AI를 사용해 간단한 프롬프트 작성으로 월드를 제작할 수 있습니다. MCP를 지원하는 다양한 개발도구를 크리에이터가 사용하고 있는 AI 에이전트와 연동해 월드를 제작해 보길 바랍니다. 대표적으로 [VS Code](https://code.visualstudio.com), [Cursor](https://cursor.com), [Claude Code](https://claude.com/product/claude-code)를 사용할 수 있습니다. 이외에도 MCP를 지원하고, Bearer [chunk_id] | Guides:1368:0
[task] | extract_knowledge [title] | 오버레이 라이트 제어하기 [category] | Guides [rephrased] | # 광원 오버레이 라이트 제어하기 ## 1. 개념 설명 `_OverlayLightService`는 클라이언트 공간에서 오버레이 라이트(Overlay Light)를 생성, 활성화, 제어 및 제거하기 위한 서비스입니다. - **활성화**: 오버레이 라이트 시스템 전체를 켜기 위해 `SetOverlayLightEnabled` 메서드를 사용합니다. - **Freeform 타입 광원 생성**: `FreeformTypeOverlayLightInfo` 객체를 통해 광원의 형태(점들의 배열)를 정의한 후, `SpawnFreeformTypeOv [original] | ```lua [client only] void OnBeginPlay() { _OverlayLightService:SetOverlayLightEnabled(true) -- 생성할 Freeform 타입 광원의 정보를 담을 객체를 생성합니다. local overlayLightInfo = FreeformTypeOverlayLightInfo(self.Entity) -- 광원 모양을 만들 점의 정보들을 입력합니다. local freeformPoints = table.create(4) [chunk_id] | Guides:1346:2
[task] | distill [title] | MSW MCP [category] | Guides [rephrased] | # 메이플스토리월드 MCP 설치 가이드 메이플스토리월드 MCP는 VS Code, Claude, Cursor, Codex CLI 등에서 사용할 수 있으며, 지원 여부는 에이전트마다 다릅니다. 크리에이터가 편의에 따라 설치 방식을 선택할 수 있습니다. ## 지원 매트릭스 | 이름 | 설정 파일 최상위 키 | stdio | HTTP | CLI 등록 | | :--- | :--- | :---: | :---: | :--- | | **VS Code** (Copilot Agent Mode) | `servers` | ⭕ | ⭕ | Comman [original] | 메이플스토리월드 MCP들은 VS Code, Claude, Cursor, Codex CLI에서 사용할 수 있습니다. 각 AI 에이전트마다 지원 여부가 다릅니다. 지원하는 설치 방식 중 하나를 크리에이터가 편의에 따라 선택해 설치할 수 있습니다. | 이름 | 설정 파일 최상위 키 | stdio 지원 | HTTP 지원 | CLI 등록 | | --- | --- | --- | --- | --- | | VS Code(Copilot Agent Mode) | servers | ⭕ | ⭕ | Command Palette | | VS Code + [chunk_id] | Guides:1368:1
[task] | distill [title] | MSW MCP [category] | Guides [rephrased] | # MCP 설정 가이드 (Claude) ## 1. `.mcp.json` 작성 프로젝트 루트의 `.mcp.json` 에 아래 내용을 추가합니다. > **주의**: VS Code의 `.vscode/mcp.json` 에 작성하면 정상 동작하지 않습니다. **Windows** ```json { "mcpServers": { "msw-maker-mcp": { "command": "cmd.exe", "args": [ "/c", [original] | 1. `.mcp.json` 에 아래 mcp 추가 내용을 작성합니다. VS Code의 `.vscode/mcp.json` 에 아래 내용을 작성하면 정상적으로 동작하지 않으므로 주의가 필요합니다. **Windows**: ```lua { "mcpServers": { "msw-maker-mcp": { "command": "cmd.exe", "args": [ "/c", "call", "%LOCALAPPDATA%\\Nexon\\Mapl [chunk_id] | Guides:1368:3
[task] | diverse_qa [title] | MSW MCP [category] | Guides [rephrased] | 질문: 메이플스토리월드 MCP는 어떤 개발 환경이나 AI 에이전트에서 사용할 수 있습니까? 답변: 메이플스토리월드 MCP들은 VS Code, Claude, Cursor, Codex CLI에서 사용할 수 있습니다. 질문: VS Code에서 MCP 설정 파일의 최상위 키는 무엇이며, 설정 파일은 어디에 위치합니까? 답변: VS Code의 설정 파일 최상위 키는 `servers`이며, 설정 파일 위치는 `{프로젝트}/.vscode/mcp.json`입니다. 질문: Cursor에서 MCP를 CLI 명령을 통해 등록할 수 있습니까? 답변: [original] | 메이플스토리월드 MCP들은 VS Code, Claude, Cursor, Codex CLI에서 사용할 수 있습니다. 각 AI 에이전트마다 지원 여부가 다릅니다. 지원하는 설치 방식 중 하나를 크리에이터가 편의에 따라 선택해 설치할 수 있습니다. | 이름 | 설정 파일 최상위 키 | stdio 지원 | HTTP 지원 | CLI 등록 | | --- | --- | --- | --- | --- | | VS Code(Copilot Agent Mode) | servers | ⭕ | ⭕ | Command Palette | | VS Code + [chunk_id] | Guides:1368:1
[task] | distill [title] | MSW MCP [category] | Guides [rephrased] | # MCP 설정 및 확장 연동 ## 1. 로컬 MCP 설정 (`.vscode/mcp.json`) 월드 로컬 워크스페이스 폴더에 `.vscode/mcp.json` 파일을 생성하여 아래 내용을 추가합니다. 저장 후 VS Code를 재시작해야 적용됩니다. **Windows** ```json { "servers": { "msw-maker-mcp": { "type": "stdio", "command": "cmd.exe", "args": ["/c", "c [original] | 1. 월드의 로컬 워크스페이스 폴더에 `.vscode/mcp.json` 파일 생성합니다. 2. 크리에이터 운영체제에 맞는 단락을 작성합니다. **Windows**: ```lua { "servers": { "msw-maker-mcp": { "type": "stdio", "command": "cmd.exe", "args": [ "/c", "call", "%LOCALAPPDATA%\\Nexon\\MapleStory W [chunk_id] | Guides:1368:2
[task] | wikipedia [title] | MSW MCP [category] | Guides [rephrased] | # 메이플스토리 월드 MCP 메이플스토리 월드(MapleStory Worlds)의 MCP(Model Context Protocol) 서버는 VS Code, Claude, Cursor, Codex CLI 등 다양한 AI 에이전트 환경에서 통합하여 사용할 수 있습니다. 각 에이전트별 지원 여부와 설치 방식이 상이하므로, 크리에이터는 자신의 작업 환경에 맞는 방법을 선택하여 설치해야 합니다. ## 지원 환경 및 설정 요약 각 AI 에이전트는 MCP 서버를 등록하는 데 서로 다른 설정 파일 구조와 등록 방식을 사용합니다. 주요 차이점 [original] | 메이플스토리월드 MCP들은 VS Code, Claude, Cursor, Codex CLI에서 사용할 수 있습니다. 각 AI 에이전트마다 지원 여부가 다릅니다. 지원하는 설치 방식 중 하나를 크리에이터가 편의에 따라 선택해 설치할 수 있습니다. | 이름 | 설정 파일 최상위 키 | stdio 지원 | HTTP 지원 | CLI 등록 | | --- | --- | --- | --- | --- | | VS Code(Copilot Agent Mode) | servers | ⭕ | ⭕ | Command Palette | | VS Code + [chunk_id] | Guides:1368:1