[task] | two_turn [pass] | ⏳ 미판정 [title] | TargetUserSync와 프로퍼티 동기화 최적화 [question] | 개인 재화나 업적 같은 데이터 관리 시 TargetUserSync를 사용해야 하는 이유는 무엇인가요? [answer] | TargetUserSync를 개인 재화나 업적 같은 데이터 관리에 사용해야 하는 이유는 **불필요한 네트워크 트래픽과 클라이언트 연산 낭비를 방지하여 최적화**하기 위해서입니다. 구체적인 이유는 다음과 같습니다. 1. **동기화 대상의 최소화**: * 일반적인 `[Sync]` 프로퍼티는 서버에서 값이 변경되면 해당 엔티티가 있는 맵에 있는 **모든 유저**에게 값을 동기화합니다. * 반면 `[TargetUserSync]`는 프로퍼티 값이 변경된 플레이어 엔티티를 **직접 조작할 수 있는 유저(본인)에게만* [followup] | Sync 프로퍼티를 사용할 경우 발생하는 패킷 낭비 문제를 방지하기 위해 TargetUserSync를 적용한 컴포넌트 스크립트 구조는 어떻게 되어야 하나요? [followup_answer] | 패킷 낭비를 방지하기 위해 TargetUserSync를 적용할 때 컴포넌트 스크립트는 다음 조건과 구조를 반드시 충족해야 합니다. ### 1. 필수 적용 조건 1. **대상 Entity 제한**: TargetUserSync 프로퍼티는 반드시 **플레이어가 직접 조작하는 `PlayerEntity`**에 포함된 컴포넌트에서만 사용해야 합니다. - `PlayerEntity`가 아닌 다른 Entity(예: NPC, 몬스터, 아이템 등)의 컴포넌트에 적용하면 정상적으로 동작하지 않으며, `[None]` 프로퍼티와 동일하게 동작합니다( [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 프로퍼티 동기화 방식 중 하나인 TargetUserSync에 대해 알아봅니다. ##### 참고 가이드 * [프로퍼티](/docs/?postId=205) * [프로퍼티 동기화](/docs/?postId=208) * [서버와 클라이언트](/docs/?postId=207) # TargetUserSync 알아보기 TargetUserSync는 Sync 프로퍼티 동기화를 좀 더 특정해 최적화하는 방식입니다. TargetUserSync는 플레이어가 스스로 조작하는 PlayerEntity에 포함된 컴포넌트의 프로퍼티만을
[task] | single_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | 비공개 상태의 월드에서 월드 인스턴스 워프가 작동하지 않는 이유는 무엇이며, 테스트를 위해선 어떤 조건을 충족해야 하나요? [answer] | 월드 인스턴스 워프는 **공개 상태로 출시된 월드**에서만 작동합니다. 비공개 상태의 월드에서는 월드 인스턴스 워프 기능이 지원되지 않기 때문에 실행할 수 없습니다. 따라서 테스트를 하려면 다음 두 가지 조건을 모두 충족해야 합니다. 1. 월드를 **공개 상태로 출시**해야 합니다. 2. 출시된 월드 환경에서 테스트를 수행해야 합니다. (제작 중인 상황에서는 테스트가 불가능합니다.) [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TeleportService**의 `WarpUserToWorldInstanceAndWait()`, `WorldUserToWorldInstanceAsync()` 함수를 활용해 유저를 다른 월드 인스턴스로 워프시킬 수 있습니다. 플레이어를 워프시키기 위해선 워프시킬 유저의 **UserId**와 워프할 월드 인스턴스의 **WorldInstanceId**가 필요합니다. 플레이어가 워프를 시도하는 시점의 최신 월드 인스턴스들의 정보를 조회해 다른 월드 인스턴스로 이동할 수 있습니다. 이동 시 필요한 최신 WorldInstanceIn
[task] | single_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | 워프 시도 대상 월드 인스턴스의 정원이 차 있거나 은퇴 준비 상태일 경우, 플레이어에게 어떤 결과가 발생하며 다시 원래 인스턴스로 복귀할 수 있나요? [answer] | 워프 시도 대상 월드 인스턴스의 정원이 모두 차 있거나 은퇴 준비 상태 등 워프가 불가능한 상태로 인해 워프에 실패할 경우, 플레이어에게는 실패 메시지 화면이 표시되며 월드의 로비 화면으로 돌아갑니다. 이러한 실패 상황에서는 워프를 시도했던 원래 월드 인스턴스로는 복귀할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TeleportService**의 `WarpUserToWorldInstanceAndWait()`, `WorldUserToWorldInstanceAsync()` 함수를 활용해 유저를 다른 월드 인스턴스로 워프시킬 수 있습니다. 플레이어를 워프시키기 위해선 워프시킬 유저의 **UserId**와 워프할 월드 인스턴스의 **WorldInstanceId**가 필요합니다. 플레이어가 워프를 시도하는 시점의 최신 월드 인스턴스들의 정보를 조회해 다른 월드 인스턴스로 이동할 수 있습니다. 이동 시 필요한 최신 WorldInstanceIn
[task] | code [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | `UIInventoryItemSlot` 컴포넌트에 `SlotIndex`, `ItemId`, `ItemCount` 프로퍼티를 정의하고, `SetData` 호출 시 인자 검증 실패 시 `log_error`를 출력하는 스크립트를 작성해줘 [answer] | `UIInventoryItemSlot` 컴포넌트에는 `SlotIndex`, `ItemId`, `ItemCount` 프로퍼티를 정의하고, `SetData` 함수에서 `_Data.ItemTable`을 통해 아이템 정보를 조회한 후 오류가 발생하면 `log_error`로 메시지를 출력하는 로직을 구현해야 합니다. ```lua Property: [None] integer SlotIndex = 0 [None] string ItemId = "" [None] integer ItemCount = 0 Method: [client only] vo [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | UIInventoryItemSlot 컴포넌트 내용을 변경해 UI 인벤토리에서 아이템 섬네일과 개수를 표시할 수 있도록 아래와 같이 작성합니다. 중간 확인을 위해 인벤토리에서 아이템을 누르면 삭제되도록 만들어봅시다. # UIInventoryItemSlot 수정 1. **UIItemSlot** 컴포넌트의 이름을 `UIInventoryItemSlot` 로 변경합니다. >**Tip.** > **ui - DefaultGroup - Inventory - InventoryPanel - Inventory_ScrollView
[task] | single_turn [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | SimpleInventory 컴포넌트에서 RemoveItemAt() 메서드를 server only로 설정해야 하는 이유와, 이 설정을 client로 잘못 변경했을 때 발생하는 동기화 문제나 데이터 불일치 현상을 비교해 주세요. [answer] | 제시된 참고 문서에는 `SimpleInventory` 컴포넌트의 `RemoveItemAt()` 함수 실행공간을 **server**로 임시 변경하는 방법을 안내하고 있으며, 이를 통해 인벤토리 슬롯 클릭 시 아이템 삭제가 정상적으로 작동하는지 확인하는 절차가 포함되어 있습니다. 하지만 문서에는 다음과 같은 정보들이 포함되어 있지 않습니다. 1. `RemoveItemAt()` 메서드를 `server only`로 설정해야 하는 구체적인 기술적 이유 (예: 데이터 무결성, 보안 등). 2. 이 설정을 `client`로 잘못 변경했을 때 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 지금까지 만든 인벤토리가 정상적으로 작동하는지 확인해봅시다. 임의의 데이터를 추가해 인벤토리의 슬롯을 눌러 지울 수 있는지 확인합니다. 정상적으로 작동하는 것을 확인했으면 확인용을 추가한 코드와 설정을 다시 변경합니다. 1. `UIInventoryItemSlot` 컴포넌트의 Event Handler에 `ButtonClickEvent` 내용을 수정합니다. ```lua [self] HandleButtonClickEvent (ButtonClickEvent event) { -- Parame
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 02_Player_Logic [question] | MapEnterLogic의 Property 중 Entity 타입의 이름과 해당 경로를 5행으로만 표로 정리하세요. [answer] | | 이름 | 경로 | | :--- | :--- | | loadingUI | /ui/000_LoadingGroup | | lobbyUI | /ui/001_LobbyGroup | | introUI | /ui/002_IntroGroup | | ingameUI | /ui/003_InGameGroup | | outroUI | /ui/004/004_OutroGroup | [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # MapEnterLogic 플레이어가 맵을 이동하는 경우 호출하는 함수들을 모아둔 로직입니다. OnMapEnter 함수에서 해당 로직에 있는 함수들 중 이동한 맵에 맞는 함수를 호출합니다. #### Property | 실행제어 | 타입 | 이름 | 설명 | | --- | --- | --- | --- | | None | Entity (/ui/000_LoadingGroup) | loadingUI | 로딩 화면 UI입니다. | | None |Entity (/ui/001_LobbyGroup) | lobbyUI | 로비 그룹 UI
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 02_Player_Logic [question] | IntroMapEnter 함수의 실행 공간과 inPlayerNum 값 변경 동작을 코드만 출력하고 설명은 주석으로 작성하세요. [answer] | ```lua Property: [None] number inPlayerNum = 0 Method: [server only] void IntroMapEnter() { -- 이동한 맵이 인트로 맵인 경우, 플레이어가 인트로 맵에 접속했음을 체크하기 위해 inPlayerNum 값을 1 증가시킵니다. self.inPlayerNum = self.inPlayerNum + 1 } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # MapEnterLogic 플레이어가 맵을 이동하는 경우 호출하는 함수들을 모아둔 로직입니다. OnMapEnter 함수에서 해당 로직에 있는 함수들 중 이동한 맵에 맞는 함수를 호출합니다. #### Property | 실행제어 | 타입 | 이름 | 설명 | | --- | --- | --- | --- | | None | Entity (/ui/000_LoadingGroup) | loadingUI | 로딩 화면 UI입니다. | | None |Entity (/ui/001_LobbyGroup) | lobbyUI | 로비 그룹 UI
[task] | single_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | WarpUserToWorldAndWait 와 WarpUserToWorldInstanceAndWait 중 유저 데이터를 함께 전달해야 할 때 어떤 함수를 사용해야 하나요? [answer] | 유저 데이터를 함께 전달해야 할 때는 `WarpUserToWorldAndWait`를 사용해야 합니다. 참고 문서에 따르면, 다른 월드 인스턴스로 워프할 때 유저가 지금까지 쌓아온 데이터를 함께 전달하려면 `WarpUserToWorldAndWait`를 활용하며, 전달받은 데이터는 `GetWarpRecord()`로 접근해 얻어올 수 있습니다. 반면, 제공된 예시 코드에서 `WarpUserToWorldInstanceAndWait`는 `serializedData`를 전달하는 형태이지만, 문서 본문에서 데이터 전달과 `GetWarpRec [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TeleportService**의 `WarpUserToWorldInstanceAndWait()`, `WorldUserToWorldInstanceAsync()` 함수를 활용해 유저를 다른 월드 인스턴스로 워프시킬 수 있습니다. 플레이어를 워프시키기 위해선 워프시킬 유저의 **UserId**와 워프할 월드 인스턴스의 **WorldInstanceId**가 필요합니다. 플레이어가 워프를 시도하는 시점의 최신 월드 인스턴스들의 정보를 조회해 다른 월드 인스턴스로 이동할 수 있습니다. 이동 시 필요한 최신 WorldInstanceIn
[task] | single_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | GetWorldInstanceInfoPagesAndWait 함수를 통해 조회한 정보 중, 실제로 유저를 이동시킬 수 있는 월드 인스턴스의 범위는 어디까지인가요? [answer] | 유저를 이동시킬 수 있는 월드 인스턴스의 범위는 **유저가 현재 접속한 월드(제1 월드) 내에서만** 가능합니다. `GetWorldInstanceInfoPagesAndWait()`를 통해 최신 월드 인스턴스 정보를 조회하더라도, 다른 월드(제2, 제3의 월드)로 즉시 이동할 수 있는 것이 아니라 현재 접속한 월드의 다른 인스턴스로만 워프가 이루어집니다. 참고로, `WarpUserToWorldAndWait`나 `WarpUserToWorldAsync`는 월드 ID(WorldId)를 기반으로 다른 제2, 제3의 월드로 이동하는 함수이 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | **TeleportService**의 `WarpUserToWorldInstanceAndWait()`, `WorldUserToWorldInstanceAsync()` 함수를 활용해 유저를 다른 월드 인스턴스로 워프시킬 수 있습니다. 플레이어를 워프시키기 위해선 워프시킬 유저의 **UserId**와 워프할 월드 인스턴스의 **WorldInstanceId**가 필요합니다. 플레이어가 워프를 시도하는 시점의 최신 월드 인스턴스들의 정보를 조회해 다른 월드 인스턴스로 이동할 수 있습니다. 이동 시 필요한 최신 WorldInstanceIn
[task] | code [pass] | ⏳ 미판정 [title] | TargetUserSync와 프로퍼티 동기화 최적화 [question] | OnSyncProperty 이벤트 핸들러를 사용하여 TargetUserSync 프로퍼티인 meso의 값이 변경되는 시점을 감지하고 로그를 출력하는 스크립트를 작성해줘 [answer] | OnSyncProperty 이벤트 핸들러는 프로퍼티의 값이 동기화되는 시점을 감지하는 데 사용됩니다. 하지만 참고 문서를 확인한 결과, mLua에서 TargetUserSync 프로퍼티의 변경을 감지하기 위해 OnSyncProperty 이벤트 핸들러를 직접 사용할 수 있는지 여부에 대한 구체적인 문법이나 예제가 제공되지 않았습니다. 문서에는 "Sync 프로퍼티와 마찬가지로 OnSyncProperty를 통해 TargetUserSync가 변화되는 시점을 확인할 수 있습니다"라고 언급되어 있지만, 해당 이벤트 핸들러의 정확한 선언 형식, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 프로퍼티 동기화 방식 중 하나인 TargetUserSync에 대해 알아봅니다. ##### 참고 가이드 * [프로퍼티](/docs/?postId=205) * [프로퍼티 동기화](/docs/?postId=208) * [서버와 클라이언트](/docs/?postId=207) # TargetUserSync 알아보기 TargetUserSync는 Sync 프로퍼티 동기화를 좀 더 특정해 최적화하는 방식입니다. TargetUserSync는 플레이어가 스스로 조작하는 PlayerEntity에 포함된 컴포넌트의 프로퍼티만을
[task] | code [pass] | ⏳ 미판정 [title] | TargetUserSync와 프로퍼티 동기화 최적화 [question] | PlayerEntity에 적용되어 있지 않은 일반 Entity 컴포넌트에서 TargetUserSync 프로퍼티를 사용했을 때 None과 동일하게 동작하는지 확인하기 위한 테스트용 스크립트를 작성해줘 [answer] | TargetUserSync는 PlayerEntity에 포함된 컴포넌트의 프로퍼티에서만 정상적으로 동기화되며, PlayerEntity가 아닌 다른 일반 Entity의 컴포넌트에서 사용할 경우 동기화되지 않고 `[None]` 프로퍼티와 동일하게 동작합니다. 이 동작을 확인하기 위해 일반 Entity에 적용되는 테스트용 스크립트는 다음과 같습니다. ```lua Property: [TargetUserSync] number TestValue = 0 Method: [server only] void OnBeginPlay() { lo [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 프로퍼티 동기화 방식 중 하나인 TargetUserSync에 대해 알아봅니다. ##### 참고 가이드 * [프로퍼티](/docs/?postId=205) * [프로퍼티 동기화](/docs/?postId=208) * [서버와 클라이언트](/docs/?postId=207) # TargetUserSync 알아보기 TargetUserSync는 Sync 프로퍼티 동기화를 좀 더 특정해 최적화하는 방식입니다. TargetUserSync는 플레이어가 스스로 조작하는 PlayerEntity에 포함된 컴포넌트의 프로퍼티만을
[task] | code [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | `UIInventoryItemSlot` 컴포넌트의 `SetData`와 `Clear` 메서드를 구현하여 `_Data.ItemTable`에서 아이콘과 개수를 설정하고, 슬롯 인덱스 및 아이템 ID를 저장하는 스크립트를 작성해줘 [answer] | `UIInventoryItemSlot` 컴포넌트에는 `SlotIndex`, `ItemId`, `ItemCount` 프로퍼티를 정의하고, `_Data.ItemTable`에서 아이템 정보를 조회하여 UI에 반영하는 `SetData`와 UI를 초기화하는 `Clear` 메서드를 구현해야 합니다. 아래는 요청하신 요구사항을 만족하는 mLua 스크립트입니다. ```lua Property: [None] integer SlotIndex = 0 [None] string ItemId = "" [None] integer ItemCount = 0 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | UIInventoryItemSlot 컴포넌트 내용을 변경해 UI 인벤토리에서 아이템 섬네일과 개수를 표시할 수 있도록 아래와 같이 작성합니다. 중간 확인을 위해 인벤토리에서 아이템을 누르면 삭제되도록 만들어봅시다. # UIInventoryItemSlot 수정 1. **UIItemSlot** 컴포넌트의 이름을 `UIInventoryItemSlot` 로 변경합니다. >**Tip.** > **ui - DefaultGroup - Inventory - InventoryPanel - Inventory_ScrollView
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | 문서에 포함된 두 예제 코드의 `while true do` 루프 내에서 페이지 이동 및 종료 처리 로직을 표로 정리하세요. [answer] | 참고 문서에 포함된 두 예제(`GetWorldInstanceInfoPagesAndWait`와 `GetWorldInstanceInfoPagesAsync`)의 `while true do` 루프 내 페이지 이동 및 종료 처리 로직은 동일하며, 다음 표와 같이 정리할 수 있습니다. | 순서 | 처리 내용 | 사용된 API/속성 | 비고 | | :--- | :--- | :--- | :--- | | 1 | 현재 페이지 데이터 조회 | `pages:GetCurrentPageDatas()` | 반환된 `datas` 테이블에 대한 반복 처리를 수 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `GetWorldInstanceInfoPagesAndWait()` 함수를 활용해 월드 인스턴스 정보를 페이지 단위로 조회하는 예제입니다. ```lua local result, pages = _WorldInstanceService:GetWorldInstanceInfoPagesAndWait() while true do --GetCurrentPageDatas()로 현재 페이지의 목록을 가져올 수 있습니다. local datas = pages:GetCurrentPageDatas()
[task] | code [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | `UIInventoryItemSlot` 컴포넌트의 `Clear` 메서드를 구현하여 기본 이미지 RUID를 복원하고, `TextComponent.Text`를 nil로 설정하며 개수 표시를 비활성화하는 스크립트를 작성해줘 [answer] | `UIInventoryItemSlot` 컴포넌트의 `Clear` 메서드는 인벤토리 슬롯에 아이템이 없을 때 호출되어 슬롯의 시각적 요소를 초기 상태로 되돌립니다. 구체적으로 수행하는 동작은 다음과 같습니다. 1. `img_slot` 자식 엔티티의 `SpriteGUIRendererComponent.ImageRUID`를 기본 이미지 RUID(`"129f02486c2baef49a41b31ce16171f6"`)로 설정하여 아이콘을 비웁니다. 2. `item_count` 자식 엔티티의 `TextComponent.Text`를 `nil`로 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | UIInventoryItemSlot 컴포넌트 내용을 변경해 UI 인벤토리에서 아이템 섬네일과 개수를 표시할 수 있도록 아래와 같이 작성합니다. 중간 확인을 위해 인벤토리에서 아이템을 누르면 삭제되도록 만들어봅시다. # UIInventoryItemSlot 수정 1. **UIItemSlot** 컴포넌트의 이름을 `UIInventoryItemSlot` 로 변경합니다. >**Tip.** > **ui - DefaultGroup - Inventory - InventoryPanel - Inventory_ScrollView
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 03_Player_Emoticon [question] | SpawnEmoticon 함수가 return 되는 조건을 2개 항목의 목록으로 나열해 주세요. [answer] | `SpawnEmoticon` 함수가 return 되는 조건은 다음과 같습니다. 1. 현재 감정 표현이 이미 재생 중일 때 2. 플레이어가 존재하지 않을 때 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # EmoticonData 플레이어가 사용하는 감정표현과 관련된 데이터를 관리하는 테이블입니다. | 이름 | 설명 | | --- | --- | | Key | 감정 표현을 호출하는 키 값으로, 해당 값을 KeyboardKey로 변환해 사용합니다. | | RUID | 감정 표현의 RUID 값입니다.| | Scale | RUID 마다 크기 값이 다르므로, 과하게 크거나 작은 이미지를 조절하기 위한 값입니다. | | PivotY | RUID 마다 피벗 또한 다르므로, y축 위치를 조절하기 위한 값입니다. | | Explain | 해
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 02_Player_Logic [question] | `RankUpdate` 함수가 랭킹 데이터를 처리할 때 적용하는 정렬 기준과 대상 데이터를 3문장 이내로 요약하세요. [answer] | `RankUpdate` 함수는 저장된 랭킹 DB 데이터를 불러와 처리합니다. 이 과정에서 DB의 점수 값을 기준으로 내림차순 정렬을 수행합니다. 정렬이 완료된 데이터를 바탕으로 랭킹 UI를 갱신합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 실행제어 | 타입 | 이름 | 설명 | | --- | --- | --- | --- | | server only | void | GetMoneyData | DB에서 플레이어의 재화를 가져오는 함수입니다. 가져온 재화값으로 가져오는 함수입니다. UI정보를 가져온 재화값으로 갱신합니다. | | server only | void | SetMoneyData | DB에서 플레이어의 재화를 가져와 매개변수 `addMoney`를 적용해 다시 데이터를 저장하는 합수입니다. UI 정보를 함께 갱신합니다. | | server only | void
[task] | code [pass] | ⏳ 미판정 [title] | TargetUserSync와 프로퍼티 동기화 최적화 [question] | Sync 프로퍼티와 TargetUserSync 프로퍼티를 함께 사용하여, 모든 유저에게 공개되는 상태와 개인만 보는 데이터를 각각 관리하는 PlayerEntity용 스크립트를 작성해줘 [answer] | Sync 프로퍼티와 TargetUserSync 프로퍼티는 하나의 컴포넌트 내에서 함께 사용할 수 있습니다. 아래 예제는 `PlayerEntity`에 적용되는 스크립트이며, 모든 유저에게 공개되는 상태(`Sync`)와 조작하는 유저만 보는 개인 데이터(`TargetUserSync`)를 분리하여 관리하는 구조입니다. ```lua Property: [Sync] number Health = 100 [Sync] boolean IsDefeated = false [TargetUserSync] integer Meso = 0 [TargetUse [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 프로퍼티 동기화 방식 중 하나인 TargetUserSync에 대해 알아봅니다. ##### 참고 가이드 * [프로퍼티](/docs/?postId=205) * [프로퍼티 동기화](/docs/?postId=208) * [서버와 클라이언트](/docs/?postId=207) # TargetUserSync 알아보기 TargetUserSync는 Sync 프로퍼티 동기화를 좀 더 특정해 최적화하는 방식입니다. TargetUserSync는 플레이어가 스스로 조작하는 PlayerEntity에 포함된 컴포넌트의 프로퍼티만을
[task] | two_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | 현재 월드 인스턴스의 Id를 확인하고 다른 인스턴스로 워프하는 기본 원리가 궁금합니다 [answer] | 현재 월드 인스턴스의 Id를 확인하고 다른 인스턴스로 워프하는 과정은 `WorldInstanceService`와 `TeleportService`를 조합하여 처리합니다. ### 1. 현재 월드 인스턴스 Id 확인 현재 접속한 월드 인스턴스의 고유 식별자인 `WorldInstanceId`를 가져오는 가장 직접적인 방법은 `WorldInstanceService`의 `WorldInstanceId` 프로퍼티를 참조하는 것입니다. ```lua [server only] void OnBeginPlay() { -- 현재 월드 인스턴스의 [followup] | `WorldInstanceService`의 `WorldInstanceId` 프로퍼티와 `TeleportService`를 조합하여 다른 인스턴스로 이동하는 코드를 작성해 주세요 [followup_answer] | 제공된 참고 문서에는 `WorldInstanceService`의 `WorldInstanceId` 프로퍼티 사용법과 `WorldInstanceInfoPages`를 이용한 인스턴스 목록 조회 방법은 자세히 설명되어 있습니다. 그러나 **`TeleportService`의 구체적인 메서드 이름(예: `TeleportToInstance` 등)과 인자 시그니처는 제공된 문서 내에 명시되어 있지 않습니다.** 문서에는 `TeleportService`를 통해 플레이어를 특정 월드 인스턴스로 워프시킬 수 있다는 원리와 API Reference 링 [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `WorldInstanceService`를 활용해 현재 월드 인스턴스Id와 생성된 다른 월드 인스턴스들의 상태를 알 수 있습니다. 또한 `TeleportService`를 활용해 플레이어를 특정 월드 인스턴스로 워프시킬 수 있습니다. ##### 참고 가이드 [월드 인스턴스](/docs/?postId=984) [월드 인스턴스 통신](d/ocs/?postId=999) [월드 워프하기](/docs/?postId=743) ##### 참고 APIReference [TeleportService](/apiReference?
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 03_Player_Emoticon [question] | PlayerEmotionOn 프로퍼티의 타입과 key, value 값의 의미를 3문장 이내로 설명해 주세요. [answer] | PlayerEmotionOn 프로퍼티의 타입은 SyncTable<string, boolean>입니다. key 값에는 플레이어의 ID가, value 값에는 해당 플레이어가 현재 감정표현을 사용 중인지 여부를 나타내는 true/false 값이 들어갑니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # EmoticonData 플레이어가 사용하는 감정표현과 관련된 데이터를 관리하는 테이블입니다. | 이름 | 설명 | | --- | --- | | Key | 감정 표현을 호출하는 키 값으로, 해당 값을 KeyboardKey로 변환해 사용합니다. | | RUID | 감정 표현의 RUID 값입니다.| | Scale | RUID 마다 크기 값이 다르므로, 과하게 크거나 작은 이미지를 조절하기 위한 값입니다. | | PivotY | RUID 마다 피벗 또한 다르므로, y축 위치를 조절하기 위한 값입니다. | | Explain | 해
[task] | code [pass] | ⏳ 미판정 [title] | TargetUserSync와 프로퍼티 동기화 최적화 [question] | 메소(meso) 프로퍼티를 [TargetUserSync]로 설정하고, 서버에서 IncreaseMeso()를 호출할 때 해당 플레이어의 조작 제어권을 가진 클라이언트에만 값이 동기화되도록 하는 스크립트를 작성해줘 [answer] | 메소(meso) 프로퍼티에 `[TargetUserSync]` 속성을 적용하면, 서버에서 해당 엔티티의 메서드를 호출했을 때 조작 제어권이 있는 클라이언트에만 값이 동기화됩니다. 다른 클라이언트에서는 변경 사항이 반영되지 않으며, `[None]` 속성을 사용한 것과 동일하게 동작합니다. 요구사항에 맞는 mLua 스크립트는 다음과 같습니다. ```lua Property: [TargetUserSync] integer meso = 0 Method: [server only] void IncreaseMeso() { self.meso + [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | meso 프로퍼티를 TargetUserSync로 변경한 뒤 서버에서 PlayerEntity A의 `IncreaseMeso()`를 호출하면, PlayerEntity A의 조작 제어권이 있는 Client A에만 meso 값이 동기화됩니다. Client B의 PlayerEntity A에는 변경이 일어나지 않는, None과 동일하게 처리됩니다. ```lua Property: [TargetUserSync] integer meso = 0 Method: [server only] void IncreaseMeso() { self.meso +
[task] | single_turn [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | 테스트를 위해 OnBeginPlay()에 임의의 아이템 추가 코드를 넣은 후 정상 동작을 확인했는데, 이 코드를 삭제하지 않고 실제 운영 환경으로 배포했을 때 발생할 수 있는 인벤토리 데이터 오류의 원인은 무엇인가요? [answer] | `OnBeginPlay()` 함수 내부에 `self:AddItem()` 호출을 통해 임의의 아이템 데이터를 직접 추가하는 코드를 운영 환경에 남겼을 때, 다음과 같은 인벤토리 데이터 오류가 발생할 수 있습니다. 1. **중복 데이터 생성 및 상태 불일치**: `OnBeginPlay()`는 엔티티가 생성될 때마다 실행됩니다. `SimpleInventory`는 `_UserService.LocalPlayer.SimpleInventory`를 통해 로컬 플레이어가 서버에서 로드한 실제 인벤토리 데이터를 참조합니다. 이 위치에 하드 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 지금까지 만든 인벤토리가 정상적으로 작동하는지 확인해봅시다. 임의의 데이터를 추가해 인벤토리의 슬롯을 눌러 지울 수 있는지 확인합니다. 정상적으로 작동하는 것을 확인했으면 확인용을 추가한 코드와 설정을 다시 변경합니다. 1. `UIInventoryItemSlot` 컴포넌트의 Event Handler에 `ButtonClickEvent` 내용을 수정합니다. ```lua [self] HandleButtonClickEvent (ButtonClickEvent event) { -- Parame
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 02_Player_Logic [question] | `SetMoneyData`와 `RankIn` 함수가 수행하는 DB 저장 후 UI 갱신 동작 과정을 단계별 번호 목록으로 설명하세요. [answer] | `SetMoneyData`와 `RankIn` 함수의 DB 저장 후 UI 갱신 동작 과정은 다음과 같습니다. **SetMoneyData** 1. DB에서 플레이어의 현재 재화 데이터를 가져옵니다. 2. 매개변수 `addMoney` 값을 가져온 재화 데이터에 적용합니다. 3. 변경된 재화 데이터를 DB에 다시 저장합니다. 4. 재화 UI를 갱신합니다. **RankIn** 1. 변경된 랭크 점수, 플레이어 ID, 닉네임 정보를 랭킹 DB에 저장합니다. 2. UI 갱신용 함수를 호출하여 랭킹 UI를 갱신합니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | | 실행제어 | 타입 | 이름 | 설명 | | --- | --- | --- | --- | | server only | void | GetMoneyData | DB에서 플레이어의 재화를 가져오는 함수입니다. 가져온 재화값으로 가져오는 함수입니다. UI정보를 가져온 재화값으로 갱신합니다. | | server only | void | SetMoneyData | DB에서 플레이어의 재화를 가져와 매개변수 `addMoney`를 적용해 다시 데이터를 저장하는 합수입니다. UI 정보를 함께 갱신합니다. | | server only | void
[task] | two_turn [pass] | ⏳ 미판정 [title] | 02_Player_Logic [question] | GetMoneyData와 SetMoneyData에서 DB 데이터 조작과 UI 갱신이 어떻게 이루어지는지 전체 흐름을 설명해 주세요. [answer] | 제공된 문서에는 `GetMoneyData`와 `SetMoneyData`의 기능적 설명만 포함되어 있으며, 구체적인 코드 구현이나 내부적인 실행 흐름(예: 특정 서비스 호출 순서, UI 갱신 메서드 호출 방식 등)에 대한 상세 기술이 없습니다. 문서에 명시된 정보에 기반한 기능 흐름은 다음과 같습니다. 1. **GetMoneyData (Server Only)** * DB에서 플레이어의 재화 데이터를 조회합니다. * 조회된 재화 값을 기반으로 UI 정보를 갱신합니다. 2. **SetMoneyData (Se [followup] | SetMoneyData에서 addMoney 매개변수를 적용할 때 기존 DB 값과 어떻게 연산하며, UI 갱신 시 MoneyUIUpdate 함수가 클라이언트에서 어떻게 트리거되는지 코드 예시를 보여 주세요. [followup_answer] | 제공된 문서에는 `SetMoneyData`의 내부 연산 방식(기존 값과의 구체적인 수식 등)이나 `MoneyUIUpdate`가 클라이언트에서 트리거되는 구체적인 코드 구현 및 호출 방식에 대한 정보가 포함되어 있지 않습니다. 문서에 명시된 내용만으로는 다음과 같이 설명할 수 있습니다. 1. **연산 방식**: `SetMoneyData`는 DB에서 플레이어의 재화를 가져와 매개변수 `addMoney`를 적용하여 다시 저장합니다. 그러나 '적용'의 구체적인 연산 방식(단순 합산인지, 차감인지 등)은 문서에 기술되어 있지 않습니다. [scores] | [judge_reason] | [source_doc] | | 실행제어 | 타입 | 이름 | 설명 | | --- | --- | --- | --- | | server only | void | GetMoneyData | DB에서 플레이어의 재화를 가져오는 함수입니다. 가져온 재화값으로 가져오는 함수입니다. UI정보를 가져온 재화값으로 갱신합니다. | | server only | void | SetMoneyData | DB에서 플레이어의 재화를 가져와 매개변수 `addMoney`를 적용해 다시 데이터를 저장하는 합수입니다. UI 정보를 함께 갱신합니다. | | server only | void
[task] | single_turn [pass] | ⏳ 미판정 [title] | 특정 월드 인스턴스로 워프하기 [question] | WorldInstanceInfo의 ShortCode는 같은 월드 내에서는 고유하지만 다른 월드 간에는 중복될 수 있다고 하는데, 이를 월드 인스턴스 식별자로 사용할 때 주의해야 할 점은 무엇인가요? [answer] | `WorldInstanceInfo`의 `ShortCode`는 동일한 월드 내에서는 고유하지만, 다른 월드 간에는 중복될 수 있기 때문에 **월드 인스턴스를 유일하게 식별하는 키로 단독으로 사용하면 안 됩니다.** 월드 인스턴스를 정확하게 구분하고 식별하려면 반드시 `WorldInstanceId`(`WorldInstanceInfo`의 `Id` 프로퍼티)를 사용해야 합니다. `ShortCode`는 월드 인스턴스의 이름이나 식별자처럼 표시용으로 사용할 수는 있지만, 논리적 처리나 워프 대상 지정 등 프로그램 내부에서 인스턴스를 특정해야 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `WorldInstanceService`를 활용해 현재 월드 인스턴스Id와 생성된 다른 월드 인스턴스들의 상태를 알 수 있습니다. 또한 `TeleportService`를 활용해 플레이어를 특정 월드 인스턴스로 워프시킬 수 있습니다. ##### 참고 가이드 [월드 인스턴스](/docs/?postId=984) [월드 인스턴스 통신](d/ocs/?postId=999) [월드 워프하기](/docs/?postId=743) ##### 참고 APIReference [TeleportService](/apiReference?
[task] | single_turn [pass] | ⏳ 미판정 [title] | LocaleDataSet [question] | Google SpreadSheet에서 데이터를 가져올 때 Key, Source, Note 순서로 머릿글 행이 채워져 있어야 한다고 하는데, 이 순서가 다르면 데이터가 어떻게 처리되나요? [answer] | 제공된 문서에는 Google SpreadSheet에서 데이터를 가져올 때 Key, Source, Note 순서로 머릿글 행이 채워져 있어야 한다고 명시되어 있습니다. 하지만 이 순서와 다르면 데이터가 어떻게 처리되는지에 대한 구체적인 설명(예: 에러 발생, 무시, 잘못된 매핑 등)은 문서에 포함되어 있지 않습니다. 따라서 문서에 근거하여 순서가 다를 경우의 처리 방식을 설명할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/custom/1120/Doc_1120_2_ko.png "LocaleDataSet") | 번호 | 설명 | | --- | --- | | | **컬럼 셀** 각 열의 데이터명, 즉 컬럼 명을 정의합니다. 기본 고정 컬럼 셀은 삭제가 불가능합니다 <ul><li>**Key**: 식별자 키입니다. 중복된 Key를 사용할 수 없습니다.</li><li>**Source**: 원본 언어, 원본 내용</li><li>**Note**: 번역자에게
[task] | instruction_following [pass] | ⏳ 미판정 [title] | 03_Player_Emoticon [question] | EmoticonData 테이블의 필드 5개를 필드명과 설명으로 구성된 표로 정리해 주세요. [answer] | EmoticonData 테이블의 필드 5개는 다음과 같습니다. | 필드명 | 설명 | | --- | --- | | Key | 감정 표현을 호출하는 키 값으로, 해당 값을 KeyboardKey로 변환해 사용합니다. | | RUID | 감정 표현의 RUID 값입니다. | | Scale | RUID 마다 크기 값이 다르므로, 과하게 크거나 작은 이미지를 조절하기 위한 값입니다. | | PivotY | RUID 마다 피벗 또한 다르므로, y축 위치를 조절하기 위한 값입니다. | | Explain | 해당 이미지를 설명하는 참고 값입니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # EmoticonData 플레이어가 사용하는 감정표현과 관련된 데이터를 관리하는 테이블입니다. | 이름 | 설명 | | --- | --- | | Key | 감정 표현을 호출하는 키 값으로, 해당 값을 KeyboardKey로 변환해 사용합니다. | | RUID | 감정 표현의 RUID 값입니다.| | Scale | RUID 마다 크기 값이 다르므로, 과하게 크거나 작은 이미지를 조절하기 위한 값입니다. | | PivotY | RUID 마다 피벗 또한 다르므로, y축 위치를 조절하기 위한 값입니다. | | Explain | 해
[task] | code [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | `UIInventoryItemSlot` 컴포넌트에서 `img_slot`과 `item_count` 자식 엔티티를 조회하여 `SpriteGUIRendererComponent.ImageRUID`와 `TextComponent.Text`를 갱신하고, `SetEnable`을 통해 개수 표시를 제어하는 스크립트를 작성해줘 [answer] | `UIInventoryItemSlot` 컴포넌트는 인벤토리 슬롯의 인덱스, 아이템 ID, 그리고 아이템 개수를 저장하는 프로퍼티를 가지며, `SetData`와 `Clear` 메서드를 통해 UI를 갱신합니다. `SetData` 함수는 전달받은 `slotIndex`, `itemId`, `itemCount`를 기반으로 `_Data.ItemTable`에서 아이템 정보를 조회합니다. 조회된 정보를 사용하여 `img_slot` 자식 엔티티의 `SpriteGUIRendererComponent.ImageRUID`를 아이템 아이콘으로 변경하고, [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | UIInventoryItemSlot 컴포넌트 내용을 변경해 UI 인벤토리에서 아이템 섬네일과 개수를 표시할 수 있도록 아래와 같이 작성합니다. 중간 확인을 위해 인벤토리에서 아이템을 누르면 삭제되도록 만들어봅시다. # UIInventoryItemSlot 수정 1. **UIItemSlot** 컴포넌트의 이름을 `UIInventoryItemSlot` 로 변경합니다. >**Tip.** > **ui - DefaultGroup - Inventory - InventoryPanel - Inventory_ScrollView
[task] | two_turn [pass] | ⏳ 미판정 [title] | 03_Player_Emoticon [question] | PlayerEmotionOn 테이블의 key와 value에 각각 어떤 값이 저장되며, 동기화 속성은 어떻게 설정되어 있나요? [answer] | `PlayerEmotionOn` 테이블은 `SyncTable<string, boolean>` 타입으로 선언되어 있으며, 동기화 속성은 `None`입니다. 각 필드에 저장되는 값은 다음과 같습니다. * **Key**: 플레이어의 ID * **Value**: 해당 플레이어가 현재 감정표현을 사용 중인지 여부를 나타내는 `true`/`false` 값 [followup] | SpawnEmoticon 함수가 '현재 감정 표현이 이미 재생 중'인 조건을 PlayerEmotionOn 테이블의 어떤 값으로 판별하는지, 그리고 이 체크가 실패할 때의 구체적인 return 로직이 담긴 코드 예제를 보여주세요. [followup_answer] | 제공된 참고 문서에는 `SpawnEmoticon` 함수가 '현재 감정 표현이 이미 재생 중'이라는 조건을 `PlayerEmotionOn` 테이블의 **value 값(`true`/`false`)**으로 판별한다고 명시되어 있습니다. 다만, 문서에는 해당 체크가 실패(이미 재생 중이거나 플레이어가 존재하지 않는 경우)했을 때의 **구체적인 return 로직을 담은 실제 mLua 코드 예제가 포함되어 있지 않습니다.** 따라서 문서 근거만으로 정확한 코드 구현을 보여드릴 수 없습니다. [scores] | [judge_reason] | [source_doc] | # EmoticonData 플레이어가 사용하는 감정표현과 관련된 데이터를 관리하는 테이블입니다. | 이름 | 설명 | | --- | --- | | Key | 감정 표현을 호출하는 키 값으로, 해당 값을 KeyboardKey로 변환해 사용합니다. | | RUID | 감정 표현의 RUID 값입니다.| | Scale | RUID 마다 크기 값이 다르므로, 과하게 크거나 작은 이미지를 조절하기 위한 값입니다. | | PivotY | RUID 마다 피벗 또한 다르므로, y축 위치를 조절하기 위한 값입니다. | | Explain | 해
[task] | single_turn [pass] | ⏳ 미판정 [title] | LocaleDataSet [question] | CSV 파일을 불러올 때 utf-8 인코딩이 아니면 정상적으로 가져오지 못한다는 안내가 있는데, 다른 인코딩으로 저장된 파일을 사용했을 때 발생하는 구체적인 오류나 현상은 무엇인가요? [answer] | 제공된 참고 문서에는 CSV 파일을 불러올 때 **utf-8로 저장된 파일만 정상적으로 가져올 수 있다**는 내용만 명시되어 있습니다. 다른 인코딩(예: EUC-KR, ANSI 등)으로 저장된 파일을 사용했을 때 발생하는 **구체적인 오류 메시지나 현상(예: 한글 깨짐, 오류 코드 표시 등)에 대한 설명은 문서에 포함되어 있지 않습니다.** 따라서 문서의 정보만으로는 특정 인코딩 오류 시나리오에 대한 자세한 현상을 답변드리기 어렵습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/custom/1120/Doc_1120_2_ko.png "LocaleDataSet") | 번호 | 설명 | | --- | --- | | | **컬럼 셀** 각 열의 데이터명, 즉 컬럼 명을 정의합니다. 기본 고정 컬럼 셀은 삭제가 불가능합니다 <ul><li>**Key**: 식별자 키입니다. 중복된 Key를 사용할 수 없습니다.</li><li>**Source**: 원본 언어, 원본 내용</li><li>**Note**: 번역자에게
[task] | single_turn [pass] | ⏳ 미판정 [title] | 6. UIInventoryItemSlot 수정 [question] | 클라이언트에서 self.ItemId를 체크하여 빈 슬롯 클릭을 무시하는 로직과, 서버에서 RemoveItemAt()을 호출하는 로직이 각각 어떤 문제를 방지하기 위해 분리되어 있는지 설명해 주세요. [answer] | 참고 문서에 제공된 코드와 설명만을 기준으로 답변합니다. **1. 클라이언트에서 `self.ItemId`를 체크하여 빈 슬롯 클릭을 무시하는 로직** ```lua -- 슬롯에 아이템이 있을 때만 if self.ItemId == "" then return end ``` 이 로직은 **슬롯에 아이템이 없는 경우(빈 슬롯)에 대한 불필요한 서버 요청을 방지**하기 위해 분리되어 있습니다. * `self.ItemId`가 빈 문자열(`""`)인 경우, 해당 슬롯에는 아이템이 없는 상태입니다. * [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 지금까지 만든 인벤토리가 정상적으로 작동하는지 확인해봅시다. 임의의 데이터를 추가해 인벤토리의 슬롯을 눌러 지울 수 있는지 확인합니다. 정상적으로 작동하는 것을 확인했으면 확인용을 추가한 코드와 설정을 다시 변경합니다. 1. `UIInventoryItemSlot` 컴포넌트의 Event Handler에 `ButtonClickEvent` 내용을 수정합니다. ```lua [self] HandleButtonClickEvent (ButtonClickEvent event) { -- Parame