✍️Today I Learned

📅 2025-11-13

• 언리얼 네트워크 복제: Actor 이름은 월드별로 독립적이다
• 구조체 내부 값 변경 시 자동 복제 조건

---

언리얼 네트워크 복제: Actor 이름은 월드별로 독립적이다

🤔 문제 상황

멀티플레이어 환경에서 Client가 BP_TSCharacter_C_0을 참조하는 것을 보고 "어? Player 1인데 왜 0번 캐릭터를 참조하지?"라고 착각했다.

💡 핵심 개념

각 월드(Server, Client)는 자신만의 Actor 인스턴스를 가지며, 이름은 각 월드에서 독립적으로 생성된다.

Server 월드:
├─ BP_TSCharacter_C_0 (Server Player)
└─ BP_TSCharacter_C_1 (Client Player)

Client 월드:
├─ BP_TSCharacter_C_0 (자신 = AutonomousProxy) ← 서버의 C_1과 동기화!
└─ BP_TSCharacter_C_1 (서버 복제본 = SimulatedProxy)

Actor 이름이 아니라 Role 값으로 판단해야 한다:

• Role: ROLE_AutonomousProxy (2) = 내가 제어하는 캐릭터
• Role: ROLE_SimulatedProxy (1) = 다른 플레이어의 복제본
• Role: ROLE_Authority (3) = 서버

✅ 결론

• Actor 이름(C_0, C_1)은 각 월드에서 독립적으로 생성됨
• "같은 Player"라도 Server 월드와 Client 월드에서 이름이 다를 수 있음
• Role 값이 진실! 이름만 보고 판단하면 안 됨

---

구조체 내부 값 변경 시 자동 복제 조건

🤔 기존 지식

"구조체 안에 구조체가 있으면 내부 값만 바꿨을 때 복제 안 되니까 ForceNetUpdate() 써야 한다"

💡 실제로는?

최상위 변수에 ReplicatedUsing을 선언하고, 내부 값들을 UPROPERTY로 정의하면 언리얼이 알아서 직렬화해서 복제해준다!

// 구조체 정의
USTRUCT(BlueprintType)
struct FSlotStructMaster
{
    GENERATED_BODY()
    
    UPROPERTY()  // ✅ UPROPERTY만 있으면 됨!
    int32 CurrentStackSize;
    
    UPROPERTY()
    FItemInstance ItemData;  // 구조체 안의 구조체도 OK
};

// 컴포넌트
UPROPERTY(ReplicatedUsing = OnRep_HotkeyInventory)  // ✅ 최상위만 선언
FInventoryStructMaster HotkeyInventory;

내부 값을 바꾸면:

HotkeyInventory.InventorySlotContainer[0].CurrentStackSize = 10;
// ✅ 자동으로 OnRep_HotkeyInventory() 호출됨!
// ForceNetUpdate() 불필요!

✅ 조건

1. 최상위 변수에 ReplicatedUsing 선언
2. 구조체의 모든 멤버 변수에 UPROPERTY 매크로
3. GetLifetimeReplicatedProps에 등록

→ 언리얼이 자동으로 변경 감지 및 직렬화!

---

💡 느낀 점 (What I Felt)

네트워크 복제는 "눈에 보이는 것"과 "실제 동작"이 다를 수 있다는 걸 배웠다. Actor 이름 같은 표면적인 정보에 속지 말고, Role이나 NetMode 같은 본질적인 값을 봐야 한다.

그리고 언리얼의 복제 시스템은 생각보다 똑똑해서, UPROPERTY만 제대로 선언하면 복잡한 구조체도 알아서 직렬화해준다. 불필요한 ForceNetUpdate() 남발을 줄일 수 있을 것 같다.