Unityチュートリアル：DontDestroyOnLoadでプレイヤーをシーン間に保持する（責務分離対応）

2025年5月21日

対象者

• Unity初心者〜中級者
• プレイヤーを複数シーンで共通に使いたい方
• スクリプトの責務分離や保守性にも関心のある方

プロジェクト構成例

Assets/
├── Prefabs/
│   ├── Player.prefab
│   └── Canvas.prefab（共通UI）
├── Scenes/
│   ├── TitleScene.unity
│   ├── StageSelectScene.unity
│   └── GameScene.unity
├── Scripts/
│   ├── PlayerController.cs         ← プレイヤーの永続化のみ
│   ├── PlayerSpawnHandler.cs       ← 出現位置移動の処理
│   ├── TitleSceneController.cs
│   ├── StageSelectController.cs
│   └── SceneNameDisplay.cs

シーン概要

1. プレイヤーの作成と分離管理

1-1. PlayerController.cs（永続化・Singleton）

using UnityEngine;

public class PlayerController : MonoBehaviour
{
    public static PlayerController Instance;

    void Awake()
    {
        if (Instance == null)
        {
            Instance = this;
            DontDestroyOnLoad(gameObject);
        }
        else
        {
            Destroy(gameObject);
        }
    }
}

このスクリプトは 「プレイヤーを一度だけ生成し、以降のシーン間で維持」 する責任のみを持ちます。

1-2. PlayerSpawnHandler.cs（出現位置制御）

using UnityEngine;
using UnityEngine.SceneManagement;

public class PlayerSpawnHandler : MonoBehaviour
{
    void OnEnable()
    {
        SceneManager.sceneLoaded += OnSceneLoaded;
    }

    void OnDisable()
    {
        SceneManager.sceneLoaded -= OnSceneLoaded;
    }

    void OnSceneLoaded(Scene scene, LoadSceneMode mode)
    {
        if (PlayerController.Instance == null) return;

        var spawn = GameObject.FindWithTag("SpawnPoint");
        if (spawn != null)
        {
            PlayerController.Instance.transform.position = spawn.transform.position;
        }
    }
}

GameManager や空オブジェクトにアタッチするだけで機能します。

Player に直接アタッチしても問題ありません（初学者向けにはこの方が扱いやすい）。

2. プレイヤープレハブの作成

1. Hierarchy に Player を作成（3Dなら Capsule、2Dなら Sprite）
2. Tag を “Player" に設定
3. Rigidbody, Collider などを必要に応じて追加
4. PlayerController.cs をアタッチ
5. Prefab化して Assets/Prefabs/Player.prefab に保存

3. 出現地点（SpawnPoint）の配置

• 各ゲーム用シーン（例：GameScene）に Empty オブジェクトを配置
• 名前：任意（例：SpawnPoint）
• Tag：SpawnPoint

4. TitleSceneの設定

ボタンのUI設定（例：Show Stage Select）

• Canvas上に Button を配置し、Textは Show Stage Select
• OnClick() に以下の関数を追加：

TitleSceneController.OnStartGame()

スクリプト：TitleSceneController.cs

using UnityEngine;
using UnityEngine.SceneManagement;

public class TitleSceneController : MonoBehaviour
{
    public GameObject playerPrefab;

    public void OnStartGame()
    {
        if (PlayerController.Instance == null)
        {
            Instantiate(playerPrefab);
        }

        SceneManager.LoadScene("StageSelectScene");
    }
}

インスペクタから playerPrefab にプレイヤーのプレハブを割り当てます。

using UnityEngine;
using UnityEngine.UI;
using UnityEngine.SceneManagement;

public class TitleSceneController : MonoBehaviour
{
    public GameObject playerPrefab;
    public Button showStageSelectButton; // インスペクターでアサインする

    void Awake()
    {
        if (showStageSelectButton != null)
        {
            showStageSelectButton.onClick.AddListener(OnStartGame);
        }
        else
        {
            Debug.LogWarning("showStageSelectButton がアサインされていません。");
        }
    }

    public void OnStartGame()
    {
        if (PlayerController.Instance == null)
        {
            Instantiate(playerPrefab);
        }

        SceneManager.LoadScene("StageSelectScene");
    }
}

5. ステージ選択画面の設定

スクリプト：StageSelectController.cs

using UnityEngine;
using UnityEngine.SceneManagement;

public class StageSelectController : MonoBehaviour
{
    public void OnStageSelected(int stageNumber)
    {
        SceneManager.LoadScene("GameScene");
    }
}

ステージごとに異なるシーンをロードする構成への拡張も可能です。

6. シーン名表示（TextMeshPro対応）

スクリプト：SceneNameDisplay.cs

using UnityEngine;
using UnityEngine.SceneManagement;
using TMPro;

public class SceneNameDisplay : MonoBehaviour
{
    void Start()
    {
        if (TryGetComponent<TextMeshProUGUI>(out var text))
        {
            text.text = SceneManager.GetActiveScene().name;
        }
    }
}

• Canvas に Text(TMP) を配置してアタッチするだけで、各シーンの名前が自動表示されます。

7. タイトルに戻る（オプション）

public void OnReturnToTitle()
{
    if (PlayerController.Instance != null)
    {
        Destroy(PlayerController.Instance.gameObject);
    }
    SceneManager.LoadScene("TitleScene");
}

プレイヤーを明示的に破棄してから再起動する設計です。

8. Build Settingsの確認

File > Build Settings にて次のシーンを登録：

• Scenes/TitleScene
• Scenes/StageSelectScene
• Scenes/GameScene

順番は任意ですが、必ず登録が必要です。

チェックリスト

• プレイヤーは TitleScene で1度だけ生成される
• シーン間でプレイヤーが維持される（DontDestroyOnLoad）
• 各シーンで SpawnPoint に移動できる
• シーン名が UI に表示される
• タイトルに戻ると再生成される

発展アイデア

まとめ

このチュートリアルでは：

• プレイヤーを DontDestroyOnLoad で維持
• 出現地点をシーンごとに配置し、自動で移動
• シーン名を自動表示
• 責務分離で保守しやすいコード構造を実現

初心者でも取り組みやすく、今後のプロジェクト設計にも応用できる構成です。

void OnSceneLoaded(Scene scene, LoadSceneMode mode)
{
    StartCoroutine(WaitAndWarp());
}

IEnumerator WaitAndWarp()
{
    yield return null; // 1フレーム待つ（すべての Start() 後）

    if (PlayerController.Instance == null) yield break;

    var spawn = GameObject.FindWithTag("SpawnPoint");
    if (spawn != null)
    {
        PlayerController.Instance.transform.position = spawn.transform.position;
    }
}