[task] | distill [title] | Command Console 명령어 [category] | Guides [rephrased] | # Command Console 명령어 Command Console에서 사용 가능한 주요 명령어입니다. ## help 사용 가능한 명령어와 설명을 출력합니다. ```lua help [command=all] [-out stream] [-err stream] ``` * **command**: 설명을 출력할 명령어 이름. `all` 입력 시 전체 명령어 설명 출력. * **-out / -err**: 결과/에러 출력 스트림 설정. **예제** ```lua help findentity ``` ## echo 입력된 메시지를 결 [original] | # 학습 과정 소개 Command Console 창에서 사용할 수 있는 명령어들을 알아봅시다. # help 사용할 수 있는 명령어와 설명을 출력합니다. ```lua help [command=all] [-out stream] [-err stream] ``` #### 매개 변수 * **command**: 설명을 출력할 명령어의 이름입니다. all을 입력하면 모든 명령어의 설명이 출력됩니다. #### 옵션 * **-out**: 결과를 출력할 스트림을 설정합니다. * stream: 출력할 스트림입니다. * **-err* [chunk_id] | Guides:1195:0
[task] | diverse_qa [title] | Command Console [category] | Guides [rephrased] | 질문: 명령어의 옵션 작성 순서에 규칙이 있는가? 답변: 아니오, 옵션 작성 순서에는 규칙이 없으므로 크리에이터가 순서를 자유롭게 변경해 작성해도 무방합니다. 질문: 옵션을 사용할 때 옵션명 앞에 붙여야 하는 기호는 무엇인가? 답변: `-` 기호입니다. 질문: 옵션의 매개 변수를 작성할 때 순서 규칙이 있는가? 답변: 네, 옵션의 매개 변수는 정해진 순서대로 작성해 사용해야 합니다. 질문: `play -debug` 명령어의 `-debug` 옵션은 매개 변수가 있는가? 답변: 아니오, `-debug` 옵션은 매개 변수가 없기 때 [original] | 명령어마다 다양한 옵션을 제공합니다. 옵션은 크리에이터의 명령어 사용 의도에 따라 자유롭게 선택해 사용하면 됩니다. 옵션 작성 순서에는 규칙이 없으므로, 크리에이터가 순서를 자유롭게 변경해 작성해도 무방합니다. 옵션을 사용할 때는 `-`을 옵션명 앞에 붙여야 합니다. 옵션 또한 매개 변수를 가질 수 있습니다. 이때 옵션의 매개 변수는 정해진 순서대로 작성해 사용해야 합니다. 예를 들어, 명령어 play의 - debug의 경우 매개 변수가 없기 때문에 `play -debug`만을 입력해 debug 모드를 실행할 수 있습니다. 그러나 [chunk_id] | Guides:1194:1
[task] | knowledge_list [title] | Command Console 명령어 [category] | Guides [rephrased] | 1. `help` 명령어는 `[command=all] [-out stream] [-err stream]` 형식으로 사용되며, `command` 매개변수에 특정 명령어 이름을 입력하면 해당 명령어의 설명을 출력하고 `all`을 입력하면 모든 명령어의 설명을 출력합니다. 2. `help` 명령어의 `-out` 옵션은 결과 출력 스트림을 설정하는 데 사용되며, `-err` 옵션은 에러 출력 스트림을 설정하는 데 사용됩니다. 3. `echo` 명령어는 `echo message [-out stream] [-err stream]` 형식으로 사 [original] | # 학습 과정 소개 Command Console 창에서 사용할 수 있는 명령어들을 알아봅시다. # help 사용할 수 있는 명령어와 설명을 출력합니다. ```lua help [command=all] [-out stream] [-err stream] ``` #### 매개 변수 * **command**: 설명을 출력할 명령어의 이름입니다. all을 입력하면 모든 명령어의 설명이 출력됩니다. #### 옵션 * **-out**: 결과를 출력할 스트림을 설정합니다. * stream: 출력할 스트림입니다. * **-err* [chunk_id] | Guides:1195:0
[task] | distill [title] | Command Console 명령어 [category] | Guides [rephrased] | # Command Console 명령어 ## findcomponent 하이어라키 내 특정 컴포넌트를 찾습니다. **시그니처** ```lua findcomponent [-path path] [-enableonly] [-name name [match_type] [comparison_type]] [-out stream] [-err stream] ``` **옵션** * `-path`: 탐색 경로 * `-enableonly`: `Enable` 상태가 켜진 컴포넌트만 검색 * `-name`: 이름 기반 필터 * `match_typ [original] | * **-path** 컴포넌트를 찾을 경로를 지정합니다. * path : 컴포넌트를 찾을 경로입니다. * **-enableonly**: Enable이 켜져있는 컴포넌트만 찾습니다. * **-name**: 지정한 이름이 포함된 컴포넌트를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용할 수 있습니다. * contains: 지정한 이름이 포함된 이름의 컴포넌트를 찾습니다. * equ [chunk_id] | Guides:1195:2
[task] | distill [title] | Command Console 명령어 [category] | Guides [rephrased] | # 메이커 Command Console: 엔티티/컴포넌트 검색 메이커 환경의 Command Console에서 `findentity`와 `findcomponent` 명령어를 사용하여 특정 조건에 맞는 엔티티 또는 컴포넌트를 검색합니다. ## findentity 하이어라키에 있는 특정 엔티티를 찾습니다. ```lua findentity [-path path] [-visibleonly] [-enableonly] [-modelonly] [-name name [match_type=contains] [comparison_type=ordi [original] | * **-path**: 엔티티를 찾을 경로로 지정합니다 * path: 엔티티를 찾을 경로입니다. * **-visibleonly**: Visible인 엔티티만 찾습니다. * **-enableonly**: Enable인 엔티티만 찾습니다. * **-modelonly**: 모델을 확장한 엔티티만 찾습니다. * **-name**: 지정한 이름이 포함된 엔티티를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용합니다. [chunk_id] | Guides:1195:1
[task] | wikipedia [title] | Command Console 명령어 [category] | Guides [rephrased] | 메이플스토리 월드 메이커(Maker)의 Command Console은 스크립트 개발 및 디버깅을 위해 다양한 명령어를 제공합니다. 이 섹션에서는 세계를 플레이하는 데 사용되는 `play` 명령어와 그 옵션에 대해 설명합니다. `play` 명령어는 현재 작업 중인 월드를 실행하기 위해 사용됩니다. 이 명령어는 기본 모드 외에도 디버그 모드 실행 또는 가상 플레이어 추가와 같은 추가 옵션을 지원하여 개발자가 다양한 환경에서 월드를 테스트할 수 있도록 합니다. `play` 명령어의 기본 문법은 다음과 같습니다. ```lua play [original] | ```lua findproperty -name "Color" -component_name "SpriteGUIRendererComponent" ``` # play 월드를 플레이합니다. 디버그 모드로 실행하거나 가상 플레이어를 추가할 수 있습니다. ```lua play [-debug] [-virtual_player player_number] [-out stream] [-err stream] ``` #### 옵션 * **-debug**: 디버그 모드로 플레이합니다. * **-virtual_player**: 가상 플레이어를 추가합 [chunk_id] | Guides:1195:3
[task] | diverse_qa [title] | Command Console 명령어 [category] | Guides [rephrased] | 질문: `findproperty` 명령어 예제에서 `-name` 옵션에 지정된 값은 무엇이며, 어떤 컴포넌트 내에서 검색하나요? 답변: `-name` 옵션의 값은 "Color"이며, "SpriteGUIRendererComponent" 컴포넌트 내에서 검색합니다. 질문: `play` 명령어의 주요 기능은 무엇인가요? 답변: 월드를 플레이하는 기능입니다. 질문: `play` 명령어에서 디버그 모드로 실행하려면 어떤 옵션을 사용해야 하나요? 답변: `-debug` 옵션을 사용해야 합니다. 질문: `play` 명령어에서 가상 플레이어 [original] | ```lua findproperty -name "Color" -component_name "SpriteGUIRendererComponent" ``` # play 월드를 플레이합니다. 디버그 모드로 실행하거나 가상 플레이어를 추가할 수 있습니다. ```lua play [-debug] [-virtual_player player_number] [-out stream] [-err stream] ``` #### 옵션 * **-debug**: 디버그 모드로 플레이합니다. * **-virtual_player**: 가상 플레이어를 추가합 [chunk_id] | Guides:1195:3
[task] | extract_knowledge [title] | Command Console [category] | Guides [rephrased] | # Command Console ## 1. 개념 설명 Command Console은 메이플스토리 월드(MSW) 제작 환경에서 특정 동작을 즉시 수행하거나 디버깅을 위해 사용하는 인터페이스입니다. `Panel - Command Console` 메뉴를 통해 열 수 있으며, 주요 구성 요소는 다음과 같습니다. * **결과 창**: 실행한 명령어의 결과를 표시합니다. * **입력 창**: 명령어를 입력하는 공간입니다. 명령어 입력 후 `Enter` 키를 누르면 실행됩니다. Command Console에서는 MSW가 사전에 지정 [original] | # 학습 과정 소개 Command Console의 다양한 명령어를 사용해 특정한 동작을 바로 수행할 수 있습니다. 특정 프로퍼티를 사용하고 있는 모든 엔티티를 찾을 수도 있고, 디버그에 활용할 수도 있습니다. Command Console 활용법을 알아봅시다. # Command Console 소개 Panel - Command Console을 눌러 Command Console 창을 열 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/17307099056193c9 [chunk_id] | Guides:1194:0
[task] | wikipedia [title] | Command Console 명령어 [category] | Guides [rephrased] | **findentity** 명령어는 지정된 조건에 부합하는 엔티티를 검색하기 위해 사용됩니다. 이 명령어는 경로, 가시성, 활성화 상태, 모델 확장 여부, 이름, 모델 ID 등 다양한 필터 옵션을 지원하며, 검색 결과를 표준 출력 스트림 또는 파일로 리디렉션할 수 있습니다. **경로 및 상태 필터링 옵션** `-path` 옵션은 엔티티를 검색할 대상 경로를 지정합니다. 이 옵션에는 검색하고자 하는 엔티티의 경로(`path`)를 인자로 전달해야 합니다. 검색 범위를 더 좁히기 위해 `-visibleonly` 옵션을 사용하면 현재 [original] | * **-path**: 엔티티를 찾을 경로로 지정합니다 * path: 엔티티를 찾을 경로입니다. * **-visibleonly**: Visible인 엔티티만 찾습니다. * **-enableonly**: Enable인 엔티티만 찾습니다. * **-modelonly**: 모델을 확장한 엔티티만 찾습니다. * **-name**: 지정한 이름이 포함된 엔티티를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용합니다. [chunk_id] | Guides:1195:1
[task] | knowledge_list [title] | Command Console 명령어 [category] | Guides [rephrased] | 제시된 문서 내용에 기반하여 핵심 사실을 정리한 목록입니다. * `findproperty` 명령어는 `-name` 매개변수를 통해 속성 이름(예: "Color")을, `-component_name` 매개변수를 통해 해당 속성이 포함된 컴포넌트 이름(예: "SpriteGUIRendererComponent")을 지정하여 속성을 검색할 때 사용됩니다. * `play` 명령어는 메이플스토리 월드를 실행(플레이)하기 위해 사용되며, 디버그 모드 활성화, 가상 플레이어 추가, 표준 출력 및 에러 출력 스트림 설정 기능을 제공합니다. [original] | ```lua findproperty -name "Color" -component_name "SpriteGUIRendererComponent" ``` # play 월드를 플레이합니다. 디버그 모드로 실행하거나 가상 플레이어를 추가할 수 있습니다. ```lua play [-debug] [-virtual_player player_number] [-out stream] [-err stream] ``` #### 옵션 * **-debug**: 디버그 모드로 플레이합니다. * **-virtual_player**: 가상 플레이어를 추가합 [chunk_id] | Guides:1195:3
[task] | distill [title] | Lua Executor [category] | Guides [rephrased] | # Lua Executor 메이커에서 플레이 중 실시간으로 스크립트를 실행하여 월드에 즉시 반영하는 도구입니다. 서버, 클라이언트, 인스턴스 룸 중 실행 공간을 선택할 수 있으며, 출력 결과는 Console 창에서 확인합니다. ## 핵심 기능 * **실시간 실행**: 테스트 플레이 중 컴포넌트/프로퍼티 값 변경 및 스크립트 동작 확인. * **실행 공간 선택**: Server, Client, Instance Room 중 하나를 지정하여 실행. * **활용 범위**: Tween 값 조정, 카메라 이동 등 연출 및 로직 [original] | # 학습 과정 소개 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트, 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하거나, 서버 또는 클라이언트 환경에서 각각 만든 스크립트가 문제없이 작동하는지 확인하고 싶을 수 있습니다. Lua Executor로 이러한 내용을 쉽게 확인할 수 있습니다. 몇 가지 활용 예시와 함께 Lua Executor에 대해 알아봅시다. # Lua Excutor Lua Executor를 사용하면 메이커에서 플레이 중에 실시간으로 스크립트를 실행하고 즉시 월드에 반영됩니다. 크리에이터의 필요에 [chunk_id] | Guides:1196:0
[task] | distill [title] | Lua Executor [category] | Guides [rephrased] | # Lua Executor: 인스턴스 룸 생성 및 엔티티 위치 디버깅 **전제 조건** * `map02`의 `MapComponent`에서 **InstanceMap** 프로퍼티 활성화 * 디버깅 대상 엔티티 `TestTarget` 존재 ## 1. 인스턴스 룸 생성 `_RoomService:CreateInstanceRoom()` 호출 후 실행 환경에서 **Server_Instance_Test** 선택. ```lua _RoomService:CreateInstanceRoom("Test", {"map02"}, 200) ``` [original] | Lua Executor에서 인스턴스 룸을 생성하고, 인스턴스 룸에서 특정 엔티티의 위치를 디버깅해볼 수 있습니다. 1. map02를 생성하고, 프로퍼티 창에서 MapComponent의 **InstanceMap**을 활성화합니다. 2. 맵에 디버깅 대상인 새로운 TestTarget 엔티티를 추가합니다. 3. 테스트 플레이를 시작합니다. 4. `CreateInstanceRoom()`을 활용해 임시로 인스턴스 룸을 만듭니다. 아래와 같이 작성하고 [실행]을 누릅니다. ```lua _RoomService:Cre [chunk_id] | Guides:1196:2
[task] | diverse_qa [title] | Command Console 명령어 [category] | Guides [rephrased] | 질문: `findcomponent` 명령어에서 `-enableonly` 옵션의 역할은 무엇인가요? 답변: Enable이 켜져있는 컴포넌트만 찾도록 지정하는 옵션입니다. 질문: `findproperty` 명령어는 어떤 범위의 맵을 대상으로 프로퍼티를 찾을 수 있나요? 답변: 모든 맵을 대상으로 찾을 수 있습니다. 질문: `match_type` 파라미터에서 `regex`를 사용할 경우 어떤 방식으로 이름을 찾나요? 답변: 정규식을 사용하여 일치하는 이름의 컴포넌트나 프로퍼티를 찾습니다. 질문: `comparison_type` 파라 [original] | * **-path** 컴포넌트를 찾을 경로를 지정합니다. * path : 컴포넌트를 찾을 경로입니다. * **-enableonly**: Enable이 켜져있는 컴포넌트만 찾습니다. * **-name**: 지정한 이름이 포함된 컴포넌트를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용할 수 있습니다. * contains: 지정한 이름이 포함된 이름의 컴포넌트를 찾습니다. * equ [chunk_id] | Guides:1195:2
[task] | diverse_qa [title] | Command Console 명령어 [category] | Guides [rephrased] | 질문: `findentity` 명령어에서 `-path` 옵션의 역할은 무엇인가요? 답변: 엔티티를 찾을 경로로 지정합니다. 질문: `findentity` 명령어에서 `-visibleonly` 옵션을 사용하면 어떤 엔티티만 찾나요? 답변: Visible 상태인 엔티티만 찾습니다. 질문: `findentity` 명령어에서 `-enableonly` 옵션을 사용하면 어떤 엔티티만 찾나요? 답변: Enable 상태인 엔티티만 찾습니다. 질문: `findentity` 명령어에서 `-modelonly` 옵션을 사용하면 어떤 엔티티만 찾나요 [original] | * **-path**: 엔티티를 찾을 경로로 지정합니다 * path: 엔티티를 찾을 경로입니다. * **-visibleonly**: Visible인 엔티티만 찾습니다. * **-enableonly**: Enable인 엔티티만 찾습니다. * **-modelonly**: 모델을 확장한 엔티티만 찾습니다. * **-name**: 지정한 이름이 포함된 엔티티를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용합니다. [chunk_id] | Guides:1195:1
[task] | extract_knowledge [title] | Command Console 명령어 [category] | Guides [rephrased] | # 메이커 Command Console: `play` 명령어 ## 개념 설명 `play` 명령어는 메이플스토리 월드 메이커에서 현재 에디트 중인 월드를 실행(플레이)하는 기능을 수행합니다. 이 명령어는 기본 실행 모드뿐만 아니라, 디버깅을 위한 특수 모드(`-debug`)와 테스트 환경을 구성하기 위한 가상 플레이어(`-virtual_player`)를 주입하는 기능을 제공합니다. 또한, 표준 출력 및 에러 로그를 특정 스트림으로 리다이렉트할 수 있습니다. ## API 사용법 `play` 명령어의 기본 문법은 다음과 같습니다. [original] | ```lua findproperty -name "Color" -component_name "SpriteGUIRendererComponent" ``` # play 월드를 플레이합니다. 디버그 모드로 실행하거나 가상 플레이어를 추가할 수 있습니다. ```lua play [-debug] [-virtual_player player_number] [-out stream] [-err stream] ``` #### 옵션 * **-debug**: 디버그 모드로 플레이합니다. * **-virtual_player**: 가상 플레이어를 추가합 [chunk_id] | Guides:1195:3
[task] | knowledge_list [title] | Command Console 명령어 [category] | Guides [rephrased] | 제시된 문서 내용만 기반으로 추출한 `Command Console` 명령어 관련 핵심 사실 목록입니다. **참고:** 문서에는 `findentity`와 `findcomponent`의 일부 옵션 및 예제만 포함되어 있으며, `findcomponent`의 전체 옵션 목록은 문서에 명시되지 않아 해당 명령어의 상세 옵션은 제외하고, 문서에 명확히 기술된 내용만 정리합니다. 1. `-path` 옵션은 엔티티를 찾을 경로를 지정하며, `path` 매개변수로 해당 경로를 입력받습니다. 2. `-visibleonly` 옵션을 사용하면 ` [original] | * **-path**: 엔티티를 찾을 경로로 지정합니다 * path: 엔티티를 찾을 경로입니다. * **-visibleonly**: Visible인 엔티티만 찾습니다. * **-enableonly**: Enable인 엔티티만 찾습니다. * **-modelonly**: 모델을 확장한 엔티티만 찾습니다. * **-name**: 지정한 이름이 포함된 엔티티를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용합니다. [chunk_id] | Guides:1195:1
[task] | knowledge_list [title] | Lua Executor [category] | Guides [rephrased] | 제시된 문서 내용에만 근거하여 Lua Executor의 핵심 사실을 추출한 목록입니다. 1. **Lua Executor 기능**: 메이커에서 플레이 중 실시간으로 스크립트를 실행하여 즉시 월드에 반영하며, 크리에이터의 필요에 따라 다양한 스크립트를 실행해 월드를 확인하는 도구입니다. 2. **실행 공간 범위**: 작성한 스크립트는 서버, 클라이언트, 인스턴스 룸 세 가지 환경 중 설정된 공간에서 각각 실행됩니다. 3. **실행 결과 확인**: 스크립트 실행 결과는 Console 창에서 확인할 수 있습니다. 4. **스크립트 작성 [original] | # 학습 과정 소개 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트, 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하거나, 서버 또는 클라이언트 환경에서 각각 만든 스크립트가 문제없이 작동하는지 확인하고 싶을 수 있습니다. Lua Executor로 이러한 내용을 쉽게 확인할 수 있습니다. 몇 가지 활용 예시와 함께 Lua Executor에 대해 알아봅시다. # Lua Excutor Lua Executor를 사용하면 메이커에서 플레이 중에 실시간으로 스크립트를 실행하고 즉시 월드에 반영됩니다. 크리에이터의 필요에 [chunk_id] | Guides:1196:0
[task] | extract_knowledge [title] | Command Console 명령어 [category] | Guides [rephrased] | # Command Console 명령어 Command Console은 메이플스토리 월드 메이커 내에서 스크립트, 데이터셋, 엔티티 등을 관리하기 위해 사용되는 텍스트 기반 인터페이스입니다. 이 절에서는 `help`, `echo`, `export`, `import`, `findentity` 명령어의 문법과 사용법을 설명합니다. ## 1. help 사용 가능한 명령어 목록 및 개별 명령어의 설명을 조회합니다. ### 문법 ```lua help [command=all] [-out stream] [-err stream] ``` # [original] | # 학습 과정 소개 Command Console 창에서 사용할 수 있는 명령어들을 알아봅시다. # help 사용할 수 있는 명령어와 설명을 출력합니다. ```lua help [command=all] [-out stream] [-err stream] ``` #### 매개 변수 * **command**: 설명을 출력할 명령어의 이름입니다. all을 입력하면 모든 명령어의 설명이 출력됩니다. #### 옵션 * **-out**: 결과를 출력할 스트림을 설정합니다. * stream: 출력할 스트림입니다. * **-err* [chunk_id] | Guides:1195:0
[task] | distill [title] | Lua Executor [category] | Guides [rephrased] | # 메이커 사용 Lua Executor 테스트 플레이 중 맵 전경 확인, 서버 상태값 검증, 몬스터 소환 등 디버깅을 위해 Lua Executor를 사용합니다. ## 1. 맵 전경 확인 (CameraComponent) 1. **Workspace - MyDesk - Create Model**로 `transformonly` 모델 생성. 2. 모델에 `TransformComponent` 추가. 3. Lua Executor에 아래 코드 작성: ```lua local mapEntity = _EntityService:GetEn [original] | 커다란 맵을 만들었을 때는 맵 전체를 돌아보며 월드의 구성이 크리에이터가 생각한 바와 동일하게 만들어졌는지 확인이 필요합니다. Lua Executor를 활용해 테스트 플레이 중에 CameraComponent를 추가해 맵 전경을 확인할 수 있습니다. 1. **Workspace - MyDesk - Create Model**을 눌러 새로운 **transformonly** 모델을 생성합니다. 2. **TransformComponent**를 추가합니다. ![[object Object]](https://mod-file.dn.nexoncd [chunk_id] | Guides:1196:1
[task] | knowledge_list [title] | Command Console 명령어 [category] | Guides [rephrased] | 제공된 문서에 명시된 `findcomponent` 및 `findproperty` 명령어의 핵심 사실은 다음과 같습니다. 1. `findcomponent` 명령어의 `-path` 옵션은 컴포넌트를 찾을 경로를 지정하는 `path` 매개변수를 취하며, 이 경로를 기준으로 컴포넌트 검색을 수행합니다. 2. `findcomponent` 명령어의 `-enableonly` 옵션을 사용하면 `Enable` 상태가 켜져 있는 컴포넌트만 검색 결과에 포함됩니다. 3. `findcomponent` 명령어의 `-name` 옵션은 `name` 매 [original] | * **-path** 컴포넌트를 찾을 경로를 지정합니다. * path : 컴포넌트를 찾을 경로입니다. * **-enableonly**: Enable이 켜져있는 컴포넌트만 찾습니다. * **-name**: 지정한 이름이 포함된 컴포넌트를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용할 수 있습니다. * contains: 지정한 이름이 포함된 이름의 컴포넌트를 찾습니다. * equ [chunk_id] | Guides:1195:2
[task] | wikipedia [title] | Command Console 명령어 [category] | Guides [rephrased] | # 메이커 Command Console 명령어 메이플스토리 월드 메이커(Maker)의 Command Console 창은 스크립트 개발 및 워크스페이스 관리에 사용할 수 있는 다양한 명령어를 제공합니다. 본 문서는 주요 명령어인 `help`, `echo`, `export`, `import`, `findentity`의 구문, 매개 변수, 옵션, 그리고 사용 예제를 설명합니다. ## help `help` 명령어는 현재 사용 가능한 명령어 목록과 각 명령어의 기능 설명을 출력합니다. 특정 명령어에 대한 상세 설명이 필요할 경우 해당 [original] | # 학습 과정 소개 Command Console 창에서 사용할 수 있는 명령어들을 알아봅시다. # help 사용할 수 있는 명령어와 설명을 출력합니다. ```lua help [command=all] [-out stream] [-err stream] ``` #### 매개 변수 * **command**: 설명을 출력할 명령어의 이름입니다. all을 입력하면 모든 명령어의 설명이 출력됩니다. #### 옵션 * **-out**: 결과를 출력할 스트림을 설정합니다. * stream: 출력할 스트림입니다. * **-err* [chunk_id] | Guides:1195:0
[task] | wikipedia [title] | Lua Executor [category] | Guides [rephrased] | # Lua Executor 개요 메이커에서 제작한 월드를 테스트하는 과정에서 다양한 컴포넌트와 프로퍼티 값을 변경하여 실시간으로 의도한 동작이 정상인지 확인하거나, 서버 및 클라이언트 환경에서 각각 작성된 스크립트가 문제없이 작동하는지 검증할 필요가 있습니다. 이러한 목적을 위해 메이커에는 **Lua Executor** 기능이 제공되며, 이를 통해 크리에이터는 플레이 중 실시간으로 스크립트를 실행하고 그 결과를 즉시 월드에 반영할 수 있습니다. Lua Executor는 작성된 스크립트를 서버(Server), 클라이언트(Clien [original] | # 학습 과정 소개 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트, 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하거나, 서버 또는 클라이언트 환경에서 각각 만든 스크립트가 문제없이 작동하는지 확인하고 싶을 수 있습니다. Lua Executor로 이러한 내용을 쉽게 확인할 수 있습니다. 몇 가지 활용 예시와 함께 Lua Executor에 대해 알아봅시다. # Lua Excutor Lua Executor를 사용하면 메이커에서 플레이 중에 실시간으로 스크립트를 실행하고 즉시 월드에 반영됩니다. 크리에이터의 필요에 [chunk_id] | Guides:1196:0
[task] | knowledge_list [title] | Lua Executor [category] | Guides [rephrased] | 1. `InstanceMap` 프로퍼티는 `MapComponent`의 프로퍼티로, 맵을 인스턴스 룸으로 사용하도록 활성화하는 데 사용됩니다. 2. `_RoomService:CreateInstanceRoom(name, mapIds, maxUserCount)` 메서드는 서버에서 호출되며, 인스턴스 룸을 생성합니다. 매개변수 `name`은 인스턴스 룸 이름(문서 예시: "Test"), `mapIds`는 사용할 맵 ID 목록(문서 예시: {"map02"}), `maxUserCount`는 최대 사용자 수(문서 예시: 200)입니다. 3. ` [original] | Lua Executor에서 인스턴스 룸을 생성하고, 인스턴스 룸에서 특정 엔티티의 위치를 디버깅해볼 수 있습니다. 1. map02를 생성하고, 프로퍼티 창에서 MapComponent의 **InstanceMap**을 활성화합니다. 2. 맵에 디버깅 대상인 새로운 TestTarget 엔티티를 추가합니다. 3. 테스트 플레이를 시작합니다. 4. `CreateInstanceRoom()`을 활용해 임시로 인스턴스 룸을 만듭니다. 아래와 같이 작성하고 [실행]을 누릅니다. ```lua _RoomService:Cre [chunk_id] | Guides:1196:2
[task] | wikipedia [title] | Lua Executor [category] | Guides [rephrased] | **메이커 사용 Lua Executor** Lua Executor는 메이플스토리 월드 메이커 내에서 인스턴스 룸을 생성하고, 해당 환경에서 특정 엔티티의 상태를 디버깅하는 데 사용되는 도구입니다. 이 섹션에서는 Lua Executor를 활용해 인스턴스 룸을 생성한 후, `EntityService` API를 통해 특정 엔티티의 위치 정보를 콘솔에 출력하는 과정을 설명합니다. **인스턴스 룸 생성 및 엔티티 위치 디버깅 과정** 먼저, 디버깅 대상이 될 맵을 준비해야 합니다. `map02` 맵을 생성한 뒤, 프로퍼티 창에서 `Ma [original] | Lua Executor에서 인스턴스 룸을 생성하고, 인스턴스 룸에서 특정 엔티티의 위치를 디버깅해볼 수 있습니다. 1. map02를 생성하고, 프로퍼티 창에서 MapComponent의 **InstanceMap**을 활성화합니다. 2. 맵에 디버깅 대상인 새로운 TestTarget 엔티티를 추가합니다. 3. 테스트 플레이를 시작합니다. 4. `CreateInstanceRoom()`을 활용해 임시로 인스턴스 룸을 만듭니다. 아래와 같이 작성하고 [실행]을 누릅니다. ```lua _RoomService:Cre [chunk_id] | Guides:1196:2
[task] | extract_knowledge [title] | Lua Executor [category] | Guides [rephrased] | # Lua Executor ## 개념 설명 Lua Executor는 메이커(Maker) 환경에서 플레이 테스트 중 실시간으로 mLua 스크립트를 작성 및 실행할 수 있는 도구입니다. 이 도구를 사용하면 컴포넌트나 프로퍼티 값을 즉시 변경하여 월드에 반영하거나, 서버·클라이언트·인스턴스 룸 환경에서 스크립트 동작을 검증할 수 있습니다. 실행 결과는 Console 창에서 확인됩니다. ## API 사용법 및 화면 구성 Lua Executor 인터페이스는 다음과 같은 요소로 구성됩니다. 1. **실행 공간 설정**: 스크립트가 실행 [original] | # 학습 과정 소개 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트, 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하거나, 서버 또는 클라이언트 환경에서 각각 만든 스크립트가 문제없이 작동하는지 확인하고 싶을 수 있습니다. Lua Executor로 이러한 내용을 쉽게 확인할 수 있습니다. 몇 가지 활용 예시와 함께 Lua Executor에 대해 알아봅시다. # Lua Excutor Lua Executor를 사용하면 메이커에서 플레이 중에 실시간으로 스크립트를 실행하고 즉시 월드에 반영됩니다. 크리에이터의 필요에 [chunk_id] | Guides:1196:0
[task] | wikipedia [title] | Lua Executor [category] | Guides [rephrased] | # 메이커 사용 Lua Executor 메이플스토리 월드에서 대규모 맵을 제작한 경우, 크리에이터가 의도한 바와 동일하게 월드가 구성되었는지 맵 전체를 둘러보며 확인하는 과정이 필요합니다. 이러한 검증 작업은 Lua Executor를 활용하여 테스트 플레이 중 `CameraComponent`를 동적으로 추가함으로써 수행할 수 있습니다. ## 카메라를 이용한 맵 전경 확인 테스트 플레이 중에 맵의 전경을 관찰하기 위해 디버그용 카메라를 설정하는 절차는 다음과 같습니다. 1. **Workspace - MyDesk - Create [original] | 커다란 맵을 만들었을 때는 맵 전체를 돌아보며 월드의 구성이 크리에이터가 생각한 바와 동일하게 만들어졌는지 확인이 필요합니다. Lua Executor를 활용해 테스트 플레이 중에 CameraComponent를 추가해 맵 전경을 확인할 수 있습니다. 1. **Workspace - MyDesk - Create Model**을 눌러 새로운 **transformonly** 모델을 생성합니다. 2. **TransformComponent**를 추가합니다. ![[object Object]](https://mod-file.dn.nexoncd [chunk_id] | Guides:1196:1
[task] | diverse_qa [title] | Lua Executor [category] | Guides [rephrased] | 질문: Lua Executor의 주요 용도는 무엇인가요? 답변: 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트나 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하고, 서버 또는 클라이언트 환경에서 스크립트가 문제없이 작동하는지 확인하는 데 사용됩니다. 질문: Lua Executor에서 작성한 스크립트는 어떤 공간에서 실행할 수 있나요? 답변: 작성한 스크립트는 서버, 클라이언트, 인스턴스 룸에서 각각 실행할 수 있습니다. 질문: Lua Executor에서 실행한 값은 어디서 확인할 수 있나요? 답변: 실행한 값은 [original] | # 학습 과정 소개 메이커에서 제작한 월드를 테스트할 때 다양한 컴포넌트, 프로퍼티 값을 변경해 실시간으로 의도한 바가 맞는지 확인하거나, 서버 또는 클라이언트 환경에서 각각 만든 스크립트가 문제없이 작동하는지 확인하고 싶을 수 있습니다. Lua Executor로 이러한 내용을 쉽게 확인할 수 있습니다. 몇 가지 활용 예시와 함께 Lua Executor에 대해 알아봅시다. # Lua Excutor Lua Executor를 사용하면 메이커에서 플레이 중에 실시간으로 스크립트를 실행하고 즉시 월드에 반영됩니다. 크리에이터의 필요에 [chunk_id] | Guides:1196:0
[task] | distill [title] | RateLimitService 활용하기 [category] | Guides [rephrased] | # RateLimitService 활용하기 `RateLimitService`는 server 실행 함수(Native API 및 크리에이터 제작 함수)의 호출 빈도를 제한하여 패킷 변조 및 반복 호출로 인한 장애를 방지합니다. 룸별로 독립적으로 동작하며, Logic에서도 활용할 수 있습니다. ## 토큰 개념 - **maxToken**: 최대 토큰 한도. 함수 호출 시 1개씩 차감됩니다. - **tokenRefillPerSecond**: 초당 충전되는 토큰 수. (예: 0.2면 5초에 1개 충전) - 제한 도달 시 토큰 재충전 완료 [original] | # 학습 과정 소개 유저의 server 함수 사용량을 제한하는 방법을 알아봅시다. ##### 참고 가이드 [패킷 변조 대비하기](https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1102) [월드 인스턴스](https://maplestoryworlds-creators.nexon.com/ko/docs?postId=984) [인스턴스 맵 만들기](https://maplestoryworlds-creators.nexon.com/ko/docs/?postId=540) # RateL [chunk_id] | Guides:1197:0
[task] | diverse_qa [title] | Lua Executor [category] | Guides [rephrased] | 질문: Lua Executor에서 인스턴스 룸 생성과 엔티티 위치 디버깅을 수행하기 위해 먼저 어떤 설정을 해야 하나요? 답변: map02를 생성하고, 프로퍼티 창에서 MapComponent의 InstanceMap을 활성화해야 합니다. 질문: 디버깅 대상이 될 엔티티를 맵에 추가할 때 어떤 이름의 엔티티를 추가하나요? 답변: TestTarget 엔티티를 추가합니다. 질문: 임시 인스턴스 룸을 생성하기 위해 어떤 서비스의 메서드를 호출해야 하나요? 답변: _RoomService의 CreateInstanceRoom 메서드를 호출해야 [original] | Lua Executor에서 인스턴스 룸을 생성하고, 인스턴스 룸에서 특정 엔티티의 위치를 디버깅해볼 수 있습니다. 1. map02를 생성하고, 프로퍼티 창에서 MapComponent의 **InstanceMap**을 활성화합니다. 2. 맵에 디버깅 대상인 새로운 TestTarget 엔티티를 추가합니다. 3. 테스트 플레이를 시작합니다. 4. `CreateInstanceRoom()`을 활용해 임시로 인스턴스 룸을 만듭니다. 아래와 같이 작성하고 [실행]을 누릅니다. ```lua _RoomService:Cre [chunk_id] | Guides:1196:2
[task] | wikipedia [title] | Command Console 명령어 [category] | Guides [rephrased] | # 메이커 사용 Command Console 명령어: findcomponent `findcomponent` 명령어는 하이어라키 내에서 특정 컴포넌트를 검색하는 데 사용됩니다. 이 명령어는 지정된 경로 또는 전체 맵을 대상으로 컴포넌트를 찾을 수 있으며, 이름 기반 필터링과 출력 스트림 지정 기능을 제공합니다. 명령어 구문은 다음과 같습니다. ```lua findcomponent [-path path] [-enableonly] [-name name [match_type=contains] [comparison_type=ordina [original] | * **-path** 컴포넌트를 찾을 경로를 지정합니다. * path : 컴포넌트를 찾을 경로입니다. * **-enableonly**: Enable이 켜져있는 컴포넌트만 찾습니다. * **-name**: 지정한 이름이 포함된 컴포넌트를 찾습니다. * name: 찾을 이름입니다. * match_type: 이름을 찾는 방식입니다. contains, equals, regex 중 하나를 사용할 수 있습니다. * contains: 지정한 이름이 포함된 이름의 컴포넌트를 찾습니다. * equ [chunk_id] | Guides:1195:2