[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | LoadItems 함수에서 _DataStorageService:GetUserDataStorage 호출 후 nil 체크를 한 이유는 무엇인가요? [answer] | `LoadItems` 함수에서 `_DataStorageService:GetUserDataStorage` 호출 후 `nil` 체크를 하는 이유는, 해당 호출이 실패하거나 유저의 데이터 저장소가 존재하지 않는 경우를 방어하기 위해서입니다. 참고 문서의 `LoadItems` 코드를 보면 다음과 같습니다: ```lua [server only] boolean LoadItems() { local userDataStorage = _DataStorageService:GetUserDataStorage(self.Entity.PlayerCo [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | if _UtilLogic:IsNilorEmptyString(currencyString) == false then local currency = _HttpService:JSONDecode(currencyString) if currency.meso ~= nil then self.meso = currency.meso end if currency.cash ~= nil then self.cash = currency.cash
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | JSONDecode로 파싱한 테이블에서 currency.meso ~= nil 조건을 먼저 검사하는 것이 왜 중요한가요? [answer] | JSONDecode로 파싱한 테이블에서 `currency.meso ~= nil` 조건을 먼저 검사하는 이유는 저장된 데이터의 구조가 기대했던 것과 다를 수 있기 때문입니다. `DataStorage`에 저장된 문자열을 `_HttpService:JSONDecode`로 변환할 때, 해당 JSON 문자열에 `meso` 필드가 존재하지 않거나 값이 `null`인 경우, 파싱된 테이블의 `currency.meso`는 `nil`이 됩니다. 만약 이 조건을 생략하고 `self.meso = currency.meso`를 바로 실행하게 되면, `se [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | if _UtilLogic:IsNilorEmptyString(currencyString) == false then local currency = _HttpService:JSONDecode(currencyString) if currency.meso ~= nil then self.meso = currency.meso end if currency.cash ~= nil then self.cash = currency.cash
[task] | code [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 사용자가 서버에서 RequestBuyItemFromClient 메서드를 호출할 때 UserDataComponent.initialized 프로퍼티가 false인 경우 로그를 출력하고 처리를 중단하는 로직을 구현하는 스크립트를 작성해줘 [answer] | 사용자가 서버에서 `RequestBuyItemFromClient` 메서드를 호출할 때 `UserDataComponent.initialized` 프로퍼티의 상태를 확인하여 `false`인 경우 로그를 출력하고 함수 실행을 중단하는 로직은 다음과 같이 구현할 수 있습니다. ```lua Method: [server] void RequestBuyItemFromClient(string userId, integer buyItemId) { local userEntity = _UserService:GetUserEntityByUserId( [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | for i, id in pairs(event.items) do table.insert(self.items, id) end } ``` Initialized 프로퍼티에 따라 상점 구매 로직 진행 여부를 결정하는 Logic 스크립트 예제입니다. ```lua Method: [server] void RequestBuyItemFromClient(string userId, integer buyItemId) { local userEntity = _UserService:GetUserEntityByUserId(u
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | JSON 문자열로 저장할 때 `_HttpService:JSONEncode()`와 `_HttpService:JSONDecode()` 함수명을 정확히 포함하여 2문장 이내로 설명하세요. [answer] | `_HttpService:JSONEncode()`는 Table을 JSON 문자열로 변환하여 저장할 때 사용하고, `_HttpService:JSONDecode()`는 저장된 JSON 문자열을 다시 Table로 변환하여 불러올 때 사용합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # DataStorage 사용량 제한과 문자열 DataStorage는 사용량 제한이 있습니다. 제한으로 인해 Credit을 사용하는 DataStorage 류의 함수들을 너무 자주 호출하면 문제가 발생할 수 있습니다. 사용량 제한의 자세한 내용은 [DataStorage 사용량 제한 알아보기](/docs/?postId=1044), [DataStorage 사용량 제한 활용하기](/docs/?postId=1045)를 참고하세요. #### 하나의 String으로 저장 Key를 사용하면 Credit을 사용합니다. 아래 예시처럼 많은 Ke
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | userDataStorage:GetAndWait 호출 후 반환되는 errorCode가 0이 아닐 경우, 이는 데이터가 없는 것인지 요청 실패인 것인지 어떻게 구분해서 처리해야 하나요? [answer] | `userDataStorage:GetAndWait` 호출 후 반환되는 `errorCode` 값이 0이 아닐 경우, **데이터가 없는 것(빈 값)인지 요청 자체의 실패(에러)인지 구분하는 방법은 제공된 문서에 명시되어 있지 않습니다.** 문서에서 확인할 수 있는 정보는 다음과 같습니다: 1. **성공 조건**: `errorCode`가 **0**일 때 데이터가 정상적으로 불러와진 것으로 간주합니다. 2. **실패 예시**: `errorCode`가 **1000005**인 경우 `ResourceExhausted`(호출 횟수 한도 초 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | two_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 유저가 서버에서 나갈 때 데이터를 저장하는 `HandleUserLeaveEvent` 이벤트 핸들러의 정확한 구현 방식은 무엇인가요? [answer] | `HandleUserLeaveEvent` 이벤트 핸들러는 유저가 서버에서 나갈 때 데이터를 저장하기 위해 `UserService` 서비스의 이벤트로 처리합니다. 구현 시에는 이벤트 핸들러 블록의 헤더에 `[server only] [service UserService]` 또는 `[server only] [service: UserService]` 태그를 명시해야 하며, 이벤트 객체 인자로 `UserLeaveEvent` 타입을 사용합니다. 핸들러 본문에서는 `self:SaveData()`와 같이 자기 자신의 데이터 저장 메서드를 호출하 [followup] | `[server only] [service UserService]` 태그를 가진 `HandleUserLeaveEvent` 핸들러에서 `self:SaveData()`를 호출하는 코드 블록을 작성해 주세요. [followup_answer] | 요청하신 `[server only] [service UserService]` 태그를 가진 `HandleUserLeaveEvent` 핸들러와 `self:SaveData()` 호출 코드는 다음과 같습니다. ```lua Event Handler: [server only] [service UserService] HandleUserLeaveEvent(UserLeaveEvent event) { self:SaveData() } ``` [scores] | [judge_reason] | [source_doc] | for i, id in pairs(event.items) do table.insert(self.items, id) end } ``` Initialized 프로퍼티에 따라 상점 구매 로직 진행 여부를 결정하는 Logic 스크립트 예제입니다. ```lua Method: [server] void RequestBuyItemFromClient(string userId, integer buyItemId) { local userEntity = _UserService:GetUserEntityByUserId(u
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | 비트 할당 연산자 `&=` 와 `|=` 를 사용하여 카드의 키워드를 제거하고 추가하는 과정에 대해 설명해 주세요. [answer] | `&=`(비트 AND 할당)와 `|=`(비트 OR 할당) 연산자는 카드에 부여된 여러 키워드를 하나의 숫자(비트 플래그)로 관리할 때 특정 키워드를 제거하거나 추가하는 데 사용됩니다. ### 1. 원리 - **`|=` (추가)**: 두 값의 비트 중 하나라도 1이면 1이 됩니다. 따라서 기존 값에 새로운 키워드 비트를 OR 연산하면 해당 키워드가 추가됩니다. - **`&=` (제거)**: 두 값의 비트가 모두 1이어야 1이 됩니다. 특정 키워드를 제거하려면, 그 키워드 비트만 0이고 나머지는 1인 마스크(보수)를 만들어 AND 연 [followup] | `newCard` 변수에 Taunt와 BattleCry가 있는 상태에서, Taunt를 `&=` 와 `~` (NOT)을 이용해 제거하고 Immune을 `|=` 로 추가하는 전체 코드 흐름과 각 단계의 출력값을 작성해 주세요. [followup_answer] | `newCard` 변수에 Taunt와 BattleCry 키워드가 있는 상태에서 Taunt를 제거하고 Immune을 추가하는 전체 코드 흐름과 각 단계의 상태는 다음과 같습니다. ```lua local cardKeywords = { Taunt = 1 << 0, -- 1 (이진수 00001) BattleCry = 1 << 1, -- 2 (이진수 00010) Deathrattle = 1 << 2,-- 4 (이진수 00100) Windfury = 1 << 3, -- 8 (이진수 01000) [scores] | [judge_reason] | [source_doc] | 비트 AND 연산자(Bitwise AND operator) `&`는 두 개의 값을 비교하여 같은 위치의 비트가 모두 1이면 결과로 1을 반환하고, 그렇지 않으면 0을 반환합니다. 반면, 비트 OR 연산자(Bitwise OR operator) `|`는 두 개의 값을 비교하여 같은 위치의 비트 중 하나라도 1이면 결과로 1을 반환하고, 그렇지 않으면 0을 반환합니다. 예를 들어 봅시다. ```lua local a = 10 -- 이진수 1010 local b = 7 -- 이진수 0111 local result = a & b -- 비트
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | SaveData 함수에서 initialized 플래그가 false인 경우 저장을 중단하는 로직의 의도는 무엇인가요? [answer] | `SaveData` 함수에서 `self.initialized` 플래그가 `false`인 경우 저장을 중단하는 로직의 의도는 **데이터 무결성을 유지하고, 잘못된 상태의 데이터가 저장되어 기존 데이터를 덮어쓰거나 오염되는 것을 방지하기 위함**입니다. 구체적인 이유와 동작 방식은 다음과 같습니다. 1. **초기화 실패 시 안전장치**: * `OnBeginPlay` 등에서 데이터를 로드(Load)하는 과정에서 오류가 발생하거나, `ResourceExhausted`(호출 한도 초과) 등의 이유로 초기화가 완료되지 않은 상 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | if _UtilLogic:IsNilorEmptyString(currencyString) == false then local currency = _HttpService:JSONDecode(currencyString) if currency.meso ~= nil then self.meso = currency.meso end if currency.cash ~= nil then self.cash = currency.cash
[task] | code [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorageService 에서 "Settings" 데이터를 불러온 후, 문자열이 비어있거나 nil 이면 기본값인 "Default" 로 초기화하여 DataStorage 에 다시 저장하는 OnBeginPlay 서버 스크립트를 작성해줘 [answer] | DataStorage에서 "Settings" 데이터를 불러온 후, 값이 `nil`이거나 빈 문자열인지 `_UtilLogic:IsNilorEmptyString` 함수로 확인합니다. 이 조건에 해당하면 기본값인 `"Default"`를 설정하고, `_DataStorageService`의 `SetAndWait` 메서드를 통해 다시 저장합니다. ```lua Property: [Sync] string Settings = "" Method: [server only] void OnBeginPlay() { local userDataSto [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 단계별 번호 목록으로 [answer] | 참고 문서에 제공된 '유저 추방하기' 및 '재시도하기' 예제를 바탕으로, DataStorage에서 데이터를 불러오는 단계별 처리 방법을 정리했습니다. **단계별 번호 목록** 1. **유저 데이터 저장소 객체 획득** * `_DataStorageService:GetAndWait(self.Entity.PlayerComponent.UserId)`를 호출하여 해당 유저의 `userDataStorage` 객체를 가져옵니다. * 객체가 `nil`인 경우 데이터 불러오기 실패로 간주합니다. 2. **데이터 요청 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | code [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorageService 에서 유저의 "Score" 데이터를 불러오고, 에러 코드가 0 이 아닌 경우 재시도 로직을 적용하여 3번 실패 시 UserService 의 KickUser 메서드로 유저를 추방하는 서버 전용 스크립트를 작성해줘 [answer] | 요청하신 DataStorageService 를 이용한 "Score" 데이터 로딩과 재시도 로직, 그리고 실패 시 유저 추방 기능이 포함된 서버 전용 스크립트입니다. ```lua Property: [None] integer score = 0 [None] boolean dataLoaded = false Method: [server only] void OnBeginPlay() { local maxRetries = 3 local retryCount = 0 while retryCount < maxRetries do [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 유저가 월드를 나가는 HandleUserLeaveEvent 이벤트에서 SaveMesoData를 호출할 때, 왜 GetUserDataStorage가 nil일 수 있으며 이 경우 어떻게 처리해야 하나요? [answer] | `HandleUserLeaveEvent`에서 `SaveMesoData`를 호출할 때 `GetUserDataStorage`가 `nil`이 될 수 있는 이유는, 해당 유저의 데이터 저장소 객체가 아직 생성되지 않았거나, 월드 종료 과정 등에서 유효하지 않게 되었기 때문입니다. 문서의 예제 코드처럼, 저장 로직의 첫 단계에서 반드시 `nil` 여부를 확인해야 합니다. 이 경우 `nil` 체크 후 바로 함수를 종료(`return`)하여后续的 저장 처리가 실행되지 않도록 해야 합니다. 이렇게 하지 않으면 `nil` 객체에 대한 메서드 호출 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드에 필수적인 데이터가 아닌 경우 데이터를 불러오는 데 실패했다면 데이터를 저장하지 않는 방식도 고려할 수 있습니다. 아래의 예제는 Component에서 요청 성공 여부를 Property에 저장하고, Logic을 이용해 데이터를 저장하지 않도록 구현합니다. ```lua Property: [Sync] boolean initialized = false -- 이 프로퍼티를 사용해 저장 막기. [Sync] integer meso = 0 Method: [server only] void OnBeginPlay() { if
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `_UtilLogic:TableToString()`이 Table이 포함된 Table 변환 시 발생하는 문제점을 표로 정리해서 나타내세요. [answer] | 참고 문서에 따르면, `_UtilLogic:TableToString()`을 사용할 때 Table이 Table을 포함하는 경우(중첩 Table)에 발생하는 문제는 다음과 같습니다. | 구분 | 내용 | | :--- | :--- | | **발생 조건** | 변환하려는 Table에 다른 Table이 Value로 포함된 경우 | | **문제점** | 정상적으로 변환되지 않음 | | **구체적 증상** | 내부 Table 값이 실제 데이터가 아닌 참조 정보(예: `table :868`)로 출력됨 | | **추가 부작용** | Key와 Va [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # DataStorage 사용량 제한과 문자열 DataStorage는 사용량 제한이 있습니다. 제한으로 인해 Credit을 사용하는 DataStorage 류의 함수들을 너무 자주 호출하면 문제가 발생할 수 있습니다. 사용량 제한의 자세한 내용은 [DataStorage 사용량 제한 알아보기](/docs/?postId=1044), [DataStorage 사용량 제한 활용하기](/docs/?postId=1045)를 참고하세요. #### 하나의 String으로 저장 Key를 사용하면 Credit을 사용합니다. 아래 예시처럼 많은 Ke
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 문서 예시와 동일한 `testTable`을 `_HttpService:JSONEncode()`로 변환한 결과 문자열만 출력하고, 각 필드 설명은 코드 주석으로 작성하세요. [answer] | ```lua Method: [server only] void PrintJsonExample() { local testTable = {} testTable.meso = 10 -- 메소 보유량 testTable.money = 200 -- 머니 보유량 testTable.innerTable = {} testTable.innerTable.val = "string value" -- 내부 테이블의 문자열 값 log(_HttpService:JSONEncode(testTable)) } `` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # DataStorage 사용량 제한과 문자열 DataStorage는 사용량 제한이 있습니다. 제한으로 인해 Credit을 사용하는 DataStorage 류의 함수들을 너무 자주 호출하면 문제가 발생할 수 있습니다. 사용량 제한의 자세한 내용은 [DataStorage 사용량 제한 알아보기](/docs/?postId=1044), [DataStorage 사용량 제한 활용하기](/docs/?postId=1045)를 참고하세요. #### 하나의 String으로 저장 Key를 사용하면 Credit을 사용합니다. 아래 예시처럼 많은 Ke
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage에서 데이터를 불러올 때 TimedOut이나 ResourceExhausted 같은 에러 코드가 발생하면 어떻게 처리해야 유저 데이터가 사라지는 것을 방지할 수 있나요? [answer] | DataStorage에서 데이터를 불러올 때 `TimedOut`이나 `ResourceExhausted` 같은 에러 코드가 발생하면, 단순히 데이터를 저장하지 않고 **에러 코드에 따라 분기 처리**하는 것이 유저 데이터 유실을 방지하는 핵심입니다. 주요 처리 방법은 다음과 같습니다. 1. **에러 코드 확인 및 분기 처리**: * `GetAndWait` 호출 시 반환되는 `errorCode`를 반드시 확인해야 합니다. * `errorCode`가 `0`이 아니면 데이터 불러오기 실패로 간주합니다. * [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `GetCurrencyString` 함수의 문자열 생성 방식을 `table.concat`을 사용하여 재작성한 코드만 출력하세요. [answer] | ```lua Method: [server only] string GetCurrencyString() { local parts = { tostring(self.meso), tostring(self.cash) } return table.concat(parts, ",") } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 사전 정의된 String 형식을 따르는 함수들을 사용하는 대신 직접 string을 만들어 사용할 수 있습니다. 직접 만들 경우 데이터를 더 짧은 문자열로 저장할 수 있습니다. 아래의 예제와 같이 `_UtilLogic:Split()`과 `문자열 합치기(..)`를 사용해 String을 문자열로 나누고, 합칠 수 있습니다. Table<v> 데이터는 table.concat을 사용할 수 있습니다. ```lua Property: [None] integer meso = 0 [None] integer cash = 0 Method
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | meso 데이터를 문자열로 저장할 때 tonumber과 math.tointeger를 함께 사용하는 이유는 무엇이며, IsNilorEmptyString 체크가 왜 필요한가요? [answer] | 제공된 문서에 따르면, `tonumber`와 `math.tointeger`를 함께 사용하고 `IsNilorEmptyString` 체크를 하는 이유는 다음과 같습니다. **1. `tonumber`와 `math.tointeger` 함께 사용하는 이유** * **문자열에서 숫자 변환:** DataStorage에 저장된 데이터는 기본적으로 문자열(String) 형태로 반환됩니다. 따라서 `tonumber(mesoString)`을 사용하여 문자열을 숫자(float)로 변환해야 합니다. * **정수형으로 변환:** mLua에서 `in [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드에 필수적인 데이터가 아닌 경우 데이터를 불러오는 데 실패했다면 데이터를 저장하지 않는 방식도 고려할 수 있습니다. 아래의 예제는 Component에서 요청 성공 여부를 Property에 저장하고, Logic을 이용해 데이터를 저장하지 않도록 구현합니다. ```lua Property: [Sync] boolean initialized = false -- 이 프로퍼티를 사용해 저장 막기. [Sync] integer meso = 0 Method: [server only] void OnBeginPlay() { if
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | Cash와 Item 데이터가 모두 정상 로드되었을 때만 저장을 허용하는 로직을 구현하는 mLua 코드만 출력하고, 각 단계의 동작 원리는 주석으로만 설명하세요. [answer] | ```lua Property: [Sync] boolean initialized = false [Sync] integer meso = 0 [Sync] integer cash = 0 [None] table items = {} -- ItemIDs Method: [server only] void OnBeginPlay() { -- 월드 진입 시 데이터 로드를 시작합니다. self:LoadData() } [server only] void LoadData() { -- 유저의 DataStorage 인스턴스를 가져옵니 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | two_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `Initialized` 프로퍼티가 `false`인 상태에서 상점 구매 요청이 들어오면 어떻게 처리해야 하나? [answer] | `Initialized` 프로퍼티가 `false`인 상태, 즉 사용자 데이터 로드(DataStorage Load)가 아직 완료되지 않거나 실패한 상태에서는 상점 구매 로직을 진행하지 않아야 합니다. 이 경우를 처리하는 방법은 다음과 같습니다. 1. 클라이언트로부터 구매 요청이 들어오면 해당 유저의 `UserDataComponent`를 조회합니다. 2. `UserDataComponent`가 유효한지 확인한 후, `initialized` 프로퍼티의 값을 검사합니다. 3. `initialized`가 `false`라면 구매 요청을 [followup] | `userDataComponent.initialized` 체크 로직이 포함된 `RequestBuyItemFromClient` 메서드의 전체 코드 구조를 보여주세요. [followup_answer] | 참고 문서에 포함된 `RequestBuyItemFromClient` 메서드의 전체 코드 구조는 다음과 같습니다. ```lua Method: [server] void RequestBuyItemFromClient(string userId, integer buyItemId) { local userEntity = _UserService:GetUserEntityByUserId(userId) if isvalid(userEntity) == false then return end [scores] | [judge_reason] | [source_doc] | for i, id in pairs(event.items) do table.insert(self.items, id) end } ``` Initialized 프로퍼티에 따라 상점 구매 로직 진행 여부를 결정하는 Logic 스크립트 예제입니다. ```lua Method: [server] void RequestBuyItemFromClient(string userId, integer buyItemId) { local userEntity = _UserService:GetUserEntityByUserId(u
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 서버에서 아이템 데이터를 클라이언트로 동기화할 때 SendItemInitializedEventToClient 이벤트를 직접 호출해야 하는 이유가 단순히 Property 동기화만으로 불가능하기 때문인가요? [answer] | 제공된 문서에는 `SendItemInitializedEventToClient` 이벤트가 존재하거나, 서버에서 클라이언트로 데이터를 동기화할 때 이벤트를 직접 호출해야 하는 구체적인 기술적 이유(예: Property 동기화의 한계)에 대한 설명이 없습니다. 문서에 포함된 코드 예제에서는 `OnUserDataItemInitialized()` 이벤트 객체를 생성하고 `SendItemInitializedEventToClient(itemInitialitedEvent)`를 호출하여 "이벤트를 이용해 Client에 items 동기화"한다는 주 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | mLua에서 비트 AND(&)와 OR(|) 연산자의 동작 원리 및 차이점을 설명해 주세요. [answer] | mLua에서 비트 AND(`&`)와 비트 OR(`|`) 연산자는 두 값의 이진수(2진수) 비트를 위치별로 비교하여 결과를 생성합니다. **동작 원리 및 차이점** 1. **비트 AND 연산자 (`&`)** * 두 값의 같은 위치 비트가 **모두 1**인 경우에만 결과 비트를 1로 만듭니다. * 그렇지 않은 경우(0과 0, 0과 1, 1과 0) 결과 비트는 0이 됩니다. * 주로 특정 비트가 설정되어 있는지 확인하거나, 특정 비트를 제거(마스크)하는 데 사용됩니다. 2. **비트 OR 연산자 [followup] | 위 문서의 예시처럼 `cardKeywords` 테이블을 정의하고, 특정 카드에 Taunt와 BattleCry를 동시에 부여하는 코드와 그 결과를 어떻게 확인하는지 구체적인 코드로 보여주세요. [followup_answer] | `cardKeywords` 테이블을 정의하고, 특정 카드에 Taunt와 BattleCry를 동시에 부여하는 과정과 그 결과를 확인하는 구체적인 코드는 다음과 같습니다. ```lua -- 1. 비트 플래그로 사용할 키워드 정의 local cardKeywords = { Taunt = 1 << 0, -- 1 (이진수 00001) BattleCry = 1 << 1, -- 2 (이진수 00010) Deathrattle = 1 << 2, -- 4 (이진수 00100) Windfury = 1 << 3 [scores] | [judge_reason] | [source_doc] | 비트 AND 연산자(Bitwise AND operator) `&`는 두 개의 값을 비교하여 같은 위치의 비트가 모두 1이면 결과로 1을 반환하고, 그렇지 않으면 0을 반환합니다. 반면, 비트 OR 연산자(Bitwise OR operator) `|`는 두 개의 값을 비교하여 같은 위치의 비트 중 하나라도 1이면 결과로 1을 반환하고, 그렇지 않으면 0을 반환합니다. 예를 들어 봅시다. ```lua local a = 10 -- 이진수 1010 local b = 7 -- 이진수 0111 local result = a & b -- 비트
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `LoadCurrency` 함수에서 `userDataStorage:GetAndWait` 호출 시 반환값 처리 로직을 3문장 이내로 설명하세요. [answer] | `userDataStorage:GetAndWait` 호출 시 반환되는 `errorCode`가 0이 아니면 로그를 출력하고 `false`를 반환하여 로딩을 중단합니다. `errorCode`가 0이면 두 번째 반환값인 `currencyString`을 받아 `_UtilLogic:IsNilorEmptyString`으로 비어 있는지 확인합니다. 문자열이 비어 있지 않으면 `_UtilLogic:Split`으로 쉼표 기준으로 분리한 뒤, `tonumber` 변환을 통해 `self.meso`와 `self.cash` 프로퍼티에 각각 대입합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 사전 정의된 String 형식을 따르는 함수들을 사용하는 대신 직접 string을 만들어 사용할 수 있습니다. 직접 만들 경우 데이터를 더 짧은 문자열로 저장할 수 있습니다. 아래의 예제와 같이 `_UtilLogic:Split()`과 `문자열 합치기(..)`를 사용해 String을 문자열로 나누고, 합칠 수 있습니다. Table<v> 데이터는 table.concat을 사용할 수 있습니다. ```lua Property: [None] integer meso = 0 [None] integer cash = 0 Method
[task] | two_turn [pass] | ⏳ 미판정 [title] | 자동 번역 [question] | 크리에이터가 지원하지 않는 언어에 대해 자동 번역 기능을 활성화하고 적용하는 기본 작동 방식이 궁금합니다. [answer] | 크리에이터가 정식으로 지원하지 않는 언어의 번역을 제공하기 위해 메이플스토리 월드에서는 자동 번역 기능을 제공합니다. 이 기능은 기계 번역을 활용하여, 크리에이터가 원문 언어로만 작성한 텍스트를 플레이어가 설정한 다른 언어로 변환해 줍니다. ### 1. 자동 번역 작동 방식 1. **원문 작성**: 크리에이터는 월드 내 텍스트를 모어(원문 언어)로만 작성합니다. 2. **출시 설정**: 월드를 출시할 때 크리에이터가 직접 번역을 제공하는 언어만 **지원 언어**로 설정합니다. 3. **플레이어 언어 선택**: 플레이어가 월드에 접 [followup] | AllowAutomaticTranslation 프로퍼티가 TextComponent 등 특정 컴포넌트에 한정된 이유는 무엇이며, 5,000자 이상의 텍스트가 번역되지 않는 예외 상황은 어떻게 처리해야 하나요? [followup_answer] | ### 1. AllowAutomaticTranslation 프로퍼티가 특정 컴포넌트에 한정된 이유 참고 문서에 따르면 `AllowAutomaticTranslation` 프로퍼티는 텍스트를 실제 화면에 표시하거나 입력받기 위한 4가지 컴포넌트, 즉 `TextComponent`, `TextInputComponent`, `TextRendererComponent`, `ChatBalloonComponent`에만 존재합니다. 이는 자동 번역 기능이 **텍스트 렌더링 및 입력과 직접적으로 관련된 컴포넌트**에서만 적용될 수 있도록 설계되어 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드에서는 크리에이터가 지원하지 않은 언어의 자동 번역 기능을 지원합니다. 이 기능을 통해 크리에이터는 번역 부담을 덜고, 다양한 언어 사용자들은 보다 편하게 월드를 즐길 수 있습니다. 이번 과정에서는 자동 번역 기능 작동 방식과 설정 방법을 알아봅시다. ##### 참고 가이드 [WorldConfig](/docs?postId=1101) [로컬라이징의 이해](/docs/?postId=951) [포맷에 맞게 로컬라이징하기](/docs/?postId=968) ##### 참고 API Reference
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 저장 주기를 결정할 때 Credit 소모량과 데이터 안정성 간 trade-off를 2문장 이내로 설명하세요. [answer] | 저장 주기를 짧게 설정하면 DataStorage의 데이터 안정성은 높아지지만 Credit 소모량이 증가합니다. 반대로 주기를 길게 늘리면 Credit 소모는 줄지만 서버 문제로 데이터가 유실될 위험이 커집니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 사용량 제한이 걸린 DataStorage에 데이터를 자주 저장하게 하면 Credit이 부족할 수 있습니다. 그러므로 값이 변경될 때마다 데이터를 저장할 필요가 없는 값들은 Property를 사용해 특정 상황일 때만 저장해 Credit 소모량을 줄일 수 있습니다. 주로 아래 3가지 상황에서 저장하는 것을 권장합니다. 1. **유저 접속 종료 시 저장**: 유저가 접속을 종료하면 데이터를 DataStorage에 저장합니다. 2. **일정 시간마다 저장**: 유저의 갱신된 정보는 주기적으로 저장해야 합니다. 서버에 문제가 생겨 저장에
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 연관된 데이터 중 하나만 DataStorage에서 불러오기 실패했을 때, 왜 나머지 데이터 저장까지 차단해야 하는지 설명해 주세요. [answer] | 연관된 데이터 중 하나만 DataStorage에서 불러오기 실패했을 때 나머지 데이터 저장까지 차단해야 하는 이유는, 데이터의 일관성(Integrity)을 유지하기 위해서입니다. 서버가 일부 데이터(예: 아이템 목록)를 정상적으로 불러오지 못했지만, 다른 데이터(예: 현금)는 성공적으로 불러온 경우, 유저가 아이템을 구매하면 다음과 같은 문제가 발생합니다. 1. **데이터 불일치 발생**: 서버에 아이템 데이터가 없기 때문에, 새로 구매한 아이템만 저장되고 이전에 존재했던 아이템 데이터는 사라지는 상황이 생길 수 있습니다. 2 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 요청에 시간이 너무 오래 걸려 실패한 경우와 호출 횟수 한도를 초과한 경우를 모두 포함하여 데이터 로딩 실패 시 유저를 즉시 추방하는 것이 항상 최선의 해결책인가요? [answer] | 아니요, 데이터 로딩 실패 시 유저를 즉시 추방하는 것이 항상 최선의 해결책은 아닙니다. 실패 원인에 따라 다른 처리가 권장되며, 특히 **호출 횟수 한도 초과(ResourceExhausted)** 상황에서는 재시도가 무의미하므로 즉시 추방하거나 다른 로직으로 전환해야 하지만, **시간 초과(TimedOut)** 같은 일시적인 네트워크 문제의 경우 재시도 후 실패 시 추방하는 방식이 더 적절할 수 있습니다. 참고 문서에서 제시하는 권장 사항과 예제는 다음과 같습니다. ### 1. 즉시 추방 (단순 실패 시) 데이터를 불러오지 못 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | OnBeginPlay에서 LoadMesoData가 false를 반환하면 즉시 return하는데, 이것이 이후 게임 로직에 어떤 영향을 미치며 왜 초기화 플래그를 설정하기 전에 종료해야 하나요? [answer] | `OnBeginPlay`에서 `LoadMesoData`가 `false`를 반환하면 즉시 `return`하는 것은 **데이터 로딩 실패 시后续的 게임 로직이 초기화되지 않은 상태로 실행되는 것을 방지하기 위한 조치**입니다. 구체적인 영향과 이유는 다음과 같습니다. ### 1. 왜 초기화 플래그(`initialized`) 설정 전에 종료해야 하나요? `initialized` 플래그는 **데이터가 성공적으로 로드되었는지**를 나타내는 신뢰 가능한 지표입니다. * **로딩 실패 시:** `LoadMesoData`가 `false`를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드에 필수적인 데이터가 아닌 경우 데이터를 불러오는 데 실패했다면 데이터를 저장하지 않는 방식도 고려할 수 있습니다. 아래의 예제는 Component에서 요청 성공 여부를 Property에 저장하고, Logic을 이용해 데이터를 저장하지 않도록 구현합니다. ```lua Property: [Sync] boolean initialized = false -- 이 프로퍼티를 사용해 저장 막기. [Sync] integer meso = 0 Method: [server only] void OnBeginPlay() { if
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage에서 데이터를 불러올 때 GetAndWait 메서드의 errorCode가 0이 아니면 단순히 로그를 남기는 것만으로는 부족해서 전체 초기화 프로세스를 중단하는 이유는 무엇인가요? [answer] | `GetAndWait` 메서드의 `errorCode`가 0이 아니라는 것은 요청한 데이터 Key를 정상적으로 불러오지 못했다는 뜻입니다. 이 시점에 단순히 로그를 남기고 초기화 프로세스를 계속 진행하면, 서버의 데이터 상태가 불일치(데이터 손실 또는 중복)로 이어질 수 있습니다. 참고 문서의 예시에서 보듯, `Item` 데이터와 `Currency` 데이터처럼 서로 연관된 데이터가 있을 때, 이 중 하나(예: Item)를 불러오지 못해도 나머지 데이터(예: Currency)는 정상적으로 로드될 수 있습니다. 만약 이 상태에서 유저가 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage에서 GetAndWait 호출 시 errorCode가 0이 아니면 어떤 상황으로 판단해야 하며, 이때 데이터를 저장하지 않기 위해 어떤 로직을 추가해야 하나요? [answer] | `GetAndWait` 호출 시 `errorCode`가 0이 아니면 데이터 로드 요청이 성공하지 못한 상황으로 판단해야 합니다. 이는 `userDataStorage`가 `nil`인 경우나, 특정 에러 코드가 반환된 경우를 포함합니다. 이러한 실패 상황에서 데이터를 저장하지 않기 위해서는 다음과 같은 로직을 추가해야 합니다: 1. **초기화 상태 관리**: 데이터를 성공적으로 로드했는지 여부를 나타내는 `boolean` 타입의 Property (예: `initialized`)를 선언합니다. 2. **로드 실패 시 초기화 금지* [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드에 필수적인 데이터가 아닌 경우 데이터를 불러오는 데 실패했다면 데이터를 저장하지 않는 방식도 고려할 수 있습니다. 아래의 예제는 Component에서 요청 성공 여부를 Property에 저장하고, Logic을 이용해 데이터를 저장하지 않도록 구현합니다. ```lua Property: [Sync] boolean initialized = false -- 이 프로퍼티를 사용해 저장 막기. [Sync] integer meso = 0 Method: [server only] void OnBeginPlay() { if
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | self.initialized 프로퍼티가 false인 상태에서 SaveMesoData 함수가 실행되면 왜 데이터를 저장하지 않는 것이 권장되며, 이 조건을 어떻게 구현하나요? [answer] | `self.initialized` 프로퍼티가 `false`인 상태에서 `SaveMesoData` 함수가 실행되면 데이터를 저장하지 않는 것이 권장되는 이유는, **데이터 로드(Load) 단계에서 실패했을 가능성이 있기 때문**입니다. `initialized` 플래그는 `LoadMesoData()` 함수가 성공적으로 완료되었는지를 나타내는 지표로 사용됩니다. 만약 로드 과정에서 `_DataStorageService` 접근 실패, 네트워크 오류, 또는 데이터 파싱 오류 등으로 인해 `initialized`가 `true`로 설정되지 못 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드에 필수적인 데이터가 아닌 경우 데이터를 불러오는 데 실패했다면 데이터를 저장하지 않는 방식도 고려할 수 있습니다. 아래의 예제는 Component에서 요청 성공 여부를 Property에 저장하고, Logic을 이용해 데이터를 저장하지 않도록 구현합니다. ```lua Property: [Sync] boolean initialized = false -- 이 프로퍼티를 사용해 저장 막기. [Sync] integer meso = 0 Method: [server only] void OnBeginPlay() { if