@satelliteoflove/godot-mcp 3.7.1 → 3.9.0

package/addon/command_router.gd

@@ -22,6 +22,7 @@ func setup(plugin: EditorPlugin) -> void:
 	_register_handler(MCPInputCommands.new(), plugin)
 	_register_handler(MCPProfilerCommands.new(), plugin)
 	_register_handler(MCPRuntimeStateCommands.new(), plugin)
+	_register_handler(MCPGameTimeCommands.new(), plugin)
 
 
 func _register_handler(handler: MCPBaseCommand, plugin: EditorPlugin) -> void:

package/addon/command_router.gd.uid

@@ -0,0 +1 @@
+uid://bhjejek8ivdv8

package/addon/commands/animation_commands.gd.uid

@@ -0,0 +1 @@
+uid://dg4xlid3mi2mi

package/addon/commands/debug_commands.gd

@@ -3,6 +3,8 @@ extends MCPBaseCommand
 class_name MCPDebugCommands
 
 const DEBUG_OUTPUT_TIMEOUT := 5.0
+# Keep in sync with LAUNCH_FROZEN_ENV in mcp_game_bridge.gd.
+const LAUNCH_FROZEN_ENV := "GODOT_MCP_LAUNCH_FROZEN"
 
 var _debug_output_result: PackedStringArray = []
 var _debug_output_pending: bool = false
@@ -21,15 +23,32 @@ func get_commands() -> Dictionary:
 
 func run_project(params: Dictionary) -> Dictionary:
 	var scene_path: String = params.get("scene_path", "")
+	var frozen: bool = params.get("frozen", false)
 
 	MCPLogger.clear()
 
+	# Launch-frozen: the spawned game inherits the editor's environment, so
+	# setting this before play makes the bridge freeze the tree in _ready —
+	# before the first process frame. Deterministic, unlike sending a freeze
+	# message after the debug session comes up (which races the game's first
+	# frames against the agent's latency).
+	if frozen:
+		OS.set_environment(LAUNCH_FROZEN_ENV, "1")
+
 	if scene_path.is_empty():
 		EditorInterface.play_main_scene()
 	else:
 		EditorInterface.play_custom_scene(scene_path)
 
-	return _success({})
+	if frozen:
+		# The child captured its environment at spawn; clear promptly so a
+		# manual F5 run doesn't inherit the freeze. Two frames covers a
+		# deferred spawn. (Godot has no unset; empty fails the == "1" check.)
+		await Engine.get_main_loop().process_frame
+		await Engine.get_main_loop().process_frame
+		OS.set_environment(LAUNCH_FROZEN_ENV, "")
+
+	return _success({"frozen": frozen})
 
 
 func stop_project(_params: Dictionary) -> Dictionary:

package/addon/commands/debug_commands.gd.uid

@@ -0,0 +1 @@
+uid://cquyem31g4y4b

package/addon/commands/game_time_commands.gd

@@ -0,0 +1,83 @@
+@tool
+extends MCPBaseCommand
+class_name MCPGameTimeCommands
+
+# Game-time control relay: freeze / step / step_until / thaw / status execute in
+# the game bridge (see mcp_game_bridge.gd); this side only forwards over the
+# debugger channel and waits. Timeout cascade: a step/step_until request is
+# capped at 20s of game time and the bridge's wall budget returns by 25s, so the
+# 28s relay timeout below fires only if the bridge is gone — and stays under the
+# server's 30s command timeout so errors surface typed instead of generic.
+const BASE_TIMEOUT := 10.0
+const STEP_TIMEOUT := 28.0
+
+var _last_error: Dictionary = {}
+
+
+func get_commands() -> Dictionary:
+	return {
+		"game_time_freeze": game_time_freeze,
+		"game_time_step": game_time_step,
+		"game_time_step_until": game_time_step_until,
+		"game_time_thaw": game_time_thaw,
+		"game_time_status": game_time_status,
+	}
+
+
+func game_time_freeze(params: Dictionary) -> Dictionary:
+	return await _relay("game_time_freeze", [params], BASE_TIMEOUT)
+
+
+func game_time_step(params: Dictionary) -> Dictionary:
+	return await _relay("game_time_step", [params], STEP_TIMEOUT)
+
+
+func game_time_step_until(params: Dictionary) -> Dictionary:
+	return await _relay("game_time_step_until", [params], STEP_TIMEOUT)
+
+
+func game_time_thaw(params: Dictionary) -> Dictionary:
+	return await _relay("game_time_thaw", [params], BASE_TIMEOUT)
+
+
+func game_time_status(params: Dictionary) -> Dictionary:
+	return await _relay("game_time_status", [params], BASE_TIMEOUT)
+
+
+func _relay(msg_type: String, args: Array, timeout: float) -> Dictionary:
+	var response = await _send_and_wait(msg_type, args, timeout)
+	if response == null:
+		return _last_error
+	if response is Dictionary and response.has("error"):
+		return _error("GAME_TIME_ERROR", str(response["error"]))
+	if response is Dictionary:
+		return _success(response)
+	return _success({"data": response})
+
+
+func _send_and_wait(msg_type: String, args: Array, timeout: float):
+	if not EditorInterface.is_playing_scene():
+		_last_error = _error("NOT_RUNNING", "No game is currently running")
+		return null
+
+	var debugger_plugin = _plugin.get_debugger_plugin() if _plugin else null
+	if debugger_plugin == null or not debugger_plugin.has_active_session():
+		_last_error = _error("NO_SESSION", "No active debug session")
+		return null
+
+	var sent: bool = debugger_plugin.send_game_message(msg_type, args)
+	if not sent:
+		_last_error = _error("SEND_FAILED", "Failed to send message to game")
+		return null
+
+	var start_time := Time.get_ticks_msec()
+	while not debugger_plugin.has_response(msg_type):
+		await Engine.get_main_loop().process_frame
+		if (Time.get_ticks_msec() - start_time) / 1000.0 > timeout:
+			debugger_plugin.clear_response(msg_type)
+			_last_error = _error("TIMEOUT", "Timed out waiting for %s response" % msg_type)
+			return null
+
+	var response = debugger_plugin.get_response(msg_type)
+	debugger_plugin.clear_response(msg_type)
+	return response

package/addon/commands/game_time_commands.gd.uid

@@ -0,0 +1 @@
+uid://c2pfjqe2yv0c4

package/addon/commands/node_commands.gd.uid

@@ -0,0 +1 @@
+uid://bke2rvqtw381m

package/addon/commands/profiler_commands.gd.uid

@@ -0,0 +1 @@
+uid://c17gnisv1uqju

package/addon/commands/project_commands.gd.uid

@@ -0,0 +1 @@
+uid://es4uegishf00

package/addon/commands/resource_commands.gd.uid

@@ -0,0 +1 @@
+uid://yts2tlf0btx5

package/addon/commands/runtime_state_commands.gd.uid

@@ -0,0 +1 @@
+uid://bns7tsagruukm

package/addon/commands/scene3d_commands.gd.uid

@@ -0,0 +1 @@
+uid://cniw11jpk5y82

package/addon/commands/scene_commands.gd.uid

@@ -0,0 +1 @@
+uid://ngt4k3u88sj3

package/addon/commands/screenshot_commands.gd.uid

@@ -0,0 +1 @@
+uid://c578gd4ovecgt

package/addon/commands/script_commands.gd.uid

@@ -0,0 +1 @@
+uid://b1om27ef4rvws

package/addon/commands/selection_commands.gd.uid

@@ -0,0 +1 @@
+uid://ciy2n67gqdsla

package/addon/commands/tilemap_commands.gd.uid

@@ -0,0 +1 @@
+uid://cietp5vxfv072

package/addon/core/base_command.gd.uid

@@ -0,0 +1 @@
+uid://cwqpmprsn6g2

package/addon/core/mcp_constants.gd.uid

@@ -0,0 +1 @@
+uid://hkoghrp3us8j

package/addon/core/mcp_debugger_plugin.gd.uid

@@ -0,0 +1 @@
+uid://daogurpabpiap

package/addon/core/mcp_enums.gd.uid

@@ -0,0 +1 @@
+uid://b1yx7jiol72rg

package/addon/core/mcp_logger.gd

@@ -34,7 +34,7 @@ func _log_error(function: String, file: String, line: int, code: String,
 	for backtrace in script_backtraces:
 		for i in backtrace.get_frame_count():
 			frames.append({
-				"file": backtrace.get_frame_source(i),
+				"file": backtrace.get_frame_file(i),
 				"line": backtrace.get_frame_line(i),
 				"function": backtrace.get_frame_function(i),
 			})

package/addon/core/mcp_logger.gd.uid

@@ -0,0 +1 @@
+uid://yv8gf1cuf48v

package/addon/core/mcp_utils.gd.uid

@@ -0,0 +1 @@
+uid://dckosaj3snxdo

package/addon/game_bridge/mcp_frame_profiler.gd.uid

@@ -0,0 +1 @@
+uid://cihxpb547p4du