Zwei Instanzen im Gleichschritt

Ein Test startet einen zweiten Godot-Prozess als Gast. Der Gast tritt
über das Netzwerk bei und schlägt Stein, beide Welten enden im selben
Zustand, ohne Abgleich unterwegs. Damit ist die Prüffrage von
Meilenstein 1 Teil der automatischen Prüfungen.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

game/tools/guest_bot.gd

@@ -0,0 +1,59 @@
+extends SceneTree
+## A second instance of the game for the test of two instances. It starts the
+## real main scene as a guest, hits the rock beside the spawn clearing until
+## it has a stone, follows the host until the host stops at a tick, and
+## writes what its world looks like then as JSON.
+##
+## The test of two instances starts it; by hand:
+##   godot --headless --path game -s res://tools/guest_bot.gd -- --join=ADDRESS
+##     --storage=FOLDER --until=TICK --out=FILE
+
+## Milliseconds the bot waits for everything before it gives up.
+const PATIENCE_MSEC := 20000
+
+
+func _initialize() -> void:
+	_run.call_deferred()
+
+
+func _run() -> void:
+	var settings := {}
+	for argument in OS.get_cmdline_user_args():
+		settings[argument.get_slice("=", 0)] = argument.get_slice("=", 1)
+	var until := int(settings.get("--until", "0"))
+	var report := {"error": "the host did not answer"}
+
+	var main: Node = load("res://main.tscn").instantiate()
+	main.storage_dir = settings.get("--storage", "user://bot")
+	main.command_line = PackedStringArray(["--join=" + settings.get("--join", ""), "--name=Bot"])
+	root.add_child(main)
+
+	var started := Time.get_ticks_msec()
+	while Time.get_ticks_msec() - started < PATIENCE_MSEC:
+		await process_frame
+		var session: GwSession = main.session
+		if session == null:
+			report = {"error": "the session ended: %s" % main.menu.status()}
+			break
+		if session.local_player() < 0:
+			continue
+		var rock := session.spawn_point() + Vector2i(7, -2)
+		if session.item_count(GwSession.ITEM_STONE) == 0:
+			main.dig_at(rock)
+		if session.tick() == until and session.pending_ticks() == 0:
+			report = {
+				"tick": session.tick(),
+				"hash": session.state_hash_hex(),
+				"player": session.local_player(),
+				"stones": session.item_count(GwSession.ITEM_STONE),
+				"resyncs": main.resyncs,
+			}
+			break
+
+	var file := FileAccess.open(settings.get("--out", "user://bot.json"), FileAccess.WRITE)
+	file.store_string(JSON.stringify(report))
+	file.close()
+	main.notification(Node.NOTIFICATION_WM_CLOSE_REQUEST)
+	root.remove_child(main)
+	main.free()
+	quit(0 if not report.has("error") else 1)