【Unity】PlayerPrefsを使ったランキング管理の実装

2026年11月2日

広告

Unityでランキングを管理するために、PlayerPrefsを使用して名前、得点、日時を保存し、得点でソートする方法を紹介します。ゲームを再起動しても記録が残るように実装します。

この記事の進め方

Unityの2Dプロジェクトで進めます。プロジェクト名は RankingDemo にしましょう(2D テンプレートで作成します)。上から順に進めれば、ランキングが表示されます。

  1. プロジェクトの作り方が分からない方は、Unity のインストールとプロジェクト作成から始めてください
  2. Canvas などの UI が初めての方は、UI(Canvas)の基本を先に見ておくと安心です
  3. この記事で、データのクラス → 管理のクラス → 表示のUI → シーンの設定の順に作ります

ランキングデータのクラスを作成する

まず、ランキングデータを保持するためのクラスを作成します。

Project ウィンドウの Assets の中に Scripts フォルダを作り(右クリック > Create > Folder)、そのフォルダの中で右クリック > Create > MonoBehaviour Script を選びます。名前の入力欄が出たら、RankingEntry のように、下のコードのクラス名と同じ名前を入力して Return キーを押します。ファイルを開いて、中身を全部消してから、下のコードを貼り付けます。名前とクラス名が違うと、あとでオブジェクトに付けられません。

using System;

[Serializable]
public class RankingEntry
{
    public string name;
    public int score;
    public string date;

    public RankingEntry(string name, int score, string date)
    {
        this.name = name;
        this.score = score;
        this.date = date;
    }
}

このクラスの役割

RankingEntry は、ランキングの1行分(名前・得点・日時)をまとめて持つ入れ物です。

  • [Serializable] は「このクラスを JSON などの文字列に変換できるようにする印」です。次の RankingManager で、リストを JSON にして保存するために必要です。
  • date を DateTime ではなく文字列にしているのは、JsonUtility が DateTime をそのまま変換できないためです。保存時に "2026/10/30 12:34" のような文字列にします。
  • このクラスは MonoBehaviour を継承しないので、シーン上のオブジェクトには付けません。作成時に「MonoBehaviour Script」を選んでも、中身を全部書き換えるので問題ありません。

ランキングデータの管理クラスを作成する

次に、リストをJSON形式でシリアライズし、それをPlayerPrefsに保存し、読み込む方法を示します。

Scripts フォルダで、1章と同じ手順で RankingManager という名前のスクリプトを作り、中身を全部消してから下のコードを貼り付けます。

using System;
using System.Collections.Generic;
using UnityEngine;

public class RankingManager : MonoBehaviour
{
    private List<RankingEntry> rankingEntries;

    void Awake()
    {
        LoadRanking();
    }

    public void AddRankingEntry(string name, int score)
    {
        RankingEntry newEntry = new RankingEntry(name, score, DateTime.Now.ToString("yyyy/MM/dd HH:mm"));
        rankingEntries.Add(newEntry);
        SaveRanking();
    }

    public List<RankingEntry> GetRankingEntries()
    {
        rankingEntries.Sort((x, y) => y.score.CompareTo(x.score));
        return rankingEntries;
    }

    // 保存したランキングを全部消します(動作確認のやり直し用)
    public void ClearRanking()
    {
        PlayerPrefs.DeleteKey("RankingData");
        rankingEntries = new List<RankingEntry>();
    }

    private void LoadRanking()
    {
        string json = PlayerPrefs.GetString("RankingData", "");
        if (!string.IsNullOrEmpty(json))
        {
            RankingList rankingList = JsonUtility.FromJson<RankingList>(json);
            rankingEntries = rankingList.rankingEntries;
        }
        else
        {
            rankingEntries = new List<RankingEntry>();
        }
    }

    private void SaveRanking()
    {
        rankingEntries.Sort((x, y) => y.score.CompareTo(x.score)); // スコアでソート
        RankingList rankingList = new RankingList { rankingEntries = rankingEntries };
        string json = JsonUtility.ToJson(rankingList);
        PlayerPrefs.SetString("RankingData", json);
        PlayerPrefs.Save();
    }

    [Serializable]
    private class RankingList
    {
        public List<RankingEntry> rankingEntries;
    }
}

保存と読み込みの流れ

PlayerPrefs に保存できるのは、数値や文字列などの単純な型だけです。そこで、次の流れにします。

  • ランキングのリスト(List<RankingEntry>)を JSON という文字列に変換する
  • その文字列を、キー "RankingData" で PlayerPrefs に保存する
  • 起動時(Awake)に文字列を読み出し、リストに戻す

なぜ RankingList で包むのか

JsonUtility は List を直接 JSON にできません。そこで、リストを1つ持つだけの入れ物クラス RankingList を作り、それを変換しています。[Serializable] が付いているのも同じ理由です。

各メソッドの役割

  • AddRankingEntry(name, score):日時を付けて1件追加し、保存します。
  • GetRankingEntries():スコアの高い順に並べて返します。
  • ClearRanking():保存データを全部消します(動作確認のやり直し用)。
  • LoadRanking() / SaveRanking():PlayerPrefs との読み書きです(外部からは呼びません)。

並び替えの書き方

(x, y) => y.score.CompareTo(x.score) は「ラムダ式」で、2件を比べるルールをその場で書く方法です。通常の x.score.CompareTo(y.score) は昇順ですが、x と y を入れ替えると得点の高い順(降順)になります。保存前にも並べ替えているので、保存データは常に得点順です。

PlayerPrefs.Save() は、データをディスクに確実に書き込むための呼び出しです。

ランキングを表示するUIを作成する

TextMeshProを使ってランキングを表示します。

Scripts フォルダで、1章と同じ手順で RankingUI という名前のスクリプトを作り、中身を全部消してから下のコードを貼り付けます。

using UnityEngine;
using TMPro;
using System.Collections.Generic;

public class RankingUI : MonoBehaviour
{
    public RankingManager rankingManager;
    public GameObject rankingEntryPrefab;
    public RectTransform rankingContainer;

    public int maxEntriesToShow = 10;

    void Start()
    {
        DisplayRanking();
    }

    public void DisplayRanking()
    {
        foreach (Transform child in rankingContainer)
        {
            Destroy(child.gameObject);
        }

        List<RankingEntry> rankingEntries = rankingManager.GetRankingEntries();
        for (int i = 0; i < maxEntriesToShow; i++)
        {
            GameObject entryObject = Instantiate(rankingEntryPrefab, rankingContainer);
            if (i < rankingEntries.Count)
            {
                RankingEntry entry = rankingEntries[i];
                entryObject.transform.Find("Name").GetComponent<TextMeshProUGUI>().text = entry.name;
                entryObject.transform.Find("Score").GetComponent<TextMeshProUGUI>().text = entry.score.ToString();
                entryObject.transform.Find("Date").GetComponent<TextMeshProUGUI>().text = entry.date;
            }
            else
            {
                entryObject.transform.Find("Name").GetComponent<TextMeshProUGUI>().text = "";
                entryObject.transform.Find("Score").GetComponent<TextMeshProUGUI>().text = "";
                entryObject.transform.Find("Date").GetComponent<TextMeshProUGUI>().text = "";
            }
        }
    }
}

このコードの流れ

DisplayRanking() は次の順に動きます。

  • 前回表示した行を、Destroy ですべて消します(重複を防ぐため)。
  • 上位 maxEntriesToShow 件(初期値 10)ぶん、プレハブから行を Instantiate で作ります。
  • 各行の Name / Score / Date の TextMeshProUGUI に値を入れます。

記録が10件に満たなくても、空文字の行を作ります。記録の数に関わらず、表の高さと見た目が変わらないようにするためです。

1行ずつ読み解く:Find と GetComponent

値を入れる行は、次のように3つの操作がつながっています。

  • entryObject.transform.Find("Name"):生成した行のプレハブから、「Name」という名前の子オブジェクトを探します。
  • .GetComponent<TextMeshProUGUI>():見つけたオブジェクトから、文字を表示する部品(TextMeshProUGUI)を取り出します。
  • .text = ...:その部品の表示文字を書き換えます。

記録がある行では entry.name、entry.score.ToString()、entry.date を入れます。得点は整数(int)なので、文字に変換する ToString() が必要です。

記録がない行(else の側)では、同じ書き方で .text = "" と空文字を入れます。これで、その行は空欄になります。

注意:プレハブ内の子オブジェクトを transform.Find("Name") のように名前で探しています。プレハブに付けた名前(Name / Score / Date)とコードの文字列が一致していないと、値が表示されません。

rankingEntryPrefabの作り方

rankingEntryPrefab は、ランキングの各エントリーを表示するためのプレハブです。これを作成するためには、Unityエディタ内でUI要素をデザインし、それをプレハブとして保存する必要があります。以下の手順でrankingEntryPrefab を作成します。

TextMeshProをインポート

TextMeshProの素材は、最初に Text - TextMeshPro を作るときに自動で入ります。「TMP Importer」の画面が出たら Import TMP Essentials を押してください。Package Manager からの操作は不要です。

ランキングを並べる入れ物を作る

先に、ランキングの行を縦に並べる入れ物(RankingContainer)を作っておきます。

  1. メニューの GameObject > UI (Canvas) > Canvas を選んで、Canvas を作ります。
  2. Hierarchy で Canvas を右クリックして Create Empty を選び、Canvas の子として空のオブジェクトを作ります。名前を RankingContainer にします。幅と高さは、ランキングが収まる大きさ(例:幅 600、高さ 450)にします。
  3. RankingContainer に Vertical Layout Group を追加します(Add Component から検索します)。Control Child Size は Width と Height の両方にチェックを入れ、Child Force Expand は Width だけチェックして Height のチェックは外します。Width にもチェックを入れないと、行の幅が 0 になって何も表示されません。設定は下の画像のとおりです(クリックで拡大できます)。

UI要素をデザイン

  1. Hierarchy で Canvas をクリックして選び、GameObject > UI (Canvas) > Panel を選びます。Canvas の子として Panel ができます。これがrankingEntryPrefabのベースとなります。
  2. Panel の大きさは、あとで Vertical Layout Group が自動で決めます。ここでは調整しなくて大丈夫です。
  3. Panel を選んだまま、GameObject > UI (Canvas) > Text - TextMeshPro を3回選び、名前・得点・日時を表示するテキストを3つ作ります。作ったテキストが Canvas の直下にできたときは、Hierarchy で Panel の上にドラッグして、Panel の子にします。

UI要素の設定

  1. 各TextMeshProオブジェクトを選択し、Inspectorで以下の設定を行います。
    • 3つのテキストの名前を、上から Name、Score、Date に変えます。
    • Rect Transform を設定します。3つとも Width を 200、Height を 40 にします。Pos X は、Name を -200、Score を 0、Date を 200 にします(左から Name、Score、Date の順に並びます)。Pos Y は 3つとも 0 です。
    • TextMeshPro の Font Size を 20 にして、Alignment を左右中央(Center)にそろえます。文字が折り返されるときは、Font Size をもう少し小さくします。
  2. Panelオブジェクトにコンポーネントを追加します。
    • Layout Element コンポーネントを追加し、Preferred Height を 40 にします(行の高さが決まり、縦に並べたときに重なりません)。

プレハブとして保存

  1. Hierarchy で Panel を選び、名前を RankingEntry に変えます(右クリック > Rename、または F2 キー)。この名前が、そのままプレハブのファイル名になります。
  2. Project ウィンドウの Assets の中に Prefabs フォルダを作ります(右クリック > Create > Folder)。
  3. Hierarchy の RankingEntry を、Project ウィンドウの Prefabs フォルダにドラッグします。Hierarchy の RankingEntry が青い文字に変わり、Prefabs フォルダに RankingEntry ができれば、プレハブの完成です。これを RankingUI の rankingEntryPrefab に設定する作業は、あとの「インターフェースの構築」で行います。
  4. プレハブにしたあと、Hierarchy に残っている RankingEntry は削除します(残したままだと、ランキングの先頭に空の行が表示されます)。

最終的な構造の例

Canvas
├── RankingContainer(Vertical Layout Group)← rankingContainer に設定
└── RankingEntry(プレハブにしたあと、Hierarchy から削除)

Assets/Prefabs/RankingEntry(rankingEntryPrefab に設定)
├── Name(TextMeshPro)
├── Score(TextMeshPro)
└── Date(TextMeshPro)

動作確認用のスクリプトを作成する

ランキングが表示されるか確かめるために、サンプルデータを追加する TestRanking スクリプトを作ります。Scripts フォルダで、1章と同じ手順で TestRanking という名前のスクリプトを作り、中身を全部消してから下のコードを貼り付けます。

using UnityEngine;

public class TestRanking : MonoBehaviour
{
    public RankingManager rankingManager;
    public RankingUI rankingUI;

    void Start()
    {
        // 記録がまだ無いときだけ、サンプルデータを追加します
        if (rankingManager.GetRankingEntries().Count == 0)
        {
            rankingManager.AddRankingEntry("Player1", 100);
            rankingManager.AddRankingEntry("Player2", 200);
            rankingManager.AddRankingEntry("Player3", 150);
        }

        // UIを更新して表示
        rankingUI.DisplayRanking();
    }
}

このコードの流れ

  • Start() で、記録が0件のときだけサンプル3件を追加します。再生を繰り返してもサンプルが増えません。
  • 最後に rankingUI.DisplayRanking() を呼んで、表示を更新します。
  • 動作確認用なので、実際のゲームに組み込むときはこのスクリプトをオブジェクトから外すか、削除してください。

インターフェースの構築

Unityエディタ内で、以下の手順でインターフェースを構築します。

  1. Hierarchy の何もないところ(一番下の空白部分)で右クリックして Create Empty を選び、名前を RankingSystem にします。RankingManager、RankingUI、TestRanking の3つのスクリプトを、RankingSystem にドラッグ&ドロップして付けます。
  2. RankingSystem の RankingUI で、rankingManager に RankingSystem、rankingEntryPrefab に Prefabs フォルダの RankingEntry(青い箱のアイコンのほう。Scripts フォルダにある同じ名前のスクリプトではありません)、rankingContainer に RankingContainer をドラッグ&ドロップして設定します。
  3. TestRanking の rankingManager と rankingUI にも、RankingSystem をドラッグ&ドロップして設定します。

再生すると、ランキングが表示されます。ランキングのデータは、AddRankingEntry を呼んだ時点で PlayerPrefs に保存され、次に起動したときに復元されます。サンプルの3件は、記録が空のときだけ追加されるので、再生し直しても件数は増えません。最初からやり直したいときは、Unity のメニュー Edit > Clear All PlayerPrefs を選んでください。

ゲームから使うとき

ゲームオーバーなどのタイミングで、次の2行を呼び出します。スコアと名前は、ゲームに合わせて渡してください。

rankingManager.AddRankingEntry("名前", score);
rankingUI.DisplayRanking();

呼び出すタイミング

  • 1行目で記録を追加して保存し、2行目で表示を更新します。
  • 呼ぶのは、ゲームオーバーやステージクリアの瞬間です。
  • "名前" と score は、名前の入力欄やゲーム内の得点変数に置き換えます。
  • rankingManager と rankingUI は public で宣言し、Inspector でドラッグ&ドロップして割り当てます。

応用:シーンをまたいで使う場合(シングルトン化)

ここまでの RankingManager は、Inspector で参照を渡して使う普通の MonoBehaviour です。シーンごとに別のオブジェクトになるため、複数のシーンで使うときは各シーンに配置して参照を設定し直す必要があります。

シーンをまたいで1つだけ使いたい場合は、シングルトンにする方法があります。RankingManager の Awake を次のように変更します。

public static RankingManager Instance { get; private set; }

void Awake()
{
    if (Instance != null)
    {
        Destroy(gameObject);
        return;
    }
    Instance = this;
    DontDestroyOnLoad(gameObject);
    LoadRanking();
}

RankingUI では、Inspector で割り当てていた rankingManager の代わりに RankingManager.Instance を使います。

List<RankingEntry> rankingEntries = RankingManager.Instance.GetRankingEntries();

注意点

  • どこからでも呼べて便利な反面、どのクラスが RankingManager に依存しているかが見えにくくなります。
  • 保存先は PlayerPrefs なので、シングルトンにしなくてもデータ自体はシーン間で共通です。シーンごとに配置し直すのが苦でなければ、この記事の形のままで問題ありません。
訪問数 477 回, 今日の訪問数 1回

広告

Unity

Posted by hidepon