Unity와 PlayFab으로 구현하는 강력한 랭킹 보상 시스템 - 실전 코드와 설계 가이드

모바일 및 온라인 게임에서 유저의 플레이 동기 부여는 큰 과제입니다. 특히 랭킹 시스템과 함께 제공되는 보상은 유저의 경쟁 심리를 자극하고 지속적인 게임 참여를 유도하는 강력한 수단이 될 수 있습니다. 본 글에서는 Unity 클라이언트와 PlayFab 서버를 활용하여 랭킹 보상 시스템을 구현하는 방법에 대해 심도 있게 설명하고, 실전에서 바로 사용할 수 있는 고급 예시 코드까지 제공해 드리겠습니다.

Unity는 많은 모바일 및 PC 게임에서 클라이언트 엔진으로 활용되며, PlayFab은 서버 쪽 랭킹 및 보상 시스템을 관리하는 데 있어 매우 유용한 도구입니다. PlayFab API를 활용하면 간단히 랭킹을 계산하고 보상 분배를 자동화할 수 있습니다. 이번 글에서는 클라이언트와 서버 간의 데이터 흐름과 보상 처리 알고리즘을 체계적으로 구현하는 방법을 다루겠습니다.

1 주요 구현 내용 및 설계
2 장점과 단점
3 마무리

주요 구현 내용 및 설계

1. 데이터 흐름 설정: 클라이언트-서버 통신

랭킹 보상 시스템의 핵심은 유저의 점수를 서버에 업로드하고, 일정 주기에 따라 순위를 계산해 보상을 분배하는 것입니다. 이를 위해 PlayFab의 Cloud Script와 Unity C# API를 활용해 클라이언트와 서버 간의 안전한 통신을 구현합니다.

// 유저 점수를 서버에 전송하는 함수
public void SubmitScore(int score)
{
    var request = new UpdatePlayerStatisticsRequest
    {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = "LeaderboardScore",
                Value = score
            }
        }
    };

    PlayFabClientAPI.UpdatePlayerStatistics(request, OnScoreSubmitted, OnError);
}

private void OnScoreSubmitted(UpdatePlayerStatisticsResult result)
{
    Debug.Log("Score submitted successfully!");
}

private void OnError(PlayFabError error)
{
    Debug.LogError("Error submitting score: " + error.GenerateErrorReport());
}

2. 랭킹 계산 및 보상 분배 로직 구현

서버 측에서는 Cloud Script로 주기적인 랭킹 갱신 및 보상 분배 스크립트를 작성할 수 있습니다. 특정 주기마다 모든 유저의 순위를 계산하고, 해당 순위에 맞는 보상을 분배합니다.

handlers.distributeRewards = function (args, context) {
    const leaderboard = server.GetLeaderboard({
        StatisticName: "LeaderboardScore",
        StartPosition: 0,
        MaxResultsCount: 100
    });

    leaderboard.Leaderboard.forEach((player, index) => {
        let reward = calculateReward(index + 1);  // 순위에 따른 보상 계산 함수 호출
        server.GrantItemsToUser({
            PlayFabId: player.PlayFabId,
            ItemIds: [reward]
        });
    });
};

function calculateReward(rank) {
    if (rank === 1) return "GoldReward";
    else if (rank <= 10) return "SilverReward";
    else return "BronzeReward";
}

3. 클라이언트에서 보상 수령

유저가 랭킹 보상을 클레임할 수 있도록 UI를 제공하며, 해당 보상을 인벤토리에 추가합니다.

public void ClaimReward()
{
    PlayFabClientAPI.GetUserInventory(new GetUserInventoryRequest(), result =>
    {
        foreach (var item in result.Inventory)
        {
            Debug.Log("Reward item: " + item.DisplayName);
            // 보상 아이템을 인벤토리에 추가하는 로직
        }
    }, OnError);
}