[task] | knowledge_list [title] | InputService [category] | Services [rephrased] | 제공된 원문에는 `InputService`의 구체적인 API 명세(매개변수, 반환 타입, 동기화/서버·클라이언트 제약)가 포함되어 있지 않으며, 다음과 같은 항목들의 이름 목록과 참고 링크만 존재합니다. 따라서 원문에 있는 정보만 사용하여 추출할 수 있는 핵심 사실은 다음과 같습니다. 1. 문서의 위치는 `[Services] InputService`입니다. 2. 관련 컴포넌트 또는 타입으로 `BasicParticleComponent`가 언급되어 있습니다. 3. 관련 컴포넌트 또는 타입으로 `RigidbodyComponent`가 언 [original] | * BasicParticleComponent * RigidbodyComponent * StateComponent * TransformComponent * KeyboardKey * KeyDownEvent * KeyHoldEvent * KeyReleaseEvent * KeyUpEvent * ScreenTouchEvent * ScreenTouchReleaseEvent * UILogic * UtilLogic * Vector3 * EntityService * [InputService를 활용한 입력과 액션](/docs?postId=209) [chunk_id] | Services:306:5
[task] | extract_knowledge [title] | InputService [category] | Services [rephrased] | # InputService ## 개념 설명 `InputService`는 메이플스토리 월드(mLua) 환경에서 사용자 입력을 처리하는 서비스입니다. 이 서비스는 키보드 입력(KeyDown, KeyHold, KeyRelease, KeyUp) 및 화면 터치 입력(ScreenTouch, ScreenTouchRelease)에 대한 이벤트를 수신하고, 이를 스크립트 컴포넌트 내의 Event Handler로 전달하는 역할을 수행합니다. ## API 사용법 문서에서 명시된 `InputService`와 직접적으로 연관된 이벤트 객체 및 상수 [original] | * BasicParticleComponent * RigidbodyComponent * StateComponent * TransformComponent * KeyboardKey * KeyDownEvent * KeyHoldEvent * KeyReleaseEvent * KeyUpEvent * ScreenTouchEvent * ScreenTouchReleaseEvent * UILogic * UtilLogic * Vector3 * EntityService * [InputService를 활용한 입력과 액션](/docs?postId=209) [chunk_id] | Services:306:5
[task] | knowledge_list [title] | LocalizationService [category] | Services [rephrased] | LocalizationService는 텍스트 번역 관련 기능을 제공하는 서비스입니다. LocalizationService의 CurrentLocaleId 속성은 [ReadOnly] string 타입으로, 출시 월드에서는 '월드 언어' 메뉴, 메이커에서는 '테스트 플레이 언어' 옵션에서 설정된 클라이언트의 현재 언어 코드를 반환합니다. LocalizationService의 LocalTranslator 속성은 [ReadOnly] Translator 타입으로, CurrentLocaleId에 해당하는 Translator 객체를 반환합니다. [original] | 텍스트 번역 관련 기능을 제공합니다. # Properties - **string CurrentLocaleId [ReadOnly]** 클라이언트의 현재 언어 코드입니다. 출시 월드에서는 '월드 언어' 메뉴에서 선택한 언어이며, 메이커에서는 '테스트 플레이 언어' 옵션에서 설정한 언어입니다. - **Translator LocalTranslator [ReadOnly]** CurrentLocaleId에 해당하는 Translator 객체입니다. # Methods - **string GetText(string key) [Clie [chunk_id] | Services:307:0
[task] | distill [title] | Service [category] | Services [rephrased] | # Service 모든 서비스의 부모 클래스로, 이벤트 연결·발생 등 기본 기능을 제공합니다. ## Methods * **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** * **설명**: 이름이 `key`인 이벤트가 발생하면 `eventHandler`가 `event` 객체를 매개변수로 받아 통지받습니다. * **리턴**: 이벤트 핸들러 기반 객체 * **EventHandlerBase ConnectEvent(Type [original] | 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능들을 제공합니다. # Methods - **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다. - **EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)** 이벤 [chunk_id] | Services:308:0
[task] | extract_knowledge [title] | InputService [category] | Services [rephrased] | # InputService를 이용한 키 입력 기반 상태 및 물리 제어 ## 개념 설명 `InputService`는 클라이언트 공간에서 키보드 입력 이벤트를 수신하는 서비스입니다. 주요 이벤트 핸들러는 다음과 같습니다. * **KeyDownEvent**: 키가 처음 눌릴 때 1회 호출됩니다. * **KeyHoldEvent**: 키를 누르고 있는 동안 지속적으로 호출됩니다. * **KeyUpEvent**: 키를 놓는 순간 1회 호출됩니다. * **KeyReleaseEvent**: 키 입력이 완전히 해제되었음을 나타내는 [original] | Z키를 누른 시간만큼 플레이어의 크기가 커지고, 높게 점프하는 컴포넌트를 만드는 예제입니다. 만든 컴포넌트를 **DefaultPlayer**에 추가해야 정상 작동합니다. 먼저 Z키를 눌렀을 때 웅크린 자세로 바꾸기 위해 `KeyDownEvent`를 아래와 같이 작성합니다. 누른 시간을 계산하기 위해서 **KeyDownTime** 프로퍼티를 만들고 현재 시간을 기록합니다. ```lua Property: [None] number KeyDownTime = 0 Event Handler: [service: InputService [chunk_id] | Services:306:2
[task] | wikipedia [title] | Service [category] | Services [rephrased] | # Service **Service**는 메이플스토리 월드(mLua) 환경에서 모든 서비스의 부모 클래스로, 서비스들이 기본적으로 갖춰야 할 공통 기능들을 제공합니다. 이 클래스는 이벤트의 연결과 해제, 그리고 발생을 관리하는 메서드들을 정의하고 있습니다. ## 메서드 (Methods) **Service** 클래스는 다음과 같은 메서드들을 제공합니다. **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이 메서드는 이벤트를 연결합니다. 이 서 [original] | 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능들을 제공합니다. # Methods - **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다. - **EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)** 이벤 [chunk_id] | Services:308:0
[task] | knowledge_list [title] | LocalizationService [category] | Services [rephrased] | * `_LocalizationService:GetText(key)`는 현재 언어 설정에 해당하는 컬럼의 텍스트를 조회하여 반환하며, 매개변수 `key`는 문자열 타입입니다. * `_LocalizationService:GetTranslatorForLocale(locale)`는 지정된 로케일(예: "en")을 사용하는 Translator 객체를 반환하며, 매개변수 `locale`은 문자열 타입입니다. * `_LocalizationService.LocalTranslator`는 현재 언어 설정에 해당하는 컬럼을 조회하는 Tran [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] | Service [category] | Services [rephrased] | - `Service`는 모든 서비스의 부모 서비스로, 서비스의 기본 기능을 제공합니다. - `ConnectEvent(string key, IScriptFunction eventHandler)` 메서드는 매개변수 `key`(string)와 `eventHandler`(IScriptFunction)를 받아, 해당 서비스에서 이름이 `key`인 이벤트가 발생하면 `eventHandler`에 `event` 매개변수를 전달하여 통지하며, 반환 타입은 `EventHandlerBase`입니다. - `ConnectEvent(Type eventTyp [original] | 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능들을 제공합니다. # Methods - **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다. - **EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)** 이벤 [chunk_id] | Services:308:0
[task] | diverse_qa [title] | Service [category] | Services [rephrased] | 질문: [Services] Service 컴포넌트의 상위 계층은 무엇이며, 어떤 역할을 합니까? 답변: 모든 서비스의 부모 서비스이며, 서비스의 기본 기능들을 제공합니다. 질문: `ConnectEvent` 메서드를 사용하여 이벤트를 연결할 때 핸들러는 어떤 매개 변수를 전달받습니까? 답변: 핸들러는 event 매개 변수를 전달받습니다. 질문: `ConnectEvent(string key, IScriptFunction eventHandler)` 메서드에서 `key` 매개 변수는 어떤 의미를 가집니까? 답변: 이 서비스에서 발생 가 [original] | 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능들을 제공합니다. # Methods - **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다. - **EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)** 이벤 [chunk_id] | Services:308:0
[task] | diverse_qa [title] | InputService [category] | Services [rephrased] | 질문: 문서에 제시된 터치 입력 예제에서 터치한 위치에 파티클을 표시하기 위해 사용하는 이벤트 핸들러는 무엇인가요? 답변: `HandleScreenTouchEvent`와 `HandleScreenTouchReleaseEvent`입니다. 질문: `HandleScreenTouchEvent` 이벤트 핸들러에서 터치 포인트의 화면 좌표를 월드 좌표로 변환하기 위해 어떤 메서드를 호출하나요? 답변: `_UILogic:ScreenToWorldPosition(TouchPoint)` 메서드를 호출한 후 `:ToVector3()`을 사용하여 변환합 [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] | extract_knowledge [title] | Service [category] | Services [rephrased] | # Service ## 개념 설명 `Service`는 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능을 제공하며, 이벤트 연결, 해제, 발생 기능을 포함합니다. ## API 사용법 ### 이벤트 연결 `ConnectEvent` 메서드는 특정 이벤트가 발생했을 때 지정된 핸들러에게 통지하도록 연결합니다. - **문자열 기반**: `ConnectEvent(string key, IScriptFunction eventHandler)` - `key`: 이벤트의 이름. - `eventHandler`: 이벤트 발생 시 호출되는 [original] | 모든 서비스의 부모 서비스입니다. 서비스의 기본 기능들을 제공합니다. # Methods - **EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)** 이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다. - **EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)** 이벤 [chunk_id] | Services:308:0
[task] | wikipedia [title] | LocalizationService [category] | Services [rephrased] | # LocalizationService **LocalizationService**는 메이플스토리 월드(mLua) 스크립트에서 텍스트 번역 및 다국어 처리와 관련된 기능을 제공하는 서비스입니다. 이 서비스는 클라이언트에서만 접근할 수 있는 메서드들을 통해 번역된 텍스트를 조회하고, 형식화된 문자열을 생성하는 역할을 수행합니다. ## 속성 (Properties) LocalizationService에는 다음과 같은 읽기 전용(ReadOnly) 속성이 정의되어 있습니다. * **CurrentLocaleId** (`string`, [original] | 텍스트 번역 관련 기능을 제공합니다. # Properties - **string CurrentLocaleId [ReadOnly]** 클라이언트의 현재 언어 코드입니다. 출시 월드에서는 '월드 언어' 메뉴에서 선택한 언어이며, 메이커에서는 '테스트 플레이 언어' 옵션에서 설정한 언어입니다. - **Translator LocalTranslator [ReadOnly]** CurrentLocaleId에 해당하는 Translator 객체입니다. # Methods - **string GetText(string key) [Clie [chunk_id] | Services:307:0
[task] | wikipedia [title] | InputService [category] | Services [rephrased] | # InputService **InputService**는 mLua 스크립트 언어에서 사용 가능한 서비스 중 하나로, 사용자의 입력(터치, 마우스 등)을 처리하고 커서 상태를 제어하는 기능을 제공합니다. 이 서비스는 주로 클라이언트 공간에서 이벤트 수신 및 커서 설정 메서드를 통해 동작하며, 서버 공간에서는 `_EntityService` 등을 활용하여 입력에 반응하는 객체의 상태를 변경하는 방식으로 구현됩니다. ## 터치 입력 처리 터치 입력은 `InputService`가 보내는 이벤트를 수신하여 처리합니다. 주요 이벤트 핸들 [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] | diverse_qa [title] | LocalizationService [category] | Services [rephrased] | 질문: LocalizationService의 주요 역할은 무엇인가요? 답변: LocalizationService는 텍스트 번역 관련 기능을 제공합니다. 질문: CurrentLocaleId 속성은 어떤 값을 가지며 읽기 전용(ReadOnly)이 맞는가요? 답변: 네, CurrentLocaleId는 클라이언트의 현재 언어 코드를 가지는 읽기 전용(string) 속성입니다. 질문: 출시 월드(Released World)에서 CurrentLocaleId 값은 어디서 결정되나요? 답변: 출시 월드에서는 '월드 언어' 메뉴에서 사용자가 선 [original] | 텍스트 번역 관련 기능을 제공합니다. # Properties - **string CurrentLocaleId [ReadOnly]** 클라이언트의 현재 언어 코드입니다. 출시 월드에서는 '월드 언어' 메뉴에서 선택한 언어이며, 메이커에서는 '테스트 플레이 언어' 옵션에서 설정한 언어입니다. - **Translator LocalTranslator [ReadOnly]** CurrentLocaleId에 해당하는 Translator 객체입니다. # Methods - **string GetText(string key) [Clie [chunk_id] | Services:307:0
[task] | extract_knowledge [title] | LocalizationService [category] | Services [rephrased] | # LocalizationService `LocalizationService`는 클라이언트에서 텍스트 번역 기능을 제공하기 위한 서비스입니다. 이 서비스를 통해 현재 클라이언트 언어에 맞는 텍스트를 조회하거나, 포맷팅된 문자열을 생성할 수 있습니다. ## 1. 개념 설명 `LocalizationService`는 클라이언트 환경에서만 동작하며, 번역된 텍스트를 가져오는 역할을 담당합니다. * **현재 로케일 정보**: `CurrentLocaleId` 프로퍼티를 통해 현재 클라이언트가 사용하는 언어 코드를 알 수 있습니다. [original] | 텍스트 번역 관련 기능을 제공합니다. # Properties - **string CurrentLocaleId [ReadOnly]** 클라이언트의 현재 언어 코드입니다. 출시 월드에서는 '월드 언어' 메뉴에서 선택한 언어이며, 메이커에서는 '테스트 플레이 언어' 옵션에서 설정한 언어입니다. - **Translator LocalTranslator [ReadOnly]** CurrentLocaleId에 해당하는 Translator 객체입니다. # Methods - **string GetText(string key) [Clie [chunk_id] | Services:307:0
[task] | distill [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService 다양한 DataStorage 접근 기능을 제공합니다. 모든 메서드는 `[ServerOnly]`입니다. ## Methods ### CreatorDataStorage - `int32 DeleteCreatorDataStorageAndWait() [Yield]` CreatorDataStorage를 삭제하고 에러 코드를 반환합니다. 수행 중 스크립트 실행 중단. - `int32 DeleteCreatorDataStorageAndWait(string name) [Yield]` 특정 이름의 Cr [original] | 다양한 DataStorage 접근 기능을 제공합니다. # Methods - **int32 DeleteCreatorDataStorageAndWait() [ServerOnly] [Yield]** CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **int32 DeleteCreatorDataStorageAndWait(string name) [ServerOnly] [Yield]** 특정 이름의 CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다 [chunk_id] | Services:309:0
[task] | distill [title] | DataStorageService [category] | Services [rephrased] | # [Services] DataStorageService 모든 메서드는 `[ServerOnly]` 공간에서 실행됩니다. ## DataStorage 접근 * **`GetCreatorDataStorage()` / `GetCreatorDataStorage(string name)`**: `CreatorDataStorage` 객체를 반환합니다. * **`GetGlobalDataStorage(string name)`**: `GlobalDataStorage` 객체를 반환합니다. * **`GetUserDataStorage(strin [original] | tAsync() 함수를 사용하세요. - **CreatorDataStorage GetCreatorDataStorage() [ServerOnly]** CreatorDataStorage를 얻어옵니다. - **CreatorDataStorage GetCreatorDataStorage(string name) [ServerOnly]** 특정 이름의 CreatorDataStorage를 얻어옵니다. - **int32, CreatorDataStoragePages GetCreatorDataStoragePagesAndWait() [ServerOn [chunk_id] | Services:309:1
[task] | distill [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService `DataStorageService`는 `UserDataStorage` 데이터의 페이지 단위 비동기 조회를 지원합니다. ## 메서드 ### `taStoragePagesAsync` ```lua void taStoragePagesAsync(func<int32, UserDataStoragePages> callbackFunction) [ServerOnly] ``` `UserDataStorage`를 페이지 단위로 비동기 조회합니다. 완료 시 `callbackFunction`에 에러 코드와 조회용 객 [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] | LocalizationService [category] | Services [rephrased] | **[Services] LocalizationService** `LocaleDataSet`에서 텍스트를 조회하고 포맷팅하는 서비스입니다. ### 주요 API 1. **`_LocalizationService:GetText(key)`** * 현재 언어 설정에 해당하는 컬럼의 일반 텍스트를 반환합니다. 2. **`_LocalizationService.LocalTranslator`** * 현재 언어 설정에 해당하는 `Translator` 객체를 반환합니다. 3. **`_LocalizationService:G [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] | diverse_qa [title] | DataStorageService [category] | Services [rephrased] | 질문: DataStorageService는 어떤 기능을 제공하는 서비스인가요? 답변: DataStorageService는 다양한 DataStorage 접근 기능을 제공하는 서비스입니다. 질문: `DeleteCreatorDataStorageAndWait()` 메서드는 어떤 실행 공간에서 사용되며, 어떤 특징이 있나요? 답변: 이 메서드는 [ServerOnly] 실행 공간에서 사용되며, [Yield] 특성을 가지고 있어 수행하는 동안 스크립트 실행을 중단합니다. 질문: `DeleteCreatorDataStorageAndWait()` [original] | 다양한 DataStorage 접근 기능을 제공합니다. # Methods - **int32 DeleteCreatorDataStorageAndWait() [ServerOnly] [Yield]** CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **int32 DeleteCreatorDataStorageAndWait(string name) [ServerOnly] [Yield]** 특정 이름의 CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다 [chunk_id] | Services:309:0
[task] | distill [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService 예제 ## GetGlobalDataStorage `GlobalDataStorage` 인스턴스를 가져옵니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` ## GetGlobalDataStoragePagesAsync 페이지네이션 방식으로 모든 `GlobalDataStorage`를 조회하여 삭제합니다. ```lua _DataStorageService:GetGlobalDataSt [original] | # Examples #### GetGlobalDataStorage DataStorageService를 활용해서 GlobalDataStorage를 가져오는 예제입니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` #### GetGlobalDataStoragePagesAsync DataStorageService를 활용해서 모든 GlobalDataStorage를 제거하는 예제입니다. ```lua _DataSto [chunk_id] | Services:309:3
[task] | wikipedia [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService `DataStorageService`는 다양한 DataStorage 접근 기능을 제공하는 서비스입니다. 이 서비스는 CreatorDataStorage, GlobalDataStorage, SortableDataStorage, UserDataStorage의 삭제 기능을 제공하며, 동기 방식(AndWait)과 비동기 방식(Async)으로 나뉩니다. 모든 메서드는 `[ServerOnly]` 속성을 가지며 서버 측에서만 실행됩니다. ## 메서드 ### CreatorDataStorage 관련 **` [original] | 다양한 DataStorage 접근 기능을 제공합니다. # Methods - **int32 DeleteCreatorDataStorageAndWait() [ServerOnly] [Yield]** CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **int32 DeleteCreatorDataStorageAndWait(string name) [ServerOnly] [Yield]** 특정 이름의 CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다 [chunk_id] | Services:309:0
[task] | wikipedia [title] | LocalizationService [category] | Services [rephrased] | # LocalizationService `LocalizationService`는 `LocaleDataSet`에 저장된 텍스트를 조회하고, 지정된 포맷 규칙에 따라 변환하는 기능을 제공하는 서비스입니다. 이 서비스는 현재 언어 설정에 맞는 컬럼의 텍스트를 가져오거나, 특정 로케일을 지정하여 번역된 텍스트를 조회할 수 있는 `Translator` 객체를 반환합니다. 또한, 한국어의 용언(하꼬표기, HPP)이나 영어의 복수(Plural) 규칙과 같은 언어별 특수 포맷을 처리하기 위한 `SmartFormat` 기능을 지원합니다. ## [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] | wikipedia [title] | DataStorageService [category] | Services [rephrased] | **DataStorageService** `DataStorageService`는 스크립트에서 사용자 데이터 저장을 관리하기 위한 서비스입니다. 주로 비동기 방식으로 사용자 데이터 페이지를 조회하거나, 데이터 저장 및 수정 작업을 수행합니다. 이 서비스는 서버에서만 사용할 수 있으며, 일부 함수는 비동기 작업의 완료를 기다리는 기동(Yield) 특성을 가집니다. ### 사용자 데이터 페이지 조회 `GetDataStoragePagesAsync` 함수는 `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] | diverse_qa [title] | LocalizationService [category] | Services [rephrased] | 질문: `LocalizationService`는 어떤 주요 기능을 수행하나요? 답변: `LocaleDataSet`에서 텍스트를 조회하고, 지정된 포맷에 맞게 변환하는 기능을 수행합니다. 질문: `TEXT_TEST1` 키에 대한 한국어(ko) 컬럼의 값은 무엇인가요? 답변: 안녕 질문: `TEXT_TEST2` 키는 어떤 종류의 포맷 예제에 해당하나요? 답변: 간단한 포맷 예제 질문: `TEXT_TEST3` 키의 한국어(ko) 컬럼 값에서 `{0:hpp:아|야}`는 어떤 용도로 사용되나요? 답변: 스마트 포맷 예제(한국어)를 위해 [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] | diverse_qa [title] | DataStorageService [category] | Services [rephrased] | 질문: DataStorageService에서 비동기 처리를 권장하는 함수 패턴은 무엇인가요? 답변: DataStorageService에서는 Async() 접미사가 붙은 함수, 예컨대 `GetCreatorDataStoragePagesAsync` 같은 함수를 사용하도록 권장합니다. 질문: `GetCreatorDataStorage()` 함수는 어떤 실행 공간에서만 사용 가능한가요? 답변: `GetCreatorDataStorage()` 함수는 `[ServerOnly]` 태그가 붙어 있어 서버 공간에서만 사용 가능합니다. 질문: `Get [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] | 제공된 문서에 포함된 정보만을 기반으로 핵심 사실을 정리한 목록입니다. 1. `_DataStorageService:GetGlobalDataStorage("sampleStorage")` 메서드는 매개변수로 저장소 이름 문자열을 받아 `GlobalDataStorage` 객체를 반환하며, 이를 통해 특정 글로벌 데이터 저장소를 가져올 수 있습니다. 2. `_DataStorageService:GetGlobalDataStoragePagesAsync(function(errorCode, pages) ... end)` 메서드는 비동기적으로 모든 [original] | # Examples #### GetGlobalDataStorage DataStorageService를 활용해서 GlobalDataStorage를 가져오는 예제입니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` #### GetGlobalDataStoragePagesAsync DataStorageService를 활용해서 모든 GlobalDataStorage를 제거하는 예제입니다. ```lua _DataSto [chunk_id] | Services:309:3
[task] | knowledge_list [title] | DataStorageService [category] | Services [rephrased] | 주어진 문서에 명시된 `DataStorageService`의 메서드 정보만을 바탕으로 핵심 사실을 정리합니다. 1. `DeleteCreatorDataStorageAndWait()` 메서드는 매개변수를 받지 않으며, `CreatorDataStorage`를 삭제한 후 에러 코드를 `int32` 타입으로 반환하고, 수행 중 스크립트 실행을 중단하는 [ServerOnly] [Yield] 제약이 있습니다. 2. `DeleteCreatorDataStorageAndWait(string name)` 메서드는 매개변수로 `name`(string) [original] | 다양한 DataStorage 접근 기능을 제공합니다. # Methods - **int32 DeleteCreatorDataStorageAndWait() [ServerOnly] [Yield]** CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다. 수행하는 동안 스크립트 실행을 중단합니다. - **int32 DeleteCreatorDataStorageAndWait(string name) [ServerOnly] [Yield]** 특정 이름의 CreatorDataStorage를 삭제하고, 에러 코드를 반환합니다 [chunk_id] | Services:309:0
[task] | diverse_qa [title] | DataStorageService [category] | Services [rephrased] | 질문: `_DataStorageService:GetGlobalDataStorage` 메서드를 사용하여 "sampleStorage"라는 이름의 GlobalDataStorage를 가져오는 코드는 어떻게 작성하나요? 답변: `local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage")` 라고 작성합니다. 질문: `GetGlobalDataStoragePagesAsync` 예제 코드에서 `errorCode` 값이 0과 같지 않을 때 스크립트는 어떻게 처리하나 [original] | # Examples #### GetGlobalDataStorage DataStorageService를 활용해서 GlobalDataStorage를 가져오는 예제입니다. ```lua local sampleStorage = _DataStorageService:GetGlobalDataStorage("sampleStorage") ``` #### GetGlobalDataStoragePagesAsync DataStorageService를 활용해서 모든 GlobalDataStorage를 제거하는 예제입니다. ```lua _DataSto [chunk_id] | Services:309:3
[task] | wikipedia [title] | DataStorageService [category] | Services [rephrased] | # DataStorageService `DataStorageService`는 메이플스토리 월드(MapleStory Worlds)에서 서버 측 데이터 저장을 관리하는 서비스입니다. 이 서비스는 데이터의 범위에 따라 `CreatorDataStorage`, `GlobalDataStorage`, `SortableDataStorage`, `UserDataStorage` 네 가지 유형을 제공하며, 각 유형별로 단일 객체 접근과 페이지 단위 조회를 위한 메서드를 지원합니다. 모든 메서드는 서버에서만 실행되며(`[ServerOnly]`), 페이 [original] | tAsync() 함수를 사용하세요. - **CreatorDataStorage GetCreatorDataStorage() [ServerOnly]** CreatorDataStorage를 얻어옵니다. - **CreatorDataStorage GetCreatorDataStorage(string name) [ServerOnly]** 특정 이름의 CreatorDataStorage를 얻어옵니다. - **int32, CreatorDataStoragePages GetCreatorDataStoragePagesAndWait() [ServerOn [chunk_id] | Services:309:1