
敵より怖い「味方AI」をGodotで作る:FSM+2メーターで"読めるやらかし"を設計する【実録#39・ポンコツ味方AI】
仕様書6枚とブラウザ試作を1つ渡しただけで、Claude CodeがGodot 4.6で動くゲームのフェーズ1を組み上げました。
起動すると、フォグ・オブ・ウォーの黒い霧、味方の視界コーン、HUD、ミニマップが揃った画面が立ち上がります。
そしてその中で、味方AIが勝手にドアを開けて、寝ていた敵を起こしていました。
これは私が「そう動け」と細かく命じた結果ではありません。
内部メーターが上がった結果、確率的にやらかしただけです。
この記事は、こんな人に向けて書いています。
ゲームの「AIキャラ」を、乱数の突然死ではなく"読めるクセ"として設計したい人
仕様書をAIエージェントに渡して、動くゲームまで一気に作らせたい人
GodotのGDScriptで「型を省いて全滅した」経験がある、またはこれからやりそうな人
読み終わると、FSM+2メーターで「憎めないポンコツ」を確率設計する考え方が手に入ります。
そして、仕様書からAIにゲームを実装させるときの流れと、GDScript特有の地雷の避け方が分かります。
敵じゃなくて「味方」が一番危ない、という反転

まず、このゲームのコンセプトを話させてください。
普通の見下ろし型シューターだと、危ないのは「敵」です。
でも私が作りたかったのは、危ないのが「味方」のゲームでした。
一緒に脱出するはずの味方AIが、パニックになって誤射する。
勝手に先行してドアを開け、敵を起こす。
しかも「自分の誤射で味方を撃つと即ゲームオーバー」という制約付きです。
つまりプレイヤーは、敵よりも背後の相棒に神経を使うことになります。
ここで一番大事なのは、味方を「ただのバカ」にしないことでした。
理不尽に突然死ぬAIは、ただストレスです。
でも「あ、今の状況ならこいつやらかすな」と読めるクセなら、憎めない相棒になります。
あなたがイライラするゲームAIと、愛せるゲームAIの違いって、どこにあると思いますか?
私の答えは、「予測できるかどうか」でした。
突然死ではなく「確率」で、読めるクセを作る

読めるクセを作る鍵は、乱数の使い方です。
ダメな設計は、毎フレーム一定確率で「ランダムにやらかす」ことです。
これはプレイヤーから見ると、ただの突然死にしか見えません。
私が採った設計は違います。
状況を数値化した「メーター」で、やらかしの確率を動かすのです。
周囲の敵が増えれば、パニックの確率が上がる。
味方の視界から外れると、不安になって挙動が変わる。
つまり「今この状況は危ない」という文脈を、プレイヤーとAIが同じ数字で共有します。
だからプレイヤーは、メーターの気配を画面から読み取れる。
「敵に囲まれてきた、そろそろこいつ暴発するぞ」と身構えられるわけです。
乱数は「有無」ではなく「重み」に使う。 これがこの設計の核心でした。
全体アーキテクチャ:FSMの5状態+2メーター

ここは出し惜しみせず、仕組みを全部説明します。
味方AIは、大きく2つの部品で動いています。
ひとつはノードベースのFSM(有限状態機械)です。
状態は5つ用意しました。
Follow:プレイヤーについていく、平常時の状態
Combat:敵を見つけて交戦する状態
Cower:怯えて縮こまる状態
Panic:パニックで暴発しやすい状態
Interact:ドアを開けるなど、環境に干渉する状態
もうひとつが、2つの内部メーターです。
緊張度:自分の周囲にいる敵の数で上下する
安心度:自分が味方(=プレイヤー)の視界コーンに入っているか
この2メーターが、各状態への遷移確率と、状態内の行動確率を動かします。
FSMが「今どの気分か」を決め、メーターが「その気分がどれだけ暴れるか」を決める。
この二層構造が、ポンコツAIの背骨になっています。
2つのメーターが、具体的に何を動かすか

メーターがどう効くか、もう少し具体的に話します。
緊張度が上がると、CombatやPanicへ遷移しやすくなります。
敵が1体なら冷静に対処するのに、3体に囲まれると暴発率が跳ね上がる。
これで「囲まれると誤射が怖い」という緊張感が自然に生まれます。
安心度が下がると、Cowerに落ちやすくなります。
プレイヤーの視界から外れて置き去りにされると、味方は不安で動けなくなる。
だからプレイヤーは「相棒を視界に入れ続ける」という無言の責任を負います。
面白いのは、この2つが相反する場面があることです。
敵から離れれば緊張度は下がるけれど、プレイヤーから離れれば安心度も下がる。
「安全な場所」と「見守られている場所」が一致しないとき、AIは揺れます。
この揺れが、機械なのに感情があるように見える瞬間でした。
数字だけで、どこまで「性格」を作れるか——それがこの設計の挑戦でした。
やらかしの実装:射線割り込みと勝手なドア

ポンコツさは、抽象的なメーターだけでは伝わりません。
具体的な「やらかし挙動」に落とし込む必要があります。
私が実装した代表的なやらかしは、こうです。
射線割り込み:プレイヤーが撃とうとした瞬間、味方が射線に入ってくる。
しかもいきなりではなく、予兆→回避のチャンス→事故という段階を踏みます。
「あ、入ってくる」と気づいて撃つのをやめれば助かる。
反応が遅れれば、味方を撃って即ゲームオーバー。
この「予兆」こそが、理不尽と読めるクセの分かれ目でした。
勝手なドア開け:Interact状態の味方が、先走ってドアを開ける。
その奥で寝ていた敵が起きて、静かに進みたかった計画が崩れる。
どちらも「AIが自分の判断で動いた結果」に見えるのがポイントです。
プレイヤーが「余計なことを…」と苦笑する。
その苦笑が出た時点で、このAIは「相棒」になっていました。
仕様書6枚を渡したら、Claude Codeが組み上げた

ここで、開発の進め方の話をします。
私はこのゲームを、いきなり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は、プレイヤーから見て「読める」やつですか、それとも「突然死」ですか?
ここまで読んでいただき、ありがとうございました。
スキを押してもらえると、次の記事を書く燃料になります。