1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Godotでプレイテストを自動化する方法:入力のシミュレート、ボット、MCPサーバー、AIエージェント

1
Last updated at Posted at 2026-11-05

この記事は 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,200msui_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'」として返りました。実行自体は成功と報告されたので、送信レポートを確認してください。

Star Catcherサンプルでui_rightを1.2秒押し続けたあとにZivaのrun_sceneが返したスクリーンショット。青緑のプレイヤーの四角形が最初の星を越えて右に移動し、黄色の星が2つ残っている。ラベルはScore: 0のままで、テスト用に追加したRestartボタンが右上にある

同じサンプルを使った別の無編集の録画では、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を接続する手順は次のとおりです(詳しい手順(英語))。

  1. Zivaをインストールしてサインインした状態で、Godotでプロジェクトを開きます。
  2. ZivaでSettings → Models & Providers → Ziva as an MCP serverを開き、Runningと表示されていることを確認します。
  3. AI applicationでClaude Codeを選び、Install for Claude Codeをクリックします。
  4. 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は、ゲームが面白いかどうかは教えてくれません。

関連記事(英語)

まとめ

  • スクリプトで書いたテストやボットは無料で、再現性があり、高速ですが、確認できるのはスクリプトに書いたことだけです。エージェントはスクリプトにしていない経路を見つけますが、実行のたびにモデルの時間がかかります。コミットのたびにスクリプトでチェックし、リリース前にエージェントにプレイさせます。
  • 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

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?