ブログに戻る

Godot 4.8 Beta 3 リリース間近?シーンが壊れる前に移行テストを実行しよう

公開日 2026年11月13日
Godot 4.8 Beta 3 リリース間近?シーンが壊れる前に移行テストを実行しよう AIを活用して生成

要点まとめ

Godot 4.8 Beta 3 の移行テストをベータ期間中にぜひ実行しよう。シーン破損を防ぐ具体的なテストスクリプト、GDScript・シーンメタデータ・物理挙動の3つの落とし穴、開発者が注目するリグレッション報告の構成まで、安定版リリース前に確認すべき項目を網羅した実践ガイド。

Godot 4.8 beta 3 スナップショットがリリースされました。開発チームによると、リリース候補(RC)フェーズに近づいているとのことです。つまり、リグレッション(回帰バグ)を発見・報告できる期間は急速に縮んでいます。Godot プロジェクトをメンテナンスしているなら、来月リリース予定でも1年後でも、今すぐこのビルドでコードベースを開いて、何が壊れるかを確認しましょう。

ほとんどの開発者はベータ版を体系的にテストしていません。ビルドをクローンしてプロジェクトを開き、いくつかのシーンを目視確認して「OK」と判断します。そして安定版がリリースされると、物理挙動が変わっていたり、セーブファイルが正しくデシリアライズされなかったり、開発中には一度も発生しなかった謎の GDScript パースエラーがプレイヤーに発生したりします。解決策は、リリース後の必死のデバッグではありません。今これらの問題を検出できる、再現可能なテスト手順です。

このガイドでは、今日すぐ実行できる移行テストスクリプト、チェックすべき3つの具体的な落とし穴、そして実際に Godot チームの注目を集めるリグレッション報告の構成を紹介します。


なぜ Beta 3 がテストの期限なのか

Beta 3 は、Godot チームがリリース候補に移行する前の最後のベータ版です。リリース候補は仕上げのためのものであり、45°より急な坂で move_and_slide() の挙動が変わることを発見するためのものではありません。RC1 がリリースされる頃には、新しいリグレッションは、リリースを遅らせるほど深刻な場合にのみブロッカーとしてトリアージされます。

ベータ期間中のあなたの仕事は明確です:

  • 安定版ビルドで見えなくなる前にリグレッションを見つける
  • プロジェクトのコードベース固有の破壊的変更を文書化する
  • メンテナーが修正できるように最小限の再現手順でバグを報告する

Godot チームは先週 GodotFest に参加しながらも、残っているリリースブロッカーの修正をプッシュし続けていました。それがペースです。4.8 のリリース時の姿に意見を反映させたいなら、今テストしましょう。


移行テスト用ブランチのセットアップ

beta 3 で何かを開く前に、クリーンなテスト環境を作成しましょう:

# Create a dedicated testing branch from your stable codebase
git checkout -b beta/4.8-testing
git push -u origin beta/4.8-testing

専用ブランチが重要な理由: Godot のシーンファイル(.tscn)はテキストベースで、エンジン固有のメタデータを含みます。4.8 beta 3 でシーンを開いて保存すると、ファイルハッシュが変わります。異なる Godot バージョンを使うチームメンバーとマージすると、解決が厄介なマージコンフリクトが発生します。ベータテストは分離しておきましょう。


移行テストスクリプトの作成

開発者が陥る最大のテストギャップは、ベースラインがないことです。プロジェクトを開いて「問題なさそう」と確認して次に進む。問題は、問題なさそうでは、物理挙動のドリフト、シェーダーコンパイルの差異、特定の条件下でのみ表面化する GDScript の挙動変化を見逃してしまうことです。

以下は、任意の Godot 4.x プロジェクトにそのまま使える移行テストスクリプトです。コアエンジンの挙動が期待値と一致するかを検証します:

@tool
extends SceneTree

## Godot 4.8 Beta 3 Migration Test Suite
## Run with: godot --headless -s migration_test.gd
##
## This script validates that core engine behaviors match
## expectations from Godot 4.7.x stable. Run it in both
## the stable build and beta 3, then compare output.

var results: Array[Dictionary] = []

func _init() -> void:
	print("\n╔══════════════════════════════════════════════╗")
	print("║   Godot 4.8 Beta 3 — Migration Test Suite   ║")
	print("╚══════════════════════════════════════════════╝\n")
	
	test_vector_math()
	test_json_parsing()
	test_scene_serialization()
	test_input_map_registration()
	test_color_conversion()
	test_file_access_permissions()
	
	print_summary()
	quit(get_exit_code())

func record(test_name: String, passed: bool, detail: String) -> void:
	results.append({
		"name": test_name,
		"passed": passed,
		"detail": detail
	})

func test_vector_math() -> void:
	# Vector2 operations — regression-prone area in minor releases
	var a := Vector2(3.0, 4.0)
	var b := Vector2(1.0, 0.0)
	
	# Length should be exactly 5.0
	record(
		"Vector2.length()",
		abs(a.length() - 5.0) < 0.001,
		"Expected 5.0, got %.6f" % a.length()
	)
	
	# Normalized vector should have length 1.0
	var normalized := a.normalized()
	record(
		"Vector2.normalized()",
		abs(normalized.length() - 1.0) < 0.001,
		"Expected length 1.0, got %.6f" % normalized.length()
	)
	
	# Dot product: (3,4)·(1,0) = 3.0
	record(
		"Vector2.dot()",
		abs(a.dot(b) - 3.0) < 0.001,
		"Expected 3.0, got %.6f" % a.dot(b)
	)

func test_json_parsing() -> void:
	var test_cases := [
		'{"score": 1500, "level": 12, "name": "TestPlayer"}',
		'{"nested": {"value": true}, "array": [1, 2, 3]}',
		'{"special": "chars: \\\"quotes\\\" and \\\\backslash"}',
	]
	
	for i in test_cases.size():
		var json := JSON.new()
		var error := json.parse(test_cases[i])
		record(
			"JSON.parse() case %d" % i,
			error == OK and json.data is Dictionary,
			"Parse error: %s" % error_string(error) if error != OK else "Parsed successfully with %d keys" % json.data.size()
		)

func test_scene_serialization() -> void:
	# Create a minimal scene and verify round-trip serialization
	var root := Node.new()
	root.name = "TestRoot"
	
	var child := Node2D.new()
	child.name = "TestChild"
	child.position = Vector2(100.5, 200.75)
	child.rotation = 1.5708  # ~90 degrees
	child.scale = Vector2(2.0, 2.0)
	root.add_child(child)
	
	# Test that properties are preserved
	record(
		"Node2D.position precision",
		abs(child.position.x - 100.5) < 0.01 and abs(child.position.y - 200.75) < 0.01,
		"Expected (100.5, 200.75), got (%.2f, %.2f)" % [child.position.x, child.position.y]
	)
	
	record(
		"Node2D.rotation",
		abs(child.rotation - 1.5708) < 0.001,
		"Expected ~1.5708, got %.6f" % child.rotation
	)
	
	root.free()

func test_input_map_registration() -> void:
	var action_name := "__migration_test_action_7f3a"
	var event := InputEventKey.new()
	event.keycode = KEY_SPACE
	
	InputMap.add_action(action_name)
	InputMap.action_add_event(action_name, event)
	
	record(
		"InputMap.add_action()",
		InputMap.has_action(action_name),
		"Action registered: %s" % InputMap.has_action(action_name)
	)
	
	var events := InputMap.action_get_events(action_name)
	record(
		"InputMap.action_get_events()",
		events.size() == 1 and events[0] is InputEventKey,
		"Expected 1 InputEventKey, got %d event(s)" % events.size()
	)
	
	InputMap.erase_action(action_name)
	record(
		"InputMap.erase_action()",
		not InputMap.has_action(action_name),
		"Action erased: %s" % (not InputMap.has_action(action_name))
	)

func test_color_conversion() -> void:
	# Colors can serialize differently across versions
	var red := Color(1.0, 0.0, 0.0, 1.0)
	var hex := red.to_html()
	
	record(
		"Color.to_html()",
		hex == "ff0000ff",
		"Expected 'ff0000ff', got '%s'" % hex
	)
	
	var from_html := Color.html("00ff00ff")
	record(
		"Color.html()",
		abs(from_html.g - 1.0) < 0.001 and abs(from_html.a - 1.0) < 0.001,
		"Expected green (0,1,0,1), got (%.2f, %.2f, %.2f, %.2f)" % [from_html.r, from_html.g, from_html.b, from_html.a]
	)

func test_file_access_permissions() -> void:
	# Verify user:// directory is writable
	var test_path := "user://_migration_test.tmp"
	var file := FileAccess.open(test_path, FileAccess.WRITE)
	record(
		"FileAccess user:// write",
		file != null if true else FileAccess.get_open_error() == OK,
		"File opened for writing: %s" % ("OK" if file != null else error_string(FileAccess.get_open_error()))
	)
	
	if file:
		file.store_string("migration_test_4.8_beta3")
		file.close()
		
		# Read it back
		var reader := FileAccess.open(test_path, FileAccess.READ)
		if reader:
			var content := reader.get_as_text()
			reader.close()
			record(
				"FileAccess user:// read",
				content == "migration_test_4.8_beta3",
				"Read back: '%s'" % content
			)
		
		DirAccess.remove_absolute(test_path)

func print_summary() -> void:
	var passed_count := 0
	for result in results:
		var icon := "✅" if result["passed"] else "❌"
		print("%s  %s: %s" % [icon, result["name"], result["detail"]])
		if result["passed"]:
			passed_count += 1
	
	print("\n────────────────────────────────────────────")
	print("Results: %d / %d tests passed" % [passed_count, results.size()])
	
	if passed_count < results.size():
		var failed := results.size() - passed_count
		print("⚠️  %d test(s) failed." % failed)
		print("   Compare output against Godot 4.7.1 stable.")
		print("   File regressions: https://github.com/godotengine/godot/issues")
	else:
		print("✅  All core behaviors match expected values.")
		print("   This does NOT guarantee full compatibility,")
		print("   but it confirms fundamental APIs are stable.")

func get_exit_code() -> int:
	for result in results:
		if not result["passed"]:
			return 1
	return 0

両方のビルドで実行し、出力を diff で比較しましょう:

# In Godot 4.7.1 stable:
godot --headless -s migration_test.gd > results_stable.txt

# In Godot 4.8 beta 3:
godot --headless -s migration_test.gd > results_beta3.txt

# Compare:
diff results_stable.txt results_beta3.txt

diff の pass/fail 結果が同一なら、コアの挙動はアップグレード後も維持されています。差異があれば、API の変更箇所が直接特定できます。


チェックすべき3つの移行の落とし穴

落とし穴1:GDScript のパースと型推論

GDScript のパーサーはマイナーリリースごとに更新されます。4.8 では、次の領域に注意してください:

  • 型付き配列の強制変換 — 最近のバージョンでは Array[int] と PackedByteArray の変換動作が厳格化されています。型付き配列とパックド配列の暗黙的な変換に依存しているコードがあるなら、そのコードパスを明示的にテストしてください。
  • @tool スクリプトの評価順序 — 特定の初期化順序に依存する EditorScript は、評価タイミングが変わると挙動が異なる可能性があります。
  • シグナル接続構文 — signal.connect(callable) パターンは安定していますが、文字列ベースの接続("signal_name")は非推奨であり、警告やエラーが発生する可能性があります。
# Check your project for these patterns:

# AVOID — string-based signal connections (deprecated):
# node.connect("body_entered", self, "_on_body_entered")

# USE — callable-based connections:
node.body_entered.connect(_on_body_entered)

# AVOID — implicit typed array coercion:
var bytes: PackedByteArray = [72, 101, 108]  # May warn in 4.8

# USE — explicit construction:
var bytes: PackedByteArray = PackedByteArray([72, 101, 108])

検出方法: プロジェクト内で以下のパターンを grep してください:

# Find deprecated signal connections
grep -rn '\.connect("' --include="*.gd" .

# Find string-based export hints
grep -rn 'export(' --include="*.gd" .

# Find untyped variables that may trigger new warnings
grep -rn 'var [a-z_]* =' --include="*.gd" . | grep -v ':'

落とし穴2:シーンファイルのメタデータ

4.8 beta 3 のエディタで .tscn ファイルを開くと、シーンは更新されたメタデータとともに再保存されます。load_steps の数、uid の値、[resource] セクションの順序が変わることがあります。通常は無害ですが、git blame を壊し、マージコンフリクトを悪化させます。

beta 3 でシーンを開く前に:

  1. 現在のシーンハッシュをエクスポート: git ls-files '*.tscn' | xargs md5sum > scene_hashes_stable.txt
  2. beta 3 でプロジェクトを開き、いくつかのシーンを閲覧して保存
  3. 再エクスポート: git ls-files '*.tscn' | xargs md5sum > scene_hashes_beta.txt
  4. 比較: diff scene_hashes_stable.txt scene_hashes_beta.txt

メタデータのみが変更された場合(シーンの内容は同じに見えるがファイルは異なる)、安定版に移行するときに何が起こるかがわかります。

落とし穴3:物理シミュレーションのベースライン変動

物理挙動の変更は、最も気づきにくいリグレッションカテゴリです。クラッシュもなければ、エラーも表示されません。キャラクターが2%遅く感じるだけ、または弾道が以前より5ピクセル低くなるだけです。プレイヤーは気づかないかもしれません。QA チームも、注意深くフィールテストをしない限り見逃します。

対策 — 物理リグレッションテストシーン:

extends Node2D

## Physics Regression Test — Godot 4.8 Beta 3
## Attach this to a Node2D in an empty scene.
## Run the scene and compare the printed positions
## against values from your stable build.

func _ready() -> void:
	await get_tree().create_timer(0.1).timeout
	run_gravity_test()
	run_velocity_test()

func run_gravity_test() -> void:
	var body := CharacterBody2D.new()
	var collision := CollisionShape2D.new()
	var shape := RectangleShape2D.new()
	shape.size = Vector2(16, 32)
	collision.shape = shape
	body.add_child(collision)
	add_child(body)
	
	body.position = Vector2(200, 100)
	body.velocity = Vector2.ZERO
	
	# Simulate 1 second of free fall (60 physics frames)
	for i in range(60):
		body.velocity.y += body.get_gravity().y * (1.0 / 60.0)
		body.move_and_slide()
		await get_tree().physics_frame
	
	var fall_distance := body.position.y - 100.0
	print("[Gravity Test] Fell %.2f pixels in 60 frames" % fall_distance)
	print("  Compare against stable build — deviation > 1.0 px = investigate")
	print("  Expected range: 489.0 - 491.0 (default gravity 980 px/s²)")
	
	body.queue_free()

func run_velocity_test() -> void:
	var body := CharacterBody2D.new()
	var collision := CollisionShape2D.new()
	var shape := RectangleShape2D.new()
	shape.size = Vector2(16, 32)
	collision.shape = shape
	body.add_child(collision)
	add_child(body)
	
	body.position = Vector2(50, 300)
	body.velocity = Vector2(300, 0)
	
	# Move horizontally for 2 seconds
	for i in range(120):
		body.velocity = Vector2(300, 0)
		body.move_and_slide()
		await get_tree().physics_frame
	
	var horizontal_distance := body.position.x - 50.0
	print("[Velocity Test] Moved %.2f pixels horizontally in 120 frames" % horizontal_distance)
	print("  Expected: ~600.0 px (300 px/s × 2 seconds)")
	print("  Deviation > 2.0 px = physics engine behavior changed")
	
	body.queue_free()

安定版 4.7.x の出力を記録し、4.8 beta 3 の出力も記録してください。数値が1〜2ピクセル以上異なる場合は、報告する価値のある物理リグレッションです。


エクスポートしたビルドのテスト — 多くの開発者がスキップする部分

エディタでのテストは、スクリプトとシーンの問題を検出します。エクスポートしたビルドには、独自のクラスの問題があります:

プラットフォーム 重点領域 4.x でよくある落とし穴
Windows シェーダーコンパイル、DLL ロード Godot バージョン間でシェーダーキャッシュが無効化される
Linux Vulkan ドライバー互換性 Vulkan 1.3 機能における Mesa ドライバーの差異
Android タッチ入力の遅延、アプリのライフサイクル 新しい Android バージョンで Activity の pause/resume が状態を失う
Web メモリ制限、GDScript パフォーマンス Emscripten コンパイルビルドはメモリ上限がより厳しい
WebXR イマーシブモード遷移 セッション終了時のクリーンアップがデスクトップ XR と異なる場合がある

エクスポート互換性テスト:

# Export your project for each target platform
# Save the export output with the Godot version in the filename

# Windows
godot --headless --export-release "Windows Desktop" build/godot471_win.exe
# Then repeat with beta 3:
godot --headless --export-release "Windows Desktop" build/godot48b3_win.exe

# Android APK
godot --headless --export-release "Android" build/godot471_android.apk
godot --headless --export-release "Android" build/godot48b3_android.apk

各ビルドを実行し、標準的な10分間のゲームプレイループを実行してください。ロード時間、フレームレート、安定版にはなかった視覚的なアーティファクトが表示されないかに注意してください。


修正されるリグレッション報告の書き方

Godot のイシュートラッカーには、リリースごとに数百件の報告が寄せられます。すぐに開発者がアサインされる報告には、共通の構造があります:

## Summary
CharacterBody2D.move_and_slide() produces 3.2% less vertical displacement 
on slopes steeper than 45° compared to Godot 4.7.1 stable.

## Environment
- OS: Windows 11, NVIDIA RTX 3070, driver 551.86
- Godot build: 4.8-beta3 (build hash from Help → Copy Build Info)
- Rendering method: Forward+

## Minimal Reproduction
1. Open attached project
2. Run scene `test_slope_regression.tscn`
3. Observe printed displacement: 456.2 px (expected: 471.3 px)

## Regression Marker
Verified behavior in Godot 4.7.1 stable: displacement is 471.3 px.
Likely introduced between commit [first known good] and [first known bad].

報告を実効的にする重要な要素:

  • 具体的な数値(「遅い気がする」ではなく)
  • Help メニューから取得したビルドハッシュ(単なる「beta 3」ではなく)
  • プロジェクト全体ではなく、問題を再現する単一のシーンファイル
  • 期待値と実際の値を示す安定版との比較
  • レンダリング問題はハードウェア依存のため、GPU とドライバー情報

正確なコミットを特定したい場合は、Godot ソースをクローンして git bisect を使用してください。リグレッションがいつ導入されたかを特定する最も効率的な方法であり、修正が大幅に加速します。


Godot 4.8 移行のベストプラクティス

  1. リポジトリに MIGRATION-4.8.md を置く — 遭遇したすべての API 変更、すべての挙動の差異を、GDScript の行と回避策とともに文書化します。安定版がリリースされたとき、問題を再発見する代わりに、プロジェクト固有の完全な移行ガイドが手元にあります。

  2. セーブ/ロードのラウンドトリップをテストする — ゲームが JSON.stringify() や ResourceSaver.save() でプレイヤーデータをシリアライズしている場合、4.7.x で書き込んだデータが 4.8 beta 3 で正しく読み込めること、その逆も確認してください。シリアライズのフォーマット変更は、プレイヤーの進行状況を静かに破壊する可能性があります。

  3. アドオンの互換性を確認する — Asset Library の GDExtension プラグインや GDScript アドオンを使用している場合、GitHub リポジトリで 4.8 互換性に関するメモを確認してください。多くのアドオンメンテナーは、開発者が要望しない限りベータ版でテストしません。その開発者になりましょう。

  4. CI パイプラインをテストする — プロジェクトに自動ビルドがある場合、CI ランナーの Godot バージョンを 4.8 beta 3 に更新して、パイプライン全体を実行してください。エディタのパスや CLI フラグを参照するビルドスクリプトは、API が変更されると壊れる可能性があります。

  5. レンダリングを個別に検証する — 該当する場合は、--rendering-driver vulkan、--rendering-driver opengl3、--rendering-driver d3d12(Windows)でゲームを実行してください。レンダリングドライバーの挙動は、他のどのサブシステムよりもバージョン間で差異が生じます。


バックエンドスタックをアップグレード後も生き残らせるには

エンジンの移行は、ゲームプレイコードだけに影響するわけではありません。ゲームがプレイヤーデータをリモートに保存している場合(認証トークン、保存済みの進行状況、リーダーボードへの送信など)、クライアントとバックエンド間のシリアライズ形式は一貫している必要があります。

次のシナリオを考えてみましょう: Godot 4.8 で JSON.stringify() が Dictionary 値の浮動小数点精度を処理する方法が変わったとします。クラウドセーブのペイロードが {"x": 100.5} から {"x": 100.499999} に変わります。バックエンドは気にしませんが、クライアント側で競合解決を行っている場合(ローカルとリモートのセーブデータを比較する)、このイプシロン差が誤ったマージコンフリクトを引き起こします。

これが、エンジンの移行時にリビジョン対応セーブシステムが重要である理由です。horizOn は、アカウントに紐づく Cloud Save をリビジョン対応の読み書きで提供し、クライアント側で競合解決を行います。エンジンのシリアライズ挙動がバージョン間で変化する場合、リビジョン対応システムは、等価比較が引き起こす幻のコンフリクトを回避します。


次のステップ

  1. 公式スナップショットから Godot 4.8 beta 3 をダウンロードするか、Web エディタで簡単なスモークテストを試す
  2. テスト用ブランチを作成し、上記の移行テストスクリプトを実行する
  3. 最も複雑なシーンを開いて、見た目と動作が正しいことを確認する
  4. エディタだけでなく、ターゲットプラットフォーム向けにエクスポートしてテストする
  5. Godot GitHub イシュートラッカーに最小再現手順付きでリグレッションを報告する

安定版は、テストするかどうかに関係なくリリースされます。ベータ版で検証した開発者は、初日からリリースできます。そうでない開発者は、ローンチ期間中に本番環境の問題をデバッグすることになります。


出典: 開発スナップショット: Godot 4.8 beta 3