【Unity】Unityスクリプトの基本！MonoBehaviourクラスを理解しよう

UnityでC#スクリプトを作ると、必ずpublic class MyScript : MonoBehaviourという一文が付いてきます。「おまじない」として何となく書いているけれど、これが何者なのかは説明できない——そんな方は意外と多いのではないでしょうか。

MonoBehaviourは、UnityのAPIと自作スクリプトを繋ぐ「基底クラス」です。これを継承（:の右側に記述）するだけで、スクリプトはゲームオブジェクトにコンポーネントとして追加できるようになり、UpdateやStartといったイベントを受け取り、transformやgameObjectといった便利なプロパティが使えるようになります。

この記事でわかること

• MonoBehaviourを継承すると何ができるようになるのか
• transform・gameObject・GetComponent<T>()の使い方
• Instantiate/Destroyによるオブジェクトの生成と破棄
• 「newできない」「Invokeは文字列指定」などのつまずきポイント

動作確認環境: Unity 6 (6000.x) ／ Input System

MonoBehaviourの役割

MonoBehaviourを継承する主なメリットは以下の通りです。

1. コンポーネント化: 作成したスクリプトをゲームオブジェクトのコンポーネントとしてアタッチできるようになります。これにより、オブジェクトに振る舞いを追加できます。
2. ライフサイクルイベントの受信: Awake, Start, Updateなど、Unityが定義した特定のタイミングで自動的に呼び出されるイベント関数を使用できます。
3. 主要プロパティへのアクセス: スクリプトがアタッチされているゲームオブジェクト自身や、そのTransformコンポーネントなどに簡単にアクセスできます。
4. コルーチンの実行: StartCoroutineメソッドを使って、「3秒待ってから実行」「数フレームに分けて少しずつ処理」のような 時間をまたぐ処理 を書けます。別スレッドで動くわけではなく、 メインスレッド上で処理を分割・待機する仕組み です（詳しくは コルーチンの記事 へ）。

MonoBehaviourの立ち位置を図にすると、「Unityエンジンと自作スクリプトを繋ぐ架け橋」というイメージになります。継承した瞬間から、Unity側のイベント（AwakeやUpdateなど）が自分のスクリプトに届くようになるわけです。

もしMonoBehaviourを継承しないただのC#クラス（POCO - Plain Old C# Object と呼ばれることもあります）を作成した場合、それはUnityのゲームオブジェクトにアタッチできず、ライフサイクルイベントも受け取れません。そうしたクラスは、データ保持専門のクラスや、計算処理専門のクラスとしてMonoBehaviourから呼び出して使うことになります。

「切り出す」感覚を小さな例で見てみましょう。ダメージ計算はUnityの機能を何も使わないので、普通のC#クラスにできます。

// MonoBehaviourを継承しない、計算専門の普通のC#クラス
public class DamageCalculator
{
    public int Calculate(int attack, int defense)
    {
        int damage = attack - defense;
        return damage < 1 ? 1 : damage; // 最低でも1ダメージ
    }
}

これをMonoBehaviour側から呼び出します。

using UnityEngine;

public class Enemy : MonoBehaviour
{
    // 普通のC#クラスは、MonoBehaviourと違ってnewで作れる
    private DamageCalculator calculator = new DamageCalculator();

    public void OnAttacked(int attack, int defense)
    {
        int damage = calculator.Calculate(attack, defense);
        Debug.Log($"受けたダメージ: {damage}");
    }
}

こうしておくと、ダメージ計算のロジックはシーンにもGameObjectにも依存せず、テストや使い回しがしやすくなります。 「Unityと対話する部分はMonoBehaviour、純粋な計算やデータは普通のクラス」 という分担は、上達してからも効き続ける基本です。

補足: MonoBehaviourを継承したクラスは、new MyScript()のように newでインスタンス化することはできません 。書いてもコンパイルは通りますが、実行するとConsoleに「You are trying to create a MonoBehaviour using the 'new' keyword. This is not allowed.」という警告が出て、部品としては働きません。必ずAddComponent<MyScript>()でゲームオブジェクトに追加するか、エディタ上でアタッチして生成します。これはつまずきやすいポイントなので覚えておきましょう。

主要なプロパティとメソッド

MonoBehaviourを継承したスクリプト内では、多くの便利なプロパティやメソッドを直接呼び出すことができます。ポイントは、 スクリプトは「自分がアタッチされている器（GameObject）」を起点に、器自身や同じ器の中の部品へ直接アクセスできる ということです。

ここでは特に頻繁に使うものを紹介します。

transform

スクリプトがアタッチされているゲームオブジェクトの Transformコンポーネント への参照を返します。オブジェクトの位置、回転、スケールを操作する際に頻繁に使用します。これはGetComponent<Transform>()のショートカットであり、非常によく使われるため特別に用意されています。

using UnityEngine;

public class PositionChanger : MonoBehaviour
{
    void Start()
    {
        // transformプロパティを使って、オブジェクトのY座標を5に設定する
        transform.position = new Vector3(0, 5, 0);
    }
}

gameObject

スクリプトがアタッチされている ゲームオブジェクト自身 への参照を返します。オブジェクトを非アクティブにしたり、他のコンポーネントを取得したりする際の起点となります。

using UnityEngine;

public class ObjectController : MonoBehaviour
{
    void Start()
    {
        // 5秒後にこのゲームオブジェクトを非アクティブにする
        Invoke("DeactivateObject", 5f);
    }

    void DeactivateObject()
    {
        // gameObjectプロパティを使って、自身を非アクティブにする
        gameObject.SetActive(false);
    }
}

補足: この例で使っているInvokeは、メソッド名を 文字列 で指定する仕組みです。手軽な反面、タイプミスをコンパイル時に検出できず、メソッド名を変更（リネーム）した際にも追従してくれません。本格的な遅延処理には、後述のコルーチンやasync/awaitを使う方が安全です。

GetComponent<T>()

同じゲームオブジェクトにアタッチされている、指定した型Tのコンポーネントへの参照を取得します。Unityのコンポーネント指向設計において、他のコンポーネントと連携するための最も基本的なメソッドです。

using UnityEngine;

public class PlayerHealth : MonoBehaviour
{
    private Rigidbody rb;

    void Start()
    {
        // 同じGameObjectにアタッチされているRigidbodyコンポーネントを取得
        rb = GetComponent<Rigidbody>();
        if (rb != null)
        {
            // Rigidbodyが見つかったら、その質量を10に設定
            rb.mass = 10f;
        }
    }
}

パフォーマンスのヒント: GetComponent<T>()の呼び出しにはコストがあります。1回や数回なら気にする必要はありませんが、Update()のような毎フレーム呼ばれる場所で繰り返し呼ぶと積み重なります。何度も使う参照はAwake()やStart()で一度だけ取得して変数に保存（キャッシュ）しておくのがベストプラクティスです。

Instantiate() と Destroy()

• Instantiate(original): original（Prefabや既存のゲームオブジェクト）のクローンをシーンに生成します。敵や弾、エフェクトなどを動的に生成する際に使用します。
• Destroy(obj): objで指定したゲームオブジェクトやコンポーネントを破棄します。不要になったオブジェクトをシーンから削除する際に使用します。Projectウィンドウにある元のPrefab（アセット）は破棄できません。消す（Destroy）か隠す（SetActive(false)）かで迷ったら、「この個体はもう終わりか、また使うか」で決めます。

スペースキーの入力は、Unity 6 で標準の Input System（Keyboard.current）で読みます。古い書き方のInput.GetKeyDownは、Unity 6 の新しいプロジェクトではエラーになることがあります。

using UnityEngine;
using UnityEngine.InputSystem;

public class BulletSpawner : MonoBehaviour
{
    public GameObject bulletPrefab;

    void Update()
    {
        // スペースキーが押されたら（キーボードが無い環境では何もしない）
        if (Keyboard.current != null && Keyboard.current.spaceKey.wasPressedThisFrame)
        {
            // Prefabから弾を生成する
            GameObject newBullet = Instantiate(bulletPrefab, transform.position, Quaternion.identity);

            // 3秒後にその弾を破棄する
            Destroy(newBullet, 3f);
        }
    }
}

空のGameObjectにBulletSpawnerを付け、Inspectorの Bullet Prefab 欄へ弾のPrefab（たとえば、HierarchyのSphereをProjectウィンドウへドラッグして作ったもの）をドラッグしてからPlayします。Spaceを押すたびに、Hierarchyに (Clone) の付いた弾が増え、3秒後に消えます。この例は弾を飛ばす処理を書いていないので、弾はその場に現れるだけです。うまくいかないときは、次の表を見てください。

症状	原因	直し方
Spaceを押しても弾が出ない（エラーも出ない）	Gameビューにフォーカスが無く、キーが届いていない	Gameビューを一度クリックしてから押す
UnassignedReferenceException が出る	Inspectorの Bullet Prefab 欄が空のまま	ProjectウィンドウのPrefabを欄へドラッグする
消したつもりのオブジェクトが残る	Destroy(this) と書いて、スクリプトの部品だけを消している	オブジェクトごと消すなら Destroy(gameObject)
Destroying assets is not permitted to avoid data loss. が出る	生成した弾ではなく、元のPrefab（bulletPrefab）をDestroyしている	Instantiateが返したnewBulletのほうをDestroyする

おまけ：先に知っておくと良いこと

この記事の内容を使い始めると、いずれ次のような「その先の話」に出会います。今すぐ理解する必要はありませんが、存在だけ知っておくと、後で困ったときの引き出しになります。

• Instantiate/Destroyは実は重い処理: 弾丸やエフェクトのように大量の生成・破棄を繰り返すと、カクつき（GCスパイク）の原因になります。実際の制作では、生成済みのオブジェクトを使い回す オブジェクトプーリング という手法で軽量化するのが定番です。詳しくは オブジェクトプーリングの記事 で解説しています。
• イベント関数が呼ばれる順序には厳密なルールがある: AwakeやUpdateが「いつ・どの順で」呼ばれるかを理解すると、初期化まわりのバグの大半を防げます。ライフサイクルの記事 にまとめています。
• なんでもMonoBehaviourにしない設計もある: データだけを扱うクラスは、MonoBehaviourを継承しない普通のC#クラスや ScriptableObject にすると、シーンに依存しないすっきりした設計になります。ScriptableObjectの記事 が参考になります。
• C#そのものの書き方: 変数・if・for・メソッドといった、Unityに限らないC#の基本は Unity開発者のためのC#入門 にまとめてあります

まとめ

MonoBehaviourは、Unityにおけるスクリプティングの根幹をなすクラスです。このクラスを継承することで、私たちの書いたC#コードは初めてUnityの世界と対話し、ゲームオブジェクトに命を吹き込むことができます。

• MonoBehaviourはUnityとスクリプトを繋ぐ架け橋。
• 継承することで、コンポーネントとして振る舞い、ライフサイクルイベントを受け取れる。
• transform, gameObject, GetComponent<T>()などの便利なプロパティやメソッドが使えるようになる。

Unityでの開発は、このMonoBehaviourをいかにうまく使いこなすかにかかっていると言っても過言ではありません。まずは今回紹介した基本的なプロパティやメソッドに慣れ親しむことから始めましょう。