SRPGデバッグツール制作｜戦闘テストを高速化する仕組み

デバッグツールは、開発効率を大幅に向上させます。

ステージスキップやユニット強化を実装すれば、テストが高速化します。

この記事では、実装方法を詳しく解説します。

✨ この記事でわかること

デバッグメニューの実装
ステージスキップ機能
ユニット強化機能
イベント強制発火機能
実装例とコード

ゲーム開発講師

デバッグツールは、開発効率を大幅に向上させます。最初に実装すれば、後から楽になります。

＼あなたにピッタリのシミュレーションゲーム制作講座を見つけよう！／

おすすめ第1位

経営シミュレーション×
農場ゲームの作り方講座

★★★★★ (Unity6対応)

Unity6対応・農場×経営の2ジャンル融合。AIエージェントを独自実装できる唯一の講座。未経験でも完成まで到達できる丁寧な解説が魅力。

講座を購読する＼大人気ジャンル！農場も経営もコレ1本で完成／

本格派・高難易度

UnityシミュレーションRPG
の作り方講座（SRPG）

★★★★★ (全16回)

本格SRPGのAI設計・グリッドシステムを全16回で習得。制作難易度が高いSRPGを作れるスキルは、他と大きく差がつく強みになります。

講座を購読する＼もう挫折しない！難解なグリッドシステムを完全攻略／

初心者にもおすすめ

Unity ノンフィールドRPG
＋スレスパ風JRPG講座

★★★★★ (Unity6対応)

Unity ノンフィールドRPGの作り方講座＋Slay the Spire風デッキ構築JRPGの作り方講座

Slay the Spire風デッキ構築×JRPGをUnityで実装。Unity6・スマホ化対応で、初心者がゲーム開発の第一歩を踏み出すのに最適な講座です。

講座を購読する＼Unity6対応の最新技術！トレンドのシステムを最速実装／

ゲームを「遊ぶ側」から「作る側」へ

あなたのオリジナルゲーム、今年こそ完成させませんか？

RPG・アクション・ホラー…Unityで本格ゲームを作りたい人のための学習サイトです。

Unity入門の森｜永久会員チケット

全講座ラインナップを見てみる

実際に完成するゲームを題材に、
ソースコード・素材・プロジェクト一式をすべて公開。
仕事や学校の合間の1〜2時間でも、
「写経→改造」で自分のゲームまで作りきれる環境です。

デバッグメニューの実装
1. デバッグメニューシステム
ステージスキップ機能
1. ステージスキップシステム
ユニット強化機能
1. ユニット強化システム
イベント強制発火機能
1. イベント強制発火システム
実装例：完全なデバッグツール
よくある質問（FAQ）
シミュレーションゲームを作りたいなら！Unity入門の森のシミュレーション制作講座で本格ゲーム開発に挑戦しよう
まとめ

デバッグメニューの実装

SRPGを開発していると、「特定の戦闘だけを何度も確認したい」「ユニットを強化した状態でバランスを見たい」といった場面が頻繁に出てきます。

しかし、そのたびに通常プレイを最初から進めていると、テストだけで大量の時間を消費してしまいます。

そこで役に立つのがデバッグメニューです。

デバッグメニューとは、開発中のみ使用する専用UIで、ステージスキップやユニット強化などのテスト機能をワンクリックで実行できる仕組みを指します。

最初に用意しておくことで、戦闘テストやイベント確認の効率が大きく向上します。

ここでは、Unityで動作するシンプルなデバッグメニューを例に、基本的な実装方法を解説します。

デバッグメニューシステム

今回のデバッグメニューは、画面上にパネルを表示し、ボタン操作によって各種デバッグ機能を呼び出す構成になっています。

また、本番ビルドに誤って表示されないよう、UNITY_EDITOR や DEVELOPMENT_BUILD のみで有効化する点も重要です。

以下のコードでは、F1キーを押すことでデバッグメニューの表示・非表示を切り替えられます。

各ボタンには「ステージスキップ」「ユニット強化」「イベント強制発火」などの処理を割り当てています。

using UnityEngine;
using UnityEngine.UI;

public class DebugMenu : MonoBehaviour
{
    public GameObject debugPanel;
    public Button stageSkipButton;
    public Button unitBoostButton;
    public Button eventTriggerButton;
    public Button levelUpButton;
    
    private bool isDebugMode = false;
    
    void Start()
    {
        // デバッグモードのチェック
        #if UNITY_EDITOR || DEVELOPMENT_BUILD
        isDebugMode = true;
        #endif
        
        if (isDebugMode)
        {
            InitializeDebugMenu();
        }
        else
        {
            debugPanel.SetActive(false);
        }
    }
    
    void InitializeDebugMenu()
    {
        stageSkipButton.onClick.AddListener(OnStageSkip);
        unitBoostButton.onClick.AddListener(OnUnitBoost);
        eventTriggerButton.onClick.AddListener(OnEventTrigger);
        levelUpButton.onClick.AddListener(OnLevelUp);
    }
    
    void Update()
    {
        // F1キーでデバッグメニューを表示／非表示
        if (isDebugMode && Input.GetKeyDown(KeyCode.F1))
        {
            debugPanel.SetActive(!debugPanel.activeSelf);
        }
    }
    
    void OnStageSkip()
    {
        StageManager.Instance.SkipToNextStage();
    }
    
    void OnUnitBoost()
    {
        Unit selectedUnit = UnitSelector.Instance.GetSelectedUnit();
        if (selectedUnit != null)
        {
            selectedUnit.attack += 10;
            selectedUnit.defense += 10;
            selectedUnit.maxHP += 50;
            selectedUnit.currentHP = selectedUnit.maxHP;
        }
    }
    
    void OnEventTrigger()
    {
        EventManager.Instance.TriggerEvent("test_event");
    }
    
    void OnLevelUp()
    {
        Unit selectedUnit = UnitSelector.Instance.GetSelectedUnit();
        if (selectedUnit != null)
        {
            selectedUnit.level++;
            selectedUnit.currentExp = 0;
        }
    }
}

using UnityEngine;

using UnityEngine.UI;

public class DebugMenu : MonoBehaviour

{

public GameObject debugPanel;

public Button stageSkipButton;

public Button unitBoostButton;

public Button eventTriggerButton;

public Button levelUpButton;

private bool isDebugMode = false;

void Start()

{

// デバッグモードのチェック

#if UNITY_EDITOR || DEVELOPMENT_BUILD

isDebugMode = true;

#endif

if (isDebugMode)

{

InitializeDebugMenu();

}

else

{

debugPanel.SetActive(false);

}

void InitializeDebugMenu()

{

stageSkipButton.onClick.AddListener(OnStageSkip);

unitBoostButton.onClick.AddListener(OnUnitBoost);

eventTriggerButton.onClick.AddListener(OnEventTrigger);

levelUpButton.onClick.AddListener(OnLevelUp);

}

void Update()

{

// F1キーでデバッグメニューを表示／非表示

if (isDebugMode && Input.GetKeyDown(KeyCode.F1))

{

debugPanel.SetActive(!debugPanel.activeSelf);

}

void OnStageSkip()

{

StageManager.Instance.SkipToNextStage();

}

void OnUnitBoost()

{

Unit selectedUnit = UnitSelector.Instance.GetSelectedUnit();

if (selectedUnit != null)

{

selectedUnit.attack += 10;

selectedUnit.defense += 10;

selectedUnit.maxHP += 50;

selectedUnit.currentHP = selectedUnit.maxHP;

}

void OnEventTrigger()

{

EventManager.Instance.TriggerEvent("test_event");

}

void OnLevelUp()

{

Unit selectedUnit = UnitSelector.Instance.GetSelectedUnit();

if (selectedUnit != null)

{

selectedUnit.level++;

selectedUnit.currentExp = 0;

}

このスクリプトを使えば、開発中のみデバッグメニューを表示し、キー操作ひとつで各種テスト機能を呼び出せます。

戦闘テストや後半ステージの確認を何度も行うSRPGでは、早い段階で導入しておくと作業効率が大きく変わります。

ステージスキップ機能

ステージスキップ機能は、デバッグメニューから実行できる代表的なデバッグ機能のひとつです。

通常プレイでは最初のステージから順番に進める必要がありますが、開発中のテストではこの制限が大きな負担になります。

特にSRPGでは、後半ステージの戦闘バランスやイベント演出を確認したい場面が多く、そのたびに序盤からプレイし直すのは非効率です。

ステージスキップを用意しておくことで、確認したいステージに即座に移動できる環境を作れます。

ここでは、デバッグメニューから呼び出すことを前提とした、シンプルなステージスキップ機能の実装例を紹介します。

ステージスキップシステム

このシステムでは、ステージ番号を指定して直接ロードする仕組みを用意しています。

現在のステージを終了させたうえで、指定したステージを読み込むため、通常のゲーム進行を大きく崩さずにテストが可能です。

「次のステージへ進む」「前のステージに戻る」といった操作も用意しておくと、連続したステージを確認したい場合のテスト効率がさらに向上します。

public class StageSkipSystem : MonoBehaviour
{
    public void SkipToStage(int stageNumber)
    {
        // 現在のステージを終了
        StageManager.Instance.EndCurrentStage();
        
        // 指定ステージを開始
        StageManager.Instance.LoadStage(stageNumber);
        
        Debug.Log($"ステージ{stageNumber}にスキップしました");
    }
    
    public void SkipToNextStage()
    {
        int currentStage = StageManager.Instance.GetCurrentStageNumber();
        SkipToStage(currentStage + 1);
    }
    
    public void SkipToPreviousStage()
    {
        int currentStage = StageManager.Instance.GetCurrentStageNumber();
        if (currentStage > 1)
        {
            SkipToStage(currentStage - 1);
        }
    }
}

public class StageSkipSystem : MonoBehaviour

{

public void SkipToStage(int stageNumber)

{

// 現在のステージを終了

StageManager.Instance.EndCurrentStage();

// 指定ステージを開始

StageManager.Instance.LoadStage(stageNumber);

Debug.Log($"ステージ{stageNumber}にスキップしました");

}

public void SkipToNextStage()

{

int currentStage = StageManager.Instance.GetCurrentStageNumber();

SkipToStage(currentStage + 1);

}

public void SkipToPreviousStage()

{

int currentStage = StageManager.Instance.GetCurrentStageNumber();

if (currentStage > 1)

{

SkipToStage(currentStage - 1);

}

このスクリプトをデバッグメニューのボタンと連携させることで、ワンクリックで任意のステージへ移動できるようになります。

後半ステージの戦闘確認や、特定イベントのテストを行う際に非常に有効です。

ゲーム開発講師

ステージスキップは、特に後半ステージのテストで効果を発揮します。
バランス調整や難易度確認を何度も行う場合、作業時間を大幅に短縮できます。

【ゲームの作り方講座プレゼント中！】

ユニット強化機能

ユニット強化機能は、テスト用にユニットを強化できます。

実装方法を紹介します。

ユニット強化システム

public class UnitBoostSystem : MonoBehaviour
{
    public void BoostUnit(Unit unit, int level, int attack, int defense, int hp)
    {
        // レベルを設定
        unit.level = level;
        
        // ステータスを強化
        unit.attack += attack;
        unit.defense += defense;
        unit.maxHP += hp;
        unit.currentHP = unit.maxHP;
        
        Debug.Log($"{unit.unitName}を強化しました");
    }
    
    public void MaxBoostUnit(Unit unit)
    {
        // 最大強化
        BoostUnit(unit, 99, 100, 100, 1000);
    }
    
    public void ResetUnit(Unit unit)
    {
        // 初期状態にリセット
        unit.level = 1;
        unit.attack = unit.baseAttack;
        unit.defense = unit.baseDefense;
        unit.maxHP = unit.baseHP;
        unit.currentHP = unit.maxHP;
    }
}

public class UnitBoostSystem : MonoBehaviour

{

public void BoostUnit(Unit unit, int level, int attack, int defense, int hp)

{

// レベルを設定

unit.level = level;

// ステータスを強化

unit.attack += attack;

unit.defense += defense;

unit.maxHP += hp;

unit.currentHP = unit.maxHP;

Debug.Log($"{unit.unitName}を強化しました");

}

public void MaxBoostUnit(Unit unit)

{

// 最大強化

BoostUnit(unit, 99, 100, 100, 1000);

}

public void ResetUnit(Unit unit)

{

// 初期状態にリセット

unit.level = 1;

unit.attack = unit.baseAttack;

unit.defense = unit.baseDefense;

unit.maxHP = unit.baseHP;

unit.currentHP = unit.maxHP;

}

このコードで、ユニット強化が実装できます。

テスト用にユニットを強化できます。

イベント強制発火機能

イベント強制発火機能は、テスト用にイベントを発火できます。

実装方法を紹介します。

イベント強制発火システム

public class EventTriggerSystem : MonoBehaviour
{
    public EventManager eventManager;
    
    public void TriggerEvent(string eventID)
    {
        BusinessEvent evt = eventManager.GetEvent(eventID);
        if (evt != null)
        {
            eventManager.TriggerEvent(evt);
            Debug.Log($"イベントを強制発火: {eventID}");
        }
        else
        {
            Debug.LogWarning($"イベントが見つかりません: {eventID}");
        }
    }
    
    public void TriggerRandomEvent()
    {
        BusinessEvent evt = eventManager.GetRandomEvent();
        if (evt != null)
        {
            eventManager.TriggerEvent(evt);
            Debug.Log("ランダムイベントを強制発火しました");
        }
    }
    
    public void ListAllEvents()
    {
        List<BusinessEvent> allEvents = eventManager.GetAllEvents();
        foreach (var evt in allEvents)
        {
            Debug.Log($"イベントID: {evt.eventID}, タイトル: {evt.eventTitle}");
        }
    }
}

public class EventTriggerSystem : MonoBehaviour

{

public EventManager eventManager;

public void TriggerEvent(string eventID)

{

BusinessEvent evt = eventManager.GetEvent(eventID);

if (evt != null)

{

eventManager.TriggerEvent(evt);

Debug.Log($"イベントを強制発火: {eventID}");

}

else

{

Debug.LogWarning($"イベントが見つかりません: {eventID}");

}

public void TriggerRandomEvent()

{

BusinessEvent evt = eventManager.GetRandomEvent();

if (evt != null)

{

eventManager.TriggerEvent(evt);

Debug.Log("ランダムイベントを強制発火しました");

}

public void ListAllEvents()

{

List<BusinessEvent> allEvents = eventManager.GetAllEvents();

foreach (var evt in allEvents)

{

Debug.Log($"イベントID: {evt.eventID}, タイトル: {evt.eventTitle}");

}

このコードで、イベント強制発火が実装できます。

テスト用にイベントを発火できます。

実装例：完全なデバッグツール

実際に使える、完全なデバッグツールの実装例を紹介します。

using UnityEngine;

public class CompleteDebugTools : MonoBehaviour
{
    [Header("システム")]
    public DebugMenu debugMenu;
    public StageSkipSystem stageSkip;
    public UnitBoostSystem unitBoost;
    public EventTriggerSystem eventTrigger;
    
    void Start()
    {
        // デバッグツールを初期化
        if (IsDebugMode())
        {
            InitializeDebugTools();
        }
    }
    
    bool IsDebugMode()
    {
        #if UNITY_EDITOR || DEVELOPMENT_BUILD
        return true;
        #else
        return false;
        #endif
    }
    
    void InitializeDebugTools()
    {
        // デバッグツールを有効化
        debugMenu.gameObject.SetActive(true);
    }
}