メインコンテンツへスキップ
見出し画像

敵より怖い「味方AI」をGodotで作る:FSM+2メーターで"読めるやらかし"を設計する【実録#39・ポンコツ味方AI】

    仕様書6枚とブラウザ試作を1つ渡しただけで、Claude CodeがGodot 4.6で動くゲームのフェーズ1を組み上げました。

    起動すると、フォグ・オブ・ウォーの黒い霧、味方の視界コーン、HUD、ミニマップが揃った画面が立ち上がります。

    そしてその中で、味方AIが勝手にドアを開けて、寝ていた敵を起こしていました。

    これは私が「そう動け」と細かく命じた結果ではありません。

    内部メーターが上がった結果、確率的にやらかしただけです。

    この記事は、こんな人に向けて書いています。

    • ゲームの「AIキャラ」を、乱数の突然死ではなく"読めるクセ"として設計したい人

    • 仕様書をAIエージェントに渡して、動くゲームまで一気に作らせたい人

    • GodotのGDScriptで「型を省いて全滅した」経験がある、またはこれからやりそうな人

    読み終わると、FSM+2メーターで「憎めないポンコツ」を確率設計する考え方が手に入ります。

    そして、仕様書からAIにゲームを実装させるときの流れと、GDScript特有の地雷の避け方が分かります。

    敵じゃなくて「味方」が一番危ない、という反転

    章扉カード01

    まず、このゲームのコンセプトを話させてください。

    普通の見下ろし型シューターだと、危ないのは「敵」です。

    でも私が作りたかったのは、危ないのが「味方」のゲームでした。

    一緒に脱出するはずの味方AIが、パニックになって誤射する。

    勝手に先行してドアを開け、敵を起こす。

    しかも「自分の誤射で味方を撃つと即ゲームオーバー」という制約付きです。

    つまりプレイヤーは、敵よりも背後の相棒に神経を使うことになります。

    ここで一番大事なのは、味方を「ただのバカ」にしないことでした。

    理不尽に突然死ぬAIは、ただストレスです。

    でも「あ、今の状況ならこいつやらかすな」と読めるクセなら、憎めない相棒になります。

    あなたがイライラするゲームAIと、愛せるゲームAIの違いって、どこにあると思いますか?

    私の答えは、「予測できるかどうか」でした。

    突然死ではなく「確率」で、読めるクセを作る

    章扉カード02

    読めるクセを作る鍵は、乱数の使い方です。

    ダメな設計は、毎フレーム一定確率で「ランダムにやらかす」ことです。

    これはプレイヤーから見ると、ただの突然死にしか見えません。

    私が採った設計は違います。

    状況を数値化した「メーター」で、やらかしの確率を動かすのです。

    周囲の敵が増えれば、パニックの確率が上がる。

    味方の視界から外れると、不安になって挙動が変わる。

    つまり「今この状況は危ない」という文脈を、プレイヤーとAIが同じ数字で共有します。

    だからプレイヤーは、メーターの気配を画面から読み取れる。

    「敵に囲まれてきた、そろそろこいつ暴発するぞ」と身構えられるわけです。

    乱数は「有無」ではなく「重み」に使う。 これがこの設計の核心でした。

    全体アーキテクチャ:FSMの5状態+2メーター

    章扉カード03

    ここは出し惜しみせず、仕組みを全部説明します。

    味方AIは、大きく2つの部品で動いています。

    ひとつはノードベースのFSM(有限状態機械)です。

    状態は5つ用意しました。

    • Follow:プレイヤーについていく、平常時の状態

    • Combat:敵を見つけて交戦する状態

    • Cower:怯えて縮こまる状態

    • Panic:パニックで暴発しやすい状態

    • Interact:ドアを開けるなど、環境に干渉する状態

    もうひとつが、2つの内部メーターです。

    • 緊張度:自分の周囲にいる敵の数で上下する

    • 安心度:自分が味方(=プレイヤー)の視界コーンに入っているか

    この2メーターが、各状態への遷移確率と、状態内の行動確率を動かします。

    FSMが「今どの気分か」を決め、メーターが「その気分がどれだけ暴れるか」を決める。

    この二層構造が、ポンコツAIの背骨になっています。

    2つのメーターが、具体的に何を動かすか

    章扉カード04

    メーターがどう効くか、もう少し具体的に話します。

    緊張度が上がると、CombatやPanicへ遷移しやすくなります。

    敵が1体なら冷静に対処するのに、3体に囲まれると暴発率が跳ね上がる。

    これで「囲まれると誤射が怖い」という緊張感が自然に生まれます。

    安心度が下がると、Cowerに落ちやすくなります。

    プレイヤーの視界から外れて置き去りにされると、味方は不安で動けなくなる。

    だからプレイヤーは「相棒を視界に入れ続ける」という無言の責任を負います。

    面白いのは、この2つが相反する場面があることです。

    敵から離れれば緊張度は下がるけれど、プレイヤーから離れれば安心度も下がる。

    「安全な場所」と「見守られている場所」が一致しないとき、AIは揺れます。

    この揺れが、機械なのに感情があるように見える瞬間でした。

    数字だけで、どこまで「性格」を作れるか——それがこの設計の挑戦でした。

    やらかしの実装:射線割り込みと勝手なドア

    章扉カード05

    ポンコツさは、抽象的なメーターだけでは伝わりません。

    具体的な「やらかし挙動」に落とし込む必要があります。

    私が実装した代表的なやらかしは、こうです。

    射線割り込み:プレイヤーが撃とうとした瞬間、味方が射線に入ってくる。

    しかもいきなりではなく、予兆→回避のチャンス→事故という段階を踏みます。

    「あ、入ってくる」と気づいて撃つのをやめれば助かる。

    反応が遅れれば、味方を撃って即ゲームオーバー。

    この「予兆」こそが、理不尽と読めるクセの分かれ目でした。

    勝手なドア開け:Interact状態の味方が、先走ってドアを開ける。

    その奥で寝ていた敵が起きて、静かに進みたかった計画が崩れる。

    どちらも「AIが自分の判断で動いた結果」に見えるのがポイントです。

    プレイヤーが「余計なことを…」と苦笑する。

    その苦笑が出た時点で、このAIは「相棒」になっていました。

    仕様書6枚を渡したら、Claude Codeが組み上げた

    章扉カード06

    ここで、開発の進め方の話をします。

    私はこのゲームを、いきなりGodotで書き始めたわけではありません。

    先に6枚の仕様書を書きました。

    master(全体像)、AI挙動、コアループ、マップ、収益化、SNSの6本です。

    さらに、ブラウザで動く参照プロトタイプ(HTML/Canvas)も1つ用意しました。

    この「仕様書群+動く試作」をまるごとClaude Codeに渡したのです。

    すると、フェーズ1のGodot実装が一気に立ち上がりました。

    FSMの5状態、2メーター、1レイド(1ステージ)通しプレイまで動く状態です。

    ここで実感したのは、設計を文書化しておくと、実装がAIで一気に進むということでした。

    「ふわっとした指示」ではなく「仕様書」を渡す。

    すると、AIは迷わずコードに変換してくれます。

    あなたは新しい機能を作るとき、いきなりコードから書き始めていませんか?

    私はこの一件で、先に仕様書を書く回り道が、結局いちばん速いと痛感しました。

    「独自部品を散らさない」を、どう設計に落とすか

    AIに大量のコードを書かせると、怖いのが「部品の乱立」です。

    似たような計算が、あちこちに散らばってしまう。

    だから私は、仕様書の段階で共通化の方針を明示しました。

    • 射線・視界コーンの計算はGeometryに集約

    • フォグ・オブ・ウォーはFogSystemに集約

    • UI部品はUiKitに集約

    • 文字列はLoc/LocStringsに集約

    「同じ役割のコードは、1か所にまとめる」と先に決めておく。

    すると、AIもその置き場所に沿って書いてくれます。

    共通化は、コードを書き始めてからでは遅い。 仕様書に書いておくものでした。

    この方針のおかげで、後からの多言語対応(i18n)もかなり楽になりました。

    後付けi18nでハマった話は実録#37で詳しく書いたので、そちらも読んでみてください。

    動かして初めて分かった、2つの地雷

    ここまでは順調そうに聞こえるかもしれません。

    でも、動かして初めて分かる地雷が2つありました。

    どちらもドキュメントを読むだけでは絶対に踏み抜くやつです。

    1つめは、GDScriptの「型を省くと全滅する」問題。

    未型の参照を書くと、そのメンバアクセスが全部Variant扱いになります。

    すると:=(型推論代入)がパースエラーを連鎖的に起こして、ビルドが全滅しました。

    2つめは、Godotで画面が真っ白になる問題。

    Controlノードをある置き方にすると、自動リサイズされず、画面が真っ白になります。

    「コードは正しいのに何も映らない」という、いちばん心臓に悪いやつです。

    どちらも「読めば分かる」系ではなく、「踏んで初めて分かる」系でした。

    この2つの正体と回避法は、この記事のいちばんの土産です。

    この記事で手に入るもの(有料部の目次)

    ここまでで、なぜこの設計にしたか、何を考えたかは全部話しました。

    理解は無料です。ここから先は「そのまま再現できる設計と、実際に溶かした地雷の回避」です。

    有料部には、以下を全部置いています。

    • FSM+2メーターの設計と実コード一式:5状態の遷移と、メーターが確率を動かす実装

    • 確率テーブルの調整指針:やらかしを「理不尽」ではなく「読めるクセ」にする数値の詰め方

    • Variant地雷の回避テンプレ::=が連鎖でパースエラーになる原因と、型付けの型(comp/raid/Array[EnemyUnit])

    • 真っ白画面の直し方:Controlが自動リサイズされない条件と、論理解像度の明示

    • マップ生成②方式:連結性をBFSで検証し、シードで再現するステージ生成

    • 循環class_name参照の結論:Godot 4.6で問題なかった件の確認

    自分でゼロから試すと、AIの挙動設計だけでなく、GDScriptの地雷で何時間も溶かします。

    特にVariantの連鎖エラーは、原因が分からないと「どこを直せばいいか」すら見えません。

    この記事は、その試行錯誤を¥500で省略するものです。

    ◀ 前回: 完成したLPを"型"にして別ジャンルのLPを30分で作る方法(HTML1枚使い回し)【実録#38・LP流用】

    📚 シリーズ全話はまとめマガジンへ

    https://note.com/lazy_engineer/m/m03a726b1673c

    地雷リスト:先に一覧で渡します

    コードの前に、私が実際に溶かした罠を先に一覧化します。

    自分でやると、この一つ一つで数十分〜数時間が消えます。

    • 未型参照→メンバアクセスが全部Variant→:=がパースエラー連鎖 → 参照を型付けして解消

    • ControlをNode直下に素置き→自動リサイズされず真っ白 → 論理解像度を明示

    • メーターの効きが強すぎて「理不尽な突然死」になる → 確率の下限・上限を設ける

    • やらかしに予兆がない→ただのストレス → 予兆→回避猶予→事故の3段階に分ける

    • マップが分断されてクリア不能になる → BFSで連結性を検証してから採用

    • 循環class_name参照が怖くて避ける → Godot 4.6では問題なし、避ける必要なし

    この6つが、ポンコツAI実装で私が実際にぶつかった全部です。

    以降で、それぞれの「そのまま使える設計とコード」を出します。

    設計判断:FSMとメーターを、なぜ分けたか

    まず、いちばん大事な設計判断の理由です。

    「FSM」と「メーター」を、なぜ2つの別部品に分けたのか。

    一体化させて「状態ごとに確率を直書き」する手もありました。

    でもそれをやると、状況(文脈)と気分(状態)が混ざって、調整不能になります。

    分けた理由はこうです。

    • FSM=離散的な「今どの気分か」(Follow/Combat/Cower/Panic/Interact)

    • メーター=連続的な「その気分がどれだけ暴れるか」(緊張度・安心度)

    FSMは「状態」なので、遷移は飛び飛びです。

    メーターは「量」なので、なめらかに上下します。

    この2つを掛け合わせることで、「同じPanic状態でも、緊張度で暴発率が変わる」が表現できます。

    もし一体化していたら、Panicの中に「弱いPanic」「強いPanic」と状態を増やす羽目になります。

    状態爆発を避けるために、連続量はメーターに逃がす。これが分離の狙いでした。

    メーターが確率を動かす、実装の骨格

    メーターがどう確率に効くか、骨格を示します。

    考え方は「メーターを0〜1に正規化して、遷移確率の重みに掛ける」だけです。

    # 周囲の敵数から緊張度を、視界内フラグから安心度を更新する
    func update_meters(comp: CompanionUnit, raid: RaidState) -> void:
        # 近くの敵をカウント(型付き配列で受ける)
        var nearby: Array[EnemyUnit] = raid.enemies_within(comp.position, DANGER_RADIUS)
        # 緊張度:敵が多いほど上がる(上限で頭打ち)
        comp.tension = clampf(float(nearby.size()) / MAX_TENSION_ENEMIES, 0.0, 1.0)
        # 安心度:プレイヤーの視界コーンに入っていれば上がる
        comp.safety = 1.0 if raid.player_sees(comp) else comp.safety - SAFETY_DECAY
    
    # パニックへ遷移する確率を、緊張度で重み付けする
    func panic_chance(comp: CompanionUnit) -> float:
        # 基礎確率に緊張度を掛け、下限・上限でクランプ
        return clampf(BASE_PANIC * comp.tension, PANIC_MIN, PANIC_MAX)
    

    ポイントはclampfでの下限・上限のクランプです。

    下限を0にすると「絶対やらかさない」瞬間ができて、緊張感が消えます。

    上限を外すと「必ずやらかす」理不尽になります。

    やらかしの確率は、0でも1でもない帯に閉じ込める。 ここが調整の勘所でした。

    確率テーブルの調整指針:理不尽と愛嬌の境目

    数値をどう詰めたか、指針を共有します。

    私が回した調整は、この3つの軸でした。

    1軸め:予兆の長さ。

    やらかしが確定してから、実際に事故るまでの猶予フレーム数です。

    短すぎると「反応できない理不尽」、長すぎると「余裕で回避できて緊張感ゼロ」。

    プレイヤーが「気づけば避けられる」ギリギリを狙います。

    2軸め:メーターの立ち上がりの速さ。

    敵が増えたとき、緊張度がどれだけ急に上がるか。

    急すぎると突然死、緩すぎると危機感が伝わらない。

    3軸め:確率の下限・上限の幅。

    前述のクランプの帯を、どれだけ広く取るか。

    狭いと単調、広いと博打になります。

    この3軸を回して探したのは、「やられた瞬間に、プレイヤーが自分のミスだと納得する」点でした。

    「AIが悪い」ではなく「見てなかった自分が悪い」と思える。

    そこに着地したとき、ポンコツAIは相棒になります。

    あなたなら、予兆の猶予を「長め」と「短め」、どちらから詰めますか?

    私は短めから始めて、理不尽だと感じるたびに伸ばしていきました。

    Variant地雷の全貌::=が連鎖で死ぬ理由

    ここからGDScriptの地雷です。まずVariant問題。

    症状は、:=(型推論代入)がパースエラーを大量に吐くというものでした。

    一見、代入の書き方が悪いように見えます。

    でも真犯人は、その手前の未型の参照でした。

    たとえば、こう書いたとします。

    # NG:compを型無しで受けると…
    var comp = get_companion()      # 型が推論されずVariant扱い
    var raid = get_raid()           # これもVariant
    
    # するとメンバアクセスの戻りが全部Variantになり…
    var enemies := raid.enemies_all()   # ← :=がVariantを推論できずパースエラー
    

    compやraidを型無しで受けると、それらのメンバアクセスの戻りが全部Variantになります。

    Variantは「何の型か確定できない」ので、:=は型を推論できません。

    結果、一箇所の未型が、下流の:=を軒並みパースエラーにする連鎖が起きます。

    だからエラーの数を見て焦っても、直すべきは1箇所——源流の型付けだけです。

    # OK:参照を型付けすると、下流の:=が全部生き返る
    var comp: CompanionUnit = get_companion()
    var raid: RaidState = get_raid()
    var enemies: Array[EnemyUnit] = raid.enemies_all()  # 型が通り := も使える
    

    comp/raidをclass_nameで型付けし、配列はArray[EnemyUnit]で型付けする。

    これだけで、連鎖していたパースエラーが一斉に消えました。

    「エラーの数」ではなく「Variantの源流」を探す。 これがVariant地雷の唯一の攻め方でした。

    真っ白画面の直し方:Controlの自動リサイズ

    2つめの地雷、画面が真っ白になる問題です。

    症状は、コードは正しいのに、起動すると何も映らないというもの。

    原因は、Controlノードの置き方にありました。

    Controlは、親のサイズに合わせて自動リサイズされる前提の子です。

    ところがNodeの直下に素で置くと、その自動リサイズが効きません。

    サイズが0のまま、あるいは想定と違うサイズになり、中身が画面外に飛ぶ。

    結果、画面が真っ白になります。

    解決は、論理解像度(基準解像度)を明示することでした。

    project.godot側でウィンドウの基準サイズとストレッチ設定を明示し、UIの土台となるControlのアンカーを画面いっぱいに設定する。

    こうすると、Controlが正しく画面サイズに追従して、中身が映るようになります。

    「真っ白=描画が壊れた」と思い込むと、レンダリング周りを延々疑って溶かします。

    でも真犯人はレイアウト(サイズが0)でした。

    真っ白を見たら、まずノードのサイズを疑う。 これは覚えておいて損はありません。

    マップ生成②方式:連結性をBFSで検証する

    やらかしAIが活きるには、ステージが成立している必要があります。

    でも自動生成したマップは、部屋が分断されてクリア不能になることがあります。

    そこで採ったのが、生成②方式(連結性検証+シード)です。

    やることは2つ。

    1つめ:シードで再現可能にする。

    同じシードなら同じマップが出る。バグ再現とテストが一気に楽になります。

    2つめ:生成後にBFSで連結性を検証する。

    スタートからゴールまで、実際に到達できるかを幅優先探索で確認します。

    到達できなければ、そのマップは捨てて、シードを変えて再生成する。

    # スタートからゴールへ到達可能かをBFSで検証する
    func is_connected(grid: MapGrid, start: Vector2i, goal: Vector2i) -> bool:
        var queue: Array[Vector2i] = [start]
        var seen := {start: true}
        while not queue.is_empty():
            var cur: Vector2i = queue.pop_front()
            if cur == goal:
                return true
            for nb in grid.walkable_neighbors(cur):
                if not seen.has(nb):
                    seen[nb] = true
                    queue.append(nb)
        return false   # ここに来たら分断されている=採用しない
    

    「生成して祈る」のではなく、「生成して検証して、ダメなら捨てる」。

    クリア不能マップは、リリース後に踏まれたら致命傷です。

    だからこそ、生成の段階で必ず連結性を保証する。これが②方式の狙いでした。

    循環class_name参照は、避けなくてよかった

    最後に、地雷だと身構えたのに問題なかった話です。

    GDScriptでclass_name同士が互いを参照する「循環参照」。

    古い情報では「循環参照は避けろ」とされがちです。

    私も最初、CompanionUnitとRaidStateが相互参照する構成を怖がっていました。

    でも結論、Godot 4.6では循環class_name参照は問題なく動きました。

    型付けのために相互参照が必要でも、避けて設計を歪める必要はなかった。

    「地雷だと思っていたものが、実は地雷じゃなかった」。

    これも、実際に踏みに行って初めて分かることでした。

    古い『避けろ』情報を鵜呑みにせず、今のバージョンで一度試す。 これも一つの手です。

    カスタマイズの勘所:3点だけ

    自分のゲームに応用する際、押さえるのはこの3点です。

    1点め:メーターは「相反する2つ」にする。

    緊張度と安心度のように、片方を満たすともう片方が犠牲になる組み合わせにする。

    すると、AIが「揺れる」瞬間が生まれ、性格が立ちます。

    2点め:やらかしには必ず予兆を付ける。

    予兆→回避猶予→事故の3段階を守る。

    予兆のない乱数は、ただの理不尽です。

    3点め:確率は0と1に振り切らせない。

    clampfで下限・上限の帯に閉じ込める。

    「絶対やる/絶対やらない」が消えた瞬間、AIは生き物っぽくなります。

    この3点だけ守れば、あなたのゲームのAIも「読めるポンコツ」になります。

    まとめと次回予告

    ポンコツ味方AIの実装で学んだことは、一言で言えばこうです。

    やらかしは乱数の「有無」ではなく、メーターで動かす「確率の重み」で作る。

    そして、FSMで気分を、メーターでその暴れ方を分けて持つと、状態爆発せずに性格が出せる。

    GDScriptでは、未型参照がVariant連鎖でビルドを全滅させる点と、Controlの素置きで画面が真っ白になる点だけ、先に知っておけば時間を溶かさずに済みます。

    そして仕様書6枚を先に書いておけば、Claude Codeが実装を一気に進めてくれました。

    🎯次の目標は、この味方AIに「学習っぽい変化」を持たせることです。

    同じレイドを重ねると、少しずつやらかしの癖が変わる——そんな表情を付けたい。

    📅時期は、フェーズ2の実装に入るタイミング(数週間以内)を予定しています。

    過去の実録でも、仕様書をAIに渡して一気に作らせる進め方は何度か扱ってきました。

    いきなりコードではなく、先に文書を書く回り道が、結局いちばん速い。これは毎回感じます。

    あなたのゲームのAIは、プレイヤーから見て「読める」やつですか、それとも「突然死」ですか?

    ここまで読んでいただき、ありがとうございました。

    スキを押してもらえると、次の記事を書く燃料になります。

     
     
    ITエンジニア9年目 / AI自動化 / note副業実録 AIを使えば、もっと楽できると気づいた。 noteで月10万円を目指す過程を、売上スクショ付きで全部公開します。 うまくいかない月も、ちゃんと出します。 「重い副業はしたくない」エンジニア・IT系の人に届けたい。

    あなたへのおすすめ