この記事は https://ziva.sh/blogs/godot-automated-playtesting の日本語版です(英語の原文はZiva.shが2026年11月5日に公開)。
はじめに
Godotのゲームのプレイテストを自動化したい人向けの記事です。次の内容を扱います。
- GUTのGutInputSenderとGdUnit4のシーンランナーで入力をシミュレートするテスト
- コマンドラインからヘッドレスで実行するボットのオートロードと、CIで使うためのフラグ
- Claude CodeやCursorにゲームを実行させるGodotのMCPサーバーの比較と、Godotエディター内で動くAIエージェントZivaの
run_sceneとFull Game Playtest Agent
Godotでプレイテストを自動化するには、代わりにボタンを押すものと、その結果が正しかったかを判定するものが必要です。どちらも自分でスクリプトにできます。GUTやGdUnit4の入力テスト、またはコマンドラインから実行するボットのオートロードを使えば、CIでのヘッドレス実行もできます。ボタンを押す役をAIに任せることもできます。Claude CodeやCursorにゲームを実行させるMCPサーバーや、Zivaのようなエディター内のエージェントです。
このページはZiva.shが公開しており、ZivaもZiva.shが開発しています。他のツールの情報は各ツールの公式ページをもとにした、2026年11月5日時点(Erodenn/godot-mcp-runtimeは2026年11月7日時点)のものです。開示:GDAI MCP は Ziva の共同創業者である Delano Lourenco が開発しています。
このページのGodotのコマンドとテストはすべて、2026年11月5日にLinux上のGodot 4.7.2で、公開されているStar Catcherサンプルを使って実行しました。GUTとGdUnit4のテストは、2026年11月7日にリリース版のGUT 9.7.1とGdUnit4 6.2.3で再実行しました。Star Catcherは意図的なバグを1つ含む小さなゲームです。星を取るとスコアが1増えるはずですが、スコアのラベルが見つからないままです。
Godotでプレイテストを自動化する方法
| 方法 | 何を押すかを決めるもの | ヘッドレスやCI | 価格 |
|---|---|---|---|
| GUTの入力テスト | GUT:テストスクリプトがGutInputSenderを通じて決める | GUT:対応。今回の実行では、GUT 9.7.1が失敗するテストで終了コード1 | GUT:無料、MIT |
| GdUnit4のシーンランナー | GdUnit4:テストスクリプトがシーンランナーを通じて決める | GdUnit4:対応。GdUnit4 6.2.3では--headlessに--ignoreHeadlessModeが必要。今回の実行では、失敗するテストで終了コード100 |
GdUnit4:無料、MIT |
| コマンドラインから実行するボットのオートロード | ボット:自分のスクリプト | ボット:godot --headlessで対応。スクリーンショットと動画にはディスプレイが必要 |
Godot:無料、MIT |
| Claude CodeやCursorと組み合わせるGodotのMCPサーバー | MCPサーバー:AIクライアントのモデル | MCPサーバー:実行中のエディターやゲームを操作する。Beckett FullにはヘッドレスのCIランナーもある | MCPサーバー:無料〜$19の買い切り、加えてクライアントの費用 |
| Ziva run_scene | Ziva run_scene:Zivaのエージェント、またはZivaのMCP経由のClaude Code | Ziva run_scene:非対応。Godotエディターを開いておく必要がある | Ziva run_scene:無料のHobbyプランを含むすべてのプラン |
| Ziva Full Game Playtest Agent | Ziva Full Game Playtest Agent:設定した目標に向かってプレイするAI | Ziva Full Game Playtest Agent:非対応。Godotエディターを開いておく必要がある | Ziva Full Game Playtest Agent:Pro(月$50)とUltra |
| modl.ai、nunu.ai | modl.ai、nunu.ai:各社のAIエージェントが画面を見て決める | modl.ai:「upload your latest build」(最新のビルドをアップロード)。nunu.ai:「PC and mobile (iOS and Android)」(PCとモバイル(iOSとAndroid)) | modl.ai、nunu.ai:ホームページに価格の記載なし |
スクリプトで書いたテストやボットは無料で、再現性があり、高速ですが、確認できるのはスクリプトに書いたことだけです。エージェントはスクリプトにしていない経路を見つけますが、実行のたびにモデルの時間がかかり、エージェントの選択は実行ごとに変わります。たいていのゲームには両方あるとよいです。コミットのたびにスクリプトでチェックし、リリース前にエージェントにプレイさせます。
Godotでキーボードとマウスの入力をシミュレートする
Godot自体に、コードから入力を偽装する方法が2つあります。今回の実行では、どちらの方法でもStar Catcherのプレイヤーがゲーム内時間の1.2秒で右に360px移動しました。
# A raw key, as if the Right arrow were pressed. _input() sees it, and it drives the ui_right action.
var key := InputEventKey.new()
key.keycode = KEY_RIGHT
key.pressed = true
Input.parse_input_event(key)
# A named action from the Input Map. No InputEvent is created, so _input() never sees it.
Input.action_press("ui_right")
Input.action_release("ui_right")
GodotのInputのドキュメントには、parse_input_eventは「Feeds an InputEvent to the game」(InputEventをゲームに送る)、「Also generates Node._input() calls」(Node._input()の呼び出しも発生させる)とあり、action_pressは「will not cause any Node._input() calls」(Node._input()の呼び出しを発生させない)とあります。どちらもOSには触れません。InputEventKeyを送っても「won't toggle between active windows」(アクティブなウィンドウを切り替えない)とされています。parse_input_eventで押したキーを離すには、pressed = falseにしたコピーを送ります。parse_input_eventで送るInputEventActionも、アクションに対して同じように動きます。
GUT:GutInputSender
GUTのGutInputSenderは、「can be used to send InputEvent* events to various objects. It also allows you to script out a series of inputs and play them back in real time.」(InputEvent*のイベントをさまざまなオブジェクトに送るために使える。一連の入力をスクリプトに書き、リアルタイムで再生することもできる)とされています。GUTのMocking Inputのページによると、Inputを受け手にすると、Godotはイベントを「exactly the same as if the events were triggered from hardware」(ハードウェアから発生したイベントとまったく同じように)扱います。次のテストは、修正後のゲームでは成功し、サンプルのmainブランチでは失敗しました。
# res://test/test_star.gd
extends GutTest
var _sender := GutInputSender.new(Input)
func after_each() -> void:
_sender.release_all()
_sender.clear()
func test_walking_right_collects_a_star() -> void:
var main: Node = add_child_autofree(load("res://main.tscn").instantiate())
_sender.action_down("ui_right").hold_for(1.2).wait(0.3)
await _sender.idle
assert_eq(main.get_node("HUD/ScoreLabel").text, "Score: 1")
godot --headless --path . --importでプロジェクトを一度インポートしたあと、GUT 9.7.1でgodot --headless --path . -s addons/gut/gut_cmdln.gd -gdir=res://test -gexitを実行し、ヘッドレスでテストしました。バグのあるブランチでは、GUTは["Score: 0"] expected to equal ["Score: 1"]と報告し、「Unexpected Errors」の下にInvalid assignment of property or key 'text' ... on a base object of type 'null instance'のエラーを挙げ、終了コード1で終了しました。GutInputSenderにはkey_down、key_up、mouse_left_click_atやその他のマウス用メソッドもあります。
GdUnit4:シーンランナー
GdUnit4のシーンランナーには、「mimic user key inputs as actions for testing purposes」(テストのためにユーザーのキー入力をアクションとして模倣する)関数があり、simulate_key_pressed(KEY_ENTER)やsimulate_mouse_button_pressed(MOUSE_BUTTON_LEFT)のようなキーとマウスの関数もあります。GdUnit4 6.2.3で同じチェックを書くと次のようになります。
# res://test/test_star.gd
extends GdUnitTestSuite
func test_walking_right_collects_a_star() -> void:
var runner := scene_runner("res://main.tscn")
runner.simulate_action_press("ui_right")
await await_millis(1200)
runner.simulate_action_release("ui_right")
await runner.await_input_processed()
assert_str(runner.find_child("ScoreLabel").text).is_equal("Score: 1")
GdUnit4 6.2.3は、--ignoreHeadlessModeを付けないと--headlessでの実行を拒否し、「Headless mode is not supported!」と出力して終了コード103で終了します。そのため、./addons/gdUnit4/runtest.sh --godot_binary /usr/bin/godot --headless --ignoreHeadlessMode -a res://testで実行しました。バグのあるブランチでは、GdUnit4は同じnull instanceへの代入について「Godot Runtime Error」を報告し、「Expecting: 'Score: 1' but was 'Score: 0'」も報告して、終了コード100で終了しました。修正後のゲームでは終了コード0で、xvfb-runで実行しても同じ結果でした。このテストはsimulate_frames(72)ではなくawait_millis(1200)で待ちます。GdUnit4が数えるのは秒ではなくフレームだからです。72フレーム押し続けるテストは、ヘッドレスでは成功しましたが、xvfb-runでは3回中3回失敗しました。xvfb-runでは、テスト全体が110〜178msで終わっていました。
押す、押すだけ、離すの各メソッド、今回遭遇した落とし穴、リリース版のGUT 9.7.1とGdUnit4 6.2.3でテストしたCI用のコマンドについては、GUTとGdUnit4でキーボードとマウスの入力をシミュレートする方法(英語)を参照してください。
ゲームに自分でプレイさせる:ボットとコマンドライン
テスト用のシーンではなく実際のゲームを通して動かすには、指示したときだけプレイするオートロードを追加します。次のオートロードは右に歩いて最初の星に触れ、スコアを確認します。
# res://bot.gd, registered under [autoload] in project.godot as Bot="*res://bot.gd"
extends Node
# Plays only when the game is started with "-- --bot", then quits with exit code 0 (pass) or 1 (fail).
func _ready() -> void:
if not OS.get_cmdline_user_args().has("--bot"):
return
await get_tree().create_timer(0.3).timeout
Input.action_press("ui_right")
await get_tree().create_timer(1.2).timeout
Input.action_release("ui_right")
await get_tree().create_timer(0.5).timeout
var label: Label = get_tree().current_scene.get_node("HUD/ScoreLabel")
print("BOT: score label says '%s'" % label.text)
get_tree().quit(0 if label.text == "Score: 1" else 1)
プロジェクトのフォルダーから実行します。
godot --headless --path . --fixed-fps 60 --quit-after 600 -- --bot
サンプルのバグのあるmainブランチでは、Godot 4.7.2が次のように出力しました。
Godot Engine v4.7.2.stable.arch_linux.ed1daf0bf (2026-08-17 01:18:38 UTC) - https://godotengine.org
ERROR: Node not found: "%ScoreLabel" (relative to "/root/Main").
at: get_node (scene/main/node.cpp:1975)
GDScript backtrace (most recent call first):
[0] @implicit_ready (res://main.gd:5)
SCRIPT ERROR: Invalid assignment of property or key 'text' with value of type 'String' on a base object of type 'null instance'.
at: _on_star_collected (res://main.gd:15)
GDScript backtrace (most recent call first):
[0] _on_star_collected (res://main.gd:15)
[1] _on_body_entered (res://star.gd:8)
BOT: score label says 'Score: 0'
終了コードは1でした。main.gdの%ScoreLabelを$HUD/ScoreLabelに変えると、同じコマンドでBOT: score label says 'Score: 1'と出力され、終了コード0で終了しました。各フラグの役割は次のとおりです。
-
--headless:ウィンドウもオーディオもなしで実行するため、CIのマシンでも動きます。何も描画されないので、スクリーンショットは撮れません。 -
--fixed-fps 60:どのフレームにもゲーム内時間でちょうど1/60秒を割り当てます。godot --helpによると、このフラグは「disables real-time synchronization」(リアルタイムとの同期を無効にする)ものです。起動を含む実行全体で、ゲーム内時間2秒に対して実時間は0.78秒でした。計測したすべての実行で、プレイヤーは同じ360pxだけ移動しました。 -
--quit-after 600:ボットが終了しなかった場合、600回のイテレーション(フレーム)でゲームを止めます。そのため、止まった実行でCIが固まることはありません。 -
--の後ろの引数はOS.get_cmdline_user_args()でゲームに渡ります。そのため、通常の起動ではボットは何もしません。
合否はボット自身が判定する必要があります。ボットなしでは、godot --headless --path . --fixed-fps 60 --quit-after 600は同じNode not foundのエラーを出力したうえで、終了コード0で終了しました。
ボットの動きを見るには、--write-movie run.aviで録画します。録画には描画が必要で、今回のテストでは--headlessを付けるとGodot 4.7.2がクラッシュしました(signal 11)。仮想Xディスプレイ(Xvfb、GPUなし)上で--headlessなしで同じ実行をすると、60FPSで122フレームのAVIが書き出され、Done recording movie at pathと出力されました。長いゲームでは、複数の入力をつなげ、各ステップでシグナルやノードの状態を確認し、レベルごとにボットの経路を用意します。
Claude CodeやCursorにゲームを実行させる:GodotのMCPサーバー
MCPサーバーは、Claude CodeやCursorのようなAIクライアントに、Godotを操作するツールを与えます。何を押すかはクライアントのモデルが決めます。次のサーバーは、ゲームの実行、入力の送信、結果の確認のためのツールを挙げています。セットアップ、費用、対応するGodotのバージョンを並べて比較するには、Claude CodeとCursorで使えるGodotのMCPサーバー(英語)を参照してください。
| MCPサーバー | ゲームの実行 | 入力の送信 | 実行中のゲームの確認 | ライセンスと価格 |
|---|---|---|---|---|
| ZivaのMCPサーバー | Ziva:run_sceneが開いているエディターからシーンを実行 |
Ziva:アクション、キー、マウスクリック、パスかテキストで指定したControlのクリック、マウスの移動 | Ziva:最後のスクリーンショットとコンソール出力、ランタイムエラー。get_screenshot(エディター) |
Ziva:run_sceneは無料のHobbyプランを含むすべてのプランで使える |
| Godot MCP Pro | Godot MCP Pro:「Launch the game」(ゲームを起動) | Godot MCP Pro:simulate_key、simulate_mouse_click、simulate_action、simulate_sequence
|
Godot MCP Pro:get_game_screenshot
|
Godot MCP Pro:「$15 one-time purchase」($15の買い切り) |
| GDAI MCP | GDAI MCP:ゲームを実行し、スクリーンショットで確認 | GDAI MCP:「press keyboard keys and input actions」(キーボードのキーと入力アクションを押す) | GDAI MCP:「the editor and running game」(エディターと実行中のゲーム)のスクリーンショット | GDAI MCP:「$19 one-time payment」($19の買い切り)、バイナリのみのライセンス |
| Beckett | Beckett LiteとFull:「run your game」(ゲームを実行) | Beckett Full:「simulate input, click 2D and 3D UI, scroll, drag, record and replay」(入力のシミュレート、2Dと3DのUIのクリック、スクロール、ドラッグ、記録と再生) | Beckett LiteとFull:「screenshot the running game」(実行中のゲームのスクリーンショット) | Beckett:Liteは無料(MIT)、Fullは「$15, one-time」($15の買い切り) |
| satelliteoflove/godot-mcp | satelliteoflove/godot-mcp:実行、停止、再起動。フリーズとステップ実行 | satelliteoflove/godot-mcp:「actions, joypad, raw keys, mouse-look, text」(アクション、ジョイパッド、生のキー、マウスルック、テキスト) | satelliteoflove/godot-mcp:ゲームのスクリーンショットと、JSONでのライブの状態 | satelliteoflove/godot-mcp:無料、MIT。Godot 4.5以降 |
| Godot AI(hi-godot/godot-ai) | Godot AI:project_run
|
Godot AI:input_key、input_mouse、input_gamepad、input_action、input_sequence
|
Godot AI:実行中のゲームのフレームバッファーを含むeditor_screenshot
|
Godot AI:無料、MIT。Godot 4.7以降 |
| Erodenn/godot-mcp-runtime | godot-mcp-runtime:run_project
|
godot-mcp-runtime:キー、マウスのクリックと移動、名前かパスで指定したUIのクリック、アクション用のsimulate_input
|
godot-mcp-runtime:take_screenshot
|
godot-mcp-runtime:無料、MIT。Godotのアドオンは不要 |
| Open Godot MCP | Open Godot MCP:godot_gameでプレイ、停止、フリーズ |
Open Godot MCP:キーボード、マウス、ゲームパッド、テキスト用のgodot_input
|
Open Godot MCP:godot_screenshot
|
Open Godot MCP:無料、MIT。Godot 4.5以降 |
| Coding-Solo/godot-mcp | Coding-Solo/godot-mcp:「run projects, capture debug output」(プロジェクトを実行し、デバッグ出力を取得) | Coding-Solo/godot-mcp:入力ツールの記載なし | Coding-Solo/godot-mcp:ゲームのスクリーンショットの記載なし | Coding-Solo/godot-mcp:無料、MIT |
| Summer Engine MCP | Summer Engine:「play」(プレイ) | Summer Engine:「input」(入力) | Summer Engine:「screenshots」(スクリーンショット) | Summer Engine:「drive Summer's desktop editor, not stock Godot」(標準のGodotではなく、Summerのデスクトップエディターを操作する)MITのCLIとMCPツール |
キーを押す以上の検証について説明しているベンダーも2つあります。Godot MCP Proのページには、「assert game state, and run stress tests with random input」(ゲームの状態をアサートし、ランダムな入力でストレステストを実行する)ことができるとあります。Beckettの作者は2026年7月10日に、Beckett Fullについて「A headless runner plays every saved suite in your own CI and exits non-zero on failure.」(ヘッドレスのランナーが、自分のCIで保存済みのすべてのスイートをプレイし、失敗すると0以外の終了コードで終了する)と書いています。
Zivaにゲームを実行させてエラーを読ませる
Zivaは、Godotエディターの中で動くAIエージェントです。バージョン3.0.0(2026年6月)以降、Zivaのrun_sceneツールは、開いているエディターから、エディターに埋め込まれたゲームビューでシーンをその場で実行します。そして、実行中のゲームのスクリーンショットと、その実行のコンソール出力とランタイムエラーを返します。Zivaのrun_sceneは、無料のHobbyプランを含むすべてのプランで使えます。具体的な確認を頼むと、Zivaのエージェントが自分でrun_sceneを呼び出します。例:「レベルを実行して、最初の足場に飛び乗り、プレイヤーが着地することを確認して」。
Zivaのrun_sceneは、時間を指定した入力のリストを受け取ります。各入力には開始時刻と押し続ける時間があります。
-
action:名前付きの入力アクション。Input.action_pressで押すため、キーの割り当てがなくても動きます。 -
key:生のInputEventKey。_inputで受け取れます。 -
mouse:ピクセル位置での左クリックまたは右クリック。 -
target:ノードパスか表示テキストで見つけたControlのクリック。 -
motion:相対的なマウスの移動。マウスをキャプチャーする一人称カメラ向けです。
Zivaは、生のキーとマウスクリックを、Godot内でキーボードのイベントが通るのと同じ経路であるInput.parse_input_eventでInputEventとして送り、名前付きのアクションはInput.action_pressで押します。Zivaが物理的なキーを押すことはなく、Zivaのrun_sceneにはゲームパッドやタッチの入力はありません。Zivaのrun_sceneの結果には毎回、各押下と解放が届いたフレームとミリ秒を記した送信レポート(delivery report)が含まれます。speed: trueを指定すると、平均FPS、1% low、最悪フレーム時間も加わります。
Star CatcherでZivaのrun_sceneが返した結果
Godot 4.7.2のStar Catcherサンプルで、モデルを介さずに、ZivaのローカルMCPエンドポイントからZivaのrun_sceneを直接呼び出しました。
- 単純に2.5秒実行すると、ソース
res://main.gd:5のNode not found: "%ScoreLabel" (relative to "/root/Main")が返りました。 - 300msの時点から1,200ms
ui_rightを押し続けると、プレイヤーが360px移動して最初の星を取りました。Zivaの結果にはres://main.gd:15のInvalid assignment of property or key 'text' with value of type 'String' on a base object of type 'null instance'が加わり、スクリーンショットではスコアは0のままでした。 - UIの確認のため、テスト用のコピーにCanvasLayer内のRestartボタンを追加しました(公開サンプルにはありません)。Zivaの
run_sceneは、表示テキスト「Restart」、ノードパスRestartLayer/RestartButton、ピクセル位置へのマウスクリックの3通りでボタンをクリックし、そのたびにボタンのpressedハンドラーが出力しました。 - 何にも一致しないターゲット「Play Again」は、Zivaの送信レポートで
delivered: falseと「no Control matched target 'Play Again'」として返りました。実行自体は成功と報告されたので、送信レポートを確認してください。
同じサンプルを使った別の無編集の録画では、1つのプロンプトで、星を追加し、ゲームをプレイして、スコアが増えることを確認するようZivaに頼みました。Zivaはui_rightを押し続けながらゲームを実行し、2つのエラーを読み、main.gdの参照を$HUD/ScoreLabelに変えて、もう一度ゲームを実行し、Score: 1を確認しました。正確なプロンプトとすべての変更は、サンプルのREADMEにあります。
Claude CodeやCursorからZivaのrun_sceneを使う
ZivaはローカルのMCPサーバーを動かしているため、Claude Code、Codex、CursorなどのMCPアプリからZivaのrun_sceneとget_screenshotのツールを呼び出せます。ZivaのMCPサーバーはローカル専用で、ホスティングされたURLはありません。Claude Codeを接続する手順は次のとおりです(詳しい手順(英語))。
- Zivaをインストールしてサインインした状態で、Godotでプロジェクトを開きます。
- ZivaでSettings → Models & Providers → Ziva as an MCP serverを開き、Runningと表示されていることを確認します。
- AI applicationでClaude Codeを選び、Install for Claude Codeをクリックします。
- GodotプロジェクトのフォルダーからClaude Codeの新しいセッションを開始し、たとえば次のように頼みます。「ziva-godotのrun_sceneツールでres://main.tscnを2500ms実行し、300msの時点から1200msのあいだui_rightを押し続けて、出力されたエラーを教えて」。
これで、Claude CodeはZiva自身のエージェントと同じスクリーンショット、コンソール出力、エラーを受け取ります。Zivaのrun_sceneはZivaの設定でプレイテストを有効にしている場合にだけ表示され、ZivaのFull Game Playtest AgentはMCP経由では使えません。
Ziva Full Game Playtest Agent
3.1.4(2026年8月)で追加されたZivaのFull Game Playtest Agentは、「木を切り倒して作業台を作る」のような、設定した目標に向かってゲーム全体をプレイします。ZivaのFull Game Playtest Agentは、ZivaのPro(月$50)とUltraのプランで使えます。Zivaに「Full Game Playtest Agentを使って」と頼みます。ZivaのFull Game Playtest Agentはゲームを起動し、モデルが考えている間はゲームを一時停止したままにし、キーボードとマウスの入力を1アクションずつ送ります。そして、スクリーンショットと実行中のシーンから読み取った値で結果を確認し、根拠とともにpass(合格)、fail(不合格)、blocked(進行不能)のいずれかを返します。Settings → AgentでRecord playtestsをオンにすると、Zivaは目標と入力を描き込んだ実行の動画を保存します。ZivaのFull Game Playtest Agentはプロジェクトを編集できません。報告するだけで、バグの修正は開発者自身か、Zivaの通常のチャットで行います。詳しくはIs there an AI agent that can playtest a Godot game?(英語)とFull Game Testerのページ(英語)を参照してください。
チェックリスト:リリース前にGodotのゲームのバグを見つける
- エラーで実行を失敗させます。今回のテストでは、Godotは
SCRIPT ERRORのあとも終了コード0で終了しました。ボットにget_tree().quit(1)を呼ばせるか、ログにSCRIPT ERRORが含まれるときにCIのステップを失敗させます。 - メインの経路(開始、最初のレベル、勝利、敗北、リスタート)をスクリプトにします。ボットとして、またはGUTかGdUnit4のテストとして、コミットのたびにヘッドレスで実行します。
-
--fixed-fps 60を使い、タイマーと物理演算が毎回同じように進むようにします。 - ゲームプレイだけでなく、UIもクリックして確認します。メニュー、ポーズ、リスタート、CanvasLayer内のボタンです。
- 失敗の様子を想像しにくいときは、ディスプレイのある環境で
--write-movieを使ってボットの実行を録画します。 - リリース前には、スクリプトにしていない経路をエージェントにプレイさせます。たとえばZivaのFull Game Playtest Agentや、MCPサーバーを使ったClaude Codeです。
- 目標のFPSでフレームレートを確認します。Zivaの
run_sceneにspeed: trueを指定すると、平均FPS、1% low、最悪フレーム時間が報告されます。 - エクスポートしたビルドは、各プラットフォームで自分でテストします。Zivaのプレイテストはエディターの中で動き、エクスポートしたビルドでは動きません。
Zivaにできないこと
- Zivaがゲームをプレイできるのは、開いているGodotエディターの中だけです。そのため、ZivaにはヘッドレスモードもCIモードもありません。CIにはGUT、GdUnit4、ボットを使ってください。
- Zivaがプレイできるのは一度に1つのゲームだけで、マルチプレイや複数ウィンドウでの実行はできません。
- Zivaが送れるのはキーボードとマウスの入力だけで、ゲームパッドやタッチの入力はありません。エクスポートしたビルド、モバイル、Webでのプレイもできません。
- ZivaのFull Game Playtest AgentはGodot専用で、ProとUltraでのみ使えます。ホスティングされたモデルを使い、プロジェクトを編集できません。
- Zivaのプレイテストには、Claude CodeがMCP経由で
run_sceneを呼び出す場合でも、Zivaへのサインインが必要です。run_sceneだけなら無料のHobbyプランで足ります。 - Zivaは、ゲームが面白いかどうかは教えてくれません。
関連記事(英語)
- Best AI tools for Godot in 2026:コーディングエージェントから3Dモデル、効果音まで、Godot向けのあらゆるAIツールを用途別に紹介
- Is there an AI agent that can playtest a Godot game?
- Ziva as an MCP server
- Ziva vs Godot MCP
- Ziva vs GDAI MCP
まとめ
- スクリプトで書いたテストやボットは無料で、再現性があり、高速ですが、確認できるのはスクリプトに書いたことだけです。エージェントはスクリプトにしていない経路を見つけますが、実行のたびにモデルの時間がかかります。コミットのたびにスクリプトでチェックし、リリース前にエージェントにプレイさせます。
- Godotはスクリプトエラーのあとも終了コード0で終了するため、合否はボットかテストフレームワークが判定する必要があります。
--fixed-fps 60でタイマーと物理演算が毎回同じように進み、--quit-afterで止まった実行でもCIが固まりません。 - Zivaの
run_sceneは無料のHobbyプランを含むすべてのプランで、ZivaのFull Game Playtest AgentはProとUltraで使えます。どちらも開いているGodotエディターの中で動き、ヘッドレスやCIのモードはなく、送れるのはキーボードとマウスの入力だけです。
よくある質問
Godotのゲームが最初から最後まで自分でプレイするように、プレイテストを自動化するには?
プレイヤーが押すはずの入力を押して結果を確認する小さなボットを書き、コマンドラインからそのボットと一緒にゲームを実行します。Godotでは、タイマーでInput.action_pressとInput.action_release(またはInputEventKeyを渡したInput.parse_input_event)を呼び出すオートロードをボットにでき、godot --headless --fixed-fps 60 --quit-after 600で起動します。スクリプトエラーのあとでもGodotの終了コードは0のままなので、チェックが失敗したらボットがget_tree().quit(1)を呼び出すようにします。GUTのGutInputSenderとGdUnit4のシーンランナーは、同じことをテストスイートの中で行います。入力をスクリプトに書きたくない場合は、Godotエディター内で動くAIエージェントZivaが、すべてのプランでrun_sceneツールを使ってシーンを実行し、キーボードとマウスの入力を送ります。また、ZivaのFull Game Playtest Agent(ProとUltra)は、設定した目標に向かってプレイし、pass、fail、blockedのいずれかを返します。
Godotのゲームをプレイしてバグを見つけてくれるAIエージェントはありますか?
あります。ZivaのPro(月$50)とUltraのプランで使えるZivaのFull Game Playtest Agentは、指定した目標に向かってエディター内でGodotのゲームをプレイし、キーボードとマウスの入力を送って、根拠とともにpass、fail、blockedの判定を返します。Record playtestsがオンなら動画も返します。ZivaのFull Game Playtest Agentはプロジェクトを編集できず、修正はZivaの通常のチャットで行います。無料のHobbyプランを含むZivaのすべてのプランで、Zivaのrun_sceneツールが時間指定の入力でシーンを実行し、スクリーンショット、コンソール出力、ランタイムエラーを返します。Godot MCP Pro、GDAI MCP、Beckett Full、satelliteoflove/godot-mcpなどのMCPサーバーは、Claude CodeやCursorに入力とスクリーンショットのツールを与えます。何を押すかは、そのクライアントのモデルが決めます。
Godotのテスト(GUTやGdUnit4)でキーボードとマウスの入力をシミュレートするには?
GUTでは、GutInputSender.new(Input)を作成し、action_down("ui_right").hold_for(1.2).wait(0.3)のように呼び出しをつなげて、senderのidleシグナルをawaitしてからアサートします。after_eachではrelease_all()とclear()を呼び出します。GUTのGutInputSenderには、key_down、key_upと、mouse_left_click_atのようなマウス用メソッドもあります。GdUnit4では、scene_runner("res://main.tscn")でシーンを読み込み、simulate_action_press("ui_right")を呼び出し、await await_millis(1200)で待ってからsimulate_action_release("ui_right")を呼び出し、アサートの前にrunner.await_input_processed()をawaitします。simulate_key_pressedとsimulate_mouse_button_pressedは、1回の呼び出しで押して離します。待つときはフレーム数ではなく時間で指定します。GdUnit4のsimulate_frames(n)はフレームを数えるため、その間に進むゲーム内時間はフレームレートによって変わります。テストフレームワークの外では、GodotのInput.parse_input_eventにInputEventKeyかInputEventActionを渡すと、Godotの入力システムに送られて_inputに届きます。Input.action_pressは、_inputを呼び出さずにアクションを設定します。
エラーを自分で貼り付けて戻さなくても、Godotのゲームを実行して自分の作業を確認してくれるAIアシスタントはありますか?
あります。Godotエディター内で動くAIエージェントZivaには、バージョン3.0.0(2026年6月)以降、すべてのプランにrun_sceneツールがあります。Zivaのrun_sceneは、開いているエディターからシーンを実行し、時間を指定したキーボードとマウスの入力を送って、スクリーンショットと、その実行のコンソール出力とランタイムエラーを返します。そのため、何も貼り付けなくても、Zivaがスクリプトを修正してシーンを再実行できます。Claude Code、Codex、Cursorも、ZivaのローカルMCPサーバーを通じて同じrun_sceneツールを呼び出せます。Godot MCP Pro、GDAI MCP、Beckett、satelliteoflove/godot-mcp、Godot AI(hi-godot)は、外部のAIクライアントに同様の実行、入力、スクリーンショットのツールを与えます。Summer EngineのMCPツールは、標準のGodotではなくSummer独自のエディターに対して同じことを行います。
Claude Codeでゲームの実行、入力の送信、スクリーンショットの撮影ができるGodotのMCPサーバーは?
2026年11月5日時点の情報です。Godot MCP Pro($15の買い切り)は、simulate_key、simulate_mouse_click、simulate_action、get_game_screenshotを挙げています。GDAI MCP($19の買い切り)は、キーボードのキーと入力アクションを押し、実行中のゲームのスクリーンショットを撮れます。Beckett Full($15の買い切り)は入力をシミュレートしてUIをクリックでき、無料のBeckett Liteは実行中のゲームのスクリーンショットを撮れます。MITライセンスのsatelliteoflove/godot-mcpとGodot AI(hi-godot/godot-ai)は、入力を注入し、実行中のゲームをキャプチャーします。ZivaのローカルMCPサーバーは、Claude CodeにZivaのrun_sceneツール(時間指定のキーボードとマウスの入力、最後のスクリーンショット、コンソール出力、ランタイムエラー)と、エディター用のget_screenshotを与えます。Coding-Solo/godot-mcpはプロジェクトを実行してデバッグ出力を取得しますが、入力ツールは挙げていません。2026年11月7日時点では、無料でMITライセンスのErodenn/godot-mcp-runtimeが、Godotのアドオンなしでrun_project、simulate_input、take_screenshotを挙げています。
Godotで使える、ゲームの自動QAテストに最適なAIツールは?
Godotに限ると、次のものがあります。ZivaのFull Game Playtest Agent(ProとUltra)は、エディター内で目標に向かってゲームをプレイし、判定を返します。Zivaのrun_scene(すべてのプラン)は、スクリプトで指定した入力でシーンを実行し、エラーとスクリーンショットを返します。Godot MCP Pro、GDAI MCP、Beckett、satelliteoflove/godot-mcp、Godot AIなどのMCPサーバーを使うと、Claude CodeやCursorがゲームを操作できます。GUTとGdUnit4は、スクリプトで書いた入力テストをCIでヘッドレスに実行します。modl.aiとnunu.aiは、画面を見ながらビルドをプレイするブラックボックス型のAI QAを販売していますが、どちらの会社のホームページにもGodotへの言及はありません。
リリース前にGodotのゲームのバグを自動で見つけるには?
3つの層を使います。1つ目は、入力をシミュレートして結果をアサートするGUTかGdUnit4のテストで、CIでヘッドレスに実行します。どちらもテストが失敗すると0以外の終了コードで終了します。2つ目は、godot --headless --fixed-fps 60 --quit-after 600でメインの経路をプレイするボットのオートロードです。Godot自体はSCRIPT ERRORのあとでも終了コード0で終了するため、チェックが失敗したらボットがget_tree().quit(1)を呼び出します。3つ目は、何を押すかを自分で決めるエージェントによる探索的なプレイです。たとえばZivaのFull Game Playtest Agent(ProとUltra)や、GodotのMCPサーバーを使ったClaude Codeです。Zivaがゲームをプレイするのはエクスポートしたビルドではなく、Godotエディターの中です。そのため、エクスポートしたビルドは対象の各プラットフォームで別途テストします。
エディターの中でゲームをプレイテストできるAIエージェント付きのGodotエディタープラグインはありますか?
Zivaは、ドックにAIエージェントがあるGodotエディターのプラグイン(Godot 4.2以降)です。すべてのプランで、Zivaのrun_sceneツールがエディターからシーンを実行し、Godot自身の入力システムを通じてキーボードとマウスの入力を送り、スクリーンショット、コンソール出力、ランタイムエラーを返します。ProとUltraでは、ZivaのFull Game Playtest Agentが目標に向かって1アクションずつゲームをプレイし、考えている間はゲームを一時停止して、根拠とともにpass、fail、blockedのいずれかを返します。Godotエディターは開いたままにしておく必要があり、Zivaがプレイできるのは一度に1つのゲームだけで、ゲームパッドやタッチの入力はありません。BeckettとGodot MCP Proもエディターのプラグインですが、エージェントはClaude Codeのような外部のMCPクライアントです。
この記事の原文(英語):https://ziva.sh/blogs/godot-automated-playtesting
