ScriptableObjectで管理するステータス設計｜拡張しやすいデータ構造の作り方

SRPGでキャラが50人、武器が100種類。コードに直接書くと、管理が大変です。

ScriptableObjectを使えば、データを外部化して管理できます。

この記事では、実装手順から活用例まで解説します。

✨ この記事でわかること

ScriptableObjectとは何か、なぜ使うのか
ステータスデータの作成手順（スクリプト作成から設定まで）
キャラクターや武器への適用方法
SRPGでの実践的な活用例
よくあるエラーと対処法

ゲーム開発講師

ScriptableObjectを使えば、デザイナーがコードを触らずにデータを編集できます。開発効率が大幅に上がります。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

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

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

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

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

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

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

ScriptableObjectとは
1. なぜScriptableObjectを使うのか
ステータスデータの作成手順
キャラクターへの適用方法
1. 武器データの例
SRPGでの実践的な活用例
1. キャラクター管理の例
2. レベルアップシステムとの連携
よくあるエラーと対処法
1. デバッグのコツ
まとめ

ScriptableObjectとは

ScriptableObjectは、Unityのデータ保存機能です。

コードに直接書かず、アセットとして保存できます。

データを外部化：コードとデータを分離できる
エディタで編集可能：プログラマー以外も編集できる
再利用しやすい：同じデータを複数のオブジェクトで使える
メモリ効率が良い：インスタンスを共有できる

SRPGのように、キャラや武器が大量にあるゲームに最適です。

コードを変更せずに、バランス調整ができます。

なぜScriptableObjectを使うのか

従来の方法では、ステータスをコードに直接書いていました。

問題点は明確です。

⚠️ コードに直接書く場合の問題点

バランス調整のたびにコードを変更する必要がある
デザイナーが編集できない
データが増えるとコードが肥大化する
バージョン管理でコンフリクトしやすい

ScriptableObjectなら、これらの問題を解決できます。

データをアセットとして保存し、エディタで編集可能です。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

ステータスデータの作成手順

実際にScriptableObjectを作成します。

ステップバイステップで進めましょう。

ステップ1：ScriptableObjectクラスを作成

Projectウィンドウで右クリック → Create → C# Script

ファイル名を「CharacterStatus」に変更します。

using UnityEngine;

[CreateAssetMenu(fileName = "NewCharacter", menuName = "Game/Character Status")]
public class CharacterStatus : ScriptableObject
{
    [Header("基本情報")]
    public string characterName;
    public Sprite portrait;
    
    [Header("ステータス")]
    public int maxHP = 100;
    public int attack = 10;
    public int defense = 5;
    public int speed = 8;
    
    [Header("成長率")]
    public float hpGrowth = 1.2f;
    public float attackGrowth = 1.1f;
}

using UnityEngine;

[CreateAssetMenu(fileName = "NewCharacter", menuName = "Game/Character Status")]

public class CharacterStatus : ScriptableObject

{

[Header("基本情報")]

public string characterName;

public Sprite portrait;

[Header("ステータス")]

public int maxHP = 100;

public int attack = 10;

public int defense = 5;

public int speed = 8;

[Header("成長率")]

public float hpGrowth = 1.2f;

public float attackGrowth = 1.1f;

}

このコードのポイント：

[CreateAssetMenu]：エディタで作成できるメニューを追加
ScriptableObjectを継承：データ保存機能を有効化
[Header]：Inspectorで見やすくする

ステップ2：アセットを作成

Projectウィンドウで右クリック
Create → Game → Character Status
ファイル名を「Knight」に変更

これで、ScriptableObjectアセットが作成されました。

Inspectorで、ステータスを編集できます。

ステップ3：ステータスを設定

Inspectorで、以下のように設定します。

Character Name: 「騎士」
Max HP: 120
Attack: 15
Defense: 8
Speed: 6

設定したデータは、アセットとして保存されます。

コードを変更せずに、バランス調整が可能です。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

キャラクターへの適用方法

作成したScriptableObjectを、キャラクターに適用します。

キャラクターのスクリプトで参照しましょう。

using UnityEngine;

public class Character : MonoBehaviour
{
    [Header("ステータスデータ")]
    public CharacterStatus statusData;
    
    private int currentHP;
    
    void Start()
    {
        // ScriptableObjectから初期値を取得
        currentHP = statusData.maxHP;
    }
    
    public int GetAttack()
    {
        return statusData.attack;
    }
    
    public int GetDefense()
    {
        return statusData.defense;
    }
    
    public void TakeDamage(int damage)
    {
        int actualDamage = Mathf.Max(1, damage - statusData.defense);
        currentHP -= actualDamage;
        
        if (currentHP <= 0)
        {
            // 死亡処理
            Debug.Log($"{statusData.characterName}が倒れた");
        }
    }
}

using UnityEngine;

public class Character : MonoBehaviour

{

[Header("ステータスデータ")]

public CharacterStatus statusData;

private int currentHP;

void Start()

{

// ScriptableObjectから初期値を取得

currentHP = statusData.maxHP;

}

public int GetAttack()

{

return statusData.attack;

}

public int GetDefense()

{

return statusData.defense;

}

public void TakeDamage(int damage)

{

int actualDamage = Mathf.Max(1, damage - statusData.defense);

currentHP -= actualDamage;

if (currentHP <= 0)

{

// 死亡処理

Debug.Log($"{statusData.characterName}が倒れた");

}

使い方：

Hierarchyでキャラクターオブジェクトを選択
Inspectorで「Status Data」に、作成したScriptableObjectをドラッグ&ドロップ

これで、キャラクターがScriptableObjectのデータを参照します。

同じScriptableObjectを複数のキャラクターで使えば、データを共有できます。

武器データの例

武器も同様に作成できます。

using UnityEngine;

[CreateAssetMenu(fileName = "NewWeapon", menuName = "Game/Weapon Data")]
public class WeaponData : ScriptableObject
{
    public string weaponName;
    public int attackBonus;
    public int durability;
    public Sprite icon;
}

using UnityEngine;

[CreateAssetMenu(fileName = "NewWeapon", menuName = "Game/Weapon Data")]

public class WeaponData : ScriptableObject

{

public string weaponName;

public int attackBonus;

public int durability;

public Sprite icon;

}

キャラクターに武器を装備させる場合：

public class Character : MonoBehaviour
{
    public CharacterStatus statusData;
    public WeaponData equippedWeapon;
    
    public int GetTotalAttack()
    {
        int baseAttack = statusData.attack;
        int weaponBonus = equippedWeapon != null ? equippedWeapon.attackBonus : 0;
        return baseAttack + weaponBonus;
    }
}

public class Character : MonoBehaviour

{

public CharacterStatus statusData;

public WeaponData equippedWeapon;

public int GetTotalAttack()

{

int baseAttack = statusData.attack;

int weaponBonus = equippedWeapon != null ? equippedWeapon.attackBonus : 0;

return baseAttack + weaponBonus;

}

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

SRPGでの実践的な活用例

SRPGでは、大量のキャラクターと武器を管理します。

ScriptableObjectで、効率的に管理しましょう。

キャラクター管理の例

プレイヤーキャラ：各キャラごとにScriptableObjectを作成
敵キャラ：敵タイプごとにScriptableObjectを作成
成長データ：レベルアップ時の成長率を別のScriptableObjectで管理

フォルダ構成の例：

✅ 推奨フォルダ構成

Assets/ScriptableObjects/Characters/Player/
Assets/ScriptableObjects/Characters/Enemy/
Assets/ScriptableObjects/Weapons/
Assets/ScriptableObjects/Items/

レベルアップシステムとの連携

成長率をScriptableObjectで管理する例：

[CreateAssetMenu(fileName = "NewGrowth", menuName = "Game/Growth Data")]
public class GrowthData : ScriptableObject
{
    public int hpPerLevel = 5;
    public int attackPerLevel = 2;
    public int defensePerLevel = 1;
}

public class Character : MonoBehaviour
{
    public CharacterStatus baseStatus;
    public GrowthData growthData;
    private int level = 1;
    
    public int GetCurrentHP()
    {
        return baseStatus.maxHP + (growthData.hpPerLevel * (level - 1));
    }
}

[CreateAssetMenu(fileName = "NewGrowth", menuName = "Game/Growth Data")]

public class GrowthData : ScriptableObject

{

public int hpPerLevel = 5;

public int attackPerLevel = 2;

public int defensePerLevel = 1;

}

public class Character : MonoBehaviour

{

public CharacterStatus baseStatus;

public GrowthData growthData;

private int level = 1;

public int GetCurrentHP()

{

return baseStatus.maxHP + (growthData.hpPerLevel * (level - 1));

}

これで、レベルアップ時の成長を柔軟に設定できます。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

よくあるエラーと対処法

ScriptableObjectを使う際の、よくあるエラーを紹介します。

対処法も合わせて解説します。

Q: 「NullReferenceException」が発生する
A: ScriptableObjectがアサインされていない可能性があります。Inspectorで、必ずScriptableObjectをドラッグ&ドロップしてください。また、nullチェックを追加しましょう。

public int GetAttack()
{
    if (statusData == null)
    {
        Debug.LogError("StatusDataが設定されていません");
        return 0;
    }
    return statusData.attack;
}

public int GetAttack()

{

if (statusData == null)

{

Debug.LogError("StatusDataが設定されていません");

return 0;

}

return statusData.attack;

}

Q: 実行時にデータが変更されない
A: ScriptableObjectは実行時に変更すると、変更が保存されます。テスト用のコピーを作成するか、EditorOnlyフラグを使いましょう。

Q: 複数のキャラで同じデータを共有したい
A: 同じScriptableObjectアセットを、複数のキャラクターにアサインすればOKです。メモリ効率も良くなります。

デバッグのコツ

ScriptableObjectの値を確認する方法：

void OnValidate()
{
    if (statusData != null)
    {
        Debug.Log($"キャラ名: {statusData.characterName}, HP: {statusData.maxHP}");
    }
}

void OnValidate()

{

if (statusData != null)

{

Debug.Log($"キャラ名: {statusData.characterName}, HP: {statusData.maxHP}");

}

OnValidate()は、Inspectorで値を変更したときに自動で呼ばれます。

デバッグに便利です。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる

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

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

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

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

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

まとめ

ScriptableObjectを使えば、データ管理が大幅に楽になります。

特に、SRPGのように大量のデータを扱うゲームに最適です。

✅ 要点のまとめ

ScriptableObjectでデータを外部化できる
エディタで編集可能で、デザイナーも使える
同じデータを複数のオブジェクトで共有できる
フォルダ構成を整理すると管理しやすい

本格的にUnityを学びたい方は、Unity入門の森で実践的なスキルを身につけましょう。

あなたのペースで、少しずつ進めていけば大丈夫です。

＼ゲーム制作をゼロから学びたいあなたへ／
Unity入門の森を見る初心者歓迎！動画×プロジェクト一式で本格ゲーム制作を学べる