RPC와 서버-클라이언트 통신

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "MyPlayerCharacter.generated.h"

UCLASS()
class MYPROJECT_API AMyPlayerCharacter : public ACharacter
{
    GENERATED_BODY()

public:
    AMyPlayerCharacter();

protected:
    virtual void BeginPlay() override;

    // 플레이어가 총을 발사했을 때 서버에게 알리는 RPC
    UFUNCTION(Server, Reliable, WithValidation)
    void Server_ShootWeapon(FVector MuzzleLocation, FRotator MuzzleRotation);

    // Server_ShootWeapon_Validate 함수 선언 (반드시 bool 반환)
    bool Server_ShootWeapon_Validate(FVector MuzzleLocation, FRotator MuzzleRotation);

    // Server_ShootWeapon_Implementation 함수 선언 (실제 로직 구현)
    void Server_ShootWeapon_Implementation(FVector MuzzleLocation, FRotator MuzzleRotation);

public:
    // 클라이언트에서 이 함수를 호출하여 Server_ShootWeapon RPC를 트리거합니다.
    UFUNCTION(BlueprintCallable, Category = "Combat")
    void Client_RequestShoot(FVector MuzzleLocation, FRotator MuzzleRotation);
};

#include "MyPlayerCharacter.h"
#include "Net/UnrealNetwork.h" // RPC 구현을 위해 필요

AMyPlayerCharacter::AMyPlayerCharacter()
{
    bReplicates = true; // 캐릭터는 항상 복제되어야 합니다.
    SetReplicateMovement(true); // 캐릭터 이동도 복제
}

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

    if (HasAuthority()) // 서버
    {
        UE_LOG(LogTemp, Warning, TEXT("Server: MyPlayerCharacter spawned."));
    }
    else // 클라이언트
    {
        UE_LOG(LogTemp, Warning, TEXT("Client: MyPlayerCharacter spawned."));
    }
}

// ===========================================
// Server_ShootWeapon RPC 구현
// ===========================================

// _Validate 함수: 클라이언트에서 받은 인자의 유효성을 서버에서 검증합니다.
// false를 반환하면 _Implementation을 실행하지 않고 호출한 클라이언트의 연결을 끊습니다.
bool AMyPlayerCharacter::Server_ShootWeapon_Validate(FVector MuzzleLocation, FRotator MuzzleRotation)
{
    // 정상적인 재사용 대기시간 거절은 _Implementation에서 처리합니다.
    // 이 예제에는 발사 빈도·탄약 검증이 아직 없습니다.
    if (MuzzleLocation.ContainsNaN() || MuzzleRotation.ContainsNaN())
    {
        return false; // NaN/Inf 인자를 거부합니다.
    }

    // 예시: 발사 위치가 캐릭터에서 너무 멀리 떨어져 있는지 검사
    if (FVector::DistSquared(GetActorLocation(), MuzzleLocation) > FMath::Square(500.0f)) // 500cm 이내
    {
        UE_LOG(LogTemp, Warning, TEXT("Server_ShootWeapon_Validate: MuzzleLocation too far from actor!"));
        return false;
    }

    return true; // 인자가 유효하면 true 반환
}

// _Implementation 함수: 실제 총 발사 로직 (서버에서만 실행)
void AMyPlayerCharacter::Server_ShootWeapon_Implementation(FVector MuzzleLocation, FRotator MuzzleRotation)
{
    // 이 코드는 서버에서만 실행됩니다. (HasAuthority() == true)
    UE_LOG(LogTemp, Warning, TEXT("Server: Received ShootWeapon RPC. Processing shot from %s"), *MuzzleLocation.ToString());

    // 1. 탄약 감소 (서버에서만)
    // CurrentAmmo--;

    // 2. 실제 투사체 스폰 (서버에서만)
    // AProjectile* NewProjectile = GetWorld()->SpawnActor<AProjectile>(ProjectileClass, MuzzleLocation, MuzzleRotation);
    // if (NewProjectile)
    // {
    //     // NewProjectile이 bReplicates=true로 설정되어 있으면 자동으로 클라이언트에게 복제됩니다.
    // }

    // 3. 데미지 계산 및 적용 (서버에서만)
    // Target->ApplyDamage(DamageAmount);

    // 4. 모든 클라이언트에게 시각/청각 효과 재생 명령 (NetMulticast RPC 호출)
    // Multicast_PlayMuzzleEffectAndSound(MuzzleLocation);
}

// 클라이언트에서 호출하여 서버 RPC를 트리거하는 함수
void AMyPlayerCharacter::Client_RequestShoot(FVector MuzzleLocation, FRotator MuzzleRotation)
{
    // 원격 클라이언트와 리슨 서버의 로컬 플레이어 입력을 모두 허용합니다.
    if (IsLocallyControlled())
    {
        UE_LOG(LogTemp, Warning, TEXT("Client: Requesting Server_ShootWeapon."));
        Server_ShootWeapon(MuzzleLocation, MuzzleRotation); // 서버 RPC 호출
    }
    // 클라이언트에서 즉각적인 피드백 (예측)
    // PlayLocalMuzzleFlash();
    // PlayLocalSound();
}

#pragma once

// ...

UCLASS()
class MYPROJECT_API AMyPlayerCharacter : public ACharacter
{
    GENERATED_BODY()

public:
    // ...

protected:
    // 서버가 액터의 소유 클라이언트에게 메시지를 보내는 RPC
    UFUNCTION(Client, Reliable)
    void Client_DisplayMessageOnHUD(const FString& Message);

    // Client_DisplayMessageOnHUD_Implementation 함수 선언
    void Client_DisplayMessageOnHUD_Implementation(const FString& Message);

public:
    // 서버에서 이 함수를 호출하여 Client_DisplayMessageOnHUD RPC를 트리거합니다.
    UFUNCTION(BlueprintCallable, Category = "Communication")
    void Server_SendPersonalMessageToOwner(const FString& MessageToSend);
};

#include "MyPlayerCharacter.h"

// ...

// ===========================================
// Client_DisplayMessageOnHUD RPC 구현
// ===========================================

// _Implementation 함수: 호출 위치와 소유 연결에 따른 대상에서 실행
void AMyPlayerCharacter::Client_DisplayMessageOnHUD_Implementation(const FString& Message)
{
    // 리슨 서버의 로컬 소유 캐릭터도 포함합니다.
    if (IsLocallyControlled())
    {
        UE_LOG(LogTemp, Warning, TEXT("Client: Displaying HUD message: %s"), *Message);
        // 여기에 UMG 위젯을 통해 HUD에 메시지를 표시하는 로직을 구현합니다.
    }
}

// 서버에서 호출하여 클라이언트 RPC를 트리거하는 함수
void AMyPlayerCharacter::Server_SendPersonalMessageToOwner(const FString& MessageToSend)
{
    // 이 함수는 서버에서만 호출되어야 합니다.
    if (HasAuthority())
    {
        // 특정 플레이어 컨트롤러를 찾아 그 컨트롤러가 소유한 캐릭터의 Client RPC를 호출합니다.
        // 또는 이 액터의 오너가 PlayerController인지 확인하고 RPC를 호출합니다.
        // FString OwnerName = GetOwner() ? GetOwner()->GetName() : TEXT("No Owner");
        // UE_LOG(LogTemp, Warning, TEXT("Server: Sending personal message to owner (%s)."), *OwnerName);

        Client_DisplayMessageOnHUD(MessageToSend); // Client RPC 호출
    }
}

#pragma once

// ...

UCLASS()
class MYPROJECT_API AMyPlayerCharacter : public ACharacter
{
    GENERATED_BODY()

public:
    // ...

protected:
    // 서버가 모든 클라이언트에게 파티클 효과 재생을 명령하는 RPC
    UFUNCTION(NetMulticast, Unreliable) // 시각 효과는 Unreliable로 충분한 경우가 많습니다.
    void Multicast_PlayExplosionEffect(FVector ExplosionLocation);

    // Multicast_PlayExplosionEffect_Implementation 함수 선언
    void Multicast_PlayExplosionEffect_Implementation(FVector ExplosionLocation);

public:
    // 서버에서 이 함수를 호출하여 Multicast_PlayExplosionEffect RPC를 트리거합니다.
    UFUNCTION(BlueprintCallable, Category = "Effects")
    void Server_TriggerGlobalExplosion(FVector Location);
};

#include "MyPlayerCharacter.h"

// ...

// ===========================================
// Multicast_PlayExplosionEffect RPC 구현
// ===========================================

// _Implementation 함수: 서버 호출 시 서버와 현재 관련 있는 클라이언트에서 실행
void AMyPlayerCharacter::Multicast_PlayExplosionEffect_Implementation(FVector ExplosionLocation)
{
    // 서버에서 호출한 경우 서버와 현재 관련 있는 클라이언트에서 실행됩니다.
    UE_LOG(LogTemp, Warning, TEXT("All Clients (and Server): Playing explosion effect at %s"), *ExplosionLocation.ToString());
    // 여기에 UGameplayStatics::SpawnEmitterAtLocation, UGameplayStatics::PlaySoundAtLocation 등
    // 시각적/청각적 효과를 구현합니다.
}

// 서버에서 호출하여 멀티캐스트 RPC를 트리거하는 함수
void AMyPlayerCharacter::Server_TriggerGlobalExplosion(FVector Location)
{
    // 이 함수는 서버에서만 호출되어야 합니다.
    if (HasAuthority())
    {
        UE_LOG(LogTemp, Warning, TEXT("Server: Triggering global explosion at %s."), *Location.ToString());
        Multicast_PlayExplosionEffect(Location); // NetMulticast RPC 호출
    }
}