[task] | knowledge_list [title] | DataStorageService [category] | Services [rephrased] | 제시된 문서에 명시된 정보만을 바탕으로 `DataStorageService`의 핵심 사실을 정리한 목록입니다. 1. `GetCreatorDataStorage()` 메서드는 매개변수를 받지 않으며, `ServerOnly` 제약이 적용되어 서버에서만 실행되고 `CreatorDataStorage` 타입의 객체를 반환합니다. 2. `GetCreatorDataStorage(string name)` 메서드는 문자열 `name`을 매개변수로 받아 `ServerOnly` 제약 하에 특정 이름의 `CreatorDataStorage` 객체를 반환합 [original] | tAsync() 함수를 사용하세요. - **CreatorDataStorage GetCreatorDataStorage() [ServerOnly]** CreatorDataStorage를 얻어옵니다. - **CreatorDataStorage GetCreatorDataStorage(string name) [ServerOnly]** 특정 이름의 CreatorDataStorage를 얻어옵니다. - **int32, CreatorDataStoragePages GetCreatorDataStoragePagesAndWait() [ServerOn [chunk_id] | Services:309:1
[task] | knowledge_list [title] | DataStorageService [category] | Services [rephrased] | ```lua -- 문서 위치: [Services] DataStorageService -- 아래는 문서에 명시된 핵심 사실 목록입니다. ``` 1. `DataStorageService`의 `taStoragePagesAsync` 메서드는 `func<int32, UserDataStoragePages>` 타입의 `callbackFunction`을 매개변수로 받아, `UserDataStorage` 데이터를 페이지 단위로 비동기로 조회하며, 작업 완료 시 에러 코드와 조회용 객체를 인자로 전달받아 콜백 함수를 호출하는 `[ServerOnly [original] | taStoragePagesAsync(func<int32, UserDataStoragePages> callbackFunction) [ServerOnly]** UserDataStorage를 페이지 단위로 조회합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **boolean SetAndWait(string storageName, string key, string value) [Deprecated] [ServerOnly] [Yield [chunk_id] | Services:309:2
[task] | diverse_qa [title] | DataStorageService [category] | Services [rephrased] | 질문: `taStoragePagesAsync` 함수의 실행 공간은 어디인가요? 답변: `taStoragePagesAsync` 함수는 `[ServerOnly]` 속성을 가지고 있어 서버에서만 실행됩니다. 질문: `taStoragePagesAsync` 함수는 어떤 방식으로 데이터를 조회하나요? 답변: 이 함수는 `UserDataStorage`를 페이지 단위로 비동기로 조회합니다. 질문: `taStoragePagesAsync` 함수의 작업이 완료되면 어떤 인자가 콜백 함수로 전달되나요? 답변: 작업이 완료되면 에러 코드와 조회용 객체 [original] | taStoragePagesAsync(func<int32, UserDataStoragePages> callbackFunction) [ServerOnly]** UserDataStorage를 페이지 단위로 조회합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **boolean SetAndWait(string storageName, string key, string value) [Deprecated] [ServerOnly] [Yield [chunk_id] | Services:309:2
[task] | distill [title] | ItemService [category] | Services [rephrased] | # ItemService 아이템 생성, 소유권 이전, 조회, 삭제 기능을 제공하는 서버 중심 서비스입니다. ## Methods **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템 소유권을 지정된 `InventoryComponent`로 이전합니다. **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** GUID로 식별된 아이템의 소유권을 지정된 `InventoryC [original] | 아이템 관련 기능을 제공합니다. # Methods - **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **Item CreateItem(Type itemType, [chunk_id] | Services:310:0
[task] | extract_knowledge [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService `DataStorageService`는 서버 사이드에서 글로벌, 크리에이터, 사용자, 정렬 가능한 데이터 저장소를 접근하고 페이지 단위로 조회하기 위한 서비스입니다. 모든 메서드는 `[ServerOnly]` 속성을 가지며, 비동기 작업은 `tAsync()` 함수를 사용해야 합니다. ## 개념 설명 `DataStorageService`는 데이터 저장소의 종류에 따라 다음과 같은 하위 타입을 제공합니다. 1. **CreatorDataStorage**: 크리에이터(제작자) 수준의 데이터를 저 [original] | tAsync() 함수를 사용하세요. - **CreatorDataStorage GetCreatorDataStorage() [ServerOnly]** CreatorDataStorage를 얻어옵니다. - **CreatorDataStorage GetCreatorDataStorage(string name) [ServerOnly]** 특정 이름의 CreatorDataStorage를 얻어옵니다. - **int32, CreatorDataStoragePages GetCreatorDataStoragePagesAndWait() [ServerOn [chunk_id] | Services:309:1
[task] | wikipedia [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService `DataStorageService`는 메이플스토리 월드(mLua) 환경에서 전역 데이터 저장소(`GlobalDataStorage`)와 사용자 데이터 저장소(`UserDataStorage`)를 관리하기 위한 서비스입니다. 이 서비스는 `_DataStorageService`라는 전역 변수를 통해 접근하며, 데이터의 생성, 조회, 수정, 삭제 및 페이지네이션(페이지 이동) 기능을 제공합니다. ## 예제 ### GlobalDataStorage 가져오기 (GetGlobalDataStorage) [original] | # Examples #### GetGlobalDataStorage DataStorageService를 활용해서 GlobalDataStorage를 가져오는 예제입니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` #### GetGlobalDataStoragePagesAsync DataStorageService를 활용해서 모든 GlobalDataStorage를 제거하는 예제입니다. ```lua _DataSto [chunk_id] | Services:309:3
[task] | diverse_qa [title] | ItemService [category] | Services [rephrased] | 질문: ItemService는 어떤 기능을 제공하는 서비스인가요? 답변: ItemService는 아이템 관련 기능을 제공하는 서비스입니다. 질문: `ChangeOwner(Item item, InventoryComponent owner)` 메서드의 실행 공간은 어디인가요? 답변: 이 메서드는 [ServerOnly] 실행 공간에서만 사용할 수 있습니다. 질문: `ChangeOwner` 메서드를 호출하면 어떤 일이 발생하나요? 답변: 해당 메서드는 아이템의 소유권을 인자로 전달받은 InventoryComponent로 이전합니다. 질 [original] | 아이템 관련 기능을 제공합니다. # Methods - **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **Item CreateItem(Type itemType, [chunk_id] | Services:310:0
[task] | distill [title] | UserService [category] | Services [rephrased] | # [Services] UserService ## Events - **UserEnterEvent**: 유저 입장 시 발생. - **UserLeaveEvent**: 유저 퇴장 시 발생. 핸들러 완료 후 엔티티가 삭제됩니다. 핸들러 실행 시간이 길면 엔티티 삭제가 핸들러 완료 전에 진행될 수 있습니다. - **UserDisconnectEvent**: 네트워크 불안정으로 접속이 끊겼을 때 발생. - **UserReconnectEvent**: 유저 재접속 시 발생. - **UserKickEvent**: 유저 추방 시 발생. **서버에서만 [original] | - **UserDisconnectEvent** 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. - **UserEnterEvent** 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. - **UserKickEvent** 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. - **UserLeaveEvent** 유저가 떠날 때 UserService에서 발생하는 이벤트입니다.\nUserLeaveEvent 핸들러 실행이 완료된 뒤 유저 엔티티 삭제가 진행됩니다.\nUserLe [chunk_id] | Services:311:1
[task] | knowledge_list [title] | ItemService [category] | Services [rephrased] | 제시된 문서의 내용만 근거로 핵심 사실을 추출하여 정리한 목록입니다. 1. `HandleTriggerEnterEvent` 이벤트 핸들러는 `[self]` 실행 공간에서 동작하며, 매개변수로 `TriggerEnterEvent` 타입의 `event`를 수신합니다. 2. 스크립트 내부에서 `self:IsClient()` 반환 값이 참인 경우(클라이언트 측)에는 함수 실행을 즉시 중단하고 반환합니다. 3. 플레이어의 인벤토리 접근은 `self.Entity.InventoryComponent` 프로퍼티를 통해 이루어집니다. 4. 인벤토리의 [original] | 플레이어의 인벤토리에 아이템을 추가하고, 개수를 변경하고, 제거하는 예제입니다. 이름이 `Get Item`인 오브젝트에 충돌하면 아이템을 3개 획득합니다. 이름이 `Give Item`인 오브젝트에 충돌하면 아이템 개수가 1 감소합니다. 아이템 개수가 0이 되면 제거합니다. 이름이 `Trash Can`인 오브젝트에 충돌하면 아이템을 제거합니다. ```lua Event Handler: [self] HandleTriggerEnterEvent (TriggerEnterEvent event) { -- Parameters lo [chunk_id] | Services:310:1
[task] | distill [title] | ItemService [category] | Services [rephrased] | # [Services] ItemService 플레이어 인벤토리의 아이템 생성, 개수 변경, 제거를 수행하는 서비스입니다. ## 핵심 API - **`_ItemService:CreateItem(modelId, name, inventory)`**: 인벤토리에 새 아이템을 생성하여 반환합니다. - **`_ItemService:RemoveItem(item)`**: 인벤토리에서 해당 아이템을 제거합니다. ## 동작 규칙 및 주의사항 1. **실행 공간**: 아이템 조작은 반드시 서버에서만 수행되어야 하므로, 클라이언트에서는 즉시 반 [original] | 플레이어의 인벤토리에 아이템을 추가하고, 개수를 변경하고, 제거하는 예제입니다. 이름이 `Get Item`인 오브젝트에 충돌하면 아이템을 3개 획득합니다. 이름이 `Give Item`인 오브젝트에 충돌하면 아이템 개수가 1 감소합니다. 아이템 개수가 0이 되면 제거합니다. 이름이 `Trash Can`인 오브젝트에 충돌하면 아이템을 제거합니다. ```lua Event Handler: [self] HandleTriggerEnterEvent (TriggerEnterEvent event) { -- Parameters lo [chunk_id] | Services:310:1
[task] | extract_knowledge [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService: Global DataStorage 관리 ## 개념 설명 `DataStorageService`는 메이플스토리 월드 환경에서 전역 데이터 저장소(Global DataStorage)를 조회 및 관리하기 위한 서비스입니다. 특정 이름을 가진 `GlobalDataStorage` 인스턴스를 직접 가져오거나, 페이지네이션(페이지 나누기)을 통해 모든 `GlobalDataStorage` 목록을 비동기적으로 조회하여 처리할 수 있습니다. ## API 사용법 본 절에서는 원문에 명시된 두 가지 주요 메서 [original] | # Examples #### GetGlobalDataStorage DataStorageService를 활용해서 GlobalDataStorage를 가져오는 예제입니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` #### GetGlobalDataStoragePagesAsync DataStorageService를 활용해서 모든 GlobalDataStorage를 제거하는 예제입니다. ```lua _DataSto [chunk_id] | Services:309:3
[task] | wikipedia [title] | UserService [category] | Services [rephrased] | # UserService 이벤트 **UserService**는 유저의 접속 상태 변경과 관련된 이벤트를 제공하는 서비스입니다. 주요 이벤트는 다음과 같습니다. **UserDisconnectEvent**는 유저의 네트워크 접속이 불안정하여 연결이 끊겨서 발생하는 이벤트입니다. **UserEnterEvent**는 유저가 월드에 입장할 때 발생합니다. **UserKickEvent**는 유저가 추방되었을 때 발생하며, 서버 환경에서만 실행됩니다. **UserLeaveEvent**는 유저가 월드를 떠날 때 발생하며, 이 이벤트의 핸들러 [original] | - **UserDisconnectEvent** 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. - **UserEnterEvent** 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. - **UserKickEvent** 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. - **UserLeaveEvent** 유저가 떠날 때 UserService에서 발생하는 이벤트입니다.\nUserLeaveEvent 핸들러 실행이 완료된 뒤 유저 엔티티 삭제가 진행됩니다.\nUserLe [chunk_id] | Services:311:1
[task] | extract_knowledge [title] | InputService [category] | Services [rephrased] | # InputService: 터치 입력 및 커서 제어 `InputService`는 사용자의 터치 및 마우스 입력을 처리하고, 커서 상태를 제어하기 위한 서비스입니다. 이 절에서는 화면 터치 이벤트를 통해 엔티티를 조작하는 방법과 마우스 입력 상태에 따라 커서 모양을 변경하는 방법을 다룹니다. ## 1. 터치 입력 처리 `InputService`는 `HandleScreenTouchEvent`와 `HandleScreenTouchReleaseEvent` 이벤트 핸들러를 통해 화면에서의 터치 시작과 종료 이벤트를 수신합니다. 이벤트 [original] | #### 터치 입력 터치한 위치에 파티클을 보여주는 예제입니다. ```lua Method: [server only] void OnBeginPlay () { local root = _EntityService:GetEntityByPath(EntityPath) for i = 1, #root.Children do root.Children[i].Enable = false end } Event Handler: [service: InputService] HandleScreenTouchEvent (ScreenTouchEvent ev [chunk_id] | Services:306:4
[task] | wikipedia [title] | ItemService [category] | Services [rephrased] | # ItemService `ItemService`는 메이플스토리 월드 스크립트 환경에서 아이템 생성, 조회, 소유권 변경, 삭제 등 아이템 관련 기능을 제공하는 서비스입니다. ## 메서드 ### 고유 메서드 `ItemService`는 다음과 같은 고유 메서드를 제공합니다. **ChangeOwner** 아이템의 소유권을 지정한 `InventoryComponent`로 이전합니다. 이 메서드는 서버에서만 실행되며(`[ServerOnly]`), 두 가지 오버로드 형태를 지원합니다. * `void ChangeOwner(Item [original] | 아이템 관련 기능을 제공합니다. # Methods - **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **Item CreateItem(Type itemType, [chunk_id] | Services:310:0
[task] | wikipedia [title] | ItemService [category] | Services [rephrased] | **ItemService**는 메이플스토리 월드 스크립트 언어(mLua)에서 플레이어의 인벤토리에 아이템을 생성, 수정, 삭제하기 위해 사용되는 서비스입니다. 이 서비스는 `_ItemService`라는 언더스코어 접두사付き의 전역 객체를 통해 접근하며, 주요 메서드로 아이템 생성을 위한 `CreateItem`과 아이템 삭제를 위한 `RemoveItem`이 있습니다. 아래는 `HandleTriggerEnterEvent` 이벤트 핸들러를 사용하여 특정 오브젝트와의 충돌 시점에 인벤토리 내 아이템을 조작하는 예제입니다. 이 스크립트는 [original] | 플레이어의 인벤토리에 아이템을 추가하고, 개수를 변경하고, 제거하는 예제입니다. 이름이 `Get Item`인 오브젝트에 충돌하면 아이템을 3개 획득합니다. 이름이 `Give Item`인 오브젝트에 충돌하면 아이템 개수가 1 감소합니다. 아이템 개수가 0이 되면 제거합니다. 이름이 `Trash Can`인 오브젝트에 충돌하면 아이템을 제거합니다. ```lua Event Handler: [self] HandleTriggerEnterEvent (TriggerEnterEvent event) { -- Parameters lo [chunk_id] | Services:310:1
[task] | extract_knowledge [title] | ItemService [category] | Services [rephrased] | # ItemService `ItemService`는 아이템 생성, 소유권 변경, 조회 및 삭제 등 아이템 관리 기능을 제공하는 서비스입니다. 서버 로직에서 아이템 인벤토리를 조작할 때 사용하며, 대부분의 메서드는 `[ServerOnly]` 속성을 가지므로 서버 공간에서만 호출할 수 있습니다. ## API 사용법 ### 아이템 생성 `CreateItem` 메서드를 사용하여 새 아이템을 생성합니다. * **`Item CreateItem(Type itemType, string itemDataTableName, Inventory [original] | 아이템 관련 기능을 제공합니다. # Methods - **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **Item CreateItem(Type itemType, [chunk_id] | Services:310:0
[task] | knowledge_list [title] | ItemService [category] | Services [rephrased] | ```lua -- ItemService 핵심 사실 정리 ``` 1. `ItemService`의 `ChangeOwner` 메서드는 `Item` 타입의 아이템과 `InventoryComponent` 타입의 owner 매개변수를 받으며, 아이템의 소유권을 해당 InventoryComponent로 이전하고 반환 타입은 `void`이며, 서버에서만 실행 가능한 `[ServerOnly]` 제약이 있습니다. 2. `ItemService`의 `ChangeOwner` 메서드는 `string` 타입의 itemGUID와 `InventoryCompon [original] | 아이템 관련 기능을 제공합니다. # Methods - **void ChangeOwner(Item item, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **void ChangeOwner(string itemGUID, InventoryComponent owner) [ServerOnly]** 아이템의 소유권을 해당 InventoryComponent로 이전합니다. - **Item CreateItem(Type itemType, [chunk_id] | Services:310:0
[task] | knowledge_list [title] | UserService [category] | Services [rephrased] | # UserService 이벤트 및 API 핵심 사실 정리 1. `UserDisconnectEvent`는 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. 2. `UserEnterEvent`는 유저가 입장할 때 `UserService`에서 발생하는 이벤트입니다. 3. `UserKickEvent`는 유저가 추방되었을 때 발생하는 이벤트이며, 서버에서만 발생합니다. 4. `UserLeaveEvent`는 유저가 떠날 때 `UserService`에서 발생하는 이벤트입니다. 5. `UserLeaveEvent` 핸들러 실행 [original] | - **UserDisconnectEvent** 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. - **UserEnterEvent** 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. - **UserKickEvent** 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. - **UserLeaveEvent** 유저가 떠날 때 UserService에서 발생하는 이벤트입니다.\nUserLeaveEvent 핸들러 실행이 완료된 뒤 유저 엔티티 삭제가 진행됩니다.\nUserLe [chunk_id] | Services:311:1
[task] | extract_knowledge [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService ## 개념 설명 `DataStorageService`는 서버 측에서 사용자 데이터(`UserDataStorage`)를 관리하는 서비스입니다. 주로 대량의 데이터를 페이지 단위로 조회하거나, 특정 키에 값을 저장하는 비동기/동기 작업을 수행합니다. 이 서비스는 `Service` 인터페이스를 상속받아 이벤트 연결(`ConnectEvent`), 해제(`DisconnectEvent`), 발생(`SendEvent`) 기능을 제공합니다. * **UserDataStorage**: 사용자별 데이터 저장 [original] | taStoragePagesAsync(func<int32, UserDataStoragePages> callbackFunction) [ServerOnly]** UserDataStorage를 페이지 단위로 조회합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **boolean SetAndWait(string storageName, string key, string value) [Deprecated] [ServerOnly] [Yield [chunk_id] | Services:309:2
[task] | distill [title] | UserService [category] | Services [rephrased] | # [Services] UserService 유저 관련 기능을 제공합니다. ## Properties * **`Entity LocalPlayer`** `[ReadOnly]` * 내 유저 엔티티. **클라이언트에서만** 사용 가능. * **`ReadOnlyDictionary<string, Entity> UserEntities`** `[ReadOnly] * 모든 유저 엔티티. Key: 유저 Id, Value: 유저 엔티티. * **`ReadOnlyDictionary<string, User> Users [original] | 유저 관련 기능을 제공합니다. # Properties - **Entity LocalPlayer [ReadOnly]** 내 유저 엔티티입니다. 클라이언트에서만 사용 가능합니다. - **ReadOnlyDictionary<string, Entity> UserEntities [ReadOnly]** 모든 유저 엔티티 목록입니다. key는 유저 Id, value는 유저 엔티티입니다. - **ReadOnlyDictionary<string, User> Users [ReadOnly]** 모든 유저 정보 목록입니다. key는 유저 Id [chunk_id] | Services:311:0
[task] | extract_knowledge [title] | LocalizationService [category] | Services [rephrased] | # LocalizationService: 텍스트 조회 및 포맷 변환 ## 개념 설명 `LocalizationService`는 `LocaleDataSet`에 저장된 다국어 텍스트를 조회하고, 런타임 값에 따라 문자열을 변환(포맷팅)하는 기능을 제공합니다. 이 서비스는 단순한 텍스트 치환(`GetText`)부터, 인덱스 기반 치환(`GetTextFormat`), 그리고 언어별 문법 규칙(한국어 호격 조사, 영어 복수형)을 자동 적용하는 스마트 포맷팅(`SmartFormat`)까지 지원합니다. * **LocaleDataSet**: [original] | LocaleDataSet에서 텍스트를 조회하고 포맷에 맞게 변환하는 예제입니다. LocaleDataSet에 아래와 같이 내용을 작성해 예제를 사용할 수 있습니다. | Key | Source | Note | ko | en | | --- | --- | --- | --- | --- | | TEXT_TEST1 | Default Text | 일반 텍스트 예제 | 안녕 | Hello | | TEXT_TEST2 | Default Text | 간단한 포맷 예제 | 안녕, {0}! | Hello, {0}! | | TEXT_TEST3 | Defau [chunk_id] | Services:307:1
[task] | knowledge_list [title] | UserService [category] | Services [rephrased] | **[Services] UserService 핵심 사실 정리** 1. **UserService**는 유저 관련 기능을 제공하며, `LocalPlayer` 프로퍼티는 내 유저 엔티티를 반환하지만 **클라이언트에서만** 사용 가능합니다. 2. `UserEntities` 프로퍼티는 키가 유저 Id, 값이 유저 엔티티인 `ReadOnlyDictionary<string, Entity>` 타입으로 모든 유저 엔티티 목록을 제공합니다. 3. `Users` 프로퍼티는 키가 유저 Id, 값이 유저 정보(`User`)인 `ReadOnlyDic [original] | 유저 관련 기능을 제공합니다. # Properties - **Entity LocalPlayer [ReadOnly]** 내 유저 엔티티입니다. 클라이언트에서만 사용 가능합니다. - **ReadOnlyDictionary<string, Entity> UserEntities [ReadOnly]** 모든 유저 엔티티 목록입니다. key는 유저 Id, value는 유저 엔티티입니다. - **ReadOnlyDictionary<string, User> Users [ReadOnly]** 모든 유저 정보 목록입니다. key는 유저 Id [chunk_id] | Services:311:0
[task] | diverse_qa [title] | ItemService [category] | Services [rephrased] | 질문: 이 문서의 예제 스크립트는 어떤 컴포넌트와 이벤트 핸들러를 사용하나요? 답변: 이 예제는 `InventoryComponent`를 사용하며, `[self]` 실행 공간의 `HandleTriggerEnterEvent` 이벤트 핸들러를 통해 동작합니다. 질문: 이름이 `Get Item`인 오브젝트에 충돌했을 때 플레이어의 인벤토리에 어떤 일이 발생하나요? 답변: 이름이 `Get Item`인 오브젝트에 충돌하면 `_ItemService:CreateItem`을 사용하여 아이템이 생성되고, 해당 아이템의 `ItemCount`가 3으로 [original] | 플레이어의 인벤토리에 아이템을 추가하고, 개수를 변경하고, 제거하는 예제입니다. 이름이 `Get Item`인 오브젝트에 충돌하면 아이템을 3개 획득합니다. 이름이 `Give Item`인 오브젝트에 충돌하면 아이템 개수가 1 감소합니다. 아이템 개수가 0이 되면 제거합니다. 이름이 `Trash Can`인 오브젝트에 충돌하면 아이템을 제거합니다. ```lua Event Handler: [self] HandleTriggerEnterEvent (TriggerEnterEvent event) { -- Parameters lo [chunk_id] | Services:310:1
[task] | diverse_qa [title] | UserService [category] | Services [rephrased] | 질문: `UserDisconnectEvent`는 어떤 상황에서 발생하는 이벤트인가요? 답변: 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. 질문: `UserEnterEvent`는 어떤 시점에 UserService에서 발생하나요? 답변: 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. 질문: `UserKickEvent`는 클라이언트와 서버 중 어디서만 발생하나요? 답변: `UserKickEvent`는 서버에서만 발생하는 이벤트입니다. 질문: `UserLeaveEvent` 핸들러 실행이 완료 [original] | - **UserDisconnectEvent** 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. - **UserEnterEvent** 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. - **UserKickEvent** 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. - **UserLeaveEvent** 유저가 떠날 때 UserService에서 발생하는 이벤트입니다.\nUserLeaveEvent 핸들러 실행이 완료된 뒤 유저 엔티티 삭제가 진행됩니다.\nUserLe [chunk_id] | Services:311:1
[task] | extract_knowledge [title] | UserService [category] | Services [rephrased] | # UserService 이벤트 핸들러 ## 개념 설명 `UserService`는 월드 내 유저의 접속 상태 변화(입장, 퇴장, 재접속, 추방, 연결 끊김)를 감지하기 위한 서비스입니다. 각 상태 변화 시점에 발생되는 이벤트(`UserEnterEvent`, `UserLeaveEvent`, `UserReconnectEvent`, `UserKickEvent`, `UserDisconnectEvent`)를 처리하여 유저 엔티티에 대한 로직을 수행합니다. 특히 `UserLeaveEvent`는 유저가 떠날 때 발생하며, 해당 핸들러 실행이 [original] | - **UserDisconnectEvent** 유저의 네트워크 접속이 불안정하여 끊겼을 때 발생하는 이벤트입니다. - **UserEnterEvent** 유저가 입장할 때 UserService에서 발생하는 이벤트입니다. - **UserKickEvent** 유저가 추방되었을 때 발생하는 이벤트입니다. 서버에서만 발생합니다. - **UserLeaveEvent** 유저가 떠날 때 UserService에서 발생하는 이벤트입니다.\nUserLeaveEvent 핸들러 실행이 완료된 뒤 유저 엔티티 삭제가 진행됩니다.\nUserLe [chunk_id] | Services:311:1
[task] | distill [title] | EditorService [category] | Services [rephrased] | # [Services] EditorService: Events 에디터 환경에서 발생하는 주요 이벤트 목록입니다. | 이벤트 이름 | 발생 시점 | | :--- | :--- | | `EnterEditorEvent` | Editor 진입 시 | | `EnterPlayEvent` | 플레이 모드 진입 시 | | `WorldLoadEditorEvent` | Editor 진입 시 (월드 로드 관련) | | `EntityCreateEditorEvent` | 엔티티 생성 시 | | `EntityDeleteEditorEvent` | 엔티티 삭 [original] | # Events - **EnterEditorEvent** Editor 진입 시 발생하는 에디터 이벤트입니다. - **EnterPlayEvent** 플레이 모드에 진입할 때 발생하는 이벤트입니다. - **EntityCreateEditorEvent** 엔티티 생성 시 발생하는 에디터 이벤트입니다. - **EntityDeleteEditorEvent** 엔티티가 삭제되었을 때 발생하는 에디터 이벤트입니다. - **EntityDeselectEditorEvent** 엔티티 선택 해제 시 발생하는 에디터 이벤트입니다. - * [chunk_id] | Services:312:2
[task] | distill [title] | EditorService [category] | Services [rephrased] | # [Services] EditorService 에디터 환경에서 모델, 타일, 맵, 레이어를 제어하고 엔티티 계층 순서를 변경하는 서비스입니다. ## Methods ```lua void SetSelectedModel(string modelId) ``` 지정한 `modelId`의 모델을 선택합니다. ```lua void SetSelectedTile(string tileRUID) ``` 지정한 `tileRUID`의 타일을 선택합니다. `tileRUID`를 지정하지 않으면 현재 레이어의 타일이 선택됩니다. ```lua void [original] | - **void SetSelectedModel(string modelId)** 해당하는 modelId의 모델을 선택합니다. - **void SetSelectedTile(string tileRUID)** 지정한 RUID의 타일을 선택합니다. 타일을 지정하지 않으면 현재 레이어의 타일이 선택됩니다. - **void SetSiblingIndex(Entity entity, int32 index)** 같은 부모를 가진 엔티티들의 계층 순서를 변경합니다. - **void SetStartingMap(string mapId)** 해 [chunk_id] | Services:312:1
[task] | wikipedia [title] | EditorService [category] | Services [rephrased] | # EditorService: Events `EditorService`는 에디터 환경에서 발생하는 다양한 상황에 대응하기 위한 이벤트들을 제공합니다. 개발자는 이 서비스의 이벤트 핸들러를 통해 에디터의 상태 변경, 엔티티 조작, 사용자 입력, 그리고 월드 로딩 등의 시점에 스크립트 로직을 실행할 수 있습니다. 에디터 진입 및 모드 전환 시에는 `EnterEditorEvent`와 `EnterPlayEvent`가 발생합니다. `EnterEditorEvent`는 사용자가 에디터에 진입할 때 트리거되며, `EnterPlayEvent`는 [original] | # Events - **EnterEditorEvent** Editor 진입 시 발생하는 에디터 이벤트입니다. - **EnterPlayEvent** 플레이 모드에 진입할 때 발생하는 이벤트입니다. - **EntityCreateEditorEvent** 엔티티 생성 시 발생하는 에디터 이벤트입니다. - **EntityDeleteEditorEvent** 엔티티가 삭제되었을 때 발생하는 에디터 이벤트입니다. - **EntityDeselectEditorEvent** 엔티티 선택 해제 시 발생하는 에디터 이벤트입니다. - * [chunk_id] | Services:312:2
[task] | diverse_qa [title] | UserService [category] | Services [rephrased] | 질문: UserService의 `LocalPlayer` 프로퍼티는 어떤 특징이 있나요? 답변: `LocalPlayer`는 내 유저 엔티티를 나타내는 읽기 전용(ReadOnly) 프로퍼티이며, 클라이언트에서만 사용 가능합니다. 질문: `UserEntities` 프로퍼티의 키(key)와 값(value)은 각각 무엇인가요? 답변: `UserEntities`는 모든 유저 엔티티를 담고 있는 읽기 전용 딕셔너리로, 키(key)는 유저 Id이며 값(value)은 해당 유저 엔티티입니다. 질문: `Users` 프로퍼티에서 값(value)으로 [original] | 유저 관련 기능을 제공합니다. # Properties - **Entity LocalPlayer [ReadOnly]** 내 유저 엔티티입니다. 클라이언트에서만 사용 가능합니다. - **ReadOnlyDictionary<string, Entity> UserEntities [ReadOnly]** 모든 유저 엔티티 목록입니다. key는 유저 Id, value는 유저 엔티티입니다. - **ReadOnlyDictionary<string, User> Users [ReadOnly]** 모든 유저 정보 목록입니다. key는 유저 Id [chunk_id] | Services:311:0
[task] | knowledge_list [title] | EditorService [category] | Services [rephrased] | ```lua -- EditorService 이벤트 목록 정리 -- 아래 항목들은 [Services] EditorService 문서에 명시된 이벤트들의 핵심 사실입니다. -- 1. EnterEditorEvent -- Editor 진입 시 발생하는 에디터 이벤트입니다. -- 2. EnterPlayEvent -- 플레이 모드에 진입할 때 발생하는 이벤트입니다. -- 3. EntityCreateEditorEvent -- 엔티티 생성 시 발생하는 에디터 이벤트입니다. -- 4. EntityDeleteEditorEvent -- 엔티티가 [original] | # Events - **EnterEditorEvent** Editor 진입 시 발생하는 에디터 이벤트입니다. - **EnterPlayEvent** 플레이 모드에 진입할 때 발생하는 이벤트입니다. - **EntityCreateEditorEvent** 엔티티 생성 시 발생하는 에디터 이벤트입니다. - **EntityDeleteEditorEvent** 엔티티가 삭제되었을 때 발생하는 에디터 이벤트입니다. - **EntityDeselectEditorEvent** 엔티티 선택 해제 시 발생하는 에디터 이벤트입니다. - * [chunk_id] | Services:312:2