Unity Gizmosの使い方 | 範囲をSceneで可視化

「攻撃範囲がどれくらいか、数値だけではイメージしづらい」

「当たり判定の球がどこにあるか、Play中に目で追いたい」

そんなときに便利なのがGizmosです。
Sceneビュー上に線や球を描画でき、ゲーム画面（Gameビュー）には表示されません。
開発中だけ「見える化」できるデバッグ用の描画ツールと考えてください。

この記事では、OnDrawGizmosの書き方、DrawWireSphere・DrawLineの例、攻撃範囲や視界の可視化、色の付け方までを説明します。
Debug.Logで数値を確認する方法と組み合わせると、バグの特定がさらに速くなります。

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

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

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

★★★★★ (Unity6対応)

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

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

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

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

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

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

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

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

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

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

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

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

Gizmosとは｜Sceneだけに表示される描画

Gizmosは、UnityエディタのSceneビュー専用の補助線・補助図形です。
プレイヤーには見えず、開発者が配置や範囲を確認するためのものです。

カメラの視錐台やライトの影響範囲など、エディタが自動で描くGizmosもあります。
スクリプトから描く場合は、OnDrawGizmosまたはOnDrawGizmosSelectedメソッドを使います。

Sceneビュー右上の「Gizmos」ボタンがオンになっているかも確認してください。
オフだと、スクリプトで描いても見えません。

OnDrawGizmosの基本コード

MonoBehaviourを継承したスクリプトに、次のようなメソッドを追加します。

public class AttackRangeGizmo : MonoBehaviour
{
    public float attackRange = 2f;

    void OnDrawGizmos
    {
        Gizmos.color = Color.red;
        Gizmos.DrawWireSphere(transform.position, attackRange);
    }
}

このスクリプトをキャラクターにアタッチし、InspectorでattackRangeを変えると、Scene上の赤いワイヤー球の大きさが変わります。
Playしなくても表示されるので、配置の段階で範囲を調整できます。

中心座標は多くの場合transform.positionを使います。
オフセットしたいときは、transform.position + Vector3.up などでずらせます。

管理人

Gizmosは「ゲームに出ない」ので安心して試せます。
まずは空のGameObjectにスクリプトを付け、球がSceneに出るか確認してみましょう。

よく使う描画メソッド

範囲の形に応じて、次のメソッドを使い分けます。

void OnDrawGizmos
{
    // 視界：前方へ5mの線
    Gizmos.color = Color.yellow;
    Gizmos.DrawRay(transform.position, transform.forward * 5f);

    // 足元に小さな立方体
    Gizmos.color = Color.cyan;
    Gizmos.DrawWireCube(transform.position, Vector3.one * 0.5f);
}

DrawWireCubeの第2引数は「サイズ（幅・高さ・奥行き）」です。
Vector3.one * 2f なら、各辺2mの立方体の枠が描かれます。

攻撃範囲と視界の可視化例

実践的な組み合わせ例です。
public変数にしておくと、Inspectorから数値を変えながら調整できます。

public float detectRange = 8f;
public float attackRange = 2f;

void OnDrawGizmosSelected
{
    Gizmos.color = new Color(1f, 1f, 0f, 0.3f);
    Gizmos.DrawWireSphere(transform.position, detectRange);

    Gizmos.color = Color.red;
    Gizmos.DrawWireSphere(transform.position, attackRange);
}

索敵範囲を黄色の大きな球、攻撃範囲を赤い小さな球で重ねて表示します。
OnDrawGizmosSelectedにすると、Hierarchyでそのオブジェクトを選んだときだけ表示され、シーンが散らかりにくくなります。

Raycastで地面を検知している場合は、DrawRayで射出方向を線にすると、「どこを向いているか」が一目で分かります。
ヒット距離が分かっているときは、その長さまで線を引くと再現性が高まります。

管理人

「当たっているはずなのに当たらない」ときは、Gizmosの球とColliderのサイズを並べて見比べると、ズレに気づきやすいです。
数値だけより断然早いですよ。

色の設定と注意点

Gizmos.colorに色を指定してから描画します。
半透明にしたいときは、new Color(r, g, b, alpha) の第4引数で透明度を下げます。

• Gameビューには出ない → プレイヤー向けUIやエフェクトには使えない
• ビルド後は動かない → エディタ専用のため、製品版には含まれない
• 重い処理を入れない → OnDrawGizmos内でFindや大量のループは避ける
• ColliderのGizmoと混同しない → 緑のワイヤーはColliderコンポーネント側の表示

2DプロジェクトでもGizmosは使えます。
Z座標を0に固定し、DrawWireSphereの代わりにDrawWireCubeで平面の範囲を枠表示する方法もよく使われます。

管理人

攻撃判定のコードとGizmosで同じ変数（attackRangeなど）を使うのがコツです。
片方だけ直してズレる、というミスが防げます。

まとめ

UnityのGizmosは、OnDrawGizmos内でDrawWireSphereやDrawLineを呼び、Sceneビューに範囲や方向を可視化する仕組みです。
ゲーム画面には出ず、開発中の確認専用。
攻撃範囲・索敵距離・レイの向きなど、数値だけでは分かりにくい情報を「見える化」できます。

まずは1つのpublic floatとDrawWireSphereから試し、慣れたら色分けやOnDrawGizmosSelectedでシーンを整理していきましょう。
Debug.Logと併用すると、ログの数値とSceneの形を照合しやすくなります。

実践的なゲーム制作でデバッグ手法を身につけたい方は、Unity入門の森の講座も参考になります。
当たり判定やAIの範囲設定を学ぶ中で、Gizmosの活用例も自然に触れられます。
今日はキャラクターに赤い球を1つ描いて、範囲のイメージを掴んでみてください。