[task] | two_turn [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | AvatarGUIRendererComponent를 활용하여 UI에 아바타를 표현하는 기본 방법과 주요 프로퍼티(PlayRate, PreserveAvatar, RaycastTarget 등)에 대해 설명해 주세요. [answer] | # AvatarGUIRendererComponent를 활용한 UI 아바타 표현 `AvatarGUIRendererComponent`는 메이플스토리 월드의 UI에 캐릭터(아바타) 정보를 렌더링하여 보여주는 데 사용되는 컴포넌트입니다. 이 컴포넌트를 활용하면 UI 위젯에 실제 3D 아바타 모델을 2D 이미지처럼 배치하고, 애니메이션 재생 속도나 표시 방식 등을 제어할 수 있습니다. ## 주요 프로퍼티 `AvatarGUIRendererComponent`의 주요 프로퍼티와 그 역할은 다음과 같습니다. | 프로퍼티 | 설명 | | -- [followup] | UI에서 아바타를 보여줄 때 RaycastTarget를 true로 설정하면 뒤에 가려진 UI가 터치 입력을 받지 못한다고 하는데, 이 경우 UI 레이아웃 구성 시 주의해야 할 점과 RaycastTarget를 false로 두는 것이 적절한 상황은 언제일까요? [followup_answer] | ## RaycastTarget 설정 시 UI 레이아웃 구성 주의점 `RaycastTarget`를 `true`로 설정하면 `AvatarGUIRendererComponent`가 렌더링되는 영역이 화면 터치 또는 마우스 클릭의 대상이 됩니다. 이 경우 아바타 뒤에 가려진 다른 UI 요소들은 입력 이벤트를 받지 못합니다. 따라서 UI 레이아웃을 구성할 때 다음과 같은 점에 주의해야 합니다. 1. **아바타 영역과 인터랙티브 UI 요소의 겹침 방지** - 아바타가 표시되는 `RectSize` 영역 안에 버튼, 슬라이더, 텍스트 입력 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 **AvatarGUIRendererComponent**를 활용하면 UI에 캐릭터 정보를 보여줄 수 있습니다. 본 과정을 통해 **AvatarGUIRendererComponent** 활용 방법을 알아봅시다. ##### 참고 가이드 [아바타 애니메이션 제어하기](docs/?postId=820) ##### 참고 API Reference [AvatarGUIRendererComponent](/apiReference/Components/AvatarGUIRendererComponent) #### AvatarGUIRende
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 스크립트에서 self.Stan.NameTagComponent.Name 에 직접 "Stan"이라고 쓰지 않고 로컬라이제이션 키를 사용하는 이유는 무엇인가요? [answer] | `self.Stan.NameTagComponent.Name`에 직접 "Stan"이라는 문자열을 하드코딩하지 않고 `_LocalizationService:GetText("UI_TEXT_NPC_Stan")` 같은 로컬라이제이션 키를 사용하는 이유는 **여러 언어(로컬라이제이션) 지원** 때문입니다. 메이플스토리 월드에서는 게임이 서비스되는 국가에 따라 한국어, 영어 등 다양한 언어를 지원해야 합니다. 만약 스크립트 안에 "Stan"이라는 텍스트를 직접 작성해 두면, 게임의 언어 설정이 영어로 바뀌더라도 여전히 "Stan"으로 출력되거 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetTextFormat()` 함수는 **LocalizationTable**에서 **Key**를 인수로 받습니다. 이 **Key**에 해당하는 텍스트를 찾고, 추가로 전달 받은 포맷 인수(format argument)가 있다면 그것을 형식에 맞게 채워 넣은 결과를 반환합니다. 예를 들어 아래와 같이 NPC 2명이 서 있고, 플레이어 캐릭터가 각 NPC와 만나면(충돌하면) 주황색 텍스트 상자에 **"안녕, NPCName!"**라는 문장을 출력해봅시다. 1. 맵에 NPC 2명을 배치하고 각 NPC 엔티티의 이름을 아래와 같이 수
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | LocalizationTable 에서 Key 를 UI_TEXT_NPC_Stan 으로 설정했는데, 스크립트에서 GetText 를 호출할 때 ID 1 을 넘겨주면 오류가 나는 이유가 있나요? [answer] | `GetText()` 함수는 **LocalizationTable**의 **ID**가 아니라 **Key**를 인수로 받아야 합니다. 문서에서 `GetTextFormat()` (참고로 `GetText()`도 동일한 원리) 함수는 **LocalizationTable**에서 **Key**를 인수로 받는다고 명시되어 있습니다. 질문에서 언급하신 `ID 1`은 테이블의 내부 식별자일 뿐, 로컬라이징 텍스트를 조회하기 위한 인자가 아닙니다. 따라서 ID를 넘겨주면 해당 Key를 찾지 못해 오류가 발생하거나 빈 값을 반환하게 됩니다. 스크립트 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetTextFormat()` 함수는 **LocalizationTable**에서 **Key**를 인수로 받습니다. 이 **Key**에 해당하는 텍스트를 찾고, 추가로 전달 받은 포맷 인수(format argument)가 있다면 그것을 형식에 맞게 채워 넣은 결과를 반환합니다. 예를 들어 아래와 같이 NPC 2명이 서 있고, 플레이어 캐릭터가 각 NPC와 만나면(충돌하면) 주황색 텍스트 상자에 **"안녕, NPCName!"**라는 문장을 출력해봅시다. 1. 맵에 NPC 2명을 배치하고 각 NPC 엔티티의 이름을 아래와 같이 수
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 번역 테이블을 사용하지 않고 포맷 기능만 활용하려면 SmartFormat()의 인수로 LocalizationTable의 Key 대신 무엇을 전달해야 하나요? [answer] | 번역 테이블을 사용하지 않고 포맷 기능만 활용하려면, `SmartFormat()`의 인수로 LocalizationTable의 Key 대신 **출력할 문자열**을 직접 전달해야 합니다. 이때 문자열 안에는 `{0}`, `{1}` 등 중괄호와 숫자를 사용해 변수가 들어갈 위치를 지정할 수 있습니다. ```lua [client only][self] HandleTriggerEnterEvent(TriggerEnterEvent event) { -- Parameters local TriggerBodyEntity = event. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## SmartFormat `GetText()`나 `GetTextFormat()`은 번역 테이블을 필요로 합니다. 번역 테이블을 사용하지 않고 `GetTextFormat()`의 포맷 기능만 따로 이용하고 싶다면 `SmartFormat()` 함수를 사용합니다. `SmartFormat()`에서는 인수로 **LocalizationTable**의 **Key** 대신 출력할 문자열을 직접 받습니다. `SmartFormat()`를 사용해 위의 예제를 구현하면 아래와 같습니다. ```lua [client only][self] Handle
[task] | code [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | SetColorBtn 버튼에 TextComponent를 추가하여 텍스트를 'SetColor'로 설정하고, 클릭 시 UI 아바타 색상이 랜덤 변경되는 동작을 구현하기 위한 UI 객체 구성과 스크립트 연결 과정을 작성해줘. [answer] | # UI 아바타 색상 랜덤 변경 구현 UI에서 아바타를 표현하는 `AvatarGUIRendererComponent`의 `Color` 프로퍼티를 변경하여 버튼 클릭 시 색상값을 랜덤하게 바꾸는 예제입니다. ## 1. UI 객체 구성 1. UI 에디터에서 버튼을 추가하고 이름을 **SetColorBtn**으로 설정합니다. 2. **SetColorBtn**에 `TextComponent`를 추가하고 아래 표와 같이 프로퍼티를 수정합니다. | 컴포넌트 | 프로퍼티 | 값 | | :---: | :---: | :---: | | TextC [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트로 **AvatarGUIRendererComponent**의 **Color** 프로퍼티를 변경해봅시다. 버튼을 누르면 UI에 보이는 아바타의 색상 값이 랜덤하게 변경되는 예제를 살펴보겠습니다. 1. UI 에디터에서 버튼을 추가한 뒤 이름을 **SetColorBtn**으로 입력합니다. 2. **SetColorBtn**에 **TextComponent**를 추가하고 프로퍼티를 아래와 같이 수정합니다. | 컴포넌트 | 프로퍼티 | 값 | | :---: | :---: | :---: | | @c
[task] | code [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | self.myInfo.AvatarGUIRendererComponent 객체를 참조하여 특정 감정 타입과 지속 시간(3)을 인자로 전달해 PlayEmotion 메서드를 호출하는 클라이언트 전용 감정 재생 코드를 작성해줘. [answer] | `self.myInfo.AvatarGUIRendererComponent`를 참조하여 감정 표현을 재생하는 클라이언트 전용 코드는 다음과 같습니다. ```lua Method: [client only] void PlaySpecificEmotion() { self.myInfo.AvatarGUIRendererComponent:PlayEmotion(EmotionalType.Smile, 3) } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 감정 표현 변경 버튼을 누르면 UI에 보이는 아바타 감정 표현이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetEmotionBtn**으로 변경합니다. 3. **SetEmotionBtn - TextComponent - Text** 프로퍼티에 **SetEmotion**을 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetEmotio
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | TriggerBodyEntity.NameTagComponent.Name 을 직접 텍스트에 넣는 것과 로컬라이징 서비스를 통해 처리하는 것의 차이점은 무엇인가요? [answer] | `TriggerBodyEntity.NameTagComponent.Name`을 직접 텍스트에 넣는 것과 로컬라이징 서비스(`_LocalizationService`)를 통해 처리하는 것의 가장 큰 차이는 **문장의 구조와 문맥을 번역할 수 있는지 여부**입니다. **1. 직접 텍스트에 넣는 경우 (예: `npcName`만 사용)** * **방법**: 엔티티의 이름(`Name`)을 가져와서 단순히 UI에 표시하거나, 코드에서 문자열을 직접 연결(`..`)하여 사용합니다. * **한계**: "안녕, {이름}!"과 같은 문장 전체를 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 8. 이벤트 핸들러에 **TriggerEnterEvent**를 추가합니다. 실행 공간은 **client only**로 설정합니다. 그리고 아래와 같이 내용을 작성합니다. ```lua [client only][self] HandleTriggerEnterEvent(TriggerEnterEvent event) { -- Parameters local TriggerBodyEntity = event.TriggerBodyEntity -------------------
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 로컬라이징된 텍스트가 특정 언어 설정에서 정해진 포맷대로 출력되지 않을 때 먼저 확인해야 할 사항은 무엇인가요? [answer] | 로컬라이징된 텍스트가 특정 언어 설정에서 정해진 포맷대로 출력되지 않을 때, 먼저 확인해야 할 사항은 **`_LocalizationService:SmartFormat` 메서드에 전달되는 포맷 문자열과 변수의 매칭 여부**입니다. 참고 문서의 예제를 보면, 로컬라이징된 텍스트를 올바르게 출력하기 위해 다음 두 가지 방식을 사용할 수 있으며, 이 과정에서 포맷 지정이 올바르게 이루어졌는지 확인해야 합니다. 1. **키 기반 로컬라이징 (`GetTextFormat`)**: * `_LocalizationService:Get [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 8. 이벤트 핸들러에 **TriggerEnterEvent**를 추가합니다. 실행 공간은 **client only**로 설정합니다. 그리고 아래와 같이 내용을 작성합니다. ```lua [client only][self] HandleTriggerEnterEvent(TriggerEnterEvent event) { -- Parameters local TriggerBodyEntity = event.TriggerBodyEntity -------------------
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | OnBeginPlay() 에서 실행 공간을 client only 로 설정한 이유는 무엇이며, server only 로 설정하면 어떤 문제가 발생할까요? [answer] | `OnBeginPlay()` 함수에서 실행 공간을 `client only`로 설정한 이유는 **UI 요소(텍스트 상자)와 로컬라이징 데이터를 클라이언트에서만 직접 조작하고 표시하기 위해서**입니다. 메이플스토리 월드의 아키텍처에서 UI 컴포넌트(예: `TextComponent`)는 서버가 아니라 플레이어의 클라이언트에서 렌더링됩니다. 따라서 스크립트가 UI의 텍스트를 변경하거나, `_LocalizationService`를 통해 클라이언트 로컬에서 적절한 언어 설정(`CurrentLocaleId`)을 확인하여 텍스트를 포맷팅하려면, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetTextFormat()` 함수는 **LocalizationTable**에서 **Key**를 인수로 받습니다. 이 **Key**에 해당하는 텍스트를 찾고, 추가로 전달 받은 포맷 인수(format argument)가 있다면 그것을 형식에 맞게 채워 넣은 결과를 반환합니다. 예를 들어 아래와 같이 NPC 2명이 서 있고, 플레이어 캐릭터가 각 NPC와 만나면(충돌하면) 주황색 텍스트 상자에 **"안녕, NPCName!"**라는 문장을 출력해봅시다. 1. 맵에 NPC 2명을 배치하고 각 NPC 엔티티의 이름을 아래와 같이 수
[task] | single_turn [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | UI에서 아바타 파츠 색상을 변경하기 위해 SetAvatarPartColor()를 호출할 때, MapleAvatarItemCategory 상수 중 특정 카테고리만 선택하고 싶다면 parts 테이블과 인덱스 생성 로직을 어떻게 수정해야 하나요? [answer] | `MapleAvatarItemCategory` 상수 중 원하는 카테고리만 포함하도록 `parts` 테이블을 직접 수정하고, 해당 테이블의 실제 크기를 계산해 `RandomIntegerRange`의 범위로 사용하도록 하면 됩니다. 아래는 특정 카테고리(예: `Body`, `Cap`, `Hair`)만 랜덤하게 선택하도록 수정한 `SetPartColor()` 함수 예시입니다. ```lua [client only] void SetPartColor() { -- 원하는 카테고리만 선택 local parts = { [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 버튼을 누르면 UI에 보이는 아바타 파츠 색상 값이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetPartColorBtn**으로 변경합니다. 3. **SetPartColorBtn - TextComponent - Text** 프로퍼티에 **SetPartColor**를 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetPartColor()`
[task] | code [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | SetColorBtn, SetPartColorBtn, SetEmotionBtn 중 이름에 따라 ChangeUIAvatar 컴포넌트의 SetColor(), SetPartColor(), SetEmotion() 메서드를 각각 호출하도록 분기 처리하는 HandleButtonClickEvent 이벤트 핸들러가 포함된 TestUIBtn 스크립트를 작성해줘. [answer] | `TestUIBtn` 스크립트 컴포넌트에는 `HandleButtonClickEvent` 이벤트 핸들러만 포함됩니다. 버튼 이름(`Entity.Name`)에 따라 `self.changeUIAvatar`를 통해 `ChangeUIAvatar` 컴포넌트의 `SetColor()`, `SetPartColor()`, `SetEmotion()` 메서드를 호출하는 분기 처리 로직이 적용됩니다. ```lua Event Handler: [self] HandleButtonClickEvent(ButtonClickEvent event) { --Pa [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 감정 표현 변경 버튼을 누르면 UI에 보이는 아바타 감정 표현이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetEmotionBtn**으로 변경합니다. 3. **SetEmotionBtn - TextComponent - Text** 프로퍼티에 **SetEmotion**을 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetEmotio
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | SmartFormat()을 사용하여 NPC 이름이 포함된 인사말을 화면의 TextBox에 출력하는 스크립트 예시는 어떻게 작성하나요? [answer] | `SmartFormat()` 함수를 사용하면 로컬라이징 번역 테이블(Key) 없이도 포맷 문자열(`{0}`, `{1}` 등)을 직접 사용해 동적 텍스트를 생성할 수 있습니다. NPC 이름과 같은 변수를 특정 위치(`{0}`)에 채워 넣는 방식으로 동작합니다. 단, `SmartFormat()`은 번역 테이블을 사용하지 않기 때문에 클라이언트의 현재 언어 설정(`CurrentLocaleId`)에 따라 자동으로 언어가 바뀌지 않습니다. 따라서 각 언어별로 원하는 문자열을 직접 지정하여 분기 처리해야 합니다. 아래는 NPC 이름(`Na [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## SmartFormat `GetText()`나 `GetTextFormat()`은 번역 테이블을 필요로 합니다. 번역 테이블을 사용하지 않고 `GetTextFormat()`의 포맷 기능만 따로 이용하고 싶다면 `SmartFormat()` 함수를 사용합니다. `SmartFormat()`에서는 인수로 **LocalizationTable**의 **Key** 대신 출력할 문자열을 직접 받습니다. `SmartFormat()`를 사용해 위의 예제를 구현하면 아래와 같습니다. ```lua [client only][self] Handle
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 클라이언트 언어가 영어로 설정되어 있는데 SmartFormat()을 사용하면 왜 한국어 문장이 그대로 출력되는지, 그 원인과 해결 방법은 무엇인가요? [answer] | `SmartFormat()` 함수는 번역 테이블(LocalizationTable)을 사용하지 않고, 인수로 전달받은 문자열 포맷과 값을 결합해 결과를 만들어내는 기능만 제공합니다. 따라서 클라이언트 언어 설정이 영어(`en`)로 되어 있어도, `SmartFormat()`에 한국어 문자열(예: `"안녕, {0}!"`)을 직접 전달하면 번역 과정이 없으므로 한국어 문장이 그대로 출력됩니다. 이는 번역 테이블을 사용하는 `GetText()`나 `GetTextFormat()`과 달리, 개발자가 직접 전달한 문자열을 그대로 처리하기 때문입 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## SmartFormat `GetText()`나 `GetTextFormat()`은 번역 테이블을 필요로 합니다. 번역 테이블을 사용하지 않고 `GetTextFormat()`의 포맷 기능만 따로 이용하고 싶다면 `SmartFormat()` 함수를 사용합니다. `SmartFormat()`에서는 인수로 **LocalizationTable**의 **Key** 대신 출력할 문자열을 직접 받습니다. `SmartFormat()`를 사용해 위의 예제를 구현하면 아래와 같습니다. ```lua [client only][self] Handle
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | `formatterName`이 잘못되었을 때와 `formatterArgument` 수가 부족했을 때의 출력 결과를 각각 1문장씩 비교해서 설명하세요. [answer] | `formatterName`이 잘못되었을 때는 원문이 그대로 출력되며, `formatterArgument` 수가 부족했을 때는 상황에 따라 정상 출력되거나 원문이 그대로 출력됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 다음과 같이 포맷이 올바르지 않을 때는 원문 그대로 출력합니다. ##### formatterName이 틀린 경우 **formatterName**에 띄어쓰기가 포함되었거나, 오탈자가 있다면 원문이 그대로 출력됩니다. ```lua -- 1) 언어 설정 영어 : formatter name에 띄어쓰기가 포함된 경우 log(_LocalizationService:SmartFormat("I have {0: plural:an apple|{} apples}.", 2)) ``` ```lua -- 2) formatter name 자체가 틀린 경우
[task] | code [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | DefaultPlayer에 부착된 LocalizationTest 컴포넌트에서 Stan과 Rina 엔티티의 참조를 Property로 선언하고 OnBeginPlay에서 _LocalizationService:GetText로 이름 태그를 초기화하는 스크립트를 작성해줘 [answer] | 요청하신 `LocalizationTest` 컴포넌트 스크립트는 아래와 같이 작성할 수 있습니다. ```lua Property: [None] Entity Stan = /maps/map01/Stan [None] Entity Rina = /maps/map01/Rina Method: [client only] void OnBeginPlay() { self.Stan.NameTagComponent.Name = _LocalizationService:GetText("UI_TEXT_NPC_Stan") self.Rina.NameTag [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetTextFormat()` 함수는 **LocalizationTable**에서 **Key**를 인수로 받습니다. 이 **Key**에 해당하는 텍스트를 찾고, 추가로 전달 받은 포맷 인수(format argument)가 있다면 그것을 형식에 맞게 채워 넣은 결과를 반환합니다. 예를 들어 아래와 같이 NPC 2명이 서 있고, 플레이어 캐릭터가 각 NPC와 만나면(충돌하면) 주황색 텍스트 상자에 **"안녕, NPCName!"**라는 문장을 출력해봅시다. 1. 맵에 NPC 2명을 배치하고 각 NPC 엔티티의 이름을 아래와 같이 수
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 코드를 실행했을 때 hpp가 적용되지 않고 원문 그대로 출력될 때 확인해야 할 주요 원인은 무엇인가요? [answer] | 참고 문서에는 `hpp`가 적용되지 않고 원문 그대로 출력될 때의 구체적인 원인이나 troubleshooting(문제 해결) 절차에 대한 내용이 포함되어 있지 않습니다. 문서에 명시된 `hpp` 사용 방법은 `LocalizationTable`의 `ko` 열에 `{0:hpp:을|를}` 형식으로 작성하고, `_LocalizationService:GetTextFormat` 또는 `_LocalizationService:SmartFormat`을 호출하는 것뿐이며, 이 과정에서 오류가 발생하거나 적용되지 않을 경우의 원인에 대해서는 설명되어 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 한국어에서 조사는 체언(명사, 대명사, 수사) 뒤에 붙어 문법의 의미를 더하는 품사입니다. 체언의 받침 유무에 따라 뒤에 붙는 조사가 달라집니다. 예를 들어, **"나는 [ ]을/를 만납니다."** 라는 문장이 있다면 빈칸 [ ]에 들어갈 단어의 마지막 글자 종성 유무에 따라 조사 **'을'** 또는 **'를'**이 연결됩니다. | 빈칸에 들어갈 단어 | 조사 | 완성된 문장 | | :---: | :---: | :---: | | 스탄 | 을 | 나는 스탄을 만납니다. | | 리나 | 를 | 나는 리나를 만납니다. | 이러한
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 현재 사용자의 언어 설정에 따라 한국어와 영어 텍스트를 각각 다르게 출력하기 위해 이벤트 핸들러 내에서 어떤 프로세스를 거쳐야 하나요? [answer] | 사용자의 언어 설정에 따라 한국어와 영어 텍스트를 각각 다르게 출력하려면 이벤트 핸들러 내에서 다음과 같은 프로세스를 거쳐야 합니다. 1. **현재 로케일 ID 확인**: `_LocalizationService.CurrentLocaleId` 프로퍼티를 읽어 현재 사용자가 선택한 언어(예: `"ko"`, `"en"`)를 확인합니다. 2. **언어별 포맷된 텍스트 생성**: `_LocalizationService:SmartFormat()` 함수를 사용하여 각 언어에 맞는 문자열 포맷(예: `"안녕, {0}!"`, `"Hello, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## SmartFormat `GetText()`나 `GetTextFormat()`은 번역 테이블을 필요로 합니다. 번역 테이블을 사용하지 않고 `GetTextFormat()`의 포맷 기능만 따로 이용하고 싶다면 `SmartFormat()` 함수를 사용합니다. `SmartFormat()`에서는 인수로 **LocalizationTable**의 **Key** 대신 출력할 문자열을 직접 받습니다. `SmartFormat()`를 사용해 위의 예제를 구현하면 아래와 같습니다. ```lua [client only][self] Handle
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | LocalizationTable의 Key와 Source 열에서 hpp 문법을 잘못 작성했을 때 발생하는 오류나 비정상 동작은 어떤 형태로 나타납니까? [answer] | 제공된 참고 문서에는 `LocalizationTable`의 `Key`와 `Source` 열에서 `hpp` 문법을 잘못 작성했을 때 발생하는 구체적인 오류 메시지나 비정상 동작 형태에 대한 정보가 포함되어 있지 않습니다. 문서에는 `hpp`의 기본 형태(예: `{0:hpp:을|를}`)와 `LocalizationTable`에서 이를 사용하는 방법, 그리고 `SmartFormat` 또는 `GetTextFormat`을 통해 이를 렌더링하는 예제만 설명되어 있을 뿐, 잘못된 형식 입력 시의 오류 처리 방식은 명시되어 있지 않습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 한국어에서 조사는 체언(명사, 대명사, 수사) 뒤에 붙어 문법의 의미를 더하는 품사입니다. 체언의 받침 유무에 따라 뒤에 붙는 조사가 달라집니다. 예를 들어, **"나는 [ ]을/를 만납니다."** 라는 문장이 있다면 빈칸 [ ]에 들어갈 단어의 마지막 글자 종성 유무에 따라 조사 **'을'** 또는 **'를'**이 연결됩니다. | 빈칸에 들어갈 단어 | 조사 | 완성된 문장 | | :---: | :---: | :---: | | 스탄 | 을 | 나는 스탄을 만납니다. | | 리나 | 를 | 나는 리나를 만납니다. | 이러한
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | NPC 이름처럼 상황에 따라 바뀌는 동적 텍스트를 로컬라이징 시키기 위해 `GetTextFormat()`을 호출할 때 인자로 전달해야 할 값의 형식이 무엇인지 궁금합니다. [answer] | 참고 문서에 제공된 정보에 따르면, 동적 텍스트를 로컬라이징하기 위해 포맷 변환을 수행할 때 `GetTextFormat()` 함수를 직접 사용하는 예시나 이 함수가 특정 인자 형식을 요구한다는 명시적인 설명은 없습니다. 문서에서는 포맷에 맞게 변환할 때 **`GetTextFormat()`** 또는 **`SmartFormat()`** 함수를 활용한다고 언급하고 있으나, 실제 코드 예제와 상세 설명에서는 **`SmartFormat()`** 함수의 사용법만 구체적으로 제시하고 있습니다. 따라서 문서에 근거하여 `GetTextForma [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 로컬라이징을 할 때, 번역할 텍스트에 상황에 따라 변할 수 있는 문자열이 포함될 수도 있습니다. 이럴 때 활용할 수 있는 함수를 알아보고 예제를 통해 그 사용법을 살펴보도록 합시다. 본 과정을 진행하기 전에 [로컬라이징의 이해](/docs?postId=951) 가이드를 먼저 살펴보면 도움이 됩니다. # 포맷에 맞게 변환하기 번역할 텍스트에는 월드 상황에 따라 변할 수 있는 문자열이 포함될 수 있습니다. 예를 들어, 단순하게 한국어 **"리나"**를 영어 **"Rina"**로 번역하는 것이 아니라 **"안녕
[task] | two_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 로컬라이징 포맷에서 hpp를 이용해 한국어 조사(을/를 등)를 자동 처리하는 기본 원리와 LocalizationTable 설정 방법은 무엇인가요? [answer] | 한국어에서 조사는 앞의 체언(명사, 대명사, 수사)의 마지막 글자에 종성(받침)이 있는지 여부에 따라 달라집니다. 예를 들어, "나는 [ ]을/를 만납니다."라는 문장에서 빈칸에 들어갈 단어의 마지막 글자에 종성이 있으면 **'을'**, 없으면 **'를'**이 붙습니다. 이러한 규칙에 따라 조사를 자동으로 선택하고 적용하는 기능을 **hpp**라고 합니다. hpp 포맷은 LocalizationTable의 Source나 번역 컬럼에서 `{0:hpp:을|를}`과 같은 형태로 사용되며, 파이프(`|`) 기준으로 왼쪽은 종성이 있을 때, [followup] | hpp를 적용한 텍스트를 실제 게임 UI에 출력하기 위해 _LocalizationService:GetTextFormat 메서드를 이벤트 핸들러에서 어떻게 호출하는지 코드 예시를 보여주세요. [followup_answer] | hpp를 적용한 텍스트를 게임 UI에 출력하려면 `_LocalizationService:GetTextFormat` 메서드를 호출하여 포맷된 문자열을 얻은 후, 해당 텍스트를 표시할 UI 엔티티의 `TextComponent`에 할당하면 됩니다. 아래는 `TriggerEnterEvent` 이벤트 핸들러 내에서 NPC 이름을 가져와 hpp가 적용된 로컬라이징 키(`UI_TEXT_HELLO`)를 포맷하고, UI의 텍스트 박스에 출력하는 코드 예시입니다. ```lua [client only][self] HandleTriggerEnterE [scores] | [judge_reason] | [source_doc] | 한국어에서 조사는 체언(명사, 대명사, 수사) 뒤에 붙어 문법의 의미를 더하는 품사입니다. 체언의 받침 유무에 따라 뒤에 붙는 조사가 달라집니다. 예를 들어, **"나는 [ ]을/를 만납니다."** 라는 문장이 있다면 빈칸 [ ]에 들어갈 단어의 마지막 글자 종성 유무에 따라 조사 **'을'** 또는 **'를'**이 연결됩니다. | 빈칸에 들어갈 단어 | 조사 | 완성된 문장 | | :---: | :---: | :---: | | 스탄 | 을 | 나는 스탄을 만납니다. | | 리나 | 를 | 나는 리나를 만납니다. | 이러한
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | 중괄호 쌍이 맞지 않거나 인덱스가 건너뛴 경우의 동작 방식을 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua -- 중괄호 쌍이 맞지 않는 경우: 중괄호가 중첩되거나 포맷이 잘못되면 변환이 실패하여 원문이 그대로 출력됩니다. log(_LocalizationService:SmartFormat("I have {0:plural:an apple|{} apples}.", 2)) -- 인덱스를 건너뛰어 사용하는 경우: format argument의 인덱스를 건너뛰어도 정상적으로 출력됩니다. log(_LocalizationService:SmartFormat("I have {1:plural:an apple|{} apples}.", 0, 1) [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 다음과 같이 포맷이 올바르지 않을 때는 원문 그대로 출력합니다. ##### formatterName이 틀린 경우 **formatterName**에 띄어쓰기가 포함되었거나, 오탈자가 있다면 원문이 그대로 출력됩니다. ```lua -- 1) 언어 설정 영어 : formatter name에 띄어쓰기가 포함된 경우 log(_LocalizationService:SmartFormat("I have {0: plural:an apple|{} apples}.", 2)) ``` ```lua -- 2) formatter name 자체가 틀린 경우
[task] | single_turn [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | SetPartColorBtn을 클릭했을 때 색상이 변경되지 않고 콘솔에 오류가 발생한다면, ChangeUIAvatar 컴포넌트에서 myInfo 또는 AvatarGUIRendererComponent 참조가 제대로 연결되지 않았거나, 실행 공간 설정 오류가 원인일 수 있는데 구체적인 확인 방법을 알려주세요. [answer] | 제시된 참고 문서에는 `myInfo` 프로퍼티나 `AvatarGUIRendererComponent`의 연결 방식, 그리고 오류 발생 시 디버깅 절차나 콘솔 로그 확인 방법이 구체적으로 설명되어 있지 않습니다. 문서에서 확인 가능한 정보만으로는 `myInfo`가 어떻게 선언되고 초기화되는지(예: `Property` 블록 정의, `OnBeginPlay`에서의 할당 등) 알 수 없으므로, 참조가 제대로 연결되지 않았는지 확인하는 구체적인 코드나 절차는 제시할 수 없습니다. 다만, 문서에 명시된 **실행 공간 설정 오류**에 관해서는 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 버튼을 누르면 UI에 보이는 아바타 파츠 색상 값이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetPartColorBtn**으로 변경합니다. 3. **SetPartColorBtn - TextComponent - Text** 프로퍼티에 **SetPartColor**를 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetPartColor()`
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | SmartFormat() 함수와 GetTextFormat() 함수의 가장 큰 차이점은 무엇이며, 각각 언제 사용하는 것이 적절한가요? [answer] | `SmartFormat()`와 `GetTextFormat()`의 가장 큰 차이점은 **번역 테이블(Localization Table)의 필요 여부**입니다. * **`GetTextFormat()`**: 번역 테이블에 저장된 **Key**를 인수로 받아, 해당 Key에 매핑된 번역된 문장을 가져와 포맷팅합니다. 따라서 번역 테이블을 설정해 두어야 정상적으로 동작합니다. * **`SmartFormat()`**: 번역 테이블을 사용하지 않고, **출력할 문자열 자체를 직접** 인수로 받아 포맷팅 기능만 적용합니다. ### 적절 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ## SmartFormat `GetText()`나 `GetTextFormat()`은 번역 테이블을 필요로 합니다. 번역 테이블을 사용하지 않고 `GetTextFormat()`의 포맷 기능만 따로 이용하고 싶다면 `SmartFormat()` 함수를 사용합니다. `SmartFormat()`에서는 인수로 **LocalizationTable**의 **Key** 대신 출력할 문자열을 직접 받습니다. `SmartFormat()`를 사용해 위의 예제를 구현하면 아래와 같습니다. ```lua [client only][self] Handle
[task] | code [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | `TestUIBtn` 스크립트의 `HandleButtonClickEvent` 이벤트 핸들러에서 `event.Entity.Name`이 "SetPartColorBtn"인 경우를 판별하여 `self.changeUIAvatar:SetPartColor()`를 호출하도록 분기 로직을 추가하는 스크립트를 작성해줘. [answer] | `TestUIBtn` 스크립트의 `HandleButtonClickEvent` 이벤트 핸들러에서 `event.Entity.Name`이 "SetPartColorBtn"인 경우를 판별하여 `self.changeUIAvatar:SetPartColor()`를 호출하도록 분기 로직을 추가한 스크립트는 다음과 같습니다. ```lua Event Handler: [self] HandleButtonClickEvent(ButtonClickEvent event) { --Parameters local Entity = event.Entity [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 버튼을 누르면 UI에 보이는 아바타 파츠 색상 값이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetPartColorBtn**으로 변경합니다. 3. **SetPartColorBtn - TextComponent - Text** 프로퍼티에 **SetPartColor**를 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetPartColor()`
[task] | code [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | EmotionalType.Hit부터 EmotionalType.qBlue까지 23개의 감정 타입을 테이블로 정의하고 _UtilLogic:RandomIntegerRange(1, 23)으로 인덱스를 추출해 랜덤 감정을 반환하는 로직을 구현하는 SetEmotion 함수를 작성해줘. [answer] | 요청하신 `SetEmotion` 함수는 UI에 표시되는 아바타의 감정 표현을 랜덤하게 변경하는 로직을 포함합니다. 문서에 따르면, `ChangeUIAvatar` 스크립트 컴포넌트에 이 함수를 추가하고 실행 공간을 **client only**로 설정해야 합니다. 함수 내부에서는 23개의 `EmotionalType`을 가진 테이블을 정의하고, `_UtilLogic:RandomIntegerRange(1, 23)`을 통해 1부터 23 사이의 랜덤 정수를 인덱스로 추출합니다. 추출된 인덱스를 이용해 `self.myInfo.AvatarGUI [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### 감정 표현 변경 버튼을 누르면 UI에 보이는 아바타 감정 표현이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetEmotionBtn**으로 변경합니다. 3. **SetEmotionBtn - TextComponent - Text** 프로퍼티에 **SetEmotion**을 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetEmotio
[task] | code [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | LocalizationTable의 Key "UI_TEXT_HELLO"에 대응하는 로컬라이즈된 텍스트를 _LocalizationService:GetTextFormat으로 포맷팅하여 NPC의 NameTagComponent.Name에 설정하는 스크립트를 작성해줘 [answer] | `GetTextFormat()` 함수는 `LocalizationTable`의 `Key`를 인수로 받아 해당 텍스트를 찾고, 추가된 포맷 인수를 `{0}`과 같은 플레이스홀더에 채워 넣습니다. 요청하신 대로 `Key`가 `"UI_TEXT_HELLO"`인 텍스트(`"안녕, {0}!"`)를 NPC의 이름과 함께 포맷팅하여, 해당 NPC의 `NameTagComponent.Name`에 설정하는 스크립트는 다음과 같습니다. 이 스크립트는 NPC 엔티티에 직접 부착하여 사용하는 것을 가정하고 작성했습니다. (참고 문서의 예제 7번과 8번에서 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetTextFormat()` 함수는 **LocalizationTable**에서 **Key**를 인수로 받습니다. 이 **Key**에 해당하는 텍스트를 찾고, 추가로 전달 받은 포맷 인수(format argument)가 있다면 그것을 형식에 맞게 채워 넣은 결과를 반환합니다. 예를 들어 아래와 같이 NPC 2명이 서 있고, 플레이어 캐릭터가 각 NPC와 만나면(충돌하면) 주황색 텍스트 상자에 **"안녕, NPCName!"**라는 문장을 출력해봅시다. 1. 맵에 NPC 2명을 배치하고 각 NPC 엔티티의 이름을 아래와 같이 수
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | `SmartFormat`에서 `plural` 포맷터를 사용할 때 언어별 요구하는 `formatterArgument` 개수 차이를 표로 정리하세요. [answer] | `SmartFormat`의 `plural` 포맷터는 설정된 언어에 따라 요구하는 `formatterArgument` 개수가 다릅니다. 참고 문서에 따르면 한국어와 영어의 요구 조건은 다음과 같습니다. | 언어 설정 | 요구하는 `formatterArgument` 개수 | 비고 | | :--- | :--- | :--- | | 한국어 | 1개 | 1개만 전달해야 정상 변환됩니다. | | 영어 | 2개 | 2개를 전달해야 정상 변환됩니다. | **요구 개수 미충족 시 동작:** - 요구하는 개수보다 적게 전달하면 포맷 변환에 실패하여 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 다음과 같이 포맷이 올바르지 않을 때는 원문 그대로 출력합니다. ##### formatterName이 틀린 경우 **formatterName**에 띄어쓰기가 포함되었거나, 오탈자가 있다면 원문이 그대로 출력됩니다. ```lua -- 1) 언어 설정 영어 : formatter name에 띄어쓰기가 포함된 경우 log(_LocalizationService:SmartFormat("I have {0: plural:an apple|{} apples}.", 2)) ``` ```lua -- 2) formatter name 자체가 틀린 경우
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | formatter argument를 공백 문자열로 전달하면 로컬라이징 변환은 정상적으로 이루어지나요? [answer] | 네, formatter argument를 공백 문자열로 전달하면 로컬라이징 변환은 정상적으로 이루어집니다. 참고 문서의 예시에 따르면, 영어 환경에서 `plural` 포맷터를 사용할 때 빈 문자열(`""`)을 formatter argument로 사용하는 경우(예: `log(_LocalizationService:SmartFormat("I have {0:plural:|}.", 1))`)에는 정상적으로 출력됩니다. 이는 빈 문자열이 유효한 formatter argument로 처리되기 때문입니다. 따라서 특정 언어의 포맷 규약(예: 영 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 다음과 같이 포맷이 올바르지 않을 때는 원문 그대로 출력합니다. ##### formatterName이 틀린 경우 **formatterName**에 띄어쓰기가 포함되었거나, 오탈자가 있다면 원문이 그대로 출력됩니다. ```lua -- 1) 언어 설정 영어 : formatter name에 띄어쓰기가 포함된 경우 log(_LocalizationService:SmartFormat("I have {0: plural:an apple|{} apples}.", 2)) ``` ```lua -- 2) formatter name 자체가 틀린 경우
[task] | single_turn [pass] | ⏳ 미판정 [title] | 아바타를 UI에서 표현하기 [question] | SetPartColor() 함수에서 사용된 _UtilLogic:RandomDouble()과 _UtilLogic:RandomIntegerRange() 메서드를 통해 생성된 RGBA 값과 인덱스가 각각 어떤 역할을 하며, parts 테이블의 길이가 18인 이유를 설명해 주세요. [answer] | `SetPartColor()` 함수 내에서 `_UtilLogic:RandomDouble()`과 `_UtilLogic:RandomIntegerRange()`가 생성한 값들은 UI에 표시되는 아바타의 특정 파츠 색상을 랜덤하게 변경하기 위해 사용됩니다. **1. RGBA 값과 인덱스의 역할** * **RGBA 값 (r, g, b, a):** * `_UtilLogic:RandomDouble()`을 4번 호출하여 `r`, `g`, `b`, `a` 변수에 각각 0에서 1 사이의 실수 값을 생성합니다. * 이 네 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 버튼을 누르면 UI에 보이는 아바타 파츠 색상 값이 랜덤하게 변경되는 예제입니다. 1. **SetColorBtn** 버튼의 콘텍스트 메뉴에서 **Duplicate**를 클릭해 복제합니다. 2. 버튼의 위치를 적당히 옮기고 이름을 **SetPartColorBtn**으로 변경합니다. 3. **SetPartColorBtn - TextComponent - Text** 프로퍼티에 **SetPartColor**를 입력합니다. 4. **ChangeUIAvatar** 스크립트 컴포넌트에 `SetPartColor()`
[task] | single_turn [pass] | ⏳ 미판정 [title] | 포맷에 맞게 로컬라이징하기 [question] | hpp를 사용할 때 조사의 선택 기준이 무엇이며, LocalizationTable에서 어떻게 표기해야 하는가요? [answer] | hpp를 사용할 때 조사의 선택 기준은 앞의 체언(명사, 대명사 등)의 마지막 글자에 **종성(받침)이 있는가 없는가**입니다. 1. **종성이 있는 경우**: `은`, `이`, `을`, `과`, `아`, `이여`, `이랑`, `으로` 2. **종성이 없는 경우**: `는`, `가`, `를`, `와`, `야`, `여`, `랑`, `로` `LocalizationTable`에서 이를 표기하는 방법은 `{0:hpp:종성있을때조사\|종성없는조사}` 형식을 사용하는 것입니다. 여기서 `\|` (백슬래시 파이프) 앞에는 종성이 있을 때 사 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 한국어에서 조사는 체언(명사, 대명사, 수사) 뒤에 붙어 문법의 의미를 더하는 품사입니다. 체언의 받침 유무에 따라 뒤에 붙는 조사가 달라집니다. 예를 들어, **"나는 [ ]을/를 만납니다."** 라는 문장이 있다면 빈칸 [ ]에 들어갈 단어의 마지막 글자 종성 유무에 따라 조사 **'을'** 또는 **'를'**이 연결됩니다. | 빈칸에 들어갈 단어 | 조사 | 완성된 문장 | | :---: | :---: | :---: | | 스탄 | 을 | 나는 스탄을 만납니다. | | 리나 | 를 | 나는 리나를 만납니다. | 이러한