블루프린트에서의 리플리케이션

변수 생성: 블루프린트에서 복제하고자 하는 변수(예: 플레이어의 Health, 적의 CurrentAmmo)를 생성합니다.

리플리케이션 설정: 변수를 선택하고 디테일(Details) 패널의 리플리케이션(Replication) 섹션에서 Replication 드롭다운을 Replicated로 설정합니다.

적용: 이제 서버에서 이 변수의 값을 변경하면, 클라이언트의 해당 액터 인스턴스에 있는 변수 값도 자동으로 업데이트됩니다.

• 주의: RepNotify를 사용하여 변수 값이 복제된 후 특정 로직을 실행할 수 있습니다.

RepNotify (Rep_Notify): RepNotify는 Replicated 변수가 클라이언트에 성공적으로 복제되어 값이 변경되었을 때 특정 함수를 자동으로 호출하는 기능입니다. 이를 통해 클라이언트에서 변수 값의 변화에 따른 시각적/청각적 효과를 구현할 수 있습니다.

• 설정: 변수를 Replicated로 설정한 후, 드롭다운에서 Replicated Using을 선택합니다. 그러면 새로운 함수가 자동으로 생성됩니다. (예: OnRep_Health)
• 활용: OnRep_Health 함수 내에 체력 바 UI 업데이트, 피격 사운드 재생, 데미지 이펙트 표시 등의 로직을 구현합니다. 이 함수는 서버에서도 호출되지만, 주로 클라이언트의 시각적 피드백을 위해 사용됩니다.

Run on Server (서버에서 실행)

• 클라이언트가 서버에 함수 실행을 요청할 때 사용합니다. (예: 플레이어가 공격 버튼을 눌렀을 때, 클라이언트가 서버에게 "나 공격할게!"라고 알림)
• 설정: 함수를 생성하고 Replicates를 Run on Server로 설정합니다. Reliable 옵션을 체크하면 네트워크 불안정 시에도 반드시 호출되도록 보장합니다.
• 주의: Run on Server 함수는 오직 소유권(Ownership)을 가진 클라이언트만이 호출할 수 있습니다. 일반적으로 PlayerController와 Pawn/Character가 소유권을 가집니다. 다른 액터(예: 월드에 있는 문)의 함수를 서버에서 실행하고 싶다면, 그 액터에 대한 Run on Server 함수를 PlayerController나 Pawn에 만들고, 거기서 다시 해당 액터의 함수를 호출하는 방식으로 우회해야 합니다.

Multicast (멀티캐스트)

• 서버가 모든 클라이언트에 함수 실행을 지시할 때 사용합니다. (예: 서버가 "모든 클라이언트는 이펙트 재생!"이라고 알림)
• 설정: 함수를 생성하고 Replicates를 Multicast로 설정합니다. Reliable 옵션을 체크하면 네트워크 불안정 시에도 반드시 호출되도록 보장합니다.
• 주의: Multicast 함수는 오직 서버에서만 호출될 수 있습니다. 클라이언트에서 Multicast 함수를 호출하려 하면 경고가 뜨며 작동하지 않습니다. 이 함수는 서버에서도 실행되고, 모든 클라이언트에서도 실행됩니다.

Run on Owning Client (소유 클라이언트에서 실행)

• 서버가 특정 폰/캐릭터의 소유권을 가진 클라이언트에만 함수 실행을 지시할 때 사용합니다. (예: 서버가 특정 플레이어에게만 "너 데미지 입었어!"라고 알림)
• 설정: 함수를 생성하고 Replicates를 Run on Owning Client로 설정합니다. Reliable 옵션을 체크하면 네트워크 불안정 시에도 반드시 호출되도록 보장합니다.
• 주의: 이 함수는 오직 서버에서만 호출될 수 있으며, 소유권을 가진 클라이언트에서만 실행됩니다.

액터 블루프린트 열기: 복제하고자 하는 액터 블루프린트 (예: BP_PickupItem)를 엽니다.

리플리케이션 설정: 클래스 디폴트(Class Defaults)를 클릭하고 디테일(Details) 패널에서 리플리케이션(Replication) 섹션을 찾습니다.

• Replicates: 체크합니다. (이 액터와 그 컴포넌트들이 모든 클라이언트에 복제되도록 허용)
• Replicate Movement: 체크합니다. (액터의 위치, 회전, 스케일이 자동으로 복제되도록 함. 폰/캐릭터는 기본적으로 체크되어 있음)
• Net Update Frequency: 해당 액터가 초당 몇 번 복제 업데이트를 보낼지 설정합니다. (높을수록 정확하지만 네트워크 부하 증가)

BP_PickupItem (아이템 액터)

• 클래스 디폴트에서 Replicates와 Replicate Movement를 체크합니다.
• 콜리전 컴포넌트의 On Component Begin Overlap 이벤트에서 로직을 시작합니다.
• 이벤트 그래프
  • On Component Begin Overlap > Other Actor를 Cast To BP_PlayerCharacter로 캐스팅합니다.
  • 캐스팅 성공 시, Has Authority 노드를 사용하여 현재 코드가 서버에서 실행 중인지 확인합니다. (아이템 줍기 로직은 서버에서만 처리해야 함)
  • Has Authority가 True일 경우:
    • Run on Server RPC (예: Server_PickupItem)를 호출합니다. 이 RPC에 BP_PlayerCharacter와 주운 아이템(Self 참조)을 파라미터로 넘깁니다.

BP_PlayerCharacter (플레이어 캐릭터)

• 함수 생성: Server_PickupItem이라는 커스텀 이벤트를 만들고, Replicates를 Run on Server로 설정합니다.
• Server_PickupItem 함수 내부
  • 아이템을 실제로 플레이어 인벤토리에 추가하는 로직을 구현합니다. (인벤토리 변수 업데이트 등)
  • 아이템 액터를 Destroy Actor 노드로 파괴합니다.
  • Multicast RPC (예: Multicast_PlayPickupEffect)를 호출하여 모든 클라이언트에 줍기 효과(사운드, 이펙트)를 재생하도록 지시합니다. (서버에서만 호출 가능)

BP_PlayerCharacter (계속)

• 함수 생성: Multicast_PlayPickupEffect라는 커스텀 이벤트를 만들고, Replicates를 Multicast로 설정합니다.
• Multicast_PlayPickupEffect 함수 내부
  • 아이템 줍는 사운드 (Play Sound at Location)
  • 아이템 줍는 이펙트 (Spawn Emitter at Location)
  • 주의: 이 함수는 서버와 모든 클라이언트에서 실행되므로, 이펙트/사운드 재생은 Is Dedicated Server 체크를 통해 전용 서버에서는 건너뛰거나, 필요하다면 Is Locally Controlled 체크를 통해 특정 클라이언트에서만 실행되도록 할 수 있습니다.