[task] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: `DeleteAndWait` 메서드는 어떤 실행 공간에서 사용되며, 수행 중 스크립트 실행이 어떻게 되나요? 답변: `DeleteAndWait` 메서드는 `[ServerOnly]` 실행 공간에서 사용되며, `[Yield]` 속성이 있어 수행하는 동안 스크립트 실행을 중단합니다. 질문: `DeleteAsync` 메서드의 작업 완료 시 callbackFunction에 전달되는 인자는 무엇인가요? 답변: `DeleteAsync` 메서드의 작업이 완료되면 에러 코드와 키가 callbackFunction으로 전달된 함수에 함께 전달 [original] | erOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void DeleteAsync(string key, fu [chunk_id] | Misc:701:1
[task] | extract_knowledge [title] | TweenLogic [category] | Logics [rephrased] | # TweenLogic `TweenLogic`은 값의 보간(Interpolation)과 엔티티 이동 및 회전 애니메이션을 처리하는 로직 컴포넌트입니다. `float`, `Vector2`, `Vector3` 타입의 값에 대한 보간을 지원하며, 네이티브 컴포넌트 메서드와의 연동도 가능합니다. ## 개념 설명 보간은 두 값(`startValue`, `endValue`) 사이의 중간 값을 시간(`duration`)에 따라 계산하는 과정입니다. `TweenLogic`은 `EaseType`을 통해 보간 곡선(선형, 가속, 감속 등)을 지 [original] | Tween 관련 기능들을 제공합니다. # Methods - **float Ease(float startValue, float endValue, float duration, EaseType type, float tweenTime)** 시작값과 끝값 사이의 보간을 수행합니다. tweenTime을 duration으로 나눈 값으로 보간을 수행합니다. duration이 0인 경우 endValue를 반환하며, tweenTime이 0보다 작거나 duration보다 큰 경우 예상치 못한 값이 반환될 수 있습니다. - **Tweener Ma [chunk_id] | Logics:700:0
[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | CreatorDataStorage는 서버 측에서만 사용 가능한 데이터 저장소 서비스로, 사용자 데이터의 저장, 삭제, 조회 및 버전 관리를 위한 메서드를 제공합니다. 모든 메서드는 서버 공간(ServerOnly)에서 실행되며, 동기화(Yield) 방식과 비동기(Async) 방식의 두 가지 형태로 제공됩니다. 동기화 메서드는 작업이 완료될 때까지 스크립트 실행을 중단하고 결과를 반환하며, 비동기 메서드는 작업을 백그라운드에서 처리하고 완료 시 콜백 함수를 통해 결과를 전달합니다. 데이터 저장 기능은 입력한 DataStorageKey [original] | erOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void DeleteAsync(string key, fu [chunk_id] | Misc:701:1
[task] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: `SetAndWait` 메서드의 실행 공간과 동작 특성은 무엇인가요? 답변: `SetAndWait` 메서드는 `[ServerOnly]`로 실행되며, `[Yield]` 특성이 있어 작업 수행 중 스크립트 실행을 중단하고 완료 시 에러 코드를 반환합니다. 질문: `SetAsync` 메서드가 작업 완료 시 callbackFunction을 통해 전달하는 값은 무엇인가요? 답변: `SetAsync` 메서드가 작업 완료 시 callbackFunction을 통해 전달하는 값은 에러 코드와 키(string)입니다. 질문: `Transa [original] | 력한 키에 해당하는 데이터의 버전들을 조회합니다. sortDirection으로 오름/내림차순 정렬을 설정할 수 있습니다. minDate, maxDate로 설정한 시간대 내에서 생성된 버전을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 키, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 SetAndWait(string key, string value) [ServerOnly] [Yield]** 입력한 키로 데이터를 저장합니다. 작업이 완료되면 에 [chunk_id] | Misc:701:2
[task] | extract_knowledge [title] | TweenLogic [category] | Logics [rephrased] | # TweenLogic ## 개념 설명 `TweenLogic`은 엔티티의 위치, 회전, 크기 변화를 시간과 이징 함수에 따라 보간하는 애니메이션(트윈)을 제어하는 로직입니다. 해당 로직은 `Logic` 클래스를 상속받아 이벤트 연결 및 실행 환경 확인 기능을 포함하며, 주로 클라이언트 또는 서버에서 특정 엔티티의 시각적 상태 변화를 자동화할 때 사용됩니다. 주요 기능은 다음과 같습니다. - **회전 트윈**: 엔티티를 지정된 각도로 회전시킵니다. - **스케일 트윈**: 엔티티의 크기를 지정된 값으로 확대 또는 축소합니다. [original] | ffset을 축으로 angle만큼 반시계 방향으로 회전시키는 Tweener를 생성하고 재생합니다. - **Tweener RotateTo(Entity entity, float angle, float duration, EaseType type)** entity를 angle만큼 반시계 방향으로 회전시키는 Tweener를 생성하고 재생합니다. - **Tweener ScaleTo(Entity entity, Vector2 targetScale, float duration, EaseType type)** entity를 targetScal [chunk_id] | Logics:700:1
[task] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage `CreatorDataStorage`는 크리에이터가 소유한 모든 월드 간에 데이터를 공유하는 저장소입니다. 메이커(Maker) 환경과 출시(Release) 환경은 서로 다른 저장소를 사용하며, 데이터가 공유되지 않습니다. ## API 사용법 ### Properties * **`Name`** (`string`, `ReadOnly`) * 해당 `CreatorDataStorage` 인스턴스의 이름입니다. ### Methods 모든 메서드는 `[ServerOnly]`로, 서버에 [original] | 이 저장소는 크리에이터가 소유한 모든 월드에서 사용 가능하고, 저장된 데이터를 공유합니다. 메이커와 출시 환경은 저장소를 공유하지 않습니다. # Properties - **string Name [ReadOnly]** 이 CreatorDataStorage의 이름입니다. # Methods - **int32, List<string> BatchDeleteAndWait(List<string> keys) [ServerOnly] [Yield]** 입력한 키들로 데이터들을 삭제합니다. 에러 코드와 삭제에 성공한 키들을 반환합니다. [chunk_id] | Misc:701:0
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | 제시된 문서 내용에서 추출한 `CreatorDataStorage` 서비스의 핵심 사실 목록입니다. 1. `SaveAndWait` 메서드는 `[ServerOnly]` 환경에서 실행되며, 입력한 `DataStorageKeyInfo` 목록으로 데이터를 저장하는 작업이 완료되면 에러 코드와 저장에 성공한 `DataStorageKeyInfo`들을 인수로 전달받아 `callbackFunction`을 호출합니다. 2. `DeleteAndWait(string key)` 메서드는 `[ServerOnly]` 및 `[Yield]` 속성을 가지며, 입 [original] | erOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void DeleteAsync(string key, fu [chunk_id] | Misc:701:1
[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage CreatorDataStorage는 크리에이터가 소유한 모든 월드에서 사용 가능하며, 저장된 데이터를 이러한 월드들 간에 공유하는 저장소 컴포넌트입니다.需要注意的是, 메이커(Maker) 환경과 출시(Release) 환경은 서로 다른 저장소를 사용하며, 두 환경 간에는 데이터가 공유되지 않습니다. ## 속성 CreatorDataStorage는 **Name**이라는 문자열(string) 형태의 읽기 전용(ReadOnly) 속성을 가지며, 이는 해당 CreatorDataStorage 인스턴스의 [original] | 이 저장소는 크리에이터가 소유한 모든 월드에서 사용 가능하고, 저장된 데이터를 공유합니다. 메이커와 출시 환경은 저장소를 공유하지 않습니다. # Properties - **string Name [ReadOnly]** 이 CreatorDataStorage의 이름입니다. # Methods - **int32, List<string> BatchDeleteAndWait(List<string> keys) [ServerOnly] [Yield]** 입력한 키들로 데이터들을 삭제합니다. 에러 코드와 삭제에 성공한 키들을 반환합니다. [chunk_id] | Misc:701:0
[task] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | **CreatorDataStorage API** 모든 메서드는 `[ServerOnly]` 영역에서 실행됩니다. ### 1. 저장 (Save) * **비동기 저장** * `void SaveAsync(DataStorageKeyInfo[] keyInfos, func<int32, DataStorageKeyInfo[]> callbackFunction)` * 주어진 `DataStorageKeyInfo` 배열로 데이터를 비동기 저장합니다. * 완료 시: 에러 코드, 성공한 `DataStorageKeyInf [original] | erOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void DeleteAsync(string key, fu [chunk_id] | Misc:701:1
[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | CreatorDataStorage는 메이플스토리 월드에서 특정 키에 해당하는 데이터를 저장, 조회, 삭제하기 위한 서비스입니다. 이 서비스는 동기(Wait) 방식과 비동기(Async) 방식의 메서드를 제공하며, 모든 메서드는 서버 전용([ServerOnly])으로 동작합니다. 데이터 버전 조회 기능은 특정 키에 대한 버전 목록을 반환합니다. 이때 `sortDirection` 파라미터를 통해 오름차순 또는 내림차순 정렬을 지정할 수 있으며, `minDate`와 `maxDate` 파라미터를 사용하여 특정 시간대 내에서 생성된 버전만 [original] | 력한 키에 해당하는 데이터의 버전들을 조회합니다. sortDirection으로 오름/내림차순 정렬을 설정할 수 있습니다. minDate, maxDate로 설정한 시간대 내에서 생성된 버전을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 키, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 SetAndWait(string key, string value) [ServerOnly] [Yield]** 입력한 키로 데이터를 저장합니다. 작업이 완료되면 에 [chunk_id] | Misc:701:2
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | ```lua local ds = _DataStorageService:GetCreatorDataStorage() local errorCode = ds:SetAndWait("key", "value") if errorCode ~= 0 then error("Failed to SetAndWait. Error : " + tostring(errorCode)) return end ``` - `_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] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # [Misc] CreatorDataStorage CreatorDataStorage API는 서버에서만 실행되며, 데이터 저장은 동기(Wait) 또는 비동기(Async) 방식으로 수행됩니다. `Transact` 계열은 한 번에 최대 20개의 Key만 조작할 수 있으며, 하나라도 실패하면 전체 호출이 실패합니다. ### 조회 (Query) - **버전 조회**: 특정 키의 데이터 버전을 조회합니다. `sortDirection`(오름/내림차순), `minDate`, `maxDate`로 필터링 및 정렬 가능. 비동기이며, 완료 시 에 [original] | 력한 키에 해당하는 데이터의 버전들을 조회합니다. sortDirection으로 오름/내림차순 정렬을 설정할 수 있습니다. minDate, maxDate로 설정한 시간대 내에서 생성된 버전을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 키, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 SetAndWait(string key, string value) [ServerOnly] [Yield]** 입력한 키로 데이터를 저장합니다. 작업이 완료되면 에 [chunk_id] | Misc:701:2
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | 제공된 문서 내용을 기반으로 `CreatorDataStorage` 관련 핵심 사실을 추출하여 정리했습니다. * `CreatorDataStorage`의 버전 조회 기능은 `sortDirection` 매개변수를 통해 오름차순 또는 내림차순 정렬을 설정할 수 있으며, `minDate`와 `maxDate` 매개변수를 지정하여 해당 시간대 내에서 생성된 데이터 버전만 조회할 수 있습니다. * 버전 조회 작업은 비동기로 수행되며, 완료 시 에러 코드, 조회 대상 키, 그리고 조회된 데이터 객체를 매개변수로 받아서 `callbackFu [original] | 력한 키에 해당하는 데이터의 버전들을 조회합니다. sortDirection으로 오름/내림차순 정렬을 설정할 수 있습니다. minDate, maxDate로 설정한 시간대 내에서 생성된 버전을 조회할 수 있습니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 키, 조회용 객체와 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 SetAndWait(string key, string value) [ServerOnly] [Yield]** 입력한 키로 데이터를 저장합니다. 작업이 완료되면 에 [chunk_id] | Misc:701:2
[task] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: `TransactSetByInfoAsync` 메서드를 사용할 때 한 번에 조작할 수 있는 최대 Key 개수는 몇 개인가요? 답변: 한 번에 최대 20개 Key까지 조작할 수 있습니다. 질문: `UpdateAndWait` 메서드에서 기존 값이 `expectedValue`와 다르면 반환되는 에러 코드와 그 의미는 무엇인가요? 답변: 에러 코드 `UpdateApiFailed(2000000)`와 기존 값이 반환됩니다. 질문: `TransactSetByInfoAsync`와 `TransactSetAndWait`의 실행 방식 차이는 [original] | ndWait(Dictionary<DataStorageKeyInfo, string> keyValues) [ServerOnly] [Yield]** 입력한 DataStorageKeyInfo들로 데이터를 저장합니다. 모든 데이터 저장에 성공하면 에러 코드와 성공한 DataStorageKeyInfo를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작 할 수 있습니다. - **void TransactSetByInfoAsync(Dictio [chunk_id] | Misc:701:3
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | 제시된 문서에 포함된 CreatorDataStorage API의 핵심 사실들을 정리한 목록입니다. 1. `ndWait(Dictionary<DataStorageKeyInfo, string> keyValues)` 메서드는 `[ServerOnly]` 및 `[Yield]` 속성을 가지며, 입력된 `DataStorageKeyInfo` 목록으로 데이터를 동기적으로 저장하고, 모든 작업이 성공하면 에러 코드와 성공한 `DataStorageKeyInfo`를 반환하며, 하나라도 실패하면 함수 호출 자체가 실패하고, 최대 20개의 Key까지 조작할 [original] | ndWait(Dictionary<DataStorageKeyInfo, string> keyValues) [ServerOnly] [Yield]** 입력한 DataStorageKeyInfo들로 데이터를 저장합니다. 모든 데이터 저장에 성공하면 에러 코드와 성공한 DataStorageKeyInfo를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작 할 수 있습니다. - **void TransactSetByInfoAsync(Dictio [chunk_id] | Misc:701:3
[task] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage (Creator Data Storage) CreatorDataStorage API는 서버 전용(`[ServerOnly]`)으로 사용자 데이터를 저장 및 갱신합니다. * **동기/비동기**: `[Yield]` 메서드는 실행 중 스크립트를 중단(블로킹)합니다. `Async` 메서드는 콜백으로 결과를 반환하며 블로킹하지 않습니다. * **최대 키 수**: `Set` 계열 메서드는 한 번에 최대 **20개** Key까지 조작 가능합니다. * **갱신 규칙**: `Update` 계열 메서드는 [original] | ndWait(Dictionary<DataStorageKeyInfo, string> keyValues) [ServerOnly] [Yield]** 입력한 DataStorageKeyInfo들로 데이터를 저장합니다. 모든 데이터 저장에 성공하면 에러 코드와 성공한 DataStorageKeyInfo를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작 할 수 있습니다. - **void TransactSetByInfoAsync(Dictio [chunk_id] | Misc:701:3
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | 제시된 문서에 포함된 정보만 바탕으로 핵심 사실을 정리한 목록입니다. 1. `CreatorDataStorage` 객체는 `_DataStorageService:GetCreatorDataStorage()` 메서드를 호출하여 획득합니다. 2. `DataStorageKeyInfo` 구조체는 `"Key"`, `"Version"`, `"Tag"` 문자열 인자를 사용하여 생성하며, 이는 데이터 저장 및 조회 시 키 정보를 정의하는 데 사용됩니다. 3. `ds:GetByInfoAndWait(keyInfo)` 메서드는 `DataStorageKey [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] | CreatorDataStorage [category] | Misc [rephrased] | 질문: CreatorDataStorage 객체를 얻기 위해 어떤 서비스와 메서드를 사용해야 하나요? 답변: `_DataStorageService:GetCreatorDataStorage()`를 사용해야 합니다. 질문: `SetAndWait` 메서드에서 오류가 발생했을 때 반환되는 값을 어떻게 확인하나요? 답변: 반환되는 `errorCode` 변수가 0이 아닌 경우(`errorCode ~= 0`) 오류가 발생한 것으로 판단합니다. 질문: `GetAndWait` 메서드가 성공적으로 실행되면 어떤 값들이 반환되나요? 답변: `error [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] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage Examples `_DataStorageService:GetCreatorDataStorage()`를 통해 키-값 데이터를 저장, 조회, 삭제합니다. 모든 메서드는 `errorCode`를 반환하며, `0`이 아닌 값은 실패를 의미합니다. ### 동기 (Wait) 메서드 블로킹 방식으로 결과를 즉시 반환합니다. * **SetAndWait**: `ds:SetAndWait(key, value)` * **GetAndWait**: `ds:GetAndWait(key)` → `errorCode, [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] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # [Misc] CreatorDataStorage `_DataStorageService:GetCreatorDataStorage()`로 인스턴스를 얻어 데이터를 관리합니다. 모든 메서드는 `errorCode`를 반환하며, `0`이 아니면 실패입니다. ### 데이터 조회 (GetByInfoAndWait) `DataStorageKeyInfo`를 사용해 특정 키의 값을 비동기 대기 후 조회합니다. ```lua local ds = _DataStorageService:GetCreatorDataStorage() local keyInfo = [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] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage **CreatorDataStorage**는 메이플스토리 월드(mLua) 환경에서 서버 측 데이터 저장소를 조작하기 위한 API 모듈입니다. 이 모듈은 데이터의 저장(Set), 조건부 갱신(Update)을 동기(Yield) 또는 비동기(Async) 방식으로 수행할 수 있는 함수들을 제공합니다. 모든 함수는 `[ServerOnly]` 속성을 가지며, 클라이언트 측에서 호출할 수 없습니다. ## 데이터 저장 함수 데이터 저장은 개별 키-값 쌍 또는 여러 키-값 쌍을 일괄적으로 처리할 수 있으며, [original] | ndWait(Dictionary<DataStorageKeyInfo, string> keyValues) [ServerOnly] [Yield]** 입력한 DataStorageKeyInfo들로 데이터를 저장합니다. 모든 데이터 저장에 성공하면 에러 코드와 성공한 DataStorageKeyInfo를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. 모든 작업 중 하나라도 실패한다면, 함수 호출이 실패합니다. 한 번에 최대 20개 Key까지 조작 할 수 있습니다. - **void TransactSetByInfoAsync(Dictio [chunk_id] | Misc:701:3
[task] | wikipedia [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage CreatorDataStorage는 메이플스토리 월드(mLua)에서 크리에이터가 사용자 데이터를 저장, 조회, 삭제하기 위해 사용하는 데이터 저장소입니다. `_DataStorageService:GetCreatorDataStorage()` 메서드를 호출하여 CreatorDataStorage 인스턴스를 획득할 수 있습니다. 이 저장소는 동기(Wait) 방식과 비동기(Async) 방식의 메서드를 제공하며, 모든 메서드는 실행 결과에 대한 오류 코드(`errorCode`)를 반환합니다. 오류 코드가 [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] | extract_knowledge [title] | TweenLogic [category] | Logics [rephrased] | # TweenLogic 컴포넌트 `TweenLogic`은 엔티티의 위치, 회전, 스케일 또는 특정 프로퍼티의 값을 시간 경과에 따라 부드럽게 변경하기 위한补간(Tweening) 기능을 제공합니다. 이 서비스는 미리 정의된 이징 함수(`EaseType`)를 사용하여 움직임의 가속과 감속을 제어할 수 있습니다. ## 1. 개념 설명 mLua에서 `TweenLogic`은 전역 서비스 객체 `_TweenLogic`을 통해 접근합니다. 주요 기능은 다음과 같습니다. * **MoveOffset**: 엔티티의 현재 위치를 기준으로 특 [original] | # Examples #### MoveOffset `MoveOffset()` 함수를 활용해 움직임을 구현하는 예제입니다. ```lua Method: [server only] void OnBeginPlay () { _TweenLogic:MoveOffset(self.Entity, Vector2(6,0), 6, EaseType.QuartEaseIn) } ``` #### PlayTween `PlayTween()` 함수를 활용해 움직임을 구현하는 예제입니다. ```lua Method: [server only] void OnBegi [chunk_id] | Logics:700:2
[task] | knowledge_list [title] | CreatorDataStorage [category] | Misc [rephrased] | 제공된 문서에 포함된 핵심 사실과 API 사용법을 바탕으로 추출한 목록은 다음과 같습니다. 1. `_DataStorageService:GetCreatorDataStorage()` 메서드를 호출하여 Creator DataStorage 객체를 반환받아 데이터를 저장하거나 가져오는 연산을 수행할 수 있습니다. 2. `DataStorageKeyInfo` 생성자는 Key, Version, Tag 순서로 문자열 인자를 받아 데이터 저장 및 조회를 위한 키 정보를 생성합니다. 3. `ds:BatchSetByInfoAndWait(keyInfoV [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] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: `DataStorageKeyInfo` 객체를 생성할 때 어떤 인자 값들을 전달하는가? 답변: `DataStorageKeyInfo` 객체를 생성할 때는 키(Key), 버전(Version), 태그(Tag)의 세 가지 문자열 인자를 전달합니다. 질문: `ds:BatchSetByInfoAndWait` 메서드를 호출할 때 전달하는 `keyInfoValues` 테이블의 구조는 어떤가? 답변: `keyInfoValues` 테이블은 키로 `DataStorageKeyInfo` 객체를, 값으로 저장할 데이터(예: "Value1")를 가지는 [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] | diverse_qa [title] | CreatorDataStorage [category] | Misc [rephrased] | 질문: CreatorDataStorage에서 데이터를 가져오기 위해 `_DataStorageService`를 통해 어떤 객체를 획득하는가? 답변: `_DataStorageService:GetCreatorDataStorage()` 메서드를 호출하여 CreatorDataStorage 객체를 획득합니다. 질문: `DataStorageKeyInfo` 객체를 생성할 때 어떤 인자 세 개를 전달해야 하는가? 답변: `"Key"`, `"Version"`, `"Tag"` 순서로 세 가지 문자열 인자를 전달해야 합니다. 질문: `GetByInf [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] | distill [title] | CreatorDataStorage [category] | Misc [rephrased] | # [Misc] CreatorDataStorage `_DataStorageService:GetCreatorDataStorage()`를 통해 `CreatorDataStorage` 인스턴스를 생성합니다. `DataStorageKeyInfo`를 사용하여 데이터를 일괄 저장 및 조회합니다. ### DataStorageKeyInfo 키, 버전, 태그를 지정하여 저장 대상 식별자를 생성합니다. ```lua local keyInfo = DataStorageKeyInfo("Key1", "Version1", "Tag1") ``` ### Bat [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] | CreatorDataStorage [category] | Misc [rephrased] | 제시된 문서 원문에 포함된 정보만을 바탕으로 핵심 사실을 정리한 목록입니다. * `_DataStorageService:GetCreatorDataStorage()` 메서드는 CreatorDataStorage 객체를 반환하며, 이 객체를 통해 데이터 저장소 관련 연산을 수행합니다. * `GetPagesAndWait(tag)` 메서드는 지정된 태그 값을 기준으로 데이터를 조회하며, 첫 번째 반환값은 결과 코드(0이 성공)이고 두 번째 반환값은 페이지 데이터를 다루는 `pages` 객체입니다. * `pages:GetCurren [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`는 크리에이터가 데이터를 저장, 조회, 수정, 삭제하기 위해 사용하는 데이터 저장소입니다. 이 저장소는 `_DataStorageService:GetCreatorDataStorage()` 메서드를 통해 접근할 수 있으며, 주로 비동기 대기(`AndWait`)가 포함된 메서드들을 제공하여 데이터 조작 결과를 즉시 반환합니다. ## 데이터 조회 데이터는 `DataStorageKeyInfo` 객체를 생성하여 조회할 수 있습니다. `DataStorageKeyInf [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] | extract_knowledge [title] | CreatorDataStorage [category] | Misc [rephrased] | # CreatorDataStorage API 사용법 ## 개념 설명 `CreatorDataStorage`는 서버 측에서 데이터를 저장, 조회, 삭제하기 위한 비동기 및 동기 API를 제공합니다. 모든 메서드는 `[ServerOnly]` 속성을 가지며 클라이언트에서는 호출할 수 없습니다. 작업 방식은 두 가지로 나뉩니다. 1. **동기 (AndWait)**: 작업이 완료될 때까지 스크립트 실행을 중단(Yield)합니다. 완료 시 에러 코드와 결과를 직접 반환합니다. 2. **비동기 (Async)**: 작업을 즉시 반환하고, 완료 [original] | erOnly]** 입력한 DataStorageKeyInfo들로 데이터들을 저장합니다. 이 작업은 비동기로 수행되며, 작업이 완료되면 에러 코드, 저장에 성공한 DataStorageKeyInfo들과 함께 callbackFunction으로 전달된 함수가 호출됩니다. - **int32 DeleteAndWait(string key) [ServerOnly] [Yield]** 입력한 키로 데이터를 삭제하고 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **void DeleteAsync(string key, fu [chunk_id] | Misc:701:1