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; // 캐릭터는 항상 복제되어야 합니다.
    SetReplicatesMovement(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)
{
    // 예시: 너무 빠른 발사 속도 감지 (치트 방지)
    // float TimeSinceLastShot = GetWorld()->GetTimeSeconds() - LastShotTime;
    // if (TimeSinceLastShot < 0.1f) return false;

    // 예시: 발사 위치가 캐릭터에서 너무 멀리 떨어져 있는지 검사
    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)
{
    // 이 함수는 클라이언트에서 호출되어야 합니다.
    // HasAuthority()는 클라이언트에서 false이므로, 클라이언트가 서버로 RPC를 보냅니다.
    // 서버에서는 이 함수를 호출하면 아무 일도 일어나지 않습니다.
    if (!HasAuthority()) 
    {
        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 (!HasAuthority()) // 클라이언트임을 다시 확인**
** {**
** 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 호출
    }
}