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

[task] | knowledge_list [title] | SortableDataStorage [category] | Misc [rephrased] | 제시된 문서 내용만을 바탕으로 `SortableDataStorage` 관련 API의 핵심 사실을 추출하여 정리한 목록입니다. * `GetVersionsAndWait` 메서드는 `[ServerOnly]` 및 `[Yield]` 속성을 가지며, `string key`, `SortDirection sortDirection`, `DateTime minDate`, `DateTime maxDate`를 매개변수로 받아 `int32` 에러 코드와 `DataStorageVersionPages` 조회용 객체를 반환하고, 수행 중 스크립트 실행을 [original] | rection으로 오름/내림차순 정렬을 설정할 수 있습니다. min, max로 설정한 범위 내의 데이터들을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32, DataStorageVersionPages GetVersionsAndWait(string key, SortDirection sortDirection, DateTime minDate, DateTime maxDate) [ServerOnly] [Yield [chunk_id] | Misc:710:2

[task] | diverse_qa [title] | SortableDataStorage [category] | Misc [rephrased] | 질문: `GetVersionsAndWait` 메서드는 어떤 실행 공간에서만 사용할 수 있습니까? 답변: `GetVersionsAndWait` 메서드는 [ServerOnly] 실행 공간에서만 사용할 수 있습니다. 질문: `GetVersionsAsync` 메서드가 작업을 완료했을 때 callbackFunction에 전달되는 인자는 무엇입니까? 답변: 작업이 완료되면 에러 코드, 키, 조회용 객체(DataStorageVersionPages)와 함께 callbackFunction으로 전달된 함수가 호출됩니다. 질문: `IncreaseA [original] | rection으로 오름/내림차순 정렬을 설정할 수 있습니다. min, max로 설정한 범위 내의 데이터들을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32, DataStorageVersionPages GetVersionsAndWait(string key, SortDirection sortDirection, DateTime minDate, DateTime maxDate) [ServerOnly] [Yield [chunk_id] | Misc:710:2

[task] | knowledge_list [title] | SortableDataStorage [category] | Misc [rephrased] | ```lua -- SortableDataStorage API 핵심 사실 정리 ``` 1. `DeleteAndWait(string key)` 메서드는 `[ServerOnly]` 및 `[Yield]` 제약이 있으며, 입력한 키로 데이터를 삭제한 후 에러 코드(`int32`)를 반환하고, 수행 중 스크립트 실행을 중단합니다. 2. `DeleteAsync(string key, func<int32, string> callbackFunction)` 메서드는 `[ServerOnly]` 제약이 있으며, 입력한 키로 데이터를 비동기로 삭제하고, [original] | lbackFunction) [ServerOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void Delete [chunk_id] | Misc:710:1

[task] | diverse_qa [title] | SortableDataStorage [category] | Misc [rephrased] | 질문: `DeleteAndWait` 메서드는 어떤 실행 특성을 가지며, 반환 값은 무엇인가요? 답변: `DeleteAndWait` 메서드는 `[ServerOnly]` 및 `[Yield]` 특성을 가지며, 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 질문: `GetAsync` 메서드가 작업 완료 시 콜백 함수로 전달하는 인자는 무엇인가요? 답변: `GetAsync` 메서드는 작업 완료 시 에러 코드, 키, 데이터와 함께 `callbackFunction`으로 전달된 함수가 호출됩니 [original] | lbackFunction) [ServerOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void Delete [chunk_id] | Misc:710:1

[task] | distill [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage 예제 `_DataStorageService:GetSortableDataStorage("Storage")`로 인스턴스를 생성합니다. ### IncreaseAndWait 동기 방식으로 값을 증가시킵니다. 키가 없으면 기본값으로 생성 후 증가합니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` ### Incr [original] | # Examples #### IncreaseAndWait 값을 증가시키는 예제입니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") -- "Key"에 해당하는 값이 없을 경우 기본 값으로 생성 후 1을 증가시킵니다. local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` #### IncreaseAsync 값을 비동기로 증가시키는 예제입니다. ```lua local ds = _DataStor [chunk_id] | Misc:710:4

[task] | distill [title] | SortableDataStorage [category] | Misc [rephrased] | # [Misc] SortableDataStorage ## 공통 동작 규칙 - **최대 20개 Key**: 한 번의 호출로 최대 20개의 키를 조작할 수 있습니다. - **전체 성공/실패**: 모든 작업이 성공해야만 성공으로 간주됩니다. 하나라도 실패하면 함수 호출 자체가 실패합니다. - **동기/비동기**: - `AndWait` (동기): 수행 중 스크립트 실행을 중단합니다 (`[Yield]`). - `Async` (비동기): 즉시 반환되고, 완료 시 `callbackFunction`을 호출합니다. - **실행 공간**: [original] | eld]** 입력한 키들로 데이터를 삭제합니다. 호출에 포함된 모든 작업이 성공하면 에러 코드, 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작할 수 있습니다. - **void TransactDeleteAsync(List<string> keys, func<int32, List<string>> callbackFunction) [ServerOnly]** 입력한 키들로 데이터를 삭제합니다. 이 함수 호출은 [chunk_id] | Misc:710:3

[task] | wikipedia [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage `SortableDataStorage`는 서버 측에서 정렬 가능한 데이터 저장을 관리하기 위한 API 모음입니다. 이 컴포넌트는 키에 기반한 데이터의 생성, 수정, 삭제 및 버전 조회 기능을 제공하며, 모든 작업은 서버에서만 실행됩니다([ServerOnly]). 각 기능은 스크립트 실행을 중단하는 동기화(Wait) 방식과 비동기(Async) 방식의 두 가지 형태로 제공되어 개발자의 필요에 따라 선택할 수 있습니다. ## 데이터 조회 및 버전 관리 `GetVersionsAndWait`와 ` [original] | rection으로 오름/내림차순 정렬을 설정할 수 있습니다. min, max로 설정한 범위 내의 데이터들을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32, DataStorageVersionPages GetVersionsAndWait(string key, SortDirection sortDirection, DateTime minDate, DateTime maxDate) [ServerOnly] [Yield [chunk_id] | Misc:710:2

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

[task] | diverse_qa [title] | SortableDataStorage [category] | Misc [rephrased] | 질문: `TransactDeleteAsync` 함수는 어떤 실행 공간에서만 사용할 수 있나요? 답변: `[ServerOnly]` 태그가 붙어 있으므로 서버에서만 사용할 수 있습니다. 질문: `TransactSetAndWait` 함수가 데이터를 저장할 때 스크립트 실행은 어떻게 되나요? 답변: 수행하는 동안 스크립트 실행이 중단됩니다. 질문: `TransactDeleteAsync`와 `TransactSetAndWait`는 각각 어떤 방식으로 처리되나요? 답변: `TransactDeleteAsync`는 비동기로 수행되고, `Tran [original] | eld]** 입력한 키들로 데이터를 삭제합니다. 호출에 포함된 모든 작업이 성공하면 에러 코드, 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작할 수 있습니다. - **void TransactDeleteAsync(List<string> keys, func<int32, List<string>> callbackFunction) [ServerOnly]** 입력한 키들로 데이터를 삭제합니다. 이 함수 호출은 [chunk_id] | Misc:710:3

[task] | knowledge_list [title] | SortableDataStorageItemPages [category] | Misc [rephrased] | 제시된 문서에 기반하여 `SortableDataStorageItemPages`의 핵심 사실을 추출한 목록입니다. 1. `SortableDataStorageItemPages`는 `SortableDataStorage`에 저장된 데이터를 페이지 단위로 조회하는 기능을 제공합니다. 2. `boolean IsLastPage`는 현재 페이지가 마지막 페이지인지 확인하는 읽기 전용(ReadOnly) 프로퍼티입니다. 3. `GetCurrentPageDatas()`는 현재 페이지의 데이터 목록을 `table<SortableDataStorag [original] | SortableDataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러 [chunk_id] | Misc:712:0

[task] | knowledge_list [title] | SortableDataStorage [category] | Misc [rephrased] | 제공된 문서에 포함된 `SortableDataStorage`의 트랜잭션 관련 메서드 핵심 사실은 다음과 같습니다. 1. `TransactDeleteAndWait(List<string> keys)` 메서드는 서버 전용([ServerOnly])이며, 입력된 키 목록으로 데이터를 삭제하고 모든 작업이 성공하면 에러 코드와 삭제에 성공한 키 목록을 반환하는 동기식 함수입니다. 2. `TransactDeleteAndWait` 메서드는 실행 중 스크립트 실행을 중단하며, 작업 중 하나라도 실패하면 함수 호출 자체가 실패하고 한 번에 최대 2 [original] | eld]** 입력한 키들로 데이터를 삭제합니다. 호출에 포함된 모든 작업이 성공하면 에러 코드, 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작할 수 있습니다. - **void TransactDeleteAsync(List<string> keys, func<int32, List<string>> callbackFunction) [ServerOnly]** 입력한 키들로 데이터를 삭제합니다. 이 함수 호출은 [chunk_id] | Misc:710:3

[task] | extract_knowledge [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage ## 개념 설명 `SortableDataStorage`는 정수형 데이터를 관리하고, 저장된 데이터를 정렬하여 가져오는 기능을 제공하는 저장소 컴포넌트입니다. 메이커(개발) 환경과 출시(운영) 환경은 이 저장소를 공유하지 않으므로, 데이터 격리가 적용됩니다. ## API 사용법 ### Properties * **`Name`** (`string`, `[ReadOnly]`): 해당 DataStorage의 이름을 나타냅니다. ### Methods 모든 메서드는 `[ServerOnly]` 속 [original] | 정수형 데이터를 관리하고, 정렬한 데이터를 가져오는 기능이 있는 저장소입니다. 메이커와 출시 환경은 저장소를 공유하지 않습니다. # Properties - **string Name [ReadOnly]** DataStorage의 이름입니다. # Methods - **int32, List<string> BatchDeleteAndWait(List<string> keys) [ServerOnly] [Yield]** 입력한 키들로 데이터들을 삭제합니다. 에러 코드와 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 [chunk_id] | Misc:710:0

[task] | knowledge_list [title] | SortableDataStorage [category] | Misc [rephrased] | 제공된 문서 원문에는 `[Misc] SortableDataStorage`의 **Examples(예제)**와 **SeeAlso(관련 항목)** 섹션만 포함되어 있습니다. 따라서 원문에 명시된 정보에만 근거하여 핵심 사실을 추출하면 다음과 같습니다. 1. `_DataStorageService:GetSortableDataStorage("Storage")` 메서드를 호출하여 `SortableDataStorage` 인스턴스를 생성할 수 있으며, 매개변수로 저장소 이름(문서 예제 기준 "Storage")을 지정합니다. 2. `ds:Incre [original] | # Examples #### IncreaseAndWait 값을 증가시키는 예제입니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") -- "Key"에 해당하는 값이 없을 경우 기본 값으로 생성 후 1을 증가시킵니다. local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` #### IncreaseAsync 값을 비동기로 증가시키는 예제입니다. ```lua local ds = _DataStor [chunk_id] | Misc:710:4

[task] | distill [title] | SortableDataStoragePages [category] | Misc [rephrased] | # SortableDataStoragePages 월드의 `SortableDataStorage`를 페이지 단위로 조회합니다. ## Properties * **`boolean IsLastPage`** `[ReadOnly]` * 현재 페이지가 마지막 페이지인지 여부. ## Methods * **`table<SortableDataStorage> GetCurrentPageDatas()`** `[ServerOnly]` * 현재 페이지의 `SortableDataStorage` 목록 반환. * **`int32 [original] | 월드의 SortableDataStorage들을 조회할 수 있는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorage> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 SortableDataStorage 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** [chunk_id] | Misc:713:0

[task] | knowledge_list [title] | SortableDataStoragePages [category] | Misc [rephrased] | 1. `SortableDataStoragePages` 컴포넌트는 월드 내 `SortableDataStorage` 객체들을 페이지 단위로 조회하는 기능을 제공합니다. 2. `IsLastPage` 프로퍼티는 읽기 전용(`ReadOnly`) `boolean` 타입이며, 현재 위치가 마지막 페이지인지 여부를 확인합니다. 3. `GetCurrentPageDatas()` 메서드는 서버에서만 실행되며(`[ServerOnly]`), 현재 페이지에 포함된 `SortableDataStorage` 객체들의 목록을 `table<SortableDataSt [original] | 월드의 SortableDataStorage들을 조회할 수 있는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorage> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 SortableDataStorage 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** [chunk_id] | Misc:713:0

[task] | wikipedia [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage `SortableDataStorage`는 정렬 가능한 데이터 저장을 위한 서비스로, `_DataStorageService:GetSortableDataStorage` 메서드를 통해 인스턴스를 획득하여 사용합니다. 이 컴포넌트는 동기 및 비동기 방식으로 값을 증가시키고, 정렬된 순서로 데이터를 페이지 단위로 조회하는 기능을 제공합니다. ## 값 증가 값을 증가시키는 작업은 동기 방식인 `IncreaseAndWait`와 비동기 방식인 `IncreaseAsync`로 수행할 수 있습니다. 동기 [original] | # Examples #### IncreaseAndWait 값을 증가시키는 예제입니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") -- "Key"에 해당하는 값이 없을 경우 기본 값으로 생성 후 1을 증가시킵니다. local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` #### IncreaseAsync 값을 비동기로 증가시키는 예제입니다. ```lua local ds = _DataStor [chunk_id] | Misc:710:4

[task] | extract_knowledge [title] | GlobalDataStorage [category] | Misc [rephrased] | # GlobalDataStorage API ## 개념 설명 `GlobalDataStorage`는 메이플스토리 월드에서 전역 데이터를 저장하고 관리하기 위한 서비스입니다. `_DataStorageService`를 통해 특정 이름을 가진 스토리지 인스턴스를 획득하며, 키(Key) 기반의 데이터 저장, 조회, 업데이트가 가능합니다. 주요 특징은 다음과 같습니다. 1. **버전 관리**: 값을 저장할 때 `Version`을 지정하면 과거 버전의 데이터를 조회하거나 복원할 수 있습니다. 2. **비동기 처리**: 모든 쓰기/읽기 작업은 [original] | 일정 기간 내의 버전 정보를 조회하는 예제입니다. ```lua local ds = _DataStorageService:GetGlobalDataStorage("StorageName") local minDate = DateTime(2023, 03, 09, 20, 20, 0, 0) local maxDate = DateTime(2023, 03, 09, 22, 20, 0, 0) -- 값을 저장할 때 버전 값을 함께 지정한 경우에만 조회할 수 있습니다. local errorCode, versionPages = ds:GetVersion [chunk_id] | Misc:708:7

[task] | wikipedia [title] | SortableDataStorageItemPages [category] | Misc [rephrased] | # SortableDataStorageItemPages **SortableDataStorageItemPages**는 `SortableDataStorage`에 저장된 데이터를 페이지 단위로 조회하기 위한 컴포넌트입니다. 대량의 데이터를 한 번에 로드하는 대신, 페이지를 순회하며 필요한 항목을 효율적으로 가져오도록 설계되었습니다. ## 속성 (Properties) * **`boolean IsLastPage`** (읽기 전용, `[ReadOnly]`) 현재 조회 위치가 마지막 페이지인지를 나타내는 부울 값입니다. `tru [original] | SortableDataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러 [chunk_id] | Misc:712:0

[task] | diverse_qa [title] | SortableDataStorage [category] | Misc [rephrased] | 질문: `IncreaseAndWait` 메서드를 사용할 때, "Key"에 해당하는 값이 존재하지 않는다면 어떤 일이 발생하나요? 답변: "Key"에 해당하는 값이 없을 경우 기본 값으로 생성된 후 1을 증가시킵니다. 질문: `IncreaseAsync` 메서드의 콜백 함수에서 작업 완료 시 전달되는 매개변수는 무엇인가요? 답변: `errorCode`, `key`, `value`입니다. 질문: 다음 코드는 무엇을 수행하나요? ```lua local errorCode, value = ds:IncreaseAndWait("Key", 1) [original] | # Examples #### IncreaseAndWait 값을 증가시키는 예제입니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") -- "Key"에 해당하는 값이 없을 경우 기본 값으로 생성 후 1을 증가시킵니다. local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` #### IncreaseAsync 값을 비동기로 증가시키는 예제입니다. ```lua local ds = _DataStor [chunk_id] | Misc:710:4

[task] | wikipedia [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage **SortableDataStorage**는 메이플스토리 월드(MapleStory Worlds)에서 서버 측 데이터 저장을 관리하는 서비스입니다. 이 서비스는 키-값(key-value) 쌍을 기반으로 데이터를 저장 및 삭제하는 트랜잭션(Transaction) 기능을 제공합니다. 모든 메서드는 서버 환경에서만 실행되며, 동기화(Synchronous) 방식과 비동기(Asynchronous) 방식으로 나뉘어 있습니다. ## 주요 특징 및 제약사항 이 서비스의 모든 트랜잭션 메서드는 다음과 같은 [original] | eld]** 입력한 키들로 데이터를 삭제합니다. 호출에 포함된 모든 작업이 성공하면 에러 코드, 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작할 수 있습니다. - **void TransactDeleteAsync(List<string> keys, func<int32, List<string>> callbackFunction) [ServerOnly]** 입력한 키들로 데이터를 삭제합니다. 이 함수 호출은 [chunk_id] | Misc:710:3

[task] | wikipedia [title] | SortableDataStoragePages [category] | Misc [rephrased] | # SortableDataStoragePages **SortableDataStoragePages**는 월드 내에서 사용 중인 **SortableDataStorage** 항목들을 페이지 단위로 조회할 수 있는 기능을 제공하는 컴포넌트입니다. 이 컴포넌트를 통해 데이터 저장소의 내용을 순차적으로 탐색하고, 특정 페이지의 데이터를 가져오는 작업을 수행할 수 있습니다. ## 속성(Properties) 이 컴포넌트는 다음과 같은 읽기 전용 속성을 제공합니다. * **IsLastPage** (타입: `boolean`, 읽기 전용): [original] | 월드의 SortableDataStorage들을 조회할 수 있는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorage> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 SortableDataStorage 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** [chunk_id] | Misc:713:0

[task] | diverse_qa [title] | SortableDataStoragePages [category] | Misc [rephrased] | 질문: SortableDataStoragePages 컴포넌트는 어떤 기능을 제공합니까? 답변: 월드의 SortableDataStorage들을 조회할 수 있는 기능을 제공합니다. 질문: IsLastPage 프로퍼티의 데이터 타입과 읽기 전용 속성은 무엇입니까? 답변: IsLastPage 프로퍼티의 데이터 타입은 boolean이며, ReadOnly 속성을 가집니다. 질문: IsLastPage 프로퍼티가 true일 때 어떤 의미를 가집니까? 답변: 현재 페이지가 마지막 페이지임을 의미합니다. 질문: GetCurrentPageData [original] | 월드의 SortableDataStorage들을 조회할 수 있는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorage> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 SortableDataStorage 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** [chunk_id] | Misc:713:0

[task] | extract_knowledge [title] | SortableDataStorageItemPages [category] | Misc [rephrased] | # SortableDataStorageItemPages `SortableDataStorageItemPages` 컴포넌트는 `SortableDataStorage`에 저장된 데이터를 페이지 단위로 조회하기 위한 기능을 제공합니다. 서버 측에서만 동작하며, 페이지 이동 및 데이터 로딩 과정은 스크립트 실행을 일시 중단(Yield)합니다. ## 1. 개념 설명 대량의 데이터를 한 번에 조회하지 않고, 페이지 단위로 나누어 순차적으로 접근하는 방식을 지원합니다. - **페이지 조회**: 현재 페이지에 포함된 데이터 목록을 가져옵니다. [original] | SortableDataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러 [chunk_id] | Misc:712:0

[task] | diverse_qa [title] | SortableDataStorageItemPages [category] | Misc [rephrased] | 질문: `SortableDataStorageItemPages`는 어떤 기능을 제공하는 컴포넌트인가요? 답변: `SortableDataStorage`에 저장된 데이터를 조회하는 기능을 제공합니다. 질문: `IsLastPage` 프로퍼티의 타입과 접근 권한은 무엇이며, 어떤 정보를 확인하는 데 사용되나요? 답변: `IsLastPage`는 `boolean` 타입의 `[ReadOnly]` 프로퍼티로, 현재 페이지가 마지막 페이지인지 확인하는 데 사용됩니다. 질문: `GetCurrentPageDatas()` 메서드의 실행 공간과 반환 타 [original] | SortableDataStorage에 저장된 데이터를 조회하는 기능을 제공합니다. # Properties - **boolean IsLastPage [ReadOnly]** 현재 페이지가 마지막 페이지인지 확인합니다. # Methods - **table<SortableDataStorageItem> GetCurrentPageDatas() [ServerOnly]** 현재 페이지의 데이터 목록을 가져옵니다. - **int32 LoadNextPageAndWait() [ServerOnly] [Yield]** 다음 페이지를 불러 [chunk_id] | Misc:712:0

[task] | extract_knowledge [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage `SortableDataStorage`는 정렬된 데이터 저장을 지원하는 저장소입니다. 이 저장소는 `_DataStorageService`를 통해 접근하며, 값의 동기/비동기 증가 및 정렬된 순서로 데이터 페이지를 조회하는 기능을 제공합니다. ## API 사용법 ### 인스턴스 생성 `_DataStorageService:GetSortableDataStorage(name)` 메서드를 호출하여 특정 이름을 가진 `SortableDataStorage` 인스턴스를 가져옵니다. ### 값 증가 - [original] | # Examples #### IncreaseAndWait 값을 증가시키는 예제입니다. ```lua local ds = _DataStorageService:GetSortableDataStorage("Storage") -- "Key"에 해당하는 값이 없을 경우 기본 값으로 생성 후 1을 증가시킵니다. local errorCode, value = ds:IncreaseAndWait("Key", 1) ``` #### IncreaseAsync 값을 비동기로 증가시키는 예제입니다. ```lua local ds = _DataStor [chunk_id] | Misc:710:4

[task] | extract_knowledge [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage 트랜잭션 (Transact) `SortableDataStorage` 컴포넌트는 특정 키(Key)들을 묶어 원자적(atomic)으로 데이터를 저장 또는 삭제하는 트랜잭션 기능을 제공합니다. 트랜잭션 내의 모든 작업이 성공해야만 데이터가 반영되며, 하나라도 실패하면 전체 호출이 실패합니다. 한 번에 최대 20개 키까지 조작할 수 있습니다. ## API 사용법 트랜잭션 API는 동기(`AndWait`)와 비동기(`Async`) 버전으로 나뉘며, 모두 `[ServerOnly]` 실행 공간에서만 [original] | eld]** 입력한 키들로 데이터를 삭제합니다. 호출에 포함된 모든 작업이 성공하면 에러 코드, 삭제에 성공한 키들을 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작할 수 있습니다. - **void TransactDeleteAsync(List<string> keys, func<int32, List<string>> callbackFunction) [ServerOnly]** 입력한 키들로 데이터를 삭제합니다. 이 함수 호출은 [chunk_id] | Misc:710:3

[task] | wikipedia [title] | SortableDataStorage [category] | Misc [rephrased] | # SortableDataStorage **SortableDataStorage**는 메이플스토리 월드의 서버 사이드에서 정렬 가능한 데이터를 저장, 조회, 삭제하기 위해 사용되는 컴포넌트 또는 서비스입니다. 이 컴포넌트는 모든 메서드가 `[ServerOnly]` 속성을 가지므로 클라이언트 측에서 직접 호출할 수 없으며, 반드시 서버 로직 내에서만 작동합니다. 주요 기능은 동기화(Blocking) 방식과 비동기(Asynchronous) 방식으로 제공되며, 데이터 조작 시 에러 코드(`int32`)와 함께 관련 데이터를 반환하거나 [original] | lbackFunction) [ServerOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void Delete [chunk_id] | Misc:710:1

[task] | wikipedia [title] | Tweener [category] | Misc [rephrased] | # Tweener Tweener는 트윈(tween) 동작을 나타내는 객체입니다. ## 프로퍼티 Tweener는 트윈의 상태와 동작 방식을 제어하기 위한 여러 프로퍼티를 제공합니다. **AutoDestroy**는 `boolean` 타입의 프로퍼티로, 트윈이 완료된 후 자동으로 파괴될지 여부를 설정합니다. **CurrentLoopCount**는 `int32` 타입의 읽기 전용(ReadOnly) 프로퍼티로, 트윈에 설정된 반복 재생 횟수 중 현재 몇 번째 재생인지 나타냅니다. 첫 번째 재생 시 값은 1입니다. **Delay** [original] | 트윈 동작을 나타냅니다. # Properties - **boolean AutoDestroy** 트윈이 완료된 후 자동 파괴 여부를 설정합니다. - **int32 CurrentLoopCount [ReadOnly]** 트윈에 설정된 반복 재생 횟수 중 몇 번째 재생인지를 나타냅니다. 첫 번째 재생 시 값은 1입니다. - **float Delay** 트윈의 총 재생 시간에서 재생 지연 시간을 설정합니다. 길이가 5초인 Tweener에 Delay를 2초로 설정하면 3초 동안만 Tween을 재생합니다. - **EaseType [chunk_id] | Misc:714:0