복제(Replication) 시스템 이해

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MyReplicatedActor.generated.h"

UCLASS()
class MYPROJECT_API AMyReplicatedActor : public AActor
{
    GENERATED_BODY()

public:
    AMyReplicatedActor();
};

#include "MyReplicatedActor.h"

AMyReplicatedActor::AMyReplicatedActor()
{
    // 중요: 이 액터가 네트워크를 통해 복제될 것임을 명시
    bReplicates = true;
    // 루트 컴포넌트 이동 복제 활성화. 이 부분 예제는 루트 생성을 생략합니다.
    SetReplicateMovement(true);
}

#pragma once

// ...
#include "GameFramework/Actor.h"
#include "MyReplicatedActor.generated.h"

UCLASS()
class MYPROJECT_API AMyReplicatedActor : public AActor
{
    GENERATED_BODY()

public:
    AMyReplicatedActor();

protected:
    // 서버에서만 값을 변경하고 클라이언트로 복제할 변수
    UPROPERTY(Replicated, BlueprintReadOnly, Category = "Replication")
    int32 ReplicatedInteger;

    virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
};

#include "MyReplicatedActor.h"
#include "Net/UnrealNetwork.h" // DOREPLIFETIME 매크로를 위해 반드시 포함

AMyReplicatedActor::AMyReplicatedActor()
{
    bReplicates = true;
    SetReplicateMovement(true);

    ReplicatedInteger = 0; // 초기값 설정
}

void AMyReplicatedActor::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);

    DOREPLIFETIME(AMyReplicatedActor, ReplicatedInteger);
}

#pragma once

// ...

UCLASS()
class MYPROJECT_API AMyReplicatedActor : public AActor
{
    GENERATED_BODY()

public:
    // ...

protected:
    // 클라이언트가 복제된 값 변경을 수신하면 알림을 실행할 변수
    UPROPERTY(ReplicatedUsing = OnRep_ReplicatedFloat, BlueprintReadOnly, Category = "Replication")
    float ReplicatedFloat;

    // OnRep_ReplicatedFloat 함수 선언 (UFUNCTION으로 선언되어야 함)
    UFUNCTION()
    void OnRep_ReplicatedFloat();

    virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;

public:
    // 서버에서 호출하여 복제된 변수들을 업데이트하는 함수
    UFUNCTION(BlueprintCallable, Category = "Replication")
    void Server_SetReplicatedFloat(float NewFloat);
};

#include "MyReplicatedActor.h"
#include "Net/UnrealNetwork.h"

// ...

void AMyReplicatedActor::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);

    DOREPLIFETIME(AMyReplicatedActor, ReplicatedInteger); // 기존
    DOREPLIFETIME(AMyReplicatedActor, ReplicatedFloat); // OnRep_ 함수와 연결된 변수 복제
}

void AMyReplicatedActor::OnRep_ReplicatedFloat()
{
 // 이 함수는 ReplicatedFloat 변수의 값이 클라이언트로 복제될 때 클라이언트에서 자동으로 호출됩니다.
 // 서버에서는 직접 값을 변경하므로 호출되지 않습니다.
 UE_LOG(LogTemp, Warning, TEXT("Client: ReplicatedFloat changed to: %f (OnRep_ called)"), ReplicatedFloat);
 // 여기에 이펙트 재생, UI 업데이트, 애니메이션 전환 등 클라이언트에서만 필요한 로직을 구현합니다.
}

void AMyReplicatedActor::Server_SetReplicatedFloat(float NewFloat)
{
    if (HasAuthority()) // 서버에서만 실행
    {
        ReplicatedFloat = NewFloat; // 중간 변경 값은 합쳐질 수 있으며 수신 조건에 따라 OnRep가 호출됩니다.
        UE_LOG(LogTemp, Warning, TEXT("Server: ReplicatedFloat set to: %f"), ReplicatedFloat);
        // 서버에서도 동일한 로직을 실행하고 싶다면 OnRep_ReplicatedFloat()를 직접 호출할 수 있습니다.
        // OnRep_ReplicatedFloat(); // 서버에서도 강제로 OnRep_ 함수 호출
    }
}

#pragma once

// ...

UCLASS()
class MYPROJECT_API AMyReplicatedActor : public AActor
{
    GENERATED_BODY()

public:
    // ...

protected:
    // 소유자에게만 복제될 변수 (예: 인벤토리)
    UPROPERTY(Replicated, Category = "Replication")
    TArray<FString> PlayerInventory;

    // 비소유자에게만 복제될 변수 (예: 공개된 상태 정보)
    // UPROPERTY(Replicated, Category = "Replication")
    // int32 PublicStateValue;

    virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
};

#include "MyReplicatedActor.h"
#include "Net/UnrealNetwork.h"

// ...

void AMyReplicatedActor::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);

    // COND_OwnerOnly: 이 변수는 액터의 소유자에게만 복제됩니다.
    DOREPLIFETIME_COND(AMyReplicatedActor, PlayerInventory, COND_OwnerOnly);
    // COND_SkipOwner: 이 변수는 소유자를 제외한 모든 클라이언트에게 복제됩니다.
    // DOREPLIFETIME_COND(AMyReplicatedActor, PublicStateValue, COND_SkipOwner);
}

#pragma once

// ...

UCLASS()
class MYPROJECT_API AMyReplicatedActor : public AActor
{
    GENERATED_BODY()

public:
    // ...

protected:
    // 1. 클라이언트가 서버로 요청하는 RPC
    UFUNCTION(Server, Reliable, WithValidation)
    void Server_FireWeapon(FVector Location, FRotator Direction);
    // _Validate 함수 (선언만)
    bool Server_FireWeapon_Validate(FVector Location, FRotator Direction);
    // _Implementation 함수 (선언만)
    void Server_FireWeapon_Implementation(FVector Location, FRotator Direction);

    // 2. 서버가 특정 클라이언트에게 보내는 RPC
    UFUNCTION(Client, Reliable)
    void Client_ReceiveChatMessage(const FString& SenderName, const FString& Message);

    // 3. 서버가 모든 클라이언트에게 보내는 RPC
    UFUNCTION(NetMulticast, Unreliable) // 애니메이션 재생 등 비중요, 빈번한 업데이트
    void Multicast_PlayParticleEffect(FVector EffectLocation);
};

#include "MyReplicatedActor.h"

// ...

// 1. Server RPC 구현: 클라이언트가 서버로 무기 발사 요청
bool AMyReplicatedActor::Server_FireWeapon_Validate(FVector Location, FRotator Direction)
{
    // 여기서 클라이언트가 보낸 데이터가 유효한지 검사합니다.
    // 예: Location이 너무 멀리 떨어져 있거나, 부정확한 값이 아닌지 등
    // 이 부분 예제는 항상 true를 반환하므로 아직 실제 입력 검증을 하지 않습니다.
    return true;
}

void AMyReplicatedActor::Server_FireWeapon_Implementation(FVector Location, FRotator Direction)
{
    // 이 코드는 서버에서만 실행됩니다.
    UE_LOG(LogTemp, Warning, TEXT("Server: Processing weapon fire from client at %s, direction %s"), *Location.ToString(), *Direction.ToString());
    // 실제 발사 로직 (충돌 감지, 데미지 적용, 탄약 감소 등)을 여기서 처리합니다.
    // 모든 클라이언트에게 발사 효과를 복제 (NetMulticast 호출)
    Multicast_PlayParticleEffect(Location);
}

void AMyReplicatedActor::Client_ReceiveChatMessage_Implementation(const FString& SenderName, const FString& Message)
{
    // 호출 위치와 소유 연결에 따른 대상에서 실행됩니다.
    UE_LOG(LogTemp, Warning, TEXT("Chat Message from %s: %s"), *SenderName, *Message);
    // UI 갱신은 로컬 플레이어·위젯의 존재를 별도로 확인해야 합니다.
}

void AMyReplicatedActor::Multicast_PlayParticleEffect_Implementation(FVector EffectLocation)
{
    // 서버 호출 시 서버와 현재 관련 있는 클라이언트에서 실행됩니다.
    UE_LOG(LogTemp, Warning, TEXT("All: Playing particle effect at %s"), *EffectLocation.ToString());
    // 여기에 파티클 시스템 생성, 사운드 재생 등 시각적/청각적 효과를 구현합니다.
}

#pragma once

#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "MyReplicatedComponent.generated.h"

UCLASS( ClassGroup=(Custom), meta=(BlueprintSpawnableComponent) )
class MYPROJECT_API UMyReplicatedComponent : public UActorComponent
{
    GENERATED_BODY()

public:
    UMyReplicatedComponent();

protected:
    virtual void BeginPlay() override;

    UPROPERTY(Replicated)
    int32 ComponentSpecificValue;

    virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
};

#include "MyReplicatedComponent.h"
#include "Net/UnrealNetwork.h"

UMyReplicatedComponent::UMyReplicatedComponent()
{
    SetIsReplicatedByDefault(true); // 컴포넌트 생성자에서 복제 기본값 설정
    ComponentSpecificValue = 0;
}

void UMyReplicatedComponent::BeginPlay()
{
    Super::BeginPlay();
}

void UMyReplicatedComponent::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);

    DOREPLIFETIME(UMyReplicatedComponent, ComponentSpecificValue);
}

#include "MyReplicatedActor.h"

void AMyReplicatedActor::BeginPlay()
{
    Super::BeginPlay();

    if (HasAuthority()) // Role == ROLE_Authority
    {
        UE_LOG(LogTemp, Warning, TEXT("AMyReplicatedActor: Authority role"));
    }
    else if (GetLocalRole() == ENetRole::ROLE_AutonomousProxy)
    {
        UE_LOG(LogTemp, Warning, TEXT("AMyReplicatedActor: Autonomous Proxy role"));
    }
    else if (GetLocalRole() == ENetRole::ROLE_SimulatedProxy)
    {
        UE_LOG(LogTemp, Warning, TEXT("AMyReplicatedActor: Simulated Proxy role"));
    }
}