Unityで使うC#の変数 | 型とInspector連携

「C#の変数って、intとfloatの違いがよく分からない…」

Unityでスクリプトを書き始めると、型の名前に最初は戸惑う方が多いです。
変数は、HPや速度、プレイヤー名など、ゲーム内のデータを入れておく箱だと考えてください。
型を間違えるとエラーになったり、Inspectorでの表示が意図と違ったりします。

この記事では、Unityでよく使う4つの型と、public・SerializeFieldによるInspector連携、命名のコツまでを具体例で説明します。
C#の基礎記事の次に読む想定で書いています。

＼プログラミング未経験でも大丈夫！まずは1本作り切ろう／

初心者が最初に選ぶならコレ

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

★★★★★ (Unity6対応)

Unity6対応・スマホ化対応の最新カリキュラム。「何から始めればいいかわからない」という初心者でも、ステップごとに手を動かすだけでRPGが完成します。

講座を見てみる ＼ゼロからでもスマホ対応RPGが作れる！／

憧れのアクションゲームに挑戦

Unity 2Dアクションゲーム
の作り方講座（ロックマン風）

★★★★★ (スマホ化・広告実装)

初心者でもロックマン風の横スクロールACTが作れる講座。7ステージ＋ラスボスという本格構成で、スマホ化・広告実装まで対応。「自分のゲームをリリースしたい」夢を叶えます。

講座を見てみる ＼初心者でも本格ACTが完成する！／

3Dゲーム開発の入口はここ

ゼルダ風3Dアクションゲーム
の作り方講座

★★★★★ (スマホ化対応)

「3Dゲームって難しそう…」と感じている初心者向けの講座。全16回でゼルダ風3Dアクションがスマホ対応で作れるようになります。3D開発の基礎がしっかり身につきます。

講座を見てみる ＼初心者でも全16回で3Dゲームが完成！／

変数とは何か

変数は、プログラムの中で値を保存しておく場所です。
Unityでは、プレイヤーのHP、移動速度、敵の名前など、ゲームの状態を変数に入れて管理します。

変数を使う理由は3つあります。

• 同じ値を何度も使うとき、1か所で管理できる
• Inspectorから数値を変えて、コードを書き換えずに調整できる
• 処理の途中で値が変わる（HPが減るなど）ことを記録できる

変数を宣言するときは、型（どんなデータを入れるか）と名前を指定します。

int hp = 100;
float moveSpeed = 5.0f;
string playerName = "Hero";
bool isAlive = true;

Unityでよく使う4つの型

最初に覚える型は、次の4つで十分です。
ゲーム制作の大半はこの中で完結します。

floatの値には末尾にfを付けます（例：5.0f）。
付け忘れるとコンパイルエラーになることがあります。
int同士の割り算は小数が切り捨てられる点にも注意しましょう。

HPと速度の具体例

実際のゲームでよく使う変数の例を見てみましょう。

using UnityEngine;

public class PlayerStatus : MonoBehaviour
{
    public int maxHp = 100;
    public int currentHp = 100;
    public float moveSpeed = 5f;
    public string playerName = "Knight";
    public bool isInvincible = false;

    void Start
    {
        currentHp = maxHp;
        Debug.Log(playerName + " HP:" + currentHp);
    }

    public void TakeDamage(int damage)
    {
        if (isInvincible) return;
        currentHp -= damage;
        if (currentHp <= 0)
        {
            currentHp = 0;
            Debug.Log("ゲームオーバー");
        }
    }
}

maxHpとcurrentHpを分けておくと、回復上限やUI表示の計算がしやすくなります。
moveSpeedはInspectorで調整し、手触りを確かめながら最適値を探せます。

管理人

速度は3f、5f、8fとInspectorで変えてPlayするのが近道です。
数字の意味が分からなくても、「速くなった・遅くなった」を体感できると理解が進みますよ。

publicとprivateの違い

変数の前に付けるpublicやprivateは、他のスクリプトやInspectorから見えるかどうかを決めます。

すべてpublicにすると、Inspectorがごちゃごちゃして編集ミスが増えます。
外から触る必要がない変数はprivateにする習慣をつけましょう。
何も書かない場合、クラス内の変数はprivate扱いです。

SerializeFieldでprivateのままInspectorに表示

「privateにしたいが、Inspectorでは調整したい」という場面では、[SerializeField]が便利です。

using UnityEngine;

public class EnemyMove : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 3f;
    [SerializeField] private int attackPower = 10;

    void Update
    {
        transform.Translate(Vector3.left * moveSpeed * Time.deltaTime);
    }
}

SerializeFieldを付けると、privateのままでもInspectorに欄が表示されます。
他のスクリプトからは直接触れないので、カプセル化（データの保護）と調整のしやすさを両立できます。

Unity 2020以降では、[SerializeField]の代わりにフィールドの右クリックから「Reset」などが使える場合もありますが、明示的にSerializeFieldを書く方が意図が伝わりやすいです。

変数の初期化とスコープ

変数は宣言時に初期値を入れておくと、Play開始直後から意図した状態になります。
currentHp = 0のまま始まる、といったバグを防げます。

スコープとは、変数が使える範囲のことです。
クラスの先頭で宣言した変数は、そのクラス内のどの関数からも使えます。
関数の中だけで宣言した変数は、その関数の中だけで有効です。

public class ScoreManager : MonoBehaviour
{
    private int score = 0;

    void AddScore(int points)
    {
        score += points;
        Debug.Log("スコア:" + score);
    }
}

scoreはクラス全体で共有されるので、AddScoreを何度呼んでも累計が保持されます。

管理人

変数名は hp より currentHp、 speed より moveSpeed のように「何の値か」が分かる名前がおすすめです。
1週間後の自分が読み返すことを想像して付けましょう。

命名のコツとよくあるミス

変数名は、英数字とアンダースコアで付けます。
日本語は使えません。
Unityでは、次のルールが一般的です。

• 先頭は小文字、単語の区切りは大文字（moveSpeed、maxHp）※キャメルケース
• boolは is や has で始める（isAlive、hasKey）
• 意味のない a、temp1 より、用途が分かる名前を選ぶ

よくあるミスも確認しておきましょう。

• floatに整数だけ書いて f を付け忘れる（5 → 5f）
• stringを + で数値と連結するとき、意図しない変換が起きる
• publicにしすぎてInspectorが見づらくなる
• 初期化忘れで0や空文字のままPlayが始まる

管理人

変数が理解できたら、次は関数で「TakeDamage」や「Move」の処理を分けていきましょう。
Updateがスッキリして、コードが読みやすくなりますよ。

まとめ

UnityのC#変数は、int・float・string・boolの4型から始めれば十分です。
HPや速度のように、ゲームのデータを変数に入れて管理します。
publicはInspector表示、privateは内部用、SerializeFieldならprivateのまま調整可能、と使い分けましょう。

初期値を設定し、意味のある名前を付けることで、後からの修正が楽になります。
Inspectorで数値を変えながらPlayする習慣も、理解を深める近道です。

変数の次は関数で処理を分ける学習に進みましょう。
体系的に追いかけたい方は、Unity入門の森の講座も参考になります。
スクリプトの基礎からゲーム完成まで、実践的な流れで学べる内容が揃っています。
今日はmoveSpeedをInspectorでいじるところから、試してみてください。