mLua · Nemotron-CC 리프레이즈 (CPT)

[task] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | ## CreatorDataStorage `_DataStorageService:GetCreatorDataStorage()` 로 인스턴스를 얻어 데이터를 관리합니다. ### 태그 기반 페이지 조회 태그(`"Tag"`)로 데이터를 페이지 단위로 조회합니다. `GetPagesAndWait` 로 페이지 객체를 생성한 후, `LoadNextPageAndWait` 와 `MoveToNextPageAndWait` 를 반복하여 모든 데이터를 처리합니다. ```lua local ds = _DataStorageService:GetCreatorDa [original] | 태그 값을 통해 데이터를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local getResultCode, pages = ds:GetPagesAndWait("Tag") if getResultCode ~= 0 then error("Failed to GetPagesAndWait. Error : " + tostring(getResultCode)) return end while true do -- 현재 페이지의 목록을 가져 [chunk_id] | Misc:701:7

[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | * `_DataStorageService` 서비스의 `GetCreatorDataStorage()` 메서드를 호출하여 CreatorDataStorage 인스턴스를 반환받습니다. * `DateTime` 타입 객체를 생성할 때 연도, 월, 일, 시, 분, 초, 밀리초 순서로 매개변수를 전달합니다. * `GetVersionsAndWait` 메서드는 키(string), 정렬 방향(`SortDirection.Ascending` 등), 최소 날짜(`DateTime`), 최대 날짜(`DateTime`)를 매개변수로 받아 결과 코드(nu [original] | 일정 기간 내의 버전 정보를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local minDate = DateTime(2023, 03, 09, 20, 20, 0, 0) local maxDate = DateTime(2023, 03, 09, 22, 20, 0, 0) -- 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. local getResultCode, pages = ds:GetVersionsAndWait("Key", [chunk_id] | Misc:701:8

[task] | distill [title] | DataStorageItemPages [category] | Misc [rephrased] | # DataStorageItemPages `DataStorage` 저장 데이터의 페이지 기반 조회를 제공합니다. ## Properties - **`boolean IsLastPage` [ReadOnly]**: 현재 페이지가 마지막 페이지인지 여부. ## Methods - **`table<DataStorageItem> GetCurrentPageDatas()` [ServerOnly]**: 현재 페이지의 데이터 목록 반환. - **`int32 LoadNextPageAndWait()` [ServerOnly] [Yield]**: 다음 페 [original] | DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드를 반환합니다 [chunk_id] | Misc:703:0

[task] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # [Misc] CreatorDataStorage `_DataStorageService:GetCreatorDataStorage()`를 통해 인스턴스를 생성합니다. ## GetVersionsAndWait 특정 기간 내의 버전 정보를 페이지네이션 방식으로 조회합니다. **조건:** 값을 저장할 때 버전 값을 함께 지정해야만 조회 가능합니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local minDate = DateTime(2023, 03, 09, 20, 20 [original] | 일정 기간 내의 버전 정보를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local minDate = DateTime(2023, 03, 09, 20, 20, 0, 0) local maxDate = DateTime(2023, 03, 09, 22, 20, 0, 0) -- 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. local getResultCode, pages = ds:GetVersionsAndWait("Key", [chunk_id] | Misc:701:8

[task] | distill [title] | DataStorageKeyInfo [category] | Misc [rephrased] | # DataStorageKeyInfo DataStorage 데이터를 식별하는 정보를 담는 구조체입니다. ## Properties * **`string Key`**: 데이터의 키. * **`string Tag`**: 데이터의 태그. 저장 시 해당 값으로 지정됩니다. * **`string Version`**: 데이터의 버전. 저장 시 해당 값으로 지정됩니다. ## Constructors * **`DataStorageKeyInfo()`**: 기본값으로 초기화합니다. * **`DataStorageKeyInfo(str [original] | DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. # Properties - **string Key** DataStorage 데이터의 키입니다. - **string Tag** DataStorage 데이터의 태그입니다. 설정한 값을 저장할 데이터의 태그로 지정할 수 있습니다. - **string Version** DataStorage의 데이터의 버전입니다. 설정한 값을 저장할 데이터의 버전으로 지정할 수 있습니다. # Constructors - **DataStorageKeyInfo()** 기본값으 [chunk_id] | Misc:704:0

[task] | wikipedia [title] | DataStorageKeyInfo [category] | Misc [rephrased] | DataStorageKeyInfo는 DataStorage에 저장된 데이터를 식별하기 위해 사용되는 정보 구조체입니다. 이 구조체는 데이터의 고유한 식별자 및 메타데이터를 포함하며, 주로 데이터 조회나 저장 시 특정 데이터를 가리키는 데 활용됩니다. DataStorageKeyInfo는 세 가지 문자열(string) 타입의 속성을 가집니다. 첫째, Key 속성은 DataStorage 데이터의 고유 키를 나타냅니다. 둘째, Tag 속성은 데이터에 부여된 태그를 나타내며, 저장할 데이터의 태그로 이 값이 지정됩니다. 셋째, Version [original] | DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. # Properties - **string Key** DataStorage 데이터의 키입니다. - **string Tag** DataStorage 데이터의 태그입니다. 설정한 값을 저장할 데이터의 태그로 지정할 수 있습니다. - **string Version** DataStorage의 데이터의 버전입니다. 설정한 값을 저장할 데이터의 버전으로 지정할 수 있습니다. # Constructors - **DataStorageKeyInfo()** 기본값으 [chunk_id] | Misc:704:0

[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage API ## 1. 개념 설명 `CreatorDataStorage`는 메이플스토리 월드에서 사용자 또는 엔티티와 관련된 데이터를 키-값(Key-Value) 형식으로 저장, 조회, 삭제하기 위한 서비스입니다. * **동기(Synchronous)와 비동기(Asynchronous) 지원**: * **동기 호출 (`*AndWait`)**: 작업 완료 시까지 스크립트 실행을 중단(Yield)하고, 결과를 즉시 반환합니다. * **비동기 호출 (`*Async`)**: 작업을 시 [original] | 력한 키에 해당하는 데이터의 버전들을 조회합니다. sortDirection으로 오름/내림차순 정렬을 설정할 수 있습니다. minDate, maxDate로 설정한 시간대 내에서 생성된 버전을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 키, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 SetAndWait(string key, string value) [ServerOnly] [Yield]** 입력한 키로 데이터를 저장합니다. 작업이 완료되면 에 [chunk_id] | Misc:701:2

[task] | knowledge_list [title] | DataStorageItemPages [category] | Misc [rephrased] | 1. `DataStorageItemPages` 컴포넌트는 `DataStorage`에 저장된 데이터를 페이지 단위로 조회하는 기능을 제공합니다. 2. `IsLastPage` 속성은 `boolean` 타입의 `[ReadOnly]` 속성으로, 현재 페이지가 마지막 페이지인지를 확인하는 데 사용됩니다. 3. `GetCurrentPageDatas()` 메서드는 `[ServerOnly]` 제약이 있으며, 현재 페이지의 데이터 목록을 `table<DataStorageItem>` 타입으로 반환합니다. 4. `LoadNextPageAndWait() [original] | DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드를 반환합니다 [chunk_id] | Misc:703:0

[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage: 데이터 저장 및 갱신 API ## 개념 설명 `CreatorDataStorage`는 서버에서만 사용 가능한 데이터 저장소 API 집합입니다. 주요 기능은 다음과 같습니다. 1. **일괄 저장 (Set)**: `DataStorageKeyInfo`를 키로 사용하여 여러 데이터를 한 번에 저장합니다. 동기(`Wait`) 및 비동기(`Async`) 방식으로 제공됩니다. 2. **조건부 갱신 (Update)**: 특정 키의 값을 변경할 때, 현재 값이 기대하는 값(`expectedValue`) [original] | ndWait(Dictionary<DataStorageKeyInfo, string> keyValues) [ServerOnly] [Yield]** 입력한 DataStorageKeyInfo들로 데이터를 저장합니다. 모든 데이터 저장에 성공하면 에러 코드와 성공한 DataStorageKeyInfo를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작 할 수 있습니다. - **void TransactSetByInfoAsync(Dictio [chunk_id] | Misc:701:3

[task] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: 태그 값을 기준으로 CreatorDataStorage에서 데이터를 조회하기 위해 먼저 호출해야 하는 메서드는 무엇이며, 어떤 서비스에서 접근하나요? 답변: `_DataStorageService:GetCreatorDataStorage()`를 통해 DataStorage 객체를 얻은 후, `GetPagesAndWait("Tag")` 메서드를 호출하여 태그를 기준으로 페이지 데이터를 조회합니다. 질문: `GetPagesAndWait` 호출 후 반환되는 `getResultCode`가 0이 아닌 경우, 예제 코드는 어떻게 처리하나요? [original] | 태그 값을 통해 데이터를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local getResultCode, pages = ds:GetPagesAndWait("Tag") if getResultCode ~= 0 then error("Failed to GetPagesAndWait. Error : " + tostring(getResultCode)) return end while true do -- 현재 페이지의 목록을 가져 [chunk_id] | Misc:701:7

[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage `CreatorDataStorage`는 메이플스토리 월드 스크립트 환경에서 크리에이터가 사용자 데이터를 저장하고 조회하기 위해 사용되는 서비스 인터페이스입니다. 이 문서에서는 `DataStorageKeyInfo` 객체를 활용하여 데이터를 일괄로 저장 및 가져오는 과정과, 페이지네이션(페이지 나누기)을 통해 대량의 데이터를 처리하는 방법을 설명합니다. ## 일괄 데이터 저장 (Batch Set) `DataStorageKeyInfo`는 저장할 데이터의 식별자 역할을 하며, 키(Key), 버전( [original] | DataStorageKeyInfo를 통해 데이터를 일괄로 저장하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local keyInfoValues = {} local keyInfo1 = DataStorageKeyInfo("Key1", "Version1", "Tag1") local keyInfo2 = DataStorageKeyInfo("Key2", "Version2", "Tag2") keyInfoValues[keyInfo1] = "Value1" k [chunk_id] | Misc:701:6

[task] | knowledge_list [title] | DataStorageKeyInfo [category] | Misc [rephrased] | 1. `DataStorageKeyInfo`는 `DataStorage`의 데이터를 식별하는 데 사용되는 정보 구조체입니다. 2. `DataStorageKeyInfo`의 `Key` 속성은 `string` 타입이며, `DataStorage` 데이터의 키를 나타냅니다. 3. `DataStorageKeyInfo`의 `Tag` 속성은 `string` 타입이며, 저장할 데이터의 태그로 지정되는 값을 나타냅니다. 4. `DataStorageKeyInfo`의 `Version` 속성은 `string` 타입이며, 저장할 데이터의 버전으로 지정되는 값을 [original] | DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. # Properties - **string Key** DataStorage 데이터의 키입니다. - **string Tag** DataStorage 데이터의 태그입니다. 설정한 값을 저장할 데이터의 태그로 지정할 수 있습니다. - **string Version** DataStorage의 데이터의 버전입니다. 설정한 값을 저장할 데이터의 버전으로 지정할 수 있습니다. # Constructors - **DataStorageKeyInfo()** 기본값으 [chunk_id] | Misc:704:0

[task] | distill [title] | DataStorageVersionPages [category] | Misc [rephrased] | # DataStorageVersionPages `DataStorage` 데이터의 버전을 페이지 단위로 조회하는 컴포넌트입니다. ## Properties * **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 여부. ## Methods * **table<DataStorageVersionInfo> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 버전 정보 목록 반환. * **int32 LoadNextPageAndWait() [Se [original] | DataStorage의 데이터의 버전들을 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageVersionInfo> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 버전 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드 [chunk_id] | Misc:706:0

[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage `CreatorDataStorage`는 `DataStorageService`를 통해 접근하며, 특정 기간 내의 버전 정보를 조회하거나 조건에 따라 데이터를 업데이트하는 기능을 제공합니다. 이 섹션에서는 버전 조회 및 데이터 업데이트 시나리오에 대한 예제를 다룹니다. ## 버전 정보 조회 `GetVersionsAndWait` 메서드를 사용하여 특정 날짜 범위(`minDate`, `maxDate`) 내의 버전 정보를 조회할 수 있습니다. 이 메서드는 값을 저장할 때 버전 값을 함께 지정한 경우 [original] | 일정 기간 내의 버전 정보를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local minDate = DateTime(2023, 03, 09, 20, 20, 0, 0) local maxDate = DateTime(2023, 03, 09, 22, 20, 0, 0) -- 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. local getResultCode, pages = ds:GetVersionsAndWait("Key", [chunk_id] | Misc:701:8

[task] | diverse_qa [title] | DataStorageKeyInfo [category] | Misc [rephrased] | 질문: DataStorageKeyInfo는 어떤 용도로 사용되는 구조체인가요? 답변: DataStorageKeyInfo는 DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. 질문: DataStorageKeyInfo의 Key 속성은 어떤 타입이며, 어떤 의미를 가지나요? 답변: Key 속성은 string 타입으로, DataStorage 데이터의 키를 나타냅니다. 질문: DataStorageKeyInfo의 Tag 속성은 어떤 역할을 하나요? 답변: Tag 속성은 string 타입으로, DataStorage 데이터의 태 [original] | DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. # Properties - **string Key** DataStorage 데이터의 키입니다. - **string Tag** DataStorage 데이터의 태그입니다. 설정한 값을 저장할 데이터의 태그로 지정할 수 있습니다. - **string Version** DataStorage의 데이터의 버전입니다. 설정한 값을 저장할 데이터의 버전으로 지정할 수 있습니다. # Constructors - **DataStorageKeyInfo()** 기본값으 [chunk_id] | Misc:704:0

[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage `CreatorDataStorage`는 크리에이터가 사용자 데이터를 저장, 조회, 삭제하기 위해 사용하는 서비스입니다. 데이터 조작은 동기(`AndWait`) 방식과 비동기(`Async`) 방식으로 제공되며, 각 메서드는 실행 결과를 나타내는 `errorCode`를 반환하거나 콜백 함수를 통해 전달합니다. ## API 사용법 ### 초기화 `_DataStorageService:GetCreatorDataStorage()`를 호출하여 `CreatorDataStorage` 인스턴스를 획득합니다. [original] | # Examples #### SetAndWait 데이터를 저장하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local errorCode = ds:SetAndWait("key", "value") if errorCode ~= 0 then error("Failed to SetAndWait. Error : " + tostring(errorCode)) return end ``` #### GetAndWait 데이터를 불러오는 예제입 [chunk_id] | Misc:701:4

[task] | diverse_qa [title] | DataStorageItemPages [category] | Misc [rephrased] | 질문: DataStorageItemPages는 어떤 기능을 제공하는 컴포넌트인가요? 답변: DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. 질문: IsLastPage 프로퍼티의 데이터 타입은 무엇이며, 어떤 속성을 가지고 있나요? 답변: IsLastPage의 데이터 타입은 boolean이며, ReadOnly 속성을 가지고 있습니다. 질문: IsLastPage 프로퍼티가 true인 경우 그 의미는 무엇인가요? 답변: 현재 페이지가 마지막 페이지임을 의미합니다. 질문: GetCurrentPageDatas() 메 [original] | DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드를 반환합니다 [chunk_id] | Misc:703:0

[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | **CreatorDataStorage** CreatorDataStorage는 메이플스토리 월드에서 크리에이터가 데이터를 저장하고 조회하기 위한 서비스 인터페이스입니다. 이 문서에서는 태그(Tag)를 기반으로 데이터를 조회하는 방법과 버전(Version)을 활용하여 데이터를 관리하는 `SetByInfoAndWait` 메서드의 동작 방식을 설명합니다. ### 태그 기반 데이터 조회 데이터를 태그 값으로 조회할 때는 `_DataStorageService:GetCreatorDataStorage()`를 호출하여 CreatorDataSt [original] | 태그 값을 통해 데이터를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local getResultCode, pages = ds:GetPagesAndWait("Tag") if getResultCode ~= 0 then error("Failed to GetPagesAndWait. Error : " + tostring(getResultCode)) return end while true do -- 현재 페이지의 목록을 가져 [chunk_id] | Misc:701:7

[task] | knowledge_list [title] | DataStorageVersionPages [category] | Misc [rephrased] | ```lua -- DataStorageVersionPages 핵심 사실 정리 ``` 1. `DataStorageVersionPages` 컴포넌트는 DataStorage의 데이터 버전 목록을 페이지 단위로 조회하는 기능을 제공합니다. 2. `IsLastPage`는 `[ReadOnly]` 속성으로, 타입은 `boolean`이며, 현재 페이지가 마지막 페이지인지 여부를 반환합니다. 3. `GetCurrentPageDatas()` 메서드는 `[ServerOnly]`로 실행되며, 반환 타입은 `table<DataStorageVersionI [original] | DataStorage의 데이터의 버전들을 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageVersionInfo> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 버전 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드 [chunk_id] | Misc:706:0

[task] | wikipedia [title] | DataStorageItemPages [category] | Misc [rephrased] | # DataStorageItemPages **DataStorageItemPages**는 `DataStorage`에 저장된 데이터를 페이지 단위로 조회하기 위한 기능을 제공하는 스크립트 컴포넌트입니다. 대량의 데이터를 한 번에 조회하는 대신, 페이지를 순회하며 데이터를 처리할 때 사용합니다. ## 속성(Properties) * **`IsLastPage`** * **타입:** `boolean` * **접근 권한:** 읽기 전용 (`ReadOnly`) * **설명:** 현재 조회 중인 페이지가 전 [original] | DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드를 반환합니다 [chunk_id] | Misc:703:0

[task] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: `CreatorDataStorage`의 `GetVersionsAndWait` 메서드를 사용하려면 저장 시 어떤 조건을 충족해야 하나요? 답변: 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. 질문: `GetVersionsAndWait` 메서드의 매개변수로 `SortDirection.Ascending`을 전달하면 어떤 정렬 방식으로 버전 정보가 반환되나요? 답변: 오름차순(Ascending)으로 정렬되어 버전 정보가 반환됩니다. 질문: 아래 코드에서 `pages:IsLastPage` 프로퍼티가 `tru [original] | 일정 기간 내의 버전 정보를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local minDate = DateTime(2023, 03, 09, 20, 20, 0, 0) local maxDate = DateTime(2023, 03, 09, 22, 20, 0, 0) -- 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. local getResultCode, pages = ds:GetVersionsAndWait("Key", [chunk_id] | Misc:701:8

[task] | extract_knowledge [title] | DataStorageKeyInfo [category] | Misc [rephrased] | # DataStorageKeyInfo `DataStorageKeyInfo`는 `DataStorage`에 저장된 데이터를 식별하기 위한 정보를 담는 구조체입니다. 데이터를 저장하거나 조회할 때, 해당 데이터가 어떤 키, 버전, 태그를 가지는지 정의하는 데 사용됩니다. ## 1. 프로퍼티 (Properties) `DataStorageKeyInfo`는 다음 세 가지 문자열 프로퍼티를 가집니다. | 프로퍼티 | 타입 | 설명 | | :--- | :--- | :--- | | `Key` | `string` | DataStorage 데이 [original] | DataStorage의 데이터를 식별하는 데 사용하는 정보입니다. # Properties - **string Key** DataStorage 데이터의 키입니다. - **string Tag** DataStorage 데이터의 태그입니다. 설정한 값을 저장할 데이터의 태그로 지정할 수 있습니다. - **string Version** DataStorage의 데이터의 버전입니다. 설정한 값을 저장할 데이터의 버전으로 지정할 수 있습니다. # Constructors - **DataStorageKeyInfo()** 기본값으 [chunk_id] | Misc:704:0

[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage `CreatorDataStorage`는 `_DataStorageService`를 통해 접근하는 데이터 저장소로, 키(Key), 버전(Version), 태그(Tag) 정보(`DataStorageKeyInfo`)를 기반으로 데이터를 저장, 조회, 삭제하는 기능을 제공합니다. 주요 메서드들은 모두 비동기 처리를 위해 `AndWait` 접미사를 가지며, 실행 결과로 `errorCode`를 반환합니다. ## API 사용법 * **`_DataStorageService:GetCreatorDataSt [original] | 데이터를 DataStorageKeyInfo를 통해 가져오는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local keyInfo = DataStorageKeyInfo("Key", "Version", "Tag") local errorCode, value = ds:GetByInfoAndWait(keyInfo) if errorCode ~= 0 then error("Failed to GetByInfoAndWait. Error : " + tostr [chunk_id] | Misc:701:5

[task] | diverse_qa [title] | DataStorageVersionPages [category] | Misc [rephrased] | 질문: `DataStorageVersionPages`는 어떤 기능을 제공하는 컴포넌트인가요? 답변: `DataStorage`의 데이터 버전들을 조회하는 기능을 제공합니다. 질문: `IsLastPage` 프로퍼티의 데이터 타입과 읽기 권한은 무엇인가요? 답변: `IsLastPage`는 `boolean` 타입이며 `ReadOnly` 속성을 가지고 있습니다. 질문: `IsLastPage` 프로퍼티가 `true`일 때 의미하는 바는 무엇인가요? 답변: 현재 페이지가 마지막 페이지임을 의미합니다. 질문: 현재 페이지의 버전 목록을 가져 [original] | DataStorage의 데이터의 버전들을 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageVersionInfo> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 버전 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드 [chunk_id] | Misc:706:0

[task] | wikipedia [title] | DataStorageVersionPages [category] | Misc [rephrased] | # DataStorageVersionPages **DataStorageVersionPages**는 DataStorage에 저장된 데이터의 버전 정보를 페이지 단위로 조회하기 위한 기능을 제공합니다. 이 컴포넌트를 통해 개발자는 대량의 버전 기록을 한 번에 불러오지 않고, 페이지별로 순차적으로 접근하여 메모리 사용량을 관리할 수 있습니다. ## 속성 (Properties) * **IsLastPage** * **타입:** `boolean` * **접근 권한:** 읽기 전용 (`ReadOnly`) * [original] | DataStorage의 데이터의 버전들을 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageVersionInfo> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 버전 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드 [chunk_id] | Misc:706:0

[task] | extract_knowledge [title] | DataStorageItemPages [category] | Misc [rephrased] | # DataStorageItemPages `DataStorageItemPages` 컴포넌트는 `DataStorage`에 저장된 대량의 데이터를 페이지 단위로 조회하기 위한 기능을 제공합니다. 전체 데이터를 한 번에 가져오는 것이 아니라, 페이지를 순회하며 필요한 데이터를 처리하도록 설계되었습니다. ## 개념 설명 데이터 조회는 페이지 기반의 순환 구조로 이루어집니다. 1. **현재 페이지 조회**: 현재 위치에서 데이터 목록을 가져옵니다. 2. **마지막 페이지 확인**: 현재 페이지가 마지막인지 확인하여 순회 종료 조건을 판 [original] | DataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<DataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러오고, 에러 코드를 반환합니다 [chunk_id] | Misc:703:0

[task] | distill [title] | GlobalDataStorage [category] | Misc [rephrased] | # GlobalDataStorage 다목적 데이터를 관리하는 저장소입니다. 메이커와 출시 환경은 저장소를 공유하지 않습니다. 모든 메서드는 `[ServerOnly]`입니다. ## Properties - **string Name [ReadOnly]**: GlobalDataStorage의 이름 ## Methods 동기(`AndWait`) 메서드는 `[Yield]`로 스크립트 실행을 중단하며, 비동기(`Async`) 메서드는 콜백 함수를 통해 결과를 반환합니다. ### BatchDelete (삭제) - **int32, List [original] | 다목적 데이터를 관리할 수 있는 저장소입니다. 메이커와 출시 환경은 저장소를 공유하지 않습니다. # Properties - **string Name [ReadOnly]** 이 GlobalDataStorage의 이름입니다. # Methods - **int32, List<string> BatchDeleteAndWait(List<string> keys) [ServerOnly] [Yield]** 입력한 키들로 데이터들을 삭제합니다. 에러 코드와 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - [chunk_id] | Misc:708:0

[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage: DataStorageKeyInfo를 활용한 일괄 저장 및 조회 ## 개념 설명 `CreatorDataStorage`는 크리에이터가 생성한 데이터를 저장하고 관리하기 위한 서비스입니다. 데이터는 `DataStorageKeyInfo` 객체를 통해 식별되며, 이 객체는 키(Key), 버전(Version), 태그(Tag)의 3가지 속성을 가집니다. `CreatorDataStorage`의 일괄 처리 API(`BatchSetByInfoAndWait`, `BatchGetByInfoAndWait`)는 [original] | DataStorageKeyInfo를 통해 데이터를 일괄로 저장하는 예제입니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local keyInfoValues = {} local keyInfo1 = DataStorageKeyInfo("Key1", "Version1", "Tag1") local keyInfo2 = DataStorageKeyInfo("Key2", "Version2", "Tag2") keyInfoValues[keyInfo1] = "Value1" k [chunk_id] | Misc:701:6

[task] | knowledge_list [title] | Foothold [category] | Misc [rephrased] | ```lua -- 핵심 사실 추출 목록 ``` 1. `Foothold` 컴포넌트는 발판의 여러 정보를 나타내는 구조체입니다. 2. `Vector2 EndPoint` 속성은 `[ReadOnly]` 제약이 있으며, 발판의 끝점을 나타내며 항상 `StartPoint`보다 오른쪽에 위치합니다. 3. `float FootholdDrag` 속성은 `RigidbodyComponent`가 포함된 엔티티가 발판 위에 있을 때 적용되는 마찰력을 나타내며, 값이 클수록 빠르게 감속합니다. 4. `float FootholdForce` 속성은 `Rigi [original] | 발판의 여러 정보를 나타냅니다. # Properties - **Vector2 EndPoint [ReadOnly]** 발판의 끝점을 나타냅니다. 항상 StartPoint보다 오른쪽에 있습니다. - **float FootholdDrag** RigidbodyComponent가 포함된 엔티티가 발판 위에 있을 때 적용되는 마찰력입니다. 값이 클수록 빠르게 감속합니다. - **float FootholdForce** RigidbodyComponent가 포함된 엔티티가 발판 위에 있을 때 가해지는 힘입니다. 값이 양수면 오른쪽, [chunk_id] | Misc:707:0