【Unity】PlayerPrefsを使ったランキング管理の実装
Unityでランキングを管理するために、PlayerPrefsを使用して名前、得点、日時を保存し、得点でソートする方法を紹介します。ゲームを再起動しても記録が残るように実装します。
この記事の進め方
Unityの2Dプロジェクトで進めます。プロジェクト名は RankingDemo にしましょう(2D テンプレートで作成します)。上から順に進めれば、ランキングが表示されます。
- プロジェクトの作り方が分からない方は、Unity のインストールとプロジェクト作成から始めてください
- Canvas などの UI が初めての方は、UI(Canvas)の基本を先に見ておくと安心です
- この記事で、データのクラス → 管理のクラス → 表示の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)を作っておきます。
- メニューの
GameObject > UI (Canvas) > Canvasを選んで、Canvas を作ります。 - Hierarchy で Canvas を右クリックして Create Empty を選び、Canvas の子として空のオブジェクトを作ります。名前を RankingContainer にします。幅と高さは、ランキングが収まる大きさ(例:幅 600、高さ 450)にします。
- RankingContainer に Vertical Layout Group を追加します(Add Component から検索します)。Control Child Size は Width と Height の両方にチェックを入れ、Child Force Expand は Width だけチェックして Height のチェックは外します。Width にもチェックを入れないと、行の幅が 0 になって何も表示されません。設定は下の画像のとおりです(クリックで拡大できます)。

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



UI要素の設定
- 各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 をもう少し小さくします。
- 3つのテキストの名前を、上から
- Panelオブジェクトにコンポーネントを追加します。
- Layout Element コンポーネントを追加し、Preferred Height を 40 にします(行の高さが決まり、縦に並べたときに重なりません)。

プレハブとして保存
- Hierarchy で Panel を選び、名前を RankingEntry に変えます(右クリック > Rename、または F2 キー)。この名前が、そのままプレハブのファイル名になります。
- Project ウィンドウの Assets の中に Prefabs フォルダを作ります(右クリック > Create > Folder)。
- Hierarchy の RankingEntry を、Project ウィンドウの Prefabs フォルダにドラッグします。Hierarchy の RankingEntry が青い文字に変わり、Prefabs フォルダに RankingEntry ができれば、プレハブの完成です。これを RankingUI の rankingEntryPrefab に設定する作業は、あとの「インターフェースの構築」で行います。
- プレハブにしたあと、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エディタ内で、以下の手順でインターフェースを構築します。
- Hierarchy の何もないところ(一番下の空白部分)で右クリックして Create Empty を選び、名前を RankingSystem にします。RankingManager、RankingUI、TestRanking の3つのスクリプトを、RankingSystem にドラッグ&ドロップして付けます。
- RankingSystem の RankingUI で、rankingManager に RankingSystem、rankingEntryPrefab に Prefabs フォルダの RankingEntry(青い箱のアイコンのほう。Scripts フォルダにある同じ名前のスクリプトではありません)、rankingContainer に RankingContainer をドラッグ&ドロップして設定します。
- 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なので、シングルトンにしなくてもデータ自体はシーン間で共通です。シーンごとに配置し直すのが苦でなければ、この記事の形のままで問題ありません。








ディスカッション
コメント一覧
まだ、コメントがありません