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

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | DataStorage는 키 값과 함께 Tag 및 Version을 지정하여 데이터를 저장할 수 있는 시스템입니다. 이러한 추가 정보를 포함하여 데이터를 저장하기 위해서는 `DataStorageKeyInfo` 객체를 사용해야 합니다. `DataStorageKeyInfo`는 생성자에서 매개 변수로 key, Tag, Version을 전달받아 초기화할 수 있으며, 예를 들어 `DataStorageKeyInfo("key", "Tag", "Version1")`과 같이 사용할 수 있습니다. 만약 `DataStorageKeyInfo`를 Tag와 V [original] | DataStorage에 키 값과 더불어 Tag, Version을 지정해서 저장할 수 있습니다. 새로운 두 값을 저장하기 위해선 DataStorageKeyInfo를 활용해야 합니다. `DataStorageKeyInfo("key", "Tag", "Version1")`처럼 매개 변수로 key, Tag, Version을 사용할 수 있습니다. 만약 DataStorageKeyInfo를 Tag, Version 없이 사용한다면, SetAndWait, SetAsync류 함수를 사용해 데이터를 저장한 것과 동일합니다. 또한 SetByInfoAndW [chunk_id] | Guides:692:3

[task] | extract_knowledge [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage 에러 코드와 데이터 관리 메타데이터 ## 1. 개념 설명 `DataStorage` API를 통해 데이터 저장, 삭제, 조회, 증가, 순회 등의 작업을 수행할 경우, 각 작업의 성공 여부를 반환되는 **에러 코드(ErrorCode)** 로 확인해야 합니다. 모든 요청이 성공적으로 완료되면 에러 코드는 `0`을 반환합니다. 또한, 데이터의 관리성을 높이기 위해 **Version(버전)** 과 **Tag(태그)** 라는 메타데이터를 사용할 수 있습니다. * **Version**: 특정 시점의 데이터를 복 [original] | DataStorage의 함수를 사용해 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회 하기 등 다양한 데이터 관련 작업을 했을 때 해당 작업이 성공했는지 실패했는지를 에러 코드로 확인할 수 있습니다. 함수 요청이 성공했을 때의 에러 코드는 0입니다. 예를 들어, `local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues)` 와 같이 errorCode를 함께 작성해야 합니다. | ErrorCode | Error Name | 설명 | | --- | --- [chunk_id] | Guides:692:1

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | * `_DataStorageService`의 `GetSortableDataStorage` 메서드는 지정된 이름의 `SortableDataStorage` 인스턴스를 반환합니다. * `SortableDataStorage`의 `IncreaseAndWait` 메서드는 매개변수 `Key`와 `delta`를 받아 동기로 처리하며, 반환 값은 에러 코드와 증가된 후의 값입니다. * `SortableDataStorage`의 `IncreaseAsync` 메서드는 매개변수 `Key`와 `delta`를 받아 비동기로 처리하며, 반환 값은 에 [original] | SortableDataStorage는 IncreaseAndWait, IncreaseAsync 함수를 활용해 값을 증가시킬 수 있습니다. 각 함수의 delta 입력 값만큼 해당 매개 변수의 값이 증가하거나 감소합니다. 매개 변수로 들어온 값이 양수일 때는 증가, 음수일 때는 감소합니다. 만약, 증가시키고자 하는 값이 DataStorage에 존재하지 않는다면 기본값 0으로 저장하고 delta만큼 증가하게 됩니다. IncreaseAndWait 및 IncreaseAsync 함수는 에러 코드와 증가된 후의 값을 제공합니다. DataStor [chunk_id] | Guides:692:5

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | **DB DataStorage 활용하기: 데이터 가져오기** 메이플스토리 월드의 DataStorage를 통해 데이터를 조회할 때는 `GetAndWait` 또는 `GetAsync` 함수를 사용한다. DataStorage의 종류에 따라 조회할 수 있는 데이터 타입이 상이하다. `GlobalDataStorage`, `UserDataStorage`, `CreatorDataStorage`는 문자열(String) 타입의 값만 조회할 수 있으며, `SortableDataStorage`는 정수(Integer) 타입의 값만 조회할 수 있다. 데 [original] | 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 만약 데이터를 저장할 때 `_UtilLogic:TableToString()` 함수를 사용해 데이터를 문자열로 변환했다면, 데이터를 가져올 때는 `_UtilLogic:StringToTable()` 함수를 사용해 기존 타입으로 변환하여 사용할 수 있습니다. SortableDataStorage는 정수 타입의 값만 가져올 [chunk_id] | Guides:692:4

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 `_DataStorageService`를 통해 DataStorage의 목록을 조회할 때, 반환 값은 `Pages` 객체 형태입니다. 이 객체를 사용하면 데이터 목록을 페이지 단위로 나누어 순차적으로 조회할 수 있습니다. `Pages` 객체는 현재 페이지의 데이터를 가져오는 `GetCurrentPageDatas()` 메서드, 마지막 페이지 여부를 확인하는 `IsLastPage` 프로퍼티, 그리고 다음 페이지로 이동하는 `MoveToNextPageAndWait()` 메서드를 제공합니다. 다음 [original] | DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. ```lua local errorCode, globalDataStoragePages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local globalDataStorages = globalDataStoragePages:GetCurrentPageDatas() --GetCurrentPageDatas()로 현 [chunk_id] | Guides:692:6

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: 데이터를 가져올 때 사용하는 함수는 무엇입니까? 답변: 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. 질문: GlobalDataStorage, UserDataStorage, CreatorDataStorage는 어떤 타입의 값만 가져올 수 있습니까? 답변: GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 질문: `_UtilLogic:TableToString()` 함수를 사용해 데이터를 저장했을 때, [original] | 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 만약 데이터를 저장할 때 `_UtilLogic:TableToString()` 함수를 사용해 데이터를 문자열로 변환했다면, 데이터를 가져올 때는 `_UtilLogic:StringToTable()` 함수를 사용해 기존 타입으로 변환하여 사용할 수 있습니다. SortableDataStorage는 정수 타입의 값만 가져올 [chunk_id] | Guides:692:4

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # 데이터 저장소(DataStorage) 활용하기 ## 값 증가 및 감소 `SortableDataStorage`는 `IncreaseAndWait`와 `IncreaseAsync` 함수를 통해 특정 키에 해당하는 값을 증가시키거나 감소시킬 수 있습니다. 이 함수들은 `delta`라는 입력 값을 받아, 해당 매개 변수의 현재 값에 반영합니다. `delta` 값이 양수일 경우 값은 증가하고, 음수일 경우 값은 감소합니다. 대상 키가 `DataStorage`에 아직 존재하지 않는다면, 시스템은 해당 키의 기본값으로 0을 설정한 후 `d [original] | SortableDataStorage는 IncreaseAndWait, IncreaseAsync 함수를 활용해 값을 증가시킬 수 있습니다. 각 함수의 delta 입력 값만큼 해당 매개 변수의 값이 증가하거나 감소합니다. 매개 변수로 들어온 값이 양수일 때는 증가, 음수일 때는 감소합니다. 만약, 증가시키고자 하는 값이 DataStorage에 존재하지 않는다면 기본값 0으로 저장하고 delta만큼 증가하게 됩니다. IncreaseAndWait 및 IncreaseAsync 함수는 에러 코드와 증가된 후의 값을 제공합니다. DataStor [chunk_id] | Guides:692:5

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 1. DataStorage에서 목록 또는 데이터 목록을 조회할 때, 반환 값은 페이지 단위로 데이터를 조회할 수 있는 `Pages` 형태의 객체입니다. 2. `_DataStorageService:GetGlobalDataStoragePagesAndWait()` 메서드를 호출하면 첫 번째 반환 값으로 에러 코드(`errorCode`), 두 번째 반환 값으로 전역 DataStorage의 페이지 객체(`globalDataStoragePages`)를 제공합니다. 3. `Pages` 객체의 `GetCurrentPageDatas()` 메서드를 [original] | DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. ```lua local errorCode, globalDataStoragePages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local globalDataStorages = globalDataStoragePages:GetCurrentPageDatas() --GetCurrentPageDatas()로 현 [chunk_id] | Guides:692:6

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: DataStorage에서 목록을 조회할 때 페이지 단위로 값을 받기 위해 어떤 형태의 객체를 사용합니까? 답변: DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. 질문: `_DataStorageService:GetGlobalDataStoragePagesAndWait()` 함수의 반환 값은 무엇입니까? 답변: 에러 코드(errorCode)와 글로벌 데이터 저장소 페이지 객체(globalDataStoragePages)를 반환합니다. 질문: 현 [original] | DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. ```lua local errorCode, globalDataStoragePages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local globalDataStorages = globalDataStoragePages:GetCurrentPageDatas() --GetCurrentPageDatas()로 현 [chunk_id] | Guides:692:6

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: SortableDataStorage에서 값을 증가시키거나 감소시키기 위해 사용할 수 있는 함수는 무엇입니까? 답변: IncreaseAndWait, IncreaseAsync 함수를 활용할 수 있습니다. 질문: IncreaseAndWait 또는 IncreaseAsync 함수의 delta 입력 값이 양수와 음수일 때 각각 어떤 처리가 이루어집니까? 답변: 매개 변수로 들어온 값이 양수일 때는 해당 값이 증가하고, 음수일 때는 감소합니다. 질문: IncreaseAndWait 함수를 통해 증가시키고자 하는 값이 DataStorag [original] | SortableDataStorage는 IncreaseAndWait, IncreaseAsync 함수를 활용해 값을 증가시킬 수 있습니다. 각 함수의 delta 입력 값만큼 해당 매개 변수의 값이 증가하거나 감소합니다. 매개 변수로 들어온 값이 양수일 때는 증가, 음수일 때는 감소합니다. 만약, 증가시키고자 하는 값이 DataStorage에 존재하지 않는다면 기본값 0으로 저장하고 delta만큼 증가하게 됩니다. IncreaseAndWait 및 IncreaseAsync 함수는 에러 코드와 증가된 후의 값을 제공합니다. DataStor [chunk_id] | Guides:692:5

[task] | extract_knowledge [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # DateTime 포맷팅: 사용자 지정 서식 지정자 mLua에서 `DateTime` 객체의 문자열 표현을 제어하기 위해 `ToFormattedString` 메서드를 사용합니다. 이 메서드는 특정 패턴 문자열(서식 지정자)을 인수로 받아 날짜와 시간 정보를 원하는 형태로 변환합니다. ## 개념 설명 사용자 지정 서식 지정자는 문자열 내의 특정 기호를 통해 연도, 시간 구분, 날짜 구분 등 특정 정보를 출력합니다. 1. **AM/PM 지정자 (`tt`)** * `tt`: AM 또는 PM 문자를 출력합니다. [original] | "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 모든 시간에 사용되고 PM 지정자는 12:00:00부터 23:59:59.999까지의 모든 시간에 사용됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` #### "y" "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타냅니다. 연도가 두 자리를 [chunk_id] | Guides:691:9

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 1. `Transact` 접두사를 가진 함수를 사용하여 데이터의 저장, 불러오기, 제거 작업을 원자적으로 일괄 요청할 수 있습니다. 2. `Transact` 함수 호출 시 포함되는 작업 중 하나라도 실패하면 전체 함수 호출이 실패 처리됩니다. 3. `Transact` 함수를 통해 한 번에 조작할 수 있는 Key의 최대 개수는 20개입니다. 4. 전달된 요청들이 모두 성공하지 않으면 모든 작업이 실패 처리되며, 요청 이전의 데이터 상태가 유지됩니다. 5. `Transact` 함수는 트랜잭션 보장을 위해 내부적으로 복잡한 처리 과정을 [original] | Transact 접두사인 함수를 활용해 데이터 저장하기, 불러오기, 제거하기를 원자적으로 일괄 요청할 수 있습니다. 만약 함수 호출에 포함된 모든 작업 중 하나라도 실패한다면, 함수 호출은 실패합니다. 한 번에 Key를 최대 20개까지 조작할 수 있습니다. 한 번에 전달된 요청들이 모두 성공하지 않으면 모두 실패 처리하고, 요청 이전의 데이터를 유지합니다. 그러므로 오류 처리 관련 코드를 간소화할 수 있습니다. 그러나 트랜잭션 보장을 위해 내부적으로 복잡한 처리 과정이 진행됩니다. credit 또한 Batch 함수에 비해 2배로 소 [chunk_id] | Guides:692:7

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | **DB DataStorage 활용하기** ### SortableDataStorage 정렬 `SortableDataStorage`는 데이터를 정렬하여 조회할 수 있습니다. * **함수**: `GetSortedAndWait`, `GetSortedAsync` * **옵션**: 정렬 방향(`SortDirection.Ascending` / `Descending`), 범위 지정(최솟값, 최댓값) * **동작**: 페이지 단위로 데이터를 반환하며, 마지막 페이지 확인 후 다음 페이지로 이동합니다. ```lua local sort [original] | SortableDataStorage는 GetSortedAndWait 및 GetSortedAsync 함수로 데이터를 정렬할 수 있습니다. 데이터를 정렬하여 가져올 때 오름차순으로 정렬할지 내림차순으로 정렬할지 지정할 수 있으며 최솟값과 최댓값을 지정하여 원하는 범위의 값 목록을 정렬하여 가져올 수 있습니다. SortableDataStorage에 저장된 데이터를 정렬해 가져오는 예제입니다. ```lua local sortableDataStorage = _DataStorageService:GetSortableDataStorage("s [chunk_id] | Guides:692:8

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | * `SortableDataStorage`는 `GetSortedAndWait` 및 `GetSortedAsync` 함수를 통해 저장된 데이터를 정렬하여 가져올 수 있으며, 정렬 방향(오름차순/내림차순)을 지정하고 최솟값과 최댓값을 설정하여 특정 범위의 값 목록만 조회할 수 있습니다. * `SortableDataStorage:GetSortedAndWait(SortDirection.Ascending, 0, 100)` 호출 시 첫 번째 인자로 정렬 방향(`SortDirection.Ascending` 등)을, 두 번째와 세 번째 인자 [original] | SortableDataStorage는 GetSortedAndWait 및 GetSortedAsync 함수로 데이터를 정렬할 수 있습니다. 데이터를 정렬하여 가져올 때 오름차순으로 정렬할지 내림차순으로 정렬할지 지정할 수 있으며 최솟값과 최댓값을 지정하여 원하는 범위의 값 목록을 정렬하여 가져올 수 있습니다. SortableDataStorage에 저장된 데이터를 정렬해 가져오는 예제입니다. ```lua local sortableDataStorage = _DataStorageService:GetSortableDataStorage("s [chunk_id] | Guides:692:8

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 `SortableDataStorage`는 `GetSortedAndWait` 및 `GetSortedAsync` 함수를 통해 저장된 데이터를 정렬하여 조회할 수 있습니다. 정렬 시 오름차순(`Ascending`) 또는 내림차순(`Descending`) 중 하나를 지정할 수 있으며, 최솟값과 최댓값을 설정하여 특정 범위의 값 목록만 필터링하여 가져올 수 있습니다. 다음은 `SortableDataStorage`에 저장된 데이터를 정렬하여 가져오는 예제입니다. ```lua local sortabl [original] | SortableDataStorage는 GetSortedAndWait 및 GetSortedAsync 함수로 데이터를 정렬할 수 있습니다. 데이터를 정렬하여 가져올 때 오름차순으로 정렬할지 내림차순으로 정렬할지 지정할 수 있으며 최솟값과 최댓값을 지정하여 원하는 범위의 값 목록을 정렬하여 가져올 수 있습니다. SortableDataStorage에 저장된 데이터를 정렬해 가져오는 예제입니다. ```lua local sortableDataStorage = _DataStorageService:GetSortableDataStorage("s [chunk_id] | Guides:692:8

[task] | wikipedia [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | **PixelRendererComponent**는 비어 있는 스프라이트에 픽셀 단위로 원하는 색상을 지정할 수 있게 하는 컴포넌트입니다. 이 컴포넌트를 사용하면 스프라이트의 특정 위치 픽셀 색상만 변경하거나, 전체 스프라이트의 색상을 일괄 지정할 수 있으며, 랜덤한 색상으로 변경하는 것도 가능합니다. 본 문서에서는 **PixelRendererComponent**의 프로퍼티 구성을 살펴본 후, 이를 활용한 색상 변경 방식을 안내합니다. 관련 API의 상세 정보는 [PixelRendererComponent](https://mod-dev [original] | # 학습 과정 소개 **PixelRendererComponent**를 활용하면 크리에이터가 비어있는 스프라이트에 픽셀 단위로 원하는 색을 지정할 수 있습니다. 특정 위치의 픽셀 색상만 바꾸거나 전체 스프라이트 색상을 지정할 수도 있고, 랜덤한 색상으로 변경할 수도 있습니다. 먼저 **PixelRendererComponent**의 프로퍼티를 살펴보고 예제를 통해 활용법을 알아봅시다. ##### 참고 API Reference [PixelRendererComponent](https://mod-developers.nexon.com/api [chunk_id] | Guides:693:0

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage: Transact (트랜잭션) `Transact` 접두사 함수를 사용하여 데이터 저장(`Set`), 제거(`Delete`) 작업을 원자적으로 일괄 처리합니다. ### 동작 규칙 * **원자성**: 요청된 작업 중 하나라도 실패하면 전체 요청이 실패하며, 데이터는 변경 전 상태로 유지됩니다. * **제한**: 한 번에 최대 **20개**의 Key를 조작할 수 있습니다. * **비용**: 내부 처리 복잡도로 인해 `Batch` 함수 대비 **Credit 소모가 2배**입니다. * **오류 [original] | Transact 접두사인 함수를 활용해 데이터 저장하기, 불러오기, 제거하기를 원자적으로 일괄 요청할 수 있습니다. 만약 함수 호출에 포함된 모든 작업 중 하나라도 실패한다면, 함수 호출은 실패합니다. 한 번에 Key를 최대 20개까지 조작할 수 있습니다. 한 번에 전달된 요청들이 모두 성공하지 않으면 모두 실패 처리하고, 요청 이전의 데이터를 유지합니다. 그러므로 오류 처리 관련 코드를 간소화할 수 있습니다. 그러나 트랜잭션 보장을 위해 내부적으로 복잡한 처리 과정이 진행됩니다. credit 또한 Batch 함수에 비해 2배로 소 [chunk_id] | Guides:692:7

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: SortableDataStorage에서 데이터를 정렬하여 가져올 때 사용할 수 있는 함수는 무엇인가요? 답변: GetSortedAndWait 및 GetSortedAsync 함수를 사용할 수 있습니다. 질문: SortableDataStorage에서 데이터를 정렬할 때 오름차순으로 정렬하려면 어떤 인자를 전달해야 하나요? 답변: SortDirection.Ascending 인자를 전달해야 합니다. 질문: 다음 코드에서 pages:GetCurrentPageDatas() 함수의 역할은 무엇인가요? ```lua local items [original] | SortableDataStorage는 GetSortedAndWait 및 GetSortedAsync 함수로 데이터를 정렬할 수 있습니다. 데이터를 정렬하여 가져올 때 오름차순으로 정렬할지 내림차순으로 정렬할지 지정할 수 있으며 최솟값과 최댓값을 지정하여 원하는 범위의 값 목록을 정렬하여 가져올 수 있습니다. SortableDataStorage에 저장된 데이터를 정렬해 가져오는 예제입니다. ```lua local sortableDataStorage = _DataStorageService:GetSortableDataStorage("s [chunk_id] | Guides:692:8

[task] | knowledge_list [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | 제시된 원문에는 `PixelRendererComponent`의 프로퍼티 정보만 포함되어 있으며, 픽셀 색상 변경을 위한 메서드(Method) 이름, 매개변수, 반환 타입 및 서버/클라이언트 제약 사항은 문서에 명시되어 있지 않습니다. 따라서 원문에 있는 정보만 사용하여 프로퍼티 관련 핵심 사실만 정리합니다. * `PixelRendererComponent`의 `Width` 프로퍼티는 `int` 타입이며, 스프라이트의 가로 길이를 나타냅니다. * `PixelRendererComponent`의 `Height` 프로퍼티는 `int [original] | # 학습 과정 소개 **PixelRendererComponent**를 활용하면 크리에이터가 비어있는 스프라이트에 픽셀 단위로 원하는 색을 지정할 수 있습니다. 특정 위치의 픽셀 색상만 바꾸거나 전체 스프라이트 색상을 지정할 수도 있고, 랜덤한 색상으로 변경할 수도 있습니다. 먼저 **PixelRendererComponent**의 프로퍼티를 살펴보고 예제를 통해 활용법을 알아봅시다. ##### 참고 API Reference [PixelRendererComponent](https://mod-developers.nexon.com/api [chunk_id] | Guides:693:0

[task] | extract_knowledge [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage 활용하기 ## 1. 개념 설명 `DataStorage`는 게임 데이터의 영구적 저장을 위한 서비스입니다. 데이터를 저장할 때 단순히 키(Key)와 값(Value)뿐만 아니라 `Tag`와 `Version`을 함께 지정하여 관리할 수 있습니다. 데이터의 메타데이터를 관리하기 위해 `DataStorageKeyInfo` 객체를 사용합니다. 이 객체를 통해 특정 키에 대한 태그와 버전을 명시적으로 정의할 수 있습니다. 데이터 스토리지는 용도와 주체에 따라 네 가지 유형으로 분류됩니다. * **GlobalD [original] | DataStorage에 키 값과 더불어 Tag, Version을 지정해서 저장할 수 있습니다. 새로운 두 값을 저장하기 위해선 DataStorageKeyInfo를 활용해야 합니다. `DataStorageKeyInfo("key", "Tag", "Version1")`처럼 매개 변수로 key, Tag, Version을 사용할 수 있습니다. 만약 DataStorageKeyInfo를 Tag, Version 없이 사용한다면, SetAndWait, SetAsync류 함수를 사용해 데이터를 저장한 것과 동일합니다. 또한 SetByInfoAndW [chunk_id] | Guides:692:3

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | **DB DataStorage 활용하기** mLua의 DataStorage 시스템에서는 `Transact` 접두사가 붙은 함수를 사용하여 데이터의 저장, 조회, 및 삭제 작업을 원자적으로 일괄 처리할 수 있습니다. 이 트랜잭션 방식은 함수 호출에 포함된 모든 작업 중 하나라도 실패할 경우 전체 함수 호출이 실패하도록 보장합니다. 한 번의 트랜잭션 요청을 통해 최대 20개까지의 키(Key)를 조작할 수 있습니다. 트랜잭션은 모든 작업이 성공해야만 데이터가 변경되며, 하나라도 실패하면 모든 변경 사항이 롤백되어 요청 이전의 데이터 [original] | Transact 접두사인 함수를 활용해 데이터 저장하기, 불러오기, 제거하기를 원자적으로 일괄 요청할 수 있습니다. 만약 함수 호출에 포함된 모든 작업 중 하나라도 실패한다면, 함수 호출은 실패합니다. 한 번에 Key를 최대 20개까지 조작할 수 있습니다. 한 번에 전달된 요청들이 모두 성공하지 않으면 모두 실패 처리하고, 요청 이전의 데이터를 유지합니다. 그러므로 오류 처리 관련 코드를 간소화할 수 있습니다. 그러나 트랜잭션 보장을 위해 내부적으로 복잡한 처리 과정이 진행됩니다. credit 또한 Batch 함수에 비해 2배로 소 [chunk_id] | Guides:692:7

[task] | diverse_qa [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | 질문: PixelRendererComponent의 주요 기능은 무엇인가요? 답변: PixelRendererComponent는 크리에이터가 비어있는 스프라이트에 픽셀 단위로 원하는 색을 지정할 수 있게 해주는 컴포넌트입니다. 질문: 특정 위치의 픽셀 색상만 바꾸거나 랜덤한 색상으로 변경할 수 있는가? 답변: 예, 가능합니다. 질문: PixelRendererComponent에서 스프라이트의 가로 길이를 나타내는 프로퍼티의 이름과 타입은 무엇인가요? 답변: 이름은 Width이며, 타입은 int입니다. 질문: PixelRenderer [original] | # 학습 과정 소개 **PixelRendererComponent**를 활용하면 크리에이터가 비어있는 스프라이트에 픽셀 단위로 원하는 색을 지정할 수 있습니다. 특정 위치의 픽셀 색상만 바꾸거나 전체 스프라이트 색상을 지정할 수도 있고, 랜덤한 색상으로 변경할 수도 있습니다. 먼저 **PixelRendererComponent**의 프로퍼티를 살펴보고 예제를 통해 활용법을 알아봅시다. ##### 참고 API Reference [PixelRendererComponent](https://mod-developers.nexon.com/api [chunk_id] | Guides:693:0

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: Transact 접두사를 가진 함수를 사용하면 데이터 저장, 불러오기, 제거 작업을 어떤 방식으로 처리할 수 있나요? 답변: 데이터 저장, 불러오기, 제거 작업을 원자적으로 일괄 요청할 수 있습니다. 질문: Transact 함수 호출 시 포함된 작업 중 하나라도 실패하면 어떻게 처리되나요? 답변: 함수 호출은 실패하며, 한 번에 전달된 요청들이 모두 실패 처리되고 요청 이전의 데이터가 유지됩니다. 질문: Transact 함수를 통해 한 번에 조작할 수 있는 Key의 최대 개수는 몇 개인가요? 답변: 한 번에 Key를 최대 [original] | Transact 접두사인 함수를 활용해 데이터 저장하기, 불러오기, 제거하기를 원자적으로 일괄 요청할 수 있습니다. 만약 함수 호출에 포함된 모든 작업 중 하나라도 실패한다면, 함수 호출은 실패합니다. 한 번에 Key를 최대 20개까지 조작할 수 있습니다. 한 번에 전달된 요청들이 모두 성공하지 않으면 모두 실패 처리하고, 요청 이전의 데이터를 유지합니다. 그러므로 오류 처리 관련 코드를 간소화할 수 있습니다. 그러나 트랜잭션 보장을 위해 내부적으로 복잡한 처리 과정이 진행됩니다. credit 또한 Batch 함수에 비해 2배로 소 [chunk_id] | Guides:692:7

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 1. `_DataStorageService:GetGlobalDataStorage("globalDS")` 메서드를 호출하여 이름이 "globalDS"인 전역 데이터 스토리지 객체를 획득합니다. 2. `DataStorageKeyInfo()` 생성자를 호출하여 키 정보 객체를 생성하고, 해당 객체의 `Key` 속성과 `Version` 속성에 각각 문자열 값을 대입합니다. 3. `globalDataStorage:SetByInfoAndWait(keyInfo, "Value")` 메서드는 지정된 `keyInfo`와 값 "Value"를 서버에 저 [original] | ```lua local globalDataStorage = _DataStorageService:GetGlobalDataStorage("globalDS") keyInfo = DataStorageKeyInfo() keyInfo.Key = "Key" keyInfo.Version = "Version1" globalDataStorage:SetByInfoAndWait(keyInfo, "Value") -- 기존 버전의 "Value" 값을 덮어 쓰는 대신 새로운 버전을 만들어 저장합니다. keyInfo.Key = "Key" keyInfo. [chunk_id] | Guides:692:9

[task] | extract_knowledge [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage의 페이지네이션 및 일괄 요청 ## 1. 개념 설명 `DataStorage`에서 목록 데이터를 조회할 때, 전체 데이터를 한 번에 받지 않고 페이지 단위로 처리할 수 있도록 `Pages` 형태의 객체를 반환합니다. 이를 통해 대량의 데이터를 메모리 부담을 줄이며 순차적으로 처리할 수 있습니다. 또한, 여러 개의 데이터를 동시에 저장, 불러오기, 제거할 때는 개별 요청 대신 `Batch` 접두사가 붙은 함수를 사용해야 합니다. 일괄 요청은 네트워크 오버헤드를 줄여 성능을 향상시키지만, 요청된 작업 중 [original] | DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. ```lua local errorCode, globalDataStoragePages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local globalDataStorages = globalDataStoragePages:GetCurrentPageDatas() --GetCurrentPageDatas()로 현 [chunk_id] | Guides:692:6

[task] | extract_knowledge [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기: 데이터 가져오기 ## 1. 개념 설명 `DataStorage` 서비스는 데이터를 조회하기 위해 두 가지 주요 함수 접미사를 제공합니다. * **`GetAndWait`**: 동기(Synchronous) 방식으로 동작합니다. 데이터 조회 작업이 완료될 때까지 스크립트 실행을 중단(Block)합니다. * **`GetAsync`**: 비동기(Asynchronous) 방식으로 동작합니다. 함수 호출 시 즉시 반환되며, 데이터 조회 작업이 완료되면 전달된 `callbackFunction` [original] | 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 만약 데이터를 저장할 때 `_UtilLogic:TableToString()` 함수를 사용해 데이터를 문자열로 변환했다면, 데이터를 가져올 때는 `_UtilLogic:StringToTable()` 함수를 사용해 기존 타입으로 변환하여 사용할 수 있습니다. SortableDataStorage는 정수 타입의 값만 가져올 [chunk_id] | Guides:692:4

[task] | knowledge_list [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | 제시된 문서 원문에 포함된 정보만을 기반으로 핵심 사실을 정리한 목록입니다. * `HandleButtonClickEvent(ButtonClickEvent event)` 이벤트 핸들러는 `event.Entity` 매개변수를 통해 엔티티 정보를 추출하며, 버튼 클릭 시 `self.PR.PixelRendererTest:SetRandomPixel()` 메서드를 호출하도록 구현됩니다. * `SetPixel` 버튼(UI - DefaultGroup - SetPixel)의 Property에 `ButtonClick_SetPixel` 컴포넌 [original] | 11. **ButtonClick_SetPixel** 스크립트에 **ButtonClickEvent**도 추가합니다. ```lua Event Handler: HandleButtonClickEvent (ButtonClickEvent event) { -- Parameters local Entity = event.Entity -------------------------------------------------------- -- 버튼을 클릭하면 SetRa [chunk_id] | Guides:693:2

[task] | distill [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | ### 스프라이트 픽셀 색상 설정 (UI 연동) **1. 이벤트 핸들러 추가** `ButtonClick_SetPixel` 스크립트에 `ButtonClickEvent` 핸들러를 추가하여 클릭 시 특정 엔티티의 `SetRandomPixel` 메서드를 호출합니다. ```lua Event Handler: HandleButtonClickEvent (ButtonClickEvent event) { -- Parameters local Entity = event.Entity --------------------------- [original] | 11. **ButtonClick_SetPixel** 스크립트에 **ButtonClickEvent**도 추가합니다. ```lua Event Handler: HandleButtonClickEvent (ButtonClickEvent event) { -- Parameters local Entity = event.Entity -------------------------------------------------------- -- 버튼을 클릭하면 SetRa [chunk_id] | Guides:693:2

[task] | extract_knowledge [title] | 스프라이트 색상을 픽셀 단위로 설정하기 [category] | Guides [rephrased] | # 픽셀 단위로 스프라이트 색상 설정하기 ## 1. 개념 설명 `PixelRendererComponent`는 비어 있는 스프라이트(Sprite)에 픽셀 단위로 색상을 지정하는 기능을 제공하는 컴포넌트입니다. 이 컴포넌트를 사용하면 특정 위치의 픽셀 색상만 변경하거나, 전체 스프라이트의 색상을 일괄 지정하거나, 랜덤한 색상으로 변경하는 등 다양한 시각적 효과를 구현할 수 있습니다. ## 2. API 사용법 (프로퍼티) `PixelRendererComponent`는 아래 표와 같은 프로퍼티를 제공합니다. | 이름 | 타입 | 주요 [original] | # 학습 과정 소개 **PixelRendererComponent**를 활용하면 크리에이터가 비어있는 스프라이트에 픽셀 단위로 원하는 색을 지정할 수 있습니다. 특정 위치의 픽셀 색상만 바꾸거나 전체 스프라이트 색상을 지정할 수도 있고, 랜덤한 색상으로 변경할 수도 있습니다. 먼저 **PixelRendererComponent**의 프로퍼티를 살펴보고 예제를 통해 활용법을 알아봅시다. ##### 참고 API Reference [PixelRendererComponent](https://mod-developers.nexon.com/api [chunk_id] | Guides:693:0