[task] | distill [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 프로파일러로 월드 성능 분석하기 ## 엔티티 성능 지표 맵 및 UI 그룹별 엔티티 총 개수와 생성/파괴 횟수를 표시합니다. 모바일 환경에서 엔티티 5,000개 이상 시 성능 저하가 발생할 수 있으므로 **5,000개 이하**로 관리해야 합니다. | 항목 | 설명 | | :--- | :--- | | **Total Entity** | 현재 월드의 총 엔티티 수.<br>- **Client**: User Entity가 존재하는 맵만 로드.<br>- **Server**: 테스트 플레이 시 User Entity가 이동한 맵은 로드 후 [original] | 맵 별, UI 그룹 별 엔티티의 총 개수와 엔티티 생성 / 파괴 횟수를 보여줍니다. 엔티티의 생성 / 파괴가 자주 발생하면 전반적인 성능에 좋지 않습니다. 기기의 사양마다 다르지만 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 그러므로 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. | 항목 | 설명 | | --- | --- | | Total Entity | 현재 월드에 생성된 모든 엔티티의 개수입니다.<ul> <li> Client <ul> <li>User Entity가 존재하 [chunk_id] | Guides:1078:2
[task] | distill [title] | 공동 제작 그룹 멤버의 등급과 권한 [category] | Guides [rephrased] | ### 메이커 공동 제작 그룹 멤버 권한 그룹 멤버 등급(그룹장, 매니저, 개발책임자, 개발자, 운영책임자, 운영자, 일반)별 권한은 아래 표와 같습니다. 그룹장은 멤버의 등급을 설정할 수 있습니다. | 기능 설명 | 그룹장 | 매니저 | 개발책임자 | 개발자 | 운영책임자 | 운영자 | 일반 | | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | CREATOR 마크 표시 | O | O | O | O | O | O | X | | LocaleDataSet 동기화 [original] | 그룹 멤버 등급별로 주어지는 권한은 아래와 같습니다. 그룹장은 아래 내용을 참고하여 각 멤버의 등급을 적절하게 설정할 수 있습니다. | 기능 설명 | 그룹장 | 매니저 | 개발책임자 | 개발자 | 운영책임자 | 운영자 | 일반 | | --- | --- | --- | --- | --- | --- | --- | --- | | CREATOR 마크 표시 | O | O | O | O | O | O | X | | LocaleDataSet 동기화 권한 | O | O | O | O | X | X | X | | MOD 파일 Import/Expor [chunk_id] | Guides:1077:1
[task] | wikipedia [title] | 공동 제작 그룹 멤버의 등급과 권한 [category] | Guides [rephrased] | # 메이커 사용 공동 제작 그룹 멤버의 등급과 권한 메이플스토리 월드 메이커에서 공동 제작을 위해 그룹을 구성할 경우, 그룹 내 멤버의 역할에 따라 허용되는 권한이 차등 적용됩니다. 그룹장은 그룹의 운영 상황과 업무 분장에 맞춰 각 멤버의 등급을 적절하게 설정할 수 있으며, 이 문서에서는 그룹장, 매니저, 개발책임자, 개발자, 운영책임자, 운영자, 일반으로 구분되는 7가지 등급별 권한 범위를 상세히 설명합니다. ## 기본 권한 및 그룹 관리 그룹 내 모든 멤버에게 공통적으로 부여되는 기본 권한은 **그룹의 비출시 또는 비공개 [original] | 그룹 멤버 등급별로 주어지는 권한은 아래와 같습니다. 그룹장은 아래 내용을 참고하여 각 멤버의 등급을 적절하게 설정할 수 있습니다. | 기능 설명 | 그룹장 | 매니저 | 개발책임자 | 개발자 | 운영책임자 | 운영자 | 일반 | | --- | --- | --- | --- | --- | --- | --- | --- | | CREATOR 마크 표시 | O | O | O | O | O | O | X | | LocaleDataSet 동기화 권한 | O | O | O | O | X | X | X | | MOD 파일 Import/Expor [chunk_id] | Guides:1077:1
[task] | distill [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | ```markdown ## Sync Property Count 동기화 횟수(송신/수신)를 프로퍼티별·컴포넌트별로 추적합니다. - **주의**: Sync Property는 내부 동기화 로직을 거치므로, 개수 증가 시 FPS/Tick 성능 저하 유발. - **개선**: 동기화 불필요 프로퍼티는 `[None]`으로 변경. 모든 User 대상 동기화 불필요 시 실행 공간 함수의 `TargetUserId` 활용으로 동기화량 감소. ## Sync Property Byte 동기화 데이터량(Byte)을 프로퍼티별·컴포넌트별로 추적합니다. - * [original] | Sync Property의 동기화 횟수입니다. | 항목 | 설명 | | --- | --- | | Send Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 송신 횟수입니다. | | Receive Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 수신 횟수입니다. | ##### Sync Property Count 관련 성능 저하 개선 Sync Property Count가 많아지면 FPS나 Tick에 악영향을 끼칠 수 있습니다. Sync Property는 None-Sync Property와 달리 내부적으로 동기 [chunk_id] | Guides:1078:3
[task] | knowledge_list [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | 제공된 문서의 내용을 바탕으로 핵심 사실을 정리한 목록입니다. 1. 프로파일러는 맵별 및 UI 그룹별 엔티티의 총 개수와 생성/파괴 횟수를 표시하며, 엔티티 생성/파괴가 빈번하면 전반적인 성능 저하를 유발하므로 모바일 환경에서는 엔티티 개수를 5000개 이하로 관리하는 것이 권장됩니다. 2. `Total Entity` 항목은 현재 월드에 생성된 모든 엔티티의 개수를 나타내며, 클라이언트는 User Entity가 존재하는 맵 이외의 맵을 불러오지 않는 반면, 서버는 메이커 테스트 시 User Entity가 이동했던 맵은 불러온 후 [original] | 맵 별, UI 그룹 별 엔티티의 총 개수와 엔티티 생성 / 파괴 횟수를 보여줍니다. 엔티티의 생성 / 파괴가 자주 발생하면 전반적인 성능에 좋지 않습니다. 기기의 사양마다 다르지만 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 그러므로 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. | 항목 | 설명 | | --- | --- | | Total Entity | 현재 월드에 생성된 모든 엔티티의 개수입니다.<ul> <li> Client <ul> <li>User Entity가 존재하 [chunk_id] | Guides:1078:2
[task] | diverse_qa [title] | 공동 제작 그룹 멤버의 등급과 권한 [category] | Guides [rephrased] | 질문: 그룹 멤버 등급 중 '일반' 등급은 CREATOR 마크 표시 권한이 있는가? 답변: 아니요, '일반' 등급은 CREATOR 마크 표시 권한이 없습니다. 질문: '매니저' 등급이 수행할 수 있는 권한으로 틀린 것을 고르시오. 1. 가입 신청 승인 / 거절 2. 매니저 권한 설정 / 삭제 3. 매니저 미만 그룹원의 등급 조절 4. 그룹 소속의 출시 전 월드 삭제 답변: 2번. 매니저 권한 설정 / 삭제는 '그룹장'만 수행할 수 있는 권한입니다. 질문: '개발책임자' 등급은 그룹의 비출시 및 비공개 월드를 열람하고 플레이할 수 [original] | 그룹 멤버 등급별로 주어지는 권한은 아래와 같습니다. 그룹장은 아래 내용을 참고하여 각 멤버의 등급을 적절하게 설정할 수 있습니다. | 기능 설명 | 그룹장 | 매니저 | 개발책임자 | 개발자 | 운영책임자 | 운영자 | 일반 | | --- | --- | --- | --- | --- | --- | --- | --- | | CREATOR 마크 표시 | O | O | O | O | O | O | X | | LocaleDataSet 동기화 권한 | O | O | O | O | X | X | X | | MOD 파일 Import/Expor [chunk_id] | Guides:1077:1
[task] | distill [title] | 광부 시뮬레이터 리메이크 [category] | Guides [rephrased] | **[응용 제작 가이드] 광부 시뮬레이터 리메이크** 기존 `광부 시뮬레이터` 월드를 복제하여 커스텀 시뮬레이터를 구축하는 가이드입니다. 해당 리메이크 월드에는 `Component`, `Logic`, `Model`, `DataSet`, `UI` 자원이 포함되어 있어, [광부 시뮬레이터](/resource/?postId=1093) 강의 학습 시 구조 분석과 보조 교재로 활용 가능합니다. [original] | [내가 직접 만드는 광부 시뮬레이터](https://maplestoryworlds.nexon.com/ko/play/7b3b29fc662a4cd7ba82858ec92953ae/) 월드를 리메이크해 나만의 광부 시뮬레이터를 만들 수 있습니다. 리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있습니다. [광부 시뮬레이터](/resource/?postId=1093) 강의를 학습할 때 보조 교재로 활용할 수 있습니다. $$childList $$ [chunk_id] | Guides:1081:0
[task] | wikipedia [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 성능 프로파일러로 월드 성능 분석하기 메이플스토리 월드에서는 스크립트 코드의 실행 효율성을 중점적으로 분석하는 루아 프로파일러와 별개로, 현재 월드의 전반적인 성능에 영향을 미치는 요인을 종합적으로 파악하기 위한 성능 프로파일러(이하 프로파일러)를 제공합니다. 이 프로파일러를 활용하여 월드 성능을 저하시키는 원인을 진단하고, 이를 개선함으로써 월드의 전반적인 성능을 향상시킬 수 있습니다. 본 가이드에서는 프로파일러의 실행 방법, 사용자 인터페이스(UI) 구성, 그리고 수집된 데이터의 해석 방식을 상세히 소개합니다. 루아 프로 [original] | # 학습 과정 소개 메이플스토리 월드의 루아 프로파일러가 스크립트를 중점적으로 분석하는 도구라면 성능 프로파일러(이하 프로파일러)는 현재 월드의 성능에 영향을 미칠 수 있는 요인들에 대해 전반적인 분석 결과를 보여줍니다. 프로파일링을 통해 월드 성능을 저하시키는 요인을 파악할 수 있고 이를 해결하여 월드 성능을 향상시킬 수 있습니다. 이번 과정에서는 프로파일러의 실행 및 사용 방법, 그리고 데이터 분석 결과를 해석하는 방법을 살펴보겠습니다. ##### 참고 가이드 [루아 프로파일러 활용하기](/docs/?postId=762) [chunk_id] | Guides:1078:0
[task] | diverse_qa [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | 질문: 메이플스토리 월드에서 클라이언트 FPS가 떨어지면 어떤 현상이 발생합니까? 답변: FPS가 떨어지면 화면 재생에 영향을 미쳐 화면 끊김이 발생할 수 있습니다. 질문: 메이플스토리 월드에서 권장하는 최소 클라이언트 FPS는 얼마입니까? 답변: 최소 30FPS를 유지하는 것을 권장합니다. 질문: World FPS와 Engine FPS 중 크리에이터의 로직을 처리하는 월드 코어의 FPS를 보여주는 것은 무엇입니까? 답변: World FPS입니다. 질문: World FPS가 떨어지는 원인으로 거론되는 요인들을 세 가지 이상 나 [original] | 유저가 각각 사용하는 PC, 모바일 기기의 사양이 매우 다양하기 때문에 같은 월드라도 플레이 환경의 쾌적함 정도는 상당히 달라질 수 있습니다. 하지만 대략적으로 분석 수치가 아래와 같을 경우 해당 월드의 성능을 어느 정도 판단할 수 있습니다. 아래의 수치는 대략적인 참고값으로 활용할 수 있으며, 그 이전에도 체감되지 않는 성능 하락은 발생할 수 있습니다. ### FPS (Client) FPS는 클라이언트에서 측정하는 요소로 반응성 및 화면 재생과 관련이 있습니다. * 플레이할 때 화면 재생에 영향을 미칩니다. FPS가 떨어지면 [chunk_id] | Guides:1078:1
[task] | extract_knowledge [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 1. 월드 성능 분석 및 최적화 메이플스토리 월드(MapleStory Worlds)의 성능은 유저 기기의 사양에 따라 체감 정도가 달라지지만, 프로파일러에서 제공하는 핵심 지표(FPS, Tick, Memory, Entity)를 기준으로 성능 저하 원인을 진단하고 최적화할 수 있습니다. ## 1.1 개념 설명 ### FPS (Client) 클라이언트에서 측정되는 지표로, 화면 재생의 매끄러움과 반응성을 나타냅니다. FPS가 떨어지면 화면 끊김이 발생하며, 최소 **30FPS** 유지가 권장됩니다. FPS는 두 가지 구성 요소 [original] | 유저가 각각 사용하는 PC, 모바일 기기의 사양이 매우 다양하기 때문에 같은 월드라도 플레이 환경의 쾌적함 정도는 상당히 달라질 수 있습니다. 하지만 대략적으로 분석 수치가 아래와 같을 경우 해당 월드의 성능을 어느 정도 판단할 수 있습니다. 아래의 수치는 대략적인 참고값으로 활용할 수 있으며, 그 이전에도 체감되지 않는 성능 하락은 발생할 수 있습니다. ### FPS (Client) FPS는 클라이언트에서 측정하는 요소로 반응성 및 화면 재생과 관련이 있습니다. * 플레이할 때 화면 재생에 영향을 미칩니다. FPS가 떨어지면 [chunk_id] | Guides:1078:1
[task] | diverse_qa [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | 질문: 모바일 환경에서 엔티티가 5000개 이상일 경우 어떤 현상이 발생할 수 있나요? 답변: 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 질문: 월드의 엔티티 개수를 관리할 때 권장되는 상한선은 얼마인가요? 답변: 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. 질문: 프로파일러의 'Total Entity' 항목에서 Client와 Server의 맵 불러오기 방식은 어떻게 다른가요? 답변: Client는 User Entity가 존재하는 맵 이외의 다른 맵은 불러오지 않습니다 [original] | 맵 별, UI 그룹 별 엔티티의 총 개수와 엔티티 생성 / 파괴 횟수를 보여줍니다. 엔티티의 생성 / 파괴가 자주 발생하면 전반적인 성능에 좋지 않습니다. 기기의 사양마다 다르지만 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 그러므로 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. | 항목 | 설명 | | --- | --- | | Total Entity | 현재 월드에 생성된 모든 엔티티의 개수입니다.<ul> <li> Client <ul> <li>User Entity가 존재하 [chunk_id] | Guides:1078:2
[task] | knowledge_list [title] | 광부 시뮬레이터 리메이크 [category] | Guides [rephrased] | 제시된 원문에는 mLua 스크립트 언어의 구체적인 API 이름, 매개변수, 반환 타입, 또는 서버/클라이언트 실행 공간 제약에 대한 기술적 정보가 포함되어 있지 않습니다. 원문에는 '리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있다'는 내용만 언급되어 있으며, 구체적인 스크립트 규칙이나 함수 시그니처는 없습니다. 따라서 요청하신 조건(완결된 문장, API 명세 포함)을 충족하는 기술적 사실은 추출할 수 없습니다. [original] | [내가 직접 만드는 광부 시뮬레이터](https://maplestoryworlds.nexon.com/ko/play/7b3b29fc662a4cd7ba82858ec92953ae/) 월드를 리메이크해 나만의 광부 시뮬레이터를 만들 수 있습니다. 리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있습니다. [광부 시뮬레이터](/resource/?postId=1093) 강의를 학습할 때 보조 교재로 활용할 수 있습니다. $$childList $$ [chunk_id] | Guides:1081:0
[task] | wikipedia [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 보안 및 최적화: 프로파일러로 월드 성능 분석하기 메이플스토리 월드(MapleStory Worlds)의 플레이 환경은 사용자가 사용하는 PC나 모바일 기기의 사양에 따라 크게 달라질 수 있습니다. 따라서 동일한 월드라도 사용자마다 체감하는 쾌적함의 정도가 상이할 수 있습니다. 이러한 변수에도 불구하고, 프로파일러에서 제공하는 특정 지표들을 기준으로 하여 월드의 전반적인 성능 상태를 진단할 수 있습니다. 아래에 제시되는 수치들은 대략적인 참고값이며, 이러한 임계값에 도달하기 전이라도 사용자가 인지할 수 있는 수준의 성능 저하가 [original] | 유저가 각각 사용하는 PC, 모바일 기기의 사양이 매우 다양하기 때문에 같은 월드라도 플레이 환경의 쾌적함 정도는 상당히 달라질 수 있습니다. 하지만 대략적으로 분석 수치가 아래와 같을 경우 해당 월드의 성능을 어느 정도 판단할 수 있습니다. 아래의 수치는 대략적인 참고값으로 활용할 수 있으며, 그 이전에도 체감되지 않는 성능 하락은 발생할 수 있습니다. ### FPS (Client) FPS는 클라이언트에서 측정하는 요소로 반응성 및 화면 재생과 관련이 있습니다. * 플레이할 때 화면 재생에 영향을 미칩니다. FPS가 떨어지면 [chunk_id] | Guides:1078:1
[task] | diverse_qa [title] | 광부 시뮬레이터 리메이크 [category] | Guides [rephrased] | 질문: 광부 시뮬레이터 리메이크 가이드는 어떤 목적으로 제공되는가? 답변: 사용자가 '내가 직접 만드는 광부 시뮬레이터' 월드를 기반으로 나만의 광부 시뮬레이터를 제작할 수 있도록 돕기 위해 제공된다. 질문: 리메이크 월드에서 확인할 수 있는 정보 유형에는 어떤 것들이 포함되는가? 답변: Component, Logic, Model, DataSet, UI 정보가 포함된다. 질문: 이 리메이크 가이드는 어떤 강의와 함께 활용할 수 있는가? 답변: [광부 시뮬레이터] 강의를 학습할 때 보조 교재로 활용할 수 있다. 질문: 리메이크 [original] | [내가 직접 만드는 광부 시뮬레이터](https://maplestoryworlds.nexon.com/ko/play/7b3b29fc662a4cd7ba82858ec92953ae/) 월드를 리메이크해 나만의 광부 시뮬레이터를 만들 수 있습니다. 리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있습니다. [광부 시뮬레이터](/resource/?postId=1093) 강의를 학습할 때 보조 교재로 활용할 수 있습니다. $$childList $$ [chunk_id] | Guides:1081:0
[task] | wikipedia [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | **보안 및 최적화 프로파일러로 월드 성능 분석하기** 본 문서는 메이플스토리 월드(MapleStory Worlds)의 보안 및 최적화 프로파일러를 통해 월드의 성능을 분석하고 엔티티 및 실행 공간 관련 성능 저하를 개선하는 방법에 대해 다룹니다. ### 엔티티 성능 지표 프로파일러는 맵 및 UI 그룹 단위로 엔티티의 총 개수와 생성·파괴 횟수를 제공하여 월드의 부하 상태를 확인하는 데 도움을 줍니다. 엔티티의 생성과 파괴가 빈번하게 발생하면 전반적인 성능에 부정적인 영향을 미칩니다. 기기의 사양에 따라 차이는 있으나, 모바일 [original] | 맵 별, UI 그룹 별 엔티티의 총 개수와 엔티티 생성 / 파괴 횟수를 보여줍니다. 엔티티의 생성 / 파괴가 자주 발생하면 전반적인 성능에 좋지 않습니다. 기기의 사양마다 다르지만 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 그러므로 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. | 항목 | 설명 | | --- | --- | | Total Entity | 현재 월드에 생성된 모든 엔티티의 개수입니다.<ul> <li> Client <ul> <li>User Entity가 존재하 [chunk_id] | Guides:1078:2
[task] | wikipedia [title] | 광부 시뮬레이터 리메이크 [category] | Guides [rephrased] | # 광부 시뮬레이터 리메이크 **광부 시뮬레이터 리메이크**는 메이플스토리 월드 플랫폼 내 기존에 공개된 "[내가 직접 만드는 광부 시뮬레이터]" 월드를 기반으로, 사용자가 자신의 창작 의도에 맞춰 수정 및 재구현할 수 있도록 설계된 응용 제작 가이드 자료입니다. ## 개요 및 목적 본 자료는 특정 월드 리소스를 리메이크하는 과정을 통해 사용자가 나만의 광부 시뮬레이터를 개발하는 방법을 안내하는 것을 목적으로 합니다. 이는 단순한 복제가 아닌, 기존 구조를 분석하여 독자적인 로직과 설계를 적용하는 제작 프로세스에 초점을 맞추고 [original] | [내가 직접 만드는 광부 시뮬레이터](https://maplestoryworlds.nexon.com/ko/play/7b3b29fc662a4cd7ba82858ec92953ae/) 월드를 리메이크해 나만의 광부 시뮬레이터를 만들 수 있습니다. 리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있습니다. [광부 시뮬레이터](/resource/?postId=1093) 강의를 학습할 때 보조 교재로 활용할 수 있습니다. $$childList $$ [chunk_id] | Guides:1081:0
[task] | knowledge_list [title] | 다각형 그리기 [category] | Guides [rephrased] | * `PolygonRendererComponent`는 추가된 점의 순서대로 선을 이어 월드에 다각형을 표현하는 컴포넌트입니다. * 다각형의 변(선)끼리 교차하는 경우 다각형이 그려지지 않으며, 현재 상태의 다각형이 그려질 수 있는지 확인하기 위해 `IsDrawable()` 함수를 사용해야 합니다. * `PolygonRendererComponent`의 `Points` 프로퍼티는 선을 구성하는 정점들의 집합을 나타내며, `Size` 값은 0부터 시작하여 해당 값만큼 점의 개수를 결정합니다. * `Points` 프로퍼티 내 [original] | # 학습 과정 안내 PolygonRendererComponent를 활용해 다각형을 월드에 자유롭게 그릴 수 있습니다. # PolygonRendererComponent `PolygonRendererComponent`는 점을 이어 월드에 다각형을 그릴 수 있습니다. 추가된 점의 순서를 따라 다각형이 그려집니다. 만약 점을 이을 때 선이 교차하면 다각형은 그려지지 않습니다. 다각형이 그려지는지 확인이 필요할 때는 `IsDrawable()` 함수를 사용해 확인할 수 있습니다. 아래와 같이 점들의 좌표를 입력하면 (0,0) (3,2) [chunk_id] | Guides:1080:0
[task] | knowledge_list [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | ```lua -- 이 블록은 문서 검토 결과에 대한 구조화된 요약입니다. -- 실제 실행 코드가 아닌 정보 목록입니다. local key_facts = { "Sync Property Count의 Send Count는 컴포넌트 단위 및 프로퍼티별 동기화 송신 횟수를 나타내는 프로파일러 지표입니다.", "Sync Property Count의 Receive Count는 컴포넌트 단위 및 프로퍼티별 동기화 수신 횟수를 나타내는 프로파일러 지표입니다.", "Sync Property는 None-Sync Property와 [original] | Sync Property의 동기화 횟수입니다. | 항목 | 설명 | | --- | --- | | Send Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 송신 횟수입니다. | | Receive Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 수신 횟수입니다. | ##### Sync Property Count 관련 성능 저하 개선 Sync Property Count가 많아지면 FPS나 Tick에 악영향을 끼칠 수 있습니다. Sync Property는 None-Sync Property와 달리 내부적으로 동기 [chunk_id] | Guides:1078:3
[task] | distill [title] | 다각형 그리기 [category] | Guides [rephrased] | # 객체 표현 다각형 그리기 (PolygonRendererComponent) `PolygonRendererComponent`는 입력된 점(`Points`)의 순서에 따라 다각형을 렌더링합니다. ## 주요 동작 규칙 및 주의사항 * **교차 금지**: 선분이 서로 교차하면 다각형이 그려지지 않습니다. * **검증**: `IsDrawable()` 함수를 통해 현재 상태의 다각형이 그려질 수 있는지 확인합니다. * **최대 점 수**: `Points`가 **2,000개**를 초과하면 이후 점은 렌더링되지 않습니다. * [original] | # 학습 과정 안내 PolygonRendererComponent를 활용해 다각형을 월드에 자유롭게 그릴 수 있습니다. # PolygonRendererComponent `PolygonRendererComponent`는 점을 이어 월드에 다각형을 그릴 수 있습니다. 추가된 점의 순서를 따라 다각형이 그려집니다. 만약 점을 이을 때 선이 교차하면 다각형은 그려지지 않습니다. 다각형이 그려지는지 확인이 필요할 때는 `IsDrawable()` 함수를 사용해 확인할 수 있습니다. 아래와 같이 점들의 좌표를 입력하면 (0,0) (3,2) [chunk_id] | Guides:1080:0
[task] | wikipedia [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | **보안 및 최적화: 프로파일러를 이용한 월드 성능 분석** mLua 프로파일러는 월드 실행 중 발생하는 동기화 트래픽, 타이머 관리, 그리고 트윈(Tween) 로직의 상태를 정량적으로 확인하여 성능 병목을 식별하고 최적화 전략을 수립하는 데 활용됩니다. 이 섹션에서는 프로파일러가 제공하는 주요 지표와 각 지표가 높게 측정될 경우 발생할 수 있는 성능 저하 원인 및 개선 방법에 대해 설명합니다. ### Sync Property Count Sync Property Count는 `[Sync]` 속성(Sync Property)의 동 [original] | Sync Property의 동기화 횟수입니다. | 항목 | 설명 | | --- | --- | | Send Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 송신 횟수입니다. | | Receive Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 수신 횟수입니다. | ##### Sync Property Count 관련 성능 저하 개선 Sync Property Count가 많아지면 FPS나 Tick에 악영향을 끼칠 수 있습니다. Sync Property는 None-Sync Property와 달리 내부적으로 동기 [chunk_id] | Guides:1078:3
[task] | distill [title] | UI Group [category] | Guides [rephrased] | # 광부 시뮬레이터 UI Group 구성 각 Group은 특정 상황이나 기능에 따라 활성화되는 UI 컴포넌트를 포함합니다. ## HUDGroup - **MineHUD**: 광산 입장 시 활성화. 시야 범위, 탐험 도구, 깊이, 머무른 시간 표시. - **TownHUD**: 마을 입장 시 활성화. 메뉴 열기 버튼 및 메뉴 목록 표시. - **HUD**: 항상 활성화되는 기본 HUD. ## 상점 및 인벤토리 Group - **MineralExchangeGroup**: `MineralExchange` - 광물 상점 UI. - **E [original] | 광부 시뮬레이터를 구성하는 UI Group은 다음과 같습니다. # HUDGroup #### MineHUD 광산에 입장하면 활성화되는 HUD입니다. 광산에서의 시야 범위, 탐험 도구, 깊이, 머무른 시간 등이 포함됩니다. #### TownHUD 마을에 입장하면 활성화되는 HUD입니다. 메뉴 열기 버튼, 메뉴들이 포함됩니다. #### HUD 항상 활성화되는 HUD입니다. # MineralExchangeGroup #### MineralExchange 광물 상점 UI입니다. # EquipmentShopGroup ### [chunk_id] | Guides:1082:0
[task] | extract_knowledge [title] | 광부 시뮬레이터 리메이크 [category] | Guides [rephrased] | 제공된 원문에는 mLua 스크립트 코드, 구체적인 API 명세, 변수 정의, 함수 구현 로직이 포함되어 있지 않습니다. 원문은 특정 월드 리소스 링크와 강의 보조 교재로서의 활용 목적을 안내하는 메타 정보만 담고 있으며, "없는 사실·API·코드 예제를 지어내지 않습니다"라는 지시에 따라 코드 블록 생성이 불가능합니다. 따라서 요청하신 "개념 설명 → API 사용법 → 예제 → 주의사항" 구조 중, 원문에 명시된 정보만으로 재구성 가능한 내용은 다음과 같습니다. ### 광부 시뮬레이터 리메이크 월드 활용 #### 개념 설명 ` [original] | [내가 직접 만드는 광부 시뮬레이터](https://maplestoryworlds.nexon.com/ko/play/7b3b29fc662a4cd7ba82858ec92953ae/) 월드를 리메이크해 나만의 광부 시뮬레이터를 만들 수 있습니다. 리메이크 월드에서 제공하는 Component, Logic, Model, DataSet, UI 정보를 확인할 수 있습니다. [광부 시뮬레이터](/resource/?postId=1093) 강의를 학습할 때 보조 교재로 활용할 수 있습니다. $$childList $$ [chunk_id] | Guides:1081:0
[task] | extract_knowledge [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 프로파일러를 통한 월드 성능 분석 및 최적화 ## 1. 개념 설명 메이플스토리 월드에서 성능 프로파일러는 맵 및 UI 그룹 단위로 엔티티의 상태와 네트워크 통신량을 모니터링하는 도구입니다. 주요 분석 대상은 다음과 같습니다. 1. **엔티티 성능**: 현재 존재하는 엔티티 총 개수(`Total Entity`)와 생성/파괴 빈도(`Construct / Destroy Entity`)를 추적합니다. 모바일 환경에서 엔티티가 5000개 이상일 경우 성능 저하가 발생할 수 있어, 이 수치를 기준으로 최적화가 필요합니다. 2. * [original] | 맵 별, UI 그룹 별 엔티티의 총 개수와 엔티티 생성 / 파괴 횟수를 보여줍니다. 엔티티의 생성 / 파괴가 자주 발생하면 전반적인 성능에 좋지 않습니다. 기기의 사양마다 다르지만 모바일 환경에서는 엔티티가 5000개 이상일 경우 성능 저하 현상이 발생할 수 있습니다. 그러므로 엔티티의 개수는 5000개 이하로 관리하는 것이 좋습니다. | 항목 | 설명 | | --- | --- | | Total Entity | 현재 월드에 생성된 모든 엔티티의 개수입니다.<ul> <li> Client <ul> <li>User Entity가 존재하 [chunk_id] | Guides:1078:2
[task] | diverse_qa [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | 질문: Sync Property의 'Send Count'와 'Receive Count'는 각각 무엇을 의미하나요? 답변: Send Count는 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 송신 횟수를, Receive Count는 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 수신 횟수를 의미합니다. 질문: Sync Property Count가 많아지면 어떤 문제가 발생할 수 있으며, 이를 개선하기 위해 동기화가 필요하지 않은 프로퍼티는 어떻게 설정해야 하나요? 답변: Sync Property Count가 많아지면 FPS나 Tic [original] | Sync Property의 동기화 횟수입니다. | 항목 | 설명 | | --- | --- | | Send Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 송신 횟수입니다. | | Receive Count | 컴포넌트 단위의 동기화 및 프로퍼티 별 동기화 수신 횟수입니다. | ##### Sync Property Count 관련 성능 저하 개선 Sync Property Count가 많아지면 FPS나 Tick에 악영향을 끼칠 수 있습니다. Sync Property는 None-Sync Property와 달리 내부적으로 동기 [chunk_id] | Guides:1078:3
[task] | knowledge_list [title] | 공동 제작 그룹 멤버의 등급과 권한 [category] | Guides [rephrased] | 제시된 문서에는 mLua 스크립트 언어, API, 함수 매개변수, 반환 타입, 또는 서버/클라이언트 실행 공간에 대한 기술적 정보가 포함되어 있지 않습니다. 해당 문서는 '메이커(Maker)' 플랫폼 내에서 그룹 멤버 등급별 권한(기능 접근성)을 설명하는 관리 가이드입니다. 따라서 요청하신 "API 이름·매개변수·반환 타입·동기화/서버·클라이언트 제약"을 명시하는 것은 불가능하며, 문단에 존재하지 않는 기술적 사실을 지어내지 않는 원칙에 따라, 문서에 명시된 **기능과 권한**에 대한 사실만 독립적인 문장으로 정리합니다. 메이플 [original] | 그룹 멤버 등급별로 주어지는 권한은 아래와 같습니다. 그룹장은 아래 내용을 참고하여 각 멤버의 등급을 적절하게 설정할 수 있습니다. | 기능 설명 | 그룹장 | 매니저 | 개발책임자 | 개발자 | 운영책임자 | 운영자 | 일반 | | --- | --- | --- | --- | --- | --- | --- | --- | | CREATOR 마크 표시 | O | O | O | O | O | O | X | | LocaleDataSet 동기화 권한 | O | O | O | O | X | X | X | | MOD 파일 Import/Expor [chunk_id] | Guides:1077:1
[task] | wikipedia [title] | UI Group [category] | Guides [rephrased] | # 광부 시뮬레이터 리메이크 UI Group 광부 시뮬레이터 리메이크는 게임의 사용자 인터페이스를 관리하기 위해 여러 UI Group을 활용합니다. 각 Group은 특정 상황이나 기능에 따라 활성화되며, 구체적인 구성 요소와 역할은 다음과 같습니다. ## HUDGroup HUD(Heads-Up Display) 그룹은 게임 진행 중 상시 또는 조건부로 표시되는 정보 패널들을 포함합니다. * **MineHUD**: 플레이어가 광산에 입장할 때 활성화되는 HUD입니다. 이 화면에는 광산 내 시야 범위, 현재 사용 중인 탐험 도 [original] | 광부 시뮬레이터를 구성하는 UI Group은 다음과 같습니다. # HUDGroup #### MineHUD 광산에 입장하면 활성화되는 HUD입니다. 광산에서의 시야 범위, 탐험 도구, 깊이, 머무른 시간 등이 포함됩니다. #### TownHUD 마을에 입장하면 활성화되는 HUD입니다. 메뉴 열기 버튼, 메뉴들이 포함됩니다. #### HUD 항상 활성화되는 HUD입니다. # MineralExchangeGroup #### MineralExchange 광물 상점 UI입니다. # EquipmentShopGroup ### [chunk_id] | Guides:1082:0
[task] | extract_knowledge [title] | 프로파일러로 월드 성능 분석하기 [category] | Guides [rephrased] | # 성능 프로파일러로 월드 성능 분석하기 ## 1. 개념 설명 메이플스토리 월드의 **성능 프로파일러**(이하 프로파일러)는 현재 월드의 성능에 영향을 미치는 요인들을 전반적으로 분석하여 결과를 제공하는 도구입니다. 루아 프로파일러가 스크립트 코드의 실행 시간을 중점적으로 분석하는 것과 달리, 성능 프로파일러는 클라이언트 및 서버 영역의 다양한 성능 지표(차트)를 시각화하여 월드 성능 저하 원인을 파악하는 데 사용됩니다. 프로파일러를 통해 수집된 데이터는 다음과 같은 영역으로 구성됩니다. * **Client (클라이언트)* [original] | # 학습 과정 소개 메이플스토리 월드의 루아 프로파일러가 스크립트를 중점적으로 분석하는 도구라면 성능 프로파일러(이하 프로파일러)는 현재 월드의 성능에 영향을 미칠 수 있는 요인들에 대해 전반적인 분석 결과를 보여줍니다. 프로파일링을 통해 월드 성능을 저하시키는 요인을 파악할 수 있고 이를 해결하여 월드 성능을 향상시킬 수 있습니다. 이번 과정에서는 프로파일러의 실행 및 사용 방법, 그리고 데이터 분석 결과를 해석하는 방법을 살펴보겠습니다. ##### 참고 가이드 [루아 프로파일러 활용하기](/docs/?postId=762) [chunk_id] | Guides:1078:0
[task] | diverse_qa [title] | 다각형 그리기 [category] | Guides [rephrased] | 질문: PolygonRendererComponent는 주로 어떤 용도로 사용됩니까? 답변: PolygonRendererComponent는 점을 이어 월드에 다각형을 자유롭게 그리는 데 사용됩니다. 질문: 추가된 점의 순서와 다각형 그리기 사이에 어떤 관계가 있습니까? 답변: 다각형은 추가된 점의 순서를 따라 그려집니다. 질문: 선이 교차하는 경우 다각형이 그려지나요? 답변: 아니요, 점을 이을 때 선이 교차하면 다각형은 그려지지 않습니다. 질문: 다각형이 실제로 그려지는지 확인하기 위해 사용할 수 있는 함수의 이름은 무엇입니까 [original] | # 학습 과정 안내 PolygonRendererComponent를 활용해 다각형을 월드에 자유롭게 그릴 수 있습니다. # PolygonRendererComponent `PolygonRendererComponent`는 점을 이어 월드에 다각형을 그릴 수 있습니다. 추가된 점의 순서를 따라 다각형이 그려집니다. 만약 점을 이을 때 선이 교차하면 다각형은 그려지지 않습니다. 다각형이 그려지는지 확인이 필요할 때는 `IsDrawable()` 함수를 사용해 확인할 수 있습니다. 아래와 같이 점들의 좌표를 입력하면 (0,0) (3,2) [chunk_id] | Guides:1080:0
[task] | knowledge_list [title] | UI Group [category] | Guides [rephrased] | 제시된 문서에는 UI 컴포넌트의 `Property`, `Method`, `Event Handler` 또는 특정 mLua API 명세(매개변수, 반환 타입, 동기화/실행 공간)에 대한 정보가 포함되어 있지 않습니다. 문서의 내용은 특정 게임 모드(광부 시뮬레이터 리메이크)를 구성하는 UI Group과 해당 UI의 기능적 역할(활성화 조건, 포함 내용)만을 설명하는 설계 문서입니다. 따라서 요청하신 **"API 이름·매개변수·반환 타입·동기화/서버·클라이언트 제약"** 에 해당하는 기술적 사실은 원문에 존재하지 않으며, 없는 사실을 [original] | 광부 시뮬레이터를 구성하는 UI Group은 다음과 같습니다. # HUDGroup #### MineHUD 광산에 입장하면 활성화되는 HUD입니다. 광산에서의 시야 범위, 탐험 도구, 깊이, 머무른 시간 등이 포함됩니다. #### TownHUD 마을에 입장하면 활성화되는 HUD입니다. 메뉴 열기 버튼, 메뉴들이 포함됩니다. #### HUD 항상 활성화되는 HUD입니다. # MineralExchangeGroup #### MineralExchange 광물 상점 UI입니다. # EquipmentShopGroup ### [chunk_id] | Guides:1082:0
[task] | wikipedia [title] | 다각형 그리기 [category] | Guides [rephrased] | PolygonRendererComponent를 사용하여 메이플스토리 월드(MapleStory Worlds) 환경에서 다각형을 생성 및 렌더링하는 방법에 관한 기술 문서입니다. ## PolygonRendererComponent 개요 `PolygonRendererComponent`는 월드 내 지점을 연결하여 다각형 형태를 시각화하는 컴포넌트입니다. 이 컴포넌트는 입력된 점의 순서에 따라 선을 연결하여 다각형을 구성하며, 이때 선이 서로 교차하는 경우 유효한 다각형으로 인식되지 않아 렌더링되지 않는 제약이 있습니다. 다각형이 올바르게 [original] | # 학습 과정 안내 PolygonRendererComponent를 활용해 다각형을 월드에 자유롭게 그릴 수 있습니다. # PolygonRendererComponent `PolygonRendererComponent`는 점을 이어 월드에 다각형을 그릴 수 있습니다. 추가된 점의 순서를 따라 다각형이 그려집니다. 만약 점을 이을 때 선이 교차하면 다각형은 그려지지 않습니다. 다각형이 그려지는지 확인이 필요할 때는 `IsDrawable()` 함수를 사용해 확인할 수 있습니다. 아래와 같이 점들의 좌표를 입력하면 (0,0) (3,2) [chunk_id] | Guides:1080:0