[task] | two_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 데이터 불러오기 실패 시 재시도 로직을 구현하려면 어떤 구조를 사용해야 하는지? [answer] | 데이터 불러오기 실패 시 재시도 로직은 `while` 루프와 `wait` 함수를 조합하여 구현합니다. 재시도 횟수를 변수로 선언하고, 데이터를 성공적으로 불러오지 못하면 지정된 시간만큼 대기한 후 재시도 횟수를 감소시키며 루프를 반복합니다. 구현 시 다음 두 가지 중요한 처리를 포함해야 합니다. 1. **ResourceExhausted (1000005) 에러 처리**: 과도한 요청으로 인한 `1000005` 에러 코드가 발생하면 재시도하지 않고 즉시 처리를 중단해야 합니다. 2. **최종 실패 시 유저 추방**: 재시도 횟수 [followup] | ResourceExhausted 에러 코드 1000005 발생 시 재시도를 중단하고 유저를 즉시 추방하는 예외 처리 코드를 작성해 주세요. [followup_answer] | ResourceExhausted(1000005) 에러 코드 발생 시 재시도를 중단하고 유저를 즉시 추방하는 로직을 구현하려면, 데이터 로딩 함수에서 에러 코드를 확인하여 `false`를 반환하도록 하고, 호출 측에서 이 실패를 감지하여 `KickUser`를 호출하는 구조로 작성해야 합니다. 참고 문서의 기본 예시에서는 1000005 에러 발생 시 `return true`를 반환하여 재시도 루프를 빠져나간 후 `initialized` 플래그를 확인하지 않고 바로 반환하는 방식(또는 초기화되지 않았으므로 추방)을 취하고 있습니다. 하 [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage에서 데이터 로딩 실패 시 유저를 추방하는 mLua 코드 예제를 작성하고, 에러 코드 확인 로직과 KickUser 호출을 반드시 포함하세요. [answer] | DataStorage에서 데이터 로딩 실패 시 유저를 추방하는 로직은 `OnBeginPlay`에서 데이터를 불러오는 메서드를 호출하고, 실패 시 `_UserService:KickUser`를 통해 유저를 월드에서 내보내는 방식으로 구현합니다. 에러 코드 확인 로직은 `userDataStorage:GetAndWait` 함수의 반환값인 `errorCode`를 검사하여 진행합니다. `errorCode`가 0이 아니거나 `userDataStorage` 객트 자체가 `nil`인 경우를 실패로 판단합니다. ```lua Property: [S [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 코드만 출력하고 설명은 주석으로 [answer] | ```lua Property: [Sync] integer meso = 0 [Sync] boolean initialized = false Method: [server only] void OnBeginPlay() { local retryCount = 2 -- 2번 재시도하게 설정. 총 3번 저장 시도. while retryCount >= 0 do if self:LoadMesoData() == true then break end wait(1 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | mLua의 복합 할당 연산자 사용 시 불가능한 문법적 제한이 무엇인가요? [answer] | mLua에서 복합 할당 연산자를 사용할 때 다음과 같은 두 가지 문법적 제한이 있습니다. 1. **다중 복합 할당 불가**: 여러 변수에 동시에 복합 할당을 수행할 수 없습니다. ```lua a , b += 1, 2 -- Error ``` 2. **인수(argument)로 사용 불가**: 복합 할당 연산자를 함수 호출의 인수로 직접 사용할 수 없습니다. ```lua print(a += 1) -- Error ``` [followup] | 다중 복합 할당(`a, b += 1, 2`)과 인수 내 복합 할당(`print(a += 1)`)이 왜 에러가 나는지 설명하고, 이를 피하면서 동일한 효과를 얻기 위해 올바른 코드 작성 방법은 무엇인지 예시를 들어주세요. [followup_answer] | 참고 문서에는 다중 복합 할당(`a, b += 1, 2`)과 인수 내 복합 할당(`print(a += 1)`)이 에러가 나는 **구체적인 이유**에 대한 설명이 포함되어 있지 않습니다. 문서에서는 단순히 "지원하지 않는 기능"이라고 명시하고 있을 뿐, 내부적인 문법적 원인이나 설계 의도를 설명하지 않습니다. 하지만 이를 피하면서 동일한 효과를 얻기 위한 올바른 코드 작성 방법은 일반 Lua 문법을 사용하여 각 연산을 분리하는 것입니다. ### 1. 다중 복합 할당 피하기 `a, b += 1, 2`는 `a = a + 1`과 `b [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] | 메이플스토리 월드 루아 문법 확장 [question] | `HasKeyword` 함수에서 `(card & keyword) == keyword`로 비교하는 방식의 논리적 근거가 궁금합니다. [answer] | `HasKeyword` 함수에서 `(card & keyword) == keyword`로 비교하는 방식은 비트 연산의 성질을 이용하여 특정 플래그가 설정되어 있는지 여부를 확인하는 가장 효율적인 방법입니다. 그 논리적 근거는 다음과 같습니다. 1. **비트 플래그 구조**: 각 키워드(예: `Taunt`, `BattleCry`)는 `1 << n` 형태로 정의되어 있어, 이진수에서 **고유한 위치의 비트 하나만 1**인 값을 가집니다. * `Taunt = 1 << 0` -> 이진수 `00001` * `B [followup] | [followup_answer] | [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] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | `<<=`와 `>>=` 연산자에서 이동할 비트 수(예: 1, 2, 3...)를 임의로 지정하는 문법과, 그 결과가 원본 변수의 타입에 미치는 영향을 구체적으로 알려주세요 [answer] | 제공된 참고 문서에는 `<<=`(왼쪽 비트 시프트 할당)와 `>>=`(오른쪽 비트 시프트 할당) 연산자가 **오른쪽 피연산자로 이동할 비트 수(정수)를 지정하여** 사용된다는 문법적 사실과, 예제에서 `1`을 이동 수로 사용한 사례가 포함되어 있습니다. 그러나 질문하신 두 가지 사항에 대해 문서에 명시된 내용은 다음과 같이 제한적입니다. 1. **이동할 비트 수를 임의로 지정하는 문법:** * 문서의 예제(`num <<= 1`, `num >>= 1`)를 근거로, `<<=`와 `>>=` 연산자의 오른쪽에 **숫자(정수 [followup] | 이동할 비트 수가 변수의 크기를 초과하거나(예: 8bit 변수에 100칸 이동) 0일 때의 동작은 어떻게되며, 실제 스크립트에서 `OnUpdate`를 통해 매 프레임 `<<=`를 호출할 때 발생할 수 있는 성능 이슈나 버그 예시를 코드와 함께 설명해 주세요? [followup_answer] | 제공된 참고 문서에는 이동할 비트 수가 변수의 크기를 초과하거나 0일 때의 동작, `OnUpdate`에서 매 프레임 `<<=`를 호출할 때의 성능 이슈나 버그 예시에 대한 정보가 **없습니다.** 문서에는 `<<=`와 `>>=` 연산자의 기본 정의(이진수를 왼쪽/오른쪽으로 이동시키고 0을 추가하거나 제거하는 것)와 이동 수가 1인 단순 예제(`num <<= 1`, `num >>= 1`)만 포함되어 있으며, 경계 조건 처리나 프레임 루프 내 반복 호출 시 부작용에 대한 기술이 없습니다. 따라서 질문하신 특수한 경우의 동작 및 성능 [scores] | [judge_reason] | [source_doc] | 문자열 이어 붙이기 할당 연산자(String concatenation assignment operator) `..=`는 문자열을 이어 붙인 결과를 할당합니다. ```lua local str = 'Hello, ' str ..= 'MapleStory ' str ..= 'World!' print(str) -- Output : -- Hello, MapleStory World! ``` #### 왼쪽 비트 시프트 할당 연산자 비트 시프트는 프로그래밍에서 사용되는 비트 연산자 중 하나로, 이진수 값을 왼쪽이나 오른쪽으로 이동시킵니다. 왼쪽
[task] | code [pass] | ⏳ 미판정 [title] | 중복 컴포넌트 수정하기 [question] | AIChaseComponent와 AIWanderComponent가 공유하는 필요 컴포넌트인 StateComponent가 두 AI 컴포넌트 모두에 의해 중복으로 추가되는 상황을 처리하기 위해, StateComponent의 중복 여부를 확인하고 중복 시 단일 인스턴스로 통합하는 스크립트를 작성해줘. [answer] | 제시된 참고 문서에 따르면, `AIChaseComponent`와 `AIWanderComponent`는 모두 `StateComponent`를 필요 컴포넌트로 가지며, 이 필요 컴포넌트는 해당 AI 컴포넌트를 추가할 때 **자동으로 추가**됩니다. 문서에는 "연관 컴포넌트끼리의 추가 순서에 따라 중복 컴포넌트가 발생할 수 있다"고 명시되어 있습니다. 하지만, **중복된 컴포넌트를 코드(Script)로 감지하여 삭제하거나 단일 인스턴스로 통합하는 API(예: `RemoveComponent`, `GetComponent` 등)는 제공된 문 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 몇몇 컴포넌트는 사용 시 필수로 함께 사용해야 하는 필요 컴포넌트가 있습니다. 이 필요 컴포넌트는 특정 컴포넌트를 추가했을 때 자동으로 추가되고 있습니다. 이 동작으로 인해 연관 컴포넌트끼리의 추가 순서에 따라 중복 컴포넌트가 발생할 수 있습니다. 이 경우 추가한 컴포넌트를 삭제하고, 재추가해 수정합니다. 이 과정에서 로직 수정이 필요할 수 있습니다. 필요 컴포넌트가 있는 컴포넌트는 아래의 표에서 확인할 수 있습니다. | 추가한 Component | 필요 Component | | --- | --- | | AIChaseCompo
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 데이터 불러오기 실패 시 유저를 월드에서 추방하기 위해 _UserService의 어떤 메서드와 KickReason을 함께 사용해야 하나요? [answer] | 데이터 불러오기에 실패했을 때 유저를 월드에서 추방하려면 `_UserService`의 `KickUser` 메서드를 사용합니다. 이 메서드에는 추방할 유저의 ID와 추방 사유로 `KickReason.WorldError`를 함께 전달합니다. 구체적인 사용 예시는 다음과 같습니다: ```lua _UserService:KickUser(self.Entity.PlayerComponent.UserId, KickReason.WorldError) ``` 이 코드는 `self.Entity.PlayerComponent.UserId`로 현재 유저를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `SaveData()` 메서드에서 `errorCode`가 0이 아닐 때 수행되는 동작을 2문장 이내로 요약하세요. [answer] | 에러 코드가 0이 아닐 경우 `log("ErrorCode : "..errorCode)`를 호출하여 오류를 기록합니다. [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] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 데이터 불러오기 재시도 로직에서 ResourceExhausted 에러 코드 1000005 발생 시 유저 추방 여부를 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua Property: [Sync] integer meso = 0 [Sync] boolean initialized = false Method: [server only] void OnBeginPlay() { local retryCount = 2 -- 2번 재시도하게 설정. 총 3번 저장 시도. while retryCount >= 0 do if self:LoadMesoData() == true then break end wait(1 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 연관된 데이터 중 하나라도 불러오기 실패 시 저장 차단을 권장하는 이유를 3문장 이내로 설명하세요. [answer] | 연관된 데이터 중 하나를 정상적으로 불러오지 못하면, 해당 데이터가 누락된 상태로 저장이 진행되어 이전에 쌓인 데이터가 사라지는 문제가 발생할 수 있습니다. 이로 인해 유저는 돈을 지불했지만 구매한 아이템이 실제로 지급되지 않는 등 데이터 불일치로 인한 피해가 생길 수 있습니다. 따라서 연관된 모든 데이터의 불러오기 성공 여부를 확인한 뒤에야 저장을 허용하는 것이 권장됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | code [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | 비트 OR 할당 연산자(|=)를 사용하여 기존 카드 플래그에 새로운 키워드를 추가하는 기능을 포함하는 스크립트를 작성해줘 [answer] | `|=` (비트 OR 할당) 연산자는 기존 값에 새로운 비트(키워드)를 추가할 때 사용합니다. 기존에 없던 키워드만 추가하고, 이미 있는 키워드는 그대로 유지하는 방식입니다. 다음은 카드 플래그에 새로운 키워드를 추가하는 기능을 담은 mLua 스크립트 예시입니다. ```lua Property: [None] number CurrentCardFlags = 0 Method: [server only] void OnBeginPlay() { -- 초기 상태: 아무 키워드도 없는 카드 self.CurrentCardFlags [followup] | [followup_answer] | [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] | `LoadItems()` 함수에서 `userDataStorage`가 nil인 경우와 `errorCode`가 0이 아닌 경우 각각 반환하는 값은 무엇인지 표로 정리하세요. [answer] | `LoadItems()` 함수에서 `userDataStorage`가 nil인 경우와 `errorCode`가 0이 아닌 경우 각각 반환하는 값은 다음과 같습니다. | 조건 | 반환 값 | | :--- | :--- | | `userDataStorage`가 nil인 경우 | `false` | | `errorCode`가 0이 아닌 경우 | `false` | [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] | two_turn [pass] | ⏳ 미판정 [title] | 자동 번역 [question] | 자동 번역을 위해 WorldConfig의 SourceLanguage를 설정할 때, 실제 월드 내 텍스트의 언어와 SourceLanguage가 일치하지 않을 경우 발생하는 문제는 무엇인가요? [answer] | 크리에이터가 WorldConfig의 `SourceLanguage`로 설정한 언어와 실제 월드 내 텍스트의 언어가 일치하지 않으면, 자동 번역 기능이 정상적으로 동작하지 않을 수 있습니다. 자동 번역 시스템은 작성된 텍스트의 실제 언어를 감지하는 것이 아니라, 설정된 `SourceLanguage`를 기준으로 해당 텍스트를 해당 언어로 가정하고 번역을 진행하기 때문입니다. 따라서 원문 언어가 실제로는 영어인데 `SourceLanguage`를 한국어로 설정한 경우, 영어 텍스트를 한국어로 오해하고 번역하여 결과적으로 의미 없는 번역이 [followup] | SourceLanguage가 한국어로 설정되어 있으나 일부 UI 텍스트가 영어로 작성된 상태에서, 플레이어가 한국어로 자동 번역을 요청했을 때 mLua 스크립트로 텍스트를 동적으로 변경하여 번역 오류를 방지하는 코드 예시를 보여주세요. [followup_answer] | 참고 문서에 따르면, 자동 번역 시스템은 텍스트의 실제 작성 언어를 감지하는 기능이 없으며, `SourceLanguage`로 설정된 언어로만 가정하고 번역을 진행합니다. 따라서 `SourceLanguage`가 한국어로 설정되어 있고 일부 UI 텍스트가 영어로 작성된 경우, 해당 영어 텍스트는 "한국어 원문"으로 잘못 인식되어 번역이 정상적으로 동작하지 않거나 오류가 발생합니다. 문서에 명시된 바와 같이, mLua 스크립트로 텍스트를 동적으로 변경하여 이러한 번역 오류를 방지하는 코드 예시나 API는 존재하지 않습니다. 자동 번역의 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드에서는 크리에이터가 지원하지 않은 언어의 자동 번역 기능을 지원합니다. 이 기능을 통해 크리에이터는 번역 부담을 덜고, 다양한 언어 사용자들은 보다 편하게 월드를 즐길 수 있습니다. 이번 과정에서는 자동 번역 기능 작동 방식과 설정 방법을 알아봅시다. ##### 참고 가이드 [WorldConfig](/docs?postId=1101) [로컬라이징의 이해](/docs/?postId=951) [포맷에 맞게 로컬라이징하기](/docs/?postId=968) ##### 참고 API Reference
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | GetAndWait 메서드에서 반환되는 errorCode가 0이 아닐 때, 모든 오류에 대해 무조건 재시도하는 것이 아니라 특정 코드를 제외해야 하는 이유는 무엇인가요? [answer] | `GetAndWait` 메서드에서 반환되는 `errorCode`가 0이 아닐 때 모든 오류에 대해 무조건 재시도하지 않는 이유는, 특정 오류 코드는 **재시도를 해도 해결되지 않는 상태**를 나타내기 때문입니다. 참고 문서에 따르면, 에러 코드 `1000005`는 `ResourceExhausted`를 의미하며, 이는 호출 횟수가 한도를 초과하여 발생한 에러입니다. 이러한 제한 초과 상태에서는 즉시 재시도해도 동일한 한도 초과 오류가 반복적으로 발생하므로, 재시도를 수행하지 않고 바로 유저를 월드에서 추방(`KickUser`)하는 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage에서 ResourceExhausted 에러가 발생했을 때 재시도 로직을 수행하면 안 되는 이유는 무엇인가요? [answer] | DataStorage에서 `ResourceExhausted` (에러 코드 1000005) 에러가 발생했을 때 재시도 로직을 수행하면 안 되는 이유는 **호출 횟수가 한도를 초과하여 에러가 발생했기 때문**입니다. 이 에러는 클라이언트나 서버가 허용된 요청 제한을 넘겼음을 의미하므로, 같은 요청을 반복하여 재시도하는 것은 문제를 해결하지 못하고 오히려 과도한 요청으로 인한 에러 상태를 지속시키거나 악화시킬 수 있습니다. 따라서 문서의 예시와 같이 이 에러 코드를 감지하면 재시도 루프를 중단하고, 해당 유저를 월드에서 추방하는 등 다 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | OnBeginPlay 안에서 while 루프를 통해 재시도를 구현할 때, 재시도 횟수를 제어하기 위해 사용하는 변수와 대기 함수는 무엇인가요? [answer] | OnBeginPlay 안에서 while 루프를 통해 재시도를 구현할 때, 재시도 횟수를 제어하기 위해 사용하는 변수는 **retryCount**이고, 대기 함수는 **wait()** 입니다. 제공된 예시 코드에서는 `retryCount` 변수를 초기값 2로 설정하여 총 3번(초기 시도 1회 + 재시도 2회)까지 데이터를 불러오기를 시도하며, 실패할 때마다 `wait(1)`을 호출하여 1초를 대기한 후 `retryCount` 값을 1씩 감소시켜 루프를 제어합니다. ```lua Method: [server only] void OnB [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | two_turn [pass] | ⏳ 미판정 [title] | 자동 번역 [question] | 월드 출시 시 지원 언어로 설정하지 않은 언어는 자동으로 '자동 번역' 옵션으로 표시된다고 하는데, 이 설정은 기기별로 저장된다는 점이 플레이어 경험에 어떤 영향을 주나요? [answer] | 문서에 따르면, 자동 번역 옵션의 설정 정보는 **기기별로 저장**됩니다. 이는 플레이어 경험에 다음과 같은 영향을 줍니다. 1. **기기 간 설정 불일치:** 플레이어가 A 기기와 B 기기에서 같은 월드를 플레이할 때, A 기기에서는 '한국어(자동 번역)'로 설정해 한국어로 즐기고 있었더라도, B 기기에 접속하면 해당 설정이 자동으로 유지되지 않습니다. B 기기에서는 다시 월드 언어 설정 창으로 들어가서 원하는 언어를 선택해야 합니다. 2. **매번 수동 설정 필요:** 새로운 기기를 사용하거나 다른 기기에서 월드에 접속할 [followup] | 플레이어가 한국어로 자동 번역을 활성화한 후, 다른 기기에 접속했을 때 번역 상태가 초기화되는 현상을 방지하거나 동기화하기 위한 mLua 기반 로직이 가능한가요? [followup_answer] | 아니요, 제공된 참고 문서에는 플레이어의 언어 설정(자동 번역 옵션)을 기기 간에 동기화하거나 초기화를 방지하기 위한 mLua 기반 API, 프로퍼티, 또는 이벤트가 존재하지 않습니다. 문서에 따르면 자동 번역 옵션의 설정 정보는 **기기별로 저장**된다고 명시되어 있으며, 이를 서버 측 스크립트나 클라이언트 스크립트로 제어하여 기기 간 동기화하는 방법에 대한 설명이나 관련 API가 문서에 포함되어 있지 않습니다. 따라서 현재 제공된 정보 범위 내에서는 mLua 로직으로 이 문제를 해결하는 것이 불가능합니다. [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드에서는 크리에이터가 지원하지 않은 언어의 자동 번역 기능을 지원합니다. 이 기능을 통해 크리에이터는 번역 부담을 덜고, 다양한 언어 사용자들은 보다 편하게 월드를 즐길 수 있습니다. 이번 과정에서는 자동 번역 기능 작동 방식과 설정 방법을 알아봅시다. ##### 참고 가이드 [WorldConfig](/docs?postId=1101) [로컬라이징의 이해](/docs/?postId=951) [포맷에 맞게 로컬라이징하기](/docs/?postId=968) ##### 참고 API Reference
[task] | two_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | DataStorage 로딩 실패 시 저장 동작을 방지하는 `initialized` 프로퍼티 로직을 어떻게 구현하나요? [answer] | DataStorage 로딩 실패 시 저장 동작을 방지하기 위해 `initialized` 프로퍼티를 사용하는 로직은 다음과 같이 구현합니다. 1. **Property 정의**: `[Sync]` 또는 `[None]` 속성을 가진 `boolean initialized = false` 프로퍼티를 선언하여 초기 상태를 관리합니다. 2. **로딩 로직 (OnBeginPlay)**: * `LoadMesoData()` (또는 유사한 로딩 함수)를 호출합니다. * 로딩이 성공하면 `self.initialized = tru [followup] | `LoadMesoData`가 false를 반환할 때 `SaveMesoData`에서 어떤 조건으로 저장 중단을 처리하며, 실패 시 로그는 어떻게 남기나요? [followup_answer] | `LoadMesoData`가 `false`를 반환하면 `OnBeginPlay`에서 `return`이 실행되어 `self.initialized`가 `true`로 설정되지 않고 기본값인 `false` 상태를 유지합니다. `SaveMesoData`에서는 이 `self.initialized` 값을 확인하여 저장 중단을 처리합니다. 1. **조건**: `if self.initialized == false then` 2. **로그**: `log("info is not initialized")` 3. **동작**: 로그를 남긴 후 `r [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] | LoadMesoData 함수에서 userDataStorage:GetAndWait 호출 후 성공적으로 데이터를 받아오기 위해 확인해야 하는 조건은 무엇인가요? [answer] | `LoadMesoData` 함수에서 `userDataStorage:GetAndWait` 호출 후 데이터를 성공적으로 받아오기 위해 확인해야 하는 조건은 반환되는 `errorCode`가 `0`인 것입니다. 코드에서 `local errorCode, mesoString = userDataStorage:GetAndWait("Meso")`를 호출한 뒤, `if errorCode == 0 then` 조건이 참일 때만 `mesoString`에서 데이터를 추출하여 `self.meso`에 저장하고 `initialized`를 `true`로 설정한 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 정상적으로 요청했지만 원인이 불명확한 일시 장애가 발생해 데이터 불러오기를 실패할 수 있습니다. 이런 상황을 대비해 데이터 불러오기 요청을 여러 번 시도할 수 있습니다. 아래 예시 코드는 데이터 불러오기에 실패하면 2초 뒤에 재시도합니다. 그 이후 일정 횟수 이상 실패하면 유저를 월드에서 추방합니다. 더불어 과도한 요청으로 인한 에러 코드 ResourceExhausted: 1000005가 발생하면, 재시도하지 않고 유저를 추방합니다. ```lua Property: [Sync] integer meso = 0 [Syn
[task] | two_turn [pass] | ⏳ 미판정 [title] | 메이플스토리 월드 루아 문법 확장 [question] | `..=` 연산자, `<<=` 연산자, `>>=` 연산자의 기본 동작 방식과 차이점을 설명해 주세요 [answer] | mLua는 Lua 5.3 기반이므로, `..=`, `<<=`, `>>=` 연산자는 각각 문자열 연결, 비트 왼쪽 시프트, 비트 오른쪽 시프트의 결과를 즉시 해당 변수에 다시 할당하는 동작을 합니다. ### 1. `..=` (문자열 이어 붙이기 할당 연산자) 문자열 두 개를 이어 붙인 결과를 해당 변수에 할당합니다. `str = str .. "text"` 와 동일한 효과를 더 간결하게 표현할 수 있습니다. * **동작 방식**: 왼쪽 피연산자의 문자열과 오른쪽 피연산자의 문자열을 연결하여 왼쪽 피연산자에 다시 저장합니다. * [followup] | 문자열이 아닌 숫자 변수에 `..=`를 적용하거나, 0보다 작은 음수(마이너스)에 `<<=` 또는 `>>=`를 적용했을 때의 예외 처리나 결과값은 어떻게 되나요? [followup_answer] | 제공된 참고 문서에는 `..=` 연산자에 숫자를 적용하거나, 음수에 `<<=` 및 `>>=` 연산자를 적용했을 때의 예외 처리 방식이나 구체적인 결과값에 대한 정보가 포함되어 있지 않습니다. 문서에는 `..=`가 문자열을 이어 붙이는 연산자이며, `<<=`와 `>>=`가 각각 비트를 왼쪽/오른쪽으로 이동시키는 연산자임을 설명하고 있고, 예제로는 문자열 변수에 `..=`를 사용하고 양의 정수(2)에 `<<=` 및 `>>=`를 사용하는 경우만 제시되어 있습니다. 따라서 해당 특수 상황(타입 불일치, 음수 처리)에 대한 동작은 참고 문 [scores] | [judge_reason] | [source_doc] | 문자열 이어 붙이기 할당 연산자(String concatenation assignment operator) `..=`는 문자열을 이어 붙인 결과를 할당합니다. ```lua local str = 'Hello, ' str ..= 'MapleStory ' str ..= 'World!' print(str) -- Output : -- Hello, MapleStory World! ``` #### 왼쪽 비트 시프트 할당 연산자 비트 시프트는 프로그래밍에서 사용되는 비트 연산자 중 하나로, 이진수 값을 왼쪽이나 오른쪽으로 이동시킵니다. 왼쪽
[task] | single_turn [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | SetAndWait 메서드의 첫 번째 인자로 "Items" 같은 문자열을 전달할 때, 이 값이 저장소의 어떤 역할을 하는지 설명해 주세요. [answer] | `SetAndWait` 메서드의 첫 번째 인자로 전달되는 문자열(예: "Items", "Currency")은 저장소에서 데이터를 식별하는 **키(Key)** 역할을 합니다. `_DataStorageService:GetUserDataStorage`를 통해 사용자별 데이터 저장소를 조회한 후, 이 저장소 내부에는 여러 가지 데이터를 저장할 수 있습니다. 이때 각 데이터를 구분하기 위해 사용자가 직접 정의한 문자열을 키로 사용하여 데이터를 저장하거나 검색합니다. 문서 예시에서 `userDataStorage:SetAndWait("Ite [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] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `GetCurrencyString()` 메서드가 반환하는 JSON 문자열에 포함된 키와 해당 값의 출처 프로퍼티를 매핑하는 코드를 주석으로 설명 포함해 출력하세요. [answer] | `GetCurrencyString()` 메서드는 `meso`와 `cash` 프로퍼티의 값을 가져와 하나의 테이블로 구성한 뒤, JSON 문자열로 인코딩하여 반환합니다. 각 키와 값의 출처는 다음과 같습니다. ```lua [server only] string GetCurrencyString() { -- 빈 테이블을 생성하여 JSON 객체의 구조를 만들 준비를 합니다. local currency = {} -- 키 "meso": -- self.meso 프로퍼티에 저장된 메소 금액을 값으로 할당합니 [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] | _GetUserDataStorage가 반환하는 객체의 SetAndWait와 GetAndWait 메서드는 비동기 처리 방식에서 어떤 차이가 있나요? [answer] | 제공된 참고 문서에는 `SetAndWait`와 `GetAndWait` 메서드가 "비동기"인지 "동기"인지에 대한 명시적인 기술이 없으며, 두 메서드 간의 처리 방식 차이를 설명하는 내용이 포함되어 있지 않습니다. 문서에 나타난 사용법만으로는 두 메서드 모두 호출 후 즉시 반환값(errorCode, data)을 받아오는 형태로 사용되고 있습니다. 예를 들어, `local errorCode, itemString = userDataStorage:GetAndWait("Items")` 또는 `local errorCode = userData [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] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 문서에 제시된 상점 구매 로직에서 `initialized` 프로퍼티가 `false`일 때의 동작을 설명하되, 3문장 이내로 작성하세요. [answer] | `initialized` 프로퍼티가 `false`일 경우 로드는 실패한 것으로 간주되어 상점 구매 로직이 진행되지 않습니다. 이때 `log("userDataComponent not initialized")`가 출력되고 함수가 즉시 반환됩니다. [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] | `HandleUserLeaveEvent` 이벤트 핸들러의 코드 블록만 출력하되, 설명은 주석으로만 달아주세요. [answer] | ```lua Event Handler: [server only] [service: UserService] HandleUserLeaveEvent(UserLeaveEvent event) { -- 유저가 맵을 이탈할 때 데이터를 저장합니다. self:SaveData() } ``` [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] | LoadMesoData 메서드에서 userDataStorage:GetAndWait 호출 결과의 errorCode가 0이 아닌 경우와 mesoString이 nil 또는 빈 문자열인 경우의 처리 방식을 비교하여 설명하세요. [answer] | `LoadMesoData` 메서드에서 `userDataStorage:GetAndWait("Meso")` 호출 결과의 `errorCode`와 `mesoString` 값에 따른 처리 방식은 다음과 같이 구분됩니다. **1. `errorCode`가 0이 아닌 경우 (데이터 불러오기 실패)** * **처리 방식:** 함수는 즉시 `false`를 반환합니다. * **의미:** `errorCode`가 0이 아니라는 것은 DataStorage로부터 데이터를 정상적으로 불러오지 못했음을 의미합니다. (예: TimedOut, Resourc [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 DataStorage는 간단하게 데이터를 저장하고 불러올 수 있습니다. 그러나 DataStorage를 사용하며 다양한 문제가 발생할 수 있습니다. 이번 가이드에서는 권장하는 DataStorage 사용 방법 중 일부를 소개합니다. 크리에이터가 만드는 월드 특성에 따라 알맞은 해결 방법이 필요합니다. # DataStorage 에러 코드 처리 다양한 이유로 인해 데이터를 DataStorage로부터 불러오지 못하는 상황이 발생할 수 있습니다. 예를 들어 요청에 시간이 너무 오래 걸려 실패하거나(TimedOut),
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | `RequestBuyItemFromClient` 메서드 내에서 `isvalid` 체크가 실패하는 두 가지 조건을 단계별 번호 목록으로 정리하세요. [answer] | `RequestBuyItemFromClient` 메서드 내에서 `isvalid` 체크가 실패하는 두 가지 조건은 다음과 같습니다. 1. `_UserService:GetUserEntityByUserId(userId)` 호출 결과로 반환된 `userEntity`가 유효하지 않은 경우 2. `userEntity.UserDataComponent` 접근 결과로 반환된 `userDataComponent`가 유효하지 않은 경우 [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] | 문서 예제 코드의 LoadData() 메서드에서 초기화 실패 시 return을 처리하는 순서와 그 의도를 단계별 번호 목록으로 정리하세요. [answer] | 제공된 문서의 `LoadData()` 메서드 예제를 분석하면, 초기화 실패 시 반환(return)을 처리하는 순서와 그 의도는 다음과 같습니다. 1. **`_DataStorageService:GetUserDataStorage` 호출 결과 확인** * **코드:** `if userDataStorage == nil then return end` * **의도:** 유저의 DataStorage 객체를 가져오지 못했으면(예: 유저 ID 오류 등) 이후 데이터 로딩이 불가능하므로 즉시 함수를 종료합니다. 2. ** [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 크리에이터는 월드를 만들 때 일반적으로 다수의 Key를 사용해 데이터를 저장합니다. 이렇게 저장한 데이터끼리 연관이 있다면 관련 기능 차단 또는 데이터 저장 차단을 고려해야 합니다. 연관된 데이터 중 하나를 저장하지 못하면 문제가 발생할 수 있습니다. 아래 그림은 연관된 두 값 중 하나의 데이터를 정상적으로 불러오지 못했을 때의 상황입니다. Item 데이터 값을 DataStorage로부터 불러오지 못해서 서버에 Item 1, 2, 3 없습니다. 불러온 데이터가 없기 때문에 Item 4를 유저가 구매했더라도 정상적으로 저장을 하면
[task] | code [pass] | ⏳ 미판정 [title] | 효과적으로 DataStorage 사용하기 [question] | 서버의 HandleUserLeaveEvent 이벤트 핸들러가 트리거될 때 self:SaveData() 메서드를 호출하여 사용자 데이터를 저장하는 로직을 구현하는 스크립트를 작성해줘 [answer] | `HandleUserLeaveEvent` 이벤트가 트리거될 때 사용자 데이터를 저장하는 로직은 `UserService`에서 발생하는 `UserLeaveEvent`를 처리하는 이벤트 핸들러를 추가하여 구현합니다. 아래 스크립트 예제처럼 `[server only] [service UserService]` 속성을 가진 `HandleUserLeaveEvent` 함수를 정의하고, 본문에서 `self:SaveData()`를 호출하면 됩니다. `SaveData` 메서드는 실제 데이터 저장 처리를 수행하도록 별도로 구현해야 합니다. ```lua [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