scad-gltf 0.3.3 → 0.5.0

package/README.md

@@ -16,6 +16,7 @@ The C++ source code for this custom OpenSCAD version is included directly in thi
 - **Extended PBR Material Support:** Native extensions to the OpenSCAD `color()` module supporting `metalness`, `roughness`, `transmission` (glass), `thickness`, `ior`, `attenuationColor`, `attenuationDistance`, `clearcoat`, `sheen`, `emissive`, `specular`, and `iridescence`, plus a `$asa` special variable for auto smooth shading.
 - **Hierarchical Node Animation:** Define articulated, rigid-body hierarchies and keyframe animations using `armature()` and `bone()` modules. Exports proper glTF node transform tracks (rigid parenting rather than vertex-weighted skinning—ideal for robots, mechanical parts, vehicles, and articulated components).
 - **Texture Baking:** Automatically generate UVs and bake high-poly details (colors, normals, ORM) onto low-poly meshes using the new `bake()` module.
+- **Scene Lighting:** Spawn precise light sources within your hierarchy (point, directional, spot) using the `light()` module, exporting directly to glTF.
 - **Web Editor & Real-time Viewer (Scadify):** In-browser IDE with live WebAssembly compilation, GPU path tracing, animation timeline scrubbing, video/image export, URL sharing, and `.scad` / `.hdr` drag-and-drop.
 - **LLM Friendly:** Includes a built-in modular prompt generator (`prompt.js` and Web UI) to help AI models (like Gemini, Claude, or ChatGPT) write compatible OpenSCAD scripts utilizing the new features.
 - **Local API Server & Editor:** Bundled `scad-gltf serve` CLI utility to manage local `.scad` files remotely via REST API with automatic `include`/`use` dependency resolution.
@@ -24,6 +25,7 @@ The C++ source code for this custom OpenSCAD version is included directly in thi
 - **AI Studio Extension:** Chrome extension to natively preview, prompt, take chat snapshots, open in Scadify, and locally save AI-generated 3D models directly inside Google AI Studio.
 - **Godot 4, Rust Bevy & Web Integration:** Native Godot 4 importer addon and Rust Bevy compile-time `build.rs` integration.
 - **Automated AI Generation:** Pass an OpenAI-compatible base URL (and optional API key) to the `scad-gltf gen` CLI tool to automatically spawn a local MCP server, query the LLM via standard endpoints, allow it to visually iterate, and output a ready-to-run game project or raw 3D asset script.
+- **Project Runner:** Bundled `scad-gltf play` CLI utility to safely unpack, build, and launch generated game projects in isolated temporary environments.
 
 ---
 
@@ -251,7 +253,7 @@ When asking an LLM (like Gemini) to generate OpenSCAD code, the extension automa
 
 ---
 
-## 🤖 Model Context Protocol (MCP) Server
+## 🤖 Model Context Protocol Server (`scad-gltf mcp`)
 
 This package includes a native [MCP Server](https://modelcontextprotocol.io/) (`scad-gltf mcp`) designed to give AI assistants **visual feedback** during the 3D modeling process.
 
@@ -259,7 +261,7 @@ Instead of generating code blindly, the AI can compile its script, render the 3D
 
 **Exposed MCP Tools:**
 
-- `get_scad_prompt`: Injects the custom OpenSCAD syntax rules (PBR, animations, baking) into the AI's context.
+- `get_project_prompt`: Generates the specialized system prompt and user input request for creating full procedural 3D projects (Godot, Web, Rust, or pure SCAD).
 - `render_scad_model`: Compiles the generated `.scad` code to GLB and returns base64 images from requested camera angles (front, back, left, right, top, bottom, isometric) and specific animation keyframes.
 - `compile_rust_project` / `test_godot_project`: Tests the generated game projects for compilation and runtime errors.
 
@@ -282,27 +284,16 @@ If you installed the package globally, you can configure your MCP client to use
 
 ---
 
-## 🎮 Godot Engine Integration
-
-This repository includes an official **Godot 4.x Importer Addon** located in the [`/godot`](./godot) directory.
-
-The addon allows you to drag-and-drop `.scad` files directly into your Godot project. It uses this WASM compiler under the hood to transform scripts into 3D scenes automatically.
-
-- **Features:** Supports PBR Materials and Hierarchical Node Animations inside the Godot Editor.
-- **License:** The Godot Addon is licensed under **MIT**.
-- **Setup:** Simply copy the `addons/scad_importer` folder to your project and enable it in Project Settings.
-
----
-
-### Automated AI Generation (OpenAI-Compatible API)
+## Automated AI Generation (`scad-gltf gen`)
 
 By default, the `scad-gltf gen` utility copies a heavily engineered system prompt to your clipboard to paste into an LLM. However, if you provide a **Base URL** (and optional **API Key**), the CLI will fully automate this process. It will automatically spin up the `scad-gltf mcp` server in the background, connect it to your LLM, and allow the AI to _visually evaluate and fix_ its code in real-time before saving the final `generate_project.js` script to your disk.
 
 **Supported Generation Types:**
 
-- `gen`: Generate a single raw `.scad` asset file.
+- `scad`: Generate a single raw `.scad` asset file.
 - `godot`: Generate a fully packaged Godot 4 game project containing generated assets and GDScript logic.
 - `bevy`: Generate a Rust Bevy game project.
+- `wgpu`: Generate a Rust wgpu graphics project.
 - `web`: Generate a Vite-based Web3D app (Three.js/Babylon).
 
 **Option 1: Using OpenAI (GPT-4o)**
@@ -340,7 +331,20 @@ You can also pass credentials inline as a JSON string argument instead of modify
 scad-gltf gen godot "A futuristic tank game" '{"openaiBaseUrl": "http://127.0.0.1:8080/v1", "openaiModel": "llama-3"}'
 ```
 
-_Once the automated process completes for full game projects, simply run the generated Node.js script to assemble your complete Godot, Bevy, or Vite project structure with all assets and code!_
+**Providing Existing SCAD Files (`scadFiles`)**
+You can inject your own local `.scad` files into the AI's context using the `scadFiles` JSON option. The AI will embed them into the generated project or use them as a foundation.
+
+```bash
+scad-gltf gen godot "A game using the provided player model" '{"scadFiles": ["./player.scad"]}'
+```
+
+_Once the automated process completes for full game projects, you can test it instantly using the `play` command:_
+
+```bash
+scad-gltf play generate_godot_project.js
+```
+
+_Alternatively, to extract the final project permanently into your current directory, just run the script with Node:_
 
 ```bash
 node generate_godot_project.js
@@ -348,6 +352,18 @@ node generate_godot_project.js
 
 ---
 
+## Testing Generated Projects (`scad-gltf play`)
+
+The `scad-gltf play` utility is designed to quickly test the single-file Node.js scripts produced by the `gen` command. Instead of cluttering your working directory, it unpacks the project into a temporary folder, automatically installs dependencies or builds the project (Godot, Rust Bevy, or Vite), and launches it. Once you close the application, the temporary folder is automatically cleaned up.
+
+**Usage:**
+
+```bash
+scad-gltf play <path_to_generated_script.js>
+```
+
+---
+
 ## Extended OpenSCAD Syntax
 
 This custom fork introduces new syntax not found in standard OpenSCAD.
@@ -440,6 +456,17 @@ bake(uvs=true) {
 }
 ```
 
+### 4. Scene Lighting
+
+Add glTF lights directly into your model hierarchy:
+
+```openscad
+// A spot light pointing down at an angle
+translate([0, 0, 50]) rotate([0, 30, 0])
+  light(type="spot", color=[1, 0.8, 0.8], intensity=5.0, innerConeAngle=15.0, outerConeAngle=30.0)
+    color("gray") cylinder(h=2, r=1, center=true); // A visual representation of the light fixture
+```
+
 ---
 
 ## AI Integration (`prompt.js`)
@@ -463,6 +490,7 @@ const promptContext = generatePrompt(description, {
   iridescence: true, // Thin-film interference
   autoSmoothAngle: true, // $asa rules
   animation: true, // Armature & bone syntax
+  lights: false, // Light rules
   bakeColors: false, // Texture baking flags
   bakeNormals: false,
   bakeOrm: false,
@@ -478,7 +506,7 @@ console.log(promptContext);
 
 Once connected, an AI assistant can use the server to execute the following loop:
 
-1. **Retrieve Syntax Rules:** The assistant calls the `get_scad_prompt` tool to get the extended syntax rules for PBR materials, hierarchical node animations, and texture baking.
+1. **Retrieve Syntax Rules:** The assistant calls the `get_project_prompt` tool to get the extended syntax rules and project structure guidelines.
 2. **Generate Code:** The assistant writes the `.scad` script based on your design request.
 3. **Compile & Visually Inspect:** The assistant calls the `render_scad_model` tool to inspect rendered multi-angle frames and keyframes, fixing any errors before final export.
 

package/bin/gen.js

@@ -14,7 +14,7 @@ async function main() {
       `Usage: scad-gltf gen <${VALID_TYPES.join("|")}> "<description>" [options_json]`,
     );
     console.error(
-      `Example: scad-gltf gen godot "A 3D physics simulation" '{"openaiModel": "gpt-4o"}'`,
+      `Example: scad-gltf gen godot "A 3D physics simulation" '{"openaiModel": "gpt-4o", "scadFiles": ["./player.scad"]}'`,
     );
     process.exit(1);
   }

package/bin/mcp.js

@@ -13,7 +13,9 @@ import {
 import puppeteer from "puppeteer";
 import { convertScadToGltf } from "../src/convert.js";
 import { generatePrompt } from "../src/prompt.js";
+import { getProjectPrompts } from "../src/project-prompts.js";
 import { runGodotAsync } from "../src/godot-utils.js";
+import { generateScadPreviewUrl } from "../src/cli-utils.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -55,15 +57,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
       {
-        name: "get_scad_prompt",
+        name: "get_project_prompt",
         description:
-          "Generates the specialized instruction prompt containing the required syntax rules for PBR, Animations, and Texture Baking in this custom OpenSCAD environment.",
+          "Generates the specialized system prompt and user input request for creating full procedural 3D projects (Godot, Web, Rust, or pure SCAD). This provides the syntax rules and structure required to generate the project.",
         inputSchema: {
           type: "object",
           properties: {
+            project_type: {
+              type: "string",
+              enum: ["scad", "bevy", "wgpu", "web", "godot"],
+              description:
+                "The target framework or output type for the project.",
+            },
             description: {
               type: "string",
-              description: "The description of the object you want to design.",
+              description:
+                "The description of the project or object you want to design.",
             },
             options: {
               type: "object",
@@ -78,17 +87,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 transmission: {
                   type: "boolean",
                   description:
-                    "Include rules for transparent/glass volumes: transmission, thickness, ior, attenuationColor, and attenuationDistance. (Default: true)",
+                    "Include rules for transparent/glass volumes. (Default: false)",
                 },
                 clearcoat: {
                   type: "boolean",
                   description:
-                    "Include rules for clearcoat and clearcoatRoughness. (Default: true)",
+                    "Include rules for clearcoat and clearcoatRoughness. (Default: false)",
                 },
                 sheen: {
                   type: "boolean",
                   description:
-                    "Include rules for cloth/velvet sheen: sheen, sheenColor, and sheenRoughness. (Default: true)",
+                    "Include rules for cloth/velvet sheen. (Default: false)",
                 },
                 emissive: {
                   type: "boolean",
@@ -98,12 +107,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 specular: {
                   type: "boolean",
                   description:
-                    "Include rules for specular reflections: specularColor and specularIntensity. (Default: true)",
+                    "Include rules for specular reflections. (Default: true)",
                 },
                 iridescence: {
                   type: "boolean",
                   description:
-                    "Include rules for thin-film interference: iridescence and iridescenceIOR. (Default: true)",
+                    "Include rules for thin-film interference. (Default: false)",
                 },
                 autoSmoothAngle: {
                   type: "boolean",
@@ -140,21 +149,27 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                   description:
                     "Include rules for the lazy-union compiler optimization. (Default: false)",
                 },
-                modelName: {
+                lights: {
                   type: "boolean",
                   description:
-                    "Include output instructions requiring the '/* Model Name: ... */' header comment. (Default: true)",
+                    "Include rules for adding scene lights. (Default: false)",
+                },
+                scadFiles: {
+                  type: "array",
+                  items: { type: "string" },
+                  description:
+                    "Array of file paths to existing .scad files to embed as context.",
                 },
               },
             },
           },
-          required: ["description"],
+          required: ["project_type", "description"],
         },
       },
       {
         name: "render_scad_model",
         description:
-          "Converts OpenSCAD code to GLTF and uses a 3D renderer to capture images from requested camera angles. Analyze these returned images to verify your design, including specific frames of your animations.",
+          "Converts OpenSCAD code to GLTF and uses a 3D renderer to capture images from requested camera angles. Analyze these returned images to verify your design. The tool response will also include a GitHub-hosted Live Editor Preview URL—you MUST share this URL with the user so they can view the model interactively.",
         inputSchema: {
           type: "object",
           properties: {
@@ -257,23 +272,54 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
 
   // ------------------------------------------
-  // TOOL 1: get_scad_prompt
+  // TOOL 1: get_project_prompt
   // ------------------------------------------
-  if (name === "get_scad_prompt") {
+  if (name === "get_project_prompt") {
     try {
-      const promptText = generatePrompt(args.description, args.options || {});
+      const pType = args.project_type;
+      const desc = args.description;
+      const opts = {
+        transmission: false,
+        clearcoat: false,
+        sheen: false,
+        iridescence: false,
+        ...(args.options || {}),
+      };
+
+      if (!["scad", "bevy", "wgpu", "web", "godot"].includes(pType)) {
+        throw new Error(`Invalid project type: ${pType}`);
+      }
+
+      if (pType !== "scad") {
+        opts.modelName = false;
+      }
+
+      const promptRules = generatePrompt(
+        pType === "scad" ? desc : "the 3D assets for the project",
+        opts,
+      );
+
+      const prompts = getProjectPrompts(pType);
+      const systemPrompt = prompts.buildSystemPrompt(promptRules, opts);
+      const userRequest = prompts.buildInputRequest
+        ? prompts.buildInputRequest(desc, promptRules)
+        : promptRules;
+
       return {
         content: [
           {
             type: "text",
-            text: promptText,
+            text: `=== SYSTEM PROMPT ===\n${systemPrompt}\n\n=== USER REQUEST ===\n${userRequest}`,
           },
         ],
       };
     } catch (error) {
       return {
         content: [
-          { type: "text", text: `Error generating prompt: ${error.message}` },
+          {
+            type: "text",
+            text: `Error generating project prompt: ${error.message}`,
+          },
         ],
         isError: true,
       };
@@ -295,7 +341,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const animIndex = args.animation_index || 0;
       const returnImages = args.return_images !== false;
 
-      // 1. Convert SCAD to GLB ArrayBuffer
+      // 1. Generate the public GitHub Scadify URL
+      const previewUrl =
+        generateScadPreviewUrl(
+          scadCode,
+          "https://iliagrigorevdev.github.io/scad-gltf",
+        ) || "Failed to generate URL";
+
+      // 2. Convert SCAD to GLB ArrayBuffer
       const glbDataArray = await convertScadToGltf(scadCode, {
         wasmUrl: `file://${wasmPath}`,
       });
@@ -305,7 +358,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           content: [
             {
               type: "text",
-              text: `Successfully compiled SCAD without syntax errors. (Visual rendering skipped because return_images is false).`,
+              text: `Successfully compiled SCAD without syntax errors. (Visual rendering skipped because return_images is false).\n\nLive Editor Preview URL: ${previewUrl}`,
             },
           ],
         };
@@ -330,8 +383,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           <script type="importmap">
             {
               "imports": {
-                "three": "https://unpkg.com/three@0.160.0/build/three.module.js",
-                "three/addons/": "https://unpkg.com/three@0.160.0/examples/jsm/"
+                "three": "https://unpkg.com/three@0.186.1/build/three.module.js",
+                "three/addons/": "https://unpkg.com/three@0.186.1/examples/jsm/"
               }
             }
           </script>
@@ -416,6 +469,58 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           const gltf = await loader.loadAsync(dataUrl);
           scene.add(gltf.scene);
 
+          // Detect scene lights to match editor behavior
+          let sceneHasLights = false;
+          let maxDir = 0;
+          let maxPt = 0;
+
+          gltf.scene.traverse((child) => {
+            if (child.isMesh) {
+              child.frustumCulled = false;
+            }
+            if (child.isLight) {
+              sceneHasLights = true;
+              child.castShadow = true;
+              if (child.isDirectionalLight) {
+                maxDir = Math.max(maxDir, child.intensity);
+              } else {
+                maxPt = Math.max(maxPt, child.intensity);
+              }
+            }
+          });
+
+          if (sceneHasLights) {
+            renderer.shadowMap.enabled = true;
+            renderer.shadowMap.type = THREE.PCFSoftShadowMap;
+
+            gltf.scene.traverse((child) => {
+              if (child.isMesh) {
+                child.castShadow = true;
+                child.receiveShadow = true;
+              }
+            });
+
+            let optimalExposure = 1.0;
+            const expDir = maxDir > 0 ? 3.0 / maxDir : 1.0;
+            const expPt = maxPt > 0 ? 3000.0 / maxPt : 1.0;
+
+            if (maxDir > 0 && maxPt > 0)
+              optimalExposure = Math.min(expDir, expPt);
+            else if (maxDir > 0) optimalExposure = expDir;
+            else if (maxPt > 0) optimalExposure = expPt;
+
+            optimalExposure = Math.max(0.00001, Math.min(optimalExposure, 5.0));
+
+            renderer.toneMappingExposure = optimalExposure;
+            scene.environmentIntensity = 0.0;
+
+            ambientLight.visible = false;
+            hemiLight.visible = false;
+            keyLight.visible = false;
+            fillLight.visible = false;
+            rimLight.visible = false;
+          }
+
           // --- Apply Animation State if requested ---
           let appliedAnim = false;
           if (gltf.animations && gltf.animations.length > 0) {
@@ -477,6 +582,35 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             vertices.push(center.x, center.y, center.z);
           }
 
+          // Dynamically scale shadow biases and camera bounds based on actual model size
+          const shadowCamSize = initialDim * 1.5;
+          const shadowScale = initialDim / 10.0;
+
+          if (sceneHasLights) {
+            gltf.scene.traverse((child) => {
+              if (child.isLight && child.shadow) {
+                child.shadow.bias = -0.0005 * shadowScale;
+                child.shadow.normalBias = 0.02 * shadowScale;
+
+                if (child.isDirectionalLight) {
+                  child.shadow.camera.left = -shadowCamSize;
+                  child.shadow.camera.right = shadowCamSize;
+                  child.shadow.camera.top = shadowCamSize;
+                  child.shadow.camera.bottom = -shadowCamSize;
+                  child.shadow.camera.near = Math.max(0.01, initialDim * 0.01);
+                  child.shadow.camera.far = shadowCamSize * 4;
+                  child.shadow.camera.updateProjectionMatrix();
+                  child.shadow.mapSize.width = 2048;
+                  child.shadow.mapSize.height = 2048;
+                } else if (child.isPointLight || child.isSpotLight) {
+                  child.shadow.camera.near = Math.max(0.01, initialDim * 0.01);
+                  child.shadow.camera.far = shadowCamSize * 4;
+                  child.shadow.camera.updateProjectionMatrix();
+                }
+              }
+            });
+          }
+
           const fovY = (camera.fov * Math.PI) / 180;
           const tanY = Math.tan(fovY / 2);
           const tanX = tanY * camera.aspect;
@@ -611,7 +745,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const content = [
         {
           type: "text",
-          text: `Successfully compiled SCAD and rendered ${snapshots.length} camera angle(s)${appliedAnimStr}. Please analyze these visual results to determine your next adjustments.`,
+          text: `Successfully compiled SCAD and rendered ${snapshots.length} camera angle(s)${appliedAnimStr}. Please analyze these visual results to determine your next adjustments.\n\nLive Editor Preview URL: ${previewUrl}`,
         },
       ];
 
@@ -746,16 +880,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const originalProjectGodot = fs.readFileSync(projectGodotPath, "utf8");
       let playResult;
 
+      // 1.5 Prepare MCP Runner Autoload Script (ALWAYS inject to ensure a clean exit)
+      const snapTime = Math.max(0.5, runTime - 0.5);
+
+      let runnerScript = `extends Node\nfunc _ready():\n\tprint("[MCP] Autoload ready. Waiting ${snapTime} seconds...")\n\tawait get_tree().create_timer(${snapTime}).timeout\n`;
+
+      // If returning images, inject the screenshot capture logic
       if (returnImages) {
-        // 1.5 Prepare Screenshot Autoload Script
-        const snapTime = Math.max(0.5, runTime - 0.5);
-
-        const screenshotScript = `extends Node
-func _ready():
-\tprint("[ScreenshotMCP] Autoload ready. Waiting ${snapTime} seconds...")
-\tawait get_tree().create_timer(${snapTime}).timeout
-\tvar ds = DisplayServer.get_name()
-\tprint("[ScreenshotMCP] DisplayServer is: ", ds)
+        runnerScript += `\tvar ds = DisplayServer.get_name()
+\tprint("[MCP] DisplayServer is: ", ds)
 \tif ds != "headless":
 \t\tawait RenderingServer.frame_post_draw
 \t\tvar tex = get_viewport().get_texture()
@@ -770,34 +903,37 @@ func _ready():
 \t\t\t\tvar cropped = img.get_region(Rect2i(x, y, size, size))
 \t\t\t\tvar path = ProjectSettings.globalize_path("res://screenshot_mcp.png")
 \t\t\t\tvar err = cropped.save_png(path)
-\t\t\t\tprint("[ScreenshotMCP] Save PNG to ", path, " returned error code: ", err)
+\t\t\t\tprint("[MCP] Save PNG to ", path, " returned error code: ", err)
 \t\t\telse:
-\t\t\t\tprint("[ScreenshotMCP] Error: Image is null or empty.")
+\t\t\t\tprint("[MCP] Error: Image is null or empty.")
 \t\telse:
-\t\t\tprint("[ScreenshotMCP] Error: Viewport texture is null.")
-\tget_tree().quit()
-`;
-        fs.writeFileSync(
-          path.join(projectDir, "screenshot_mcp.gd"),
-          screenshotScript,
+\t\t\tprint("[MCP] Error: Viewport texture is null.")\n`;
+      }
+
+      // Always force Godot to quit gracefully from the inside
+      runnerScript += `\tget_tree().quit()\n`;
+
+      fs.writeFileSync(path.join(projectDir, "mcp_runner.gd"), runnerScript);
+
+      let tempProjectGodot = originalProjectGodot;
+      if (tempProjectGodot.includes("[autoload]")) {
+        tempProjectGodot = tempProjectGodot.replace(
+          "[autoload]",
+          '[autoload]\nMCPRunner="*res://mcp_runner.gd"',
         );
+      } else {
+        tempProjectGodot += `\n[autoload]\nMCPRunner="*res://mcp_runner.gd"\n`;
+      }
+      fs.writeFileSync(projectGodotPath, tempProjectGodot, "utf8");
 
-        let tempProjectGodot = originalProjectGodot;
-        if (tempProjectGodot.includes("[autoload]")) {
-          tempProjectGodot = tempProjectGodot.replace(
-            "[autoload]",
-            '[autoload]\nScreenshotMCP="*res://screenshot_mcp.gd"',
-          );
-        } else {
-          tempProjectGodot += `\n[autoload]\nScreenshotMCP="*res://screenshot_mcp.gd"\n`;
-        }
-        fs.writeFileSync(projectGodotPath, tempProjectGodot, "utf8");
+      // 2. Run Project Step
+      // Give the Node wrapper a +5000ms buffer so the internal Godot timer always finishes first
+      const safeNodeTimeout = runTime * 1000 + 5000;
 
-        // 2. Run Project Step
-        // Always try windowed first to get the screenshot.
-        // If the environment lacks a display server, we'll catch the error and fallback.
+      if (returnImages) {
+        // Windowed first to get the screenshot
         let playArgs = [
-          "--windowed", // Use windowed instead of headless to ensure rendering works for screenshot
+          "--windowed",
           "--resolution",
           "512x512",
           "--audio-driver",
@@ -806,13 +942,7 @@ func _ready():
           projectDir,
         ];
 
-        playResult = await runGodotAsync(
-          playArgs,
-          projectDir,
-          // Give Godot extra buffer time to boot, take the shot, and quit gracefully
-          runTime * 1000 + 5000,
-        );
-
+        playResult = await runGodotAsync(playArgs, projectDir, safeNodeTimeout);
         let windowedOutput = playResult.output;
 
         // Fallback if windowed mode fails due to display server issues
@@ -824,30 +954,29 @@ func _ready():
           playResult = await runGodotAsync(
             ["--headless", "--audio-driver", "Dummy", "--path", projectDir],
             projectDir,
-            runTime * 1000,
+            safeNodeTimeout,
           );
-          // Explicitly inject the display error into the final output so we aren't flying blind!
           playResult.output =
             "--- WINDOWED LAUNCH FAILED (Display Error) ---\n" +
             windowedOutput.trim() +
             "\n\n--- FALLBACK HEADLESS LAUNCH ---\n" +
             playResult.output;
         }
-
-        // 3. Cleanup Autoloads
-        fs.writeFileSync(projectGodotPath, originalProjectGodot, "utf8");
-        if (fs.existsSync(path.join(projectDir, "screenshot_mcp.gd"))) {
-          fs.unlinkSync(path.join(projectDir, "screenshot_mcp.gd"));
-        }
       } else {
         // Text-only mode: Run headless immediately
         playResult = await runGodotAsync(
           ["--headless", "--audio-driver", "Dummy", "--path", projectDir],
           projectDir,
-          runTime * 1000,
+          safeNodeTimeout,
         );
       }
 
+      // 3. Cleanup Autoloads
+      fs.writeFileSync(projectGodotPath, originalProjectGodot, "utf8");
+      if (fs.existsSync(path.join(projectDir, "mcp_runner.gd"))) {
+        fs.unlinkSync(path.join(projectDir, "mcp_runner.gd"));
+      }
+
       // 4. Read Screenshot
       let screenshotBase64 = null;
       if (returnImages) {

package/editor/dist/assets/{index-B1KAb97r.css → index-D8In1wnN.css}

@@ -1 +1 @@
-*{box-sizing:border-box}body{color:#ddd;background-color:#222;margin:0;font-family:system-ui,sans-serif;overflow:hidden}#app-container{flex-direction:row;width:100vw;height:100vh;display:flex}@media (width<=800px),(orientation:portrait){#app-container{flex-direction:column}}#left-panel{background:#1e1e1e;border-right:1px solid #444;flex-direction:column;flex:1;gap:15px;min-width:0;min-height:50vh;padding:15px;display:flex;overflow-y:auto}@media (width<=800px),(orientation:portrait){#left-panel{border-bottom:1px solid #444;border-right:none}}#right-panel{background:#111;flex:1;min-width:0;min-height:50vh;position:relative}.panel-section{flex-direction:column;gap:8px;display:flex}.flex-grow{flex-grow:1}h2{color:#fff;text-transform:uppercase;letter-spacing:.5px;margin:0;font-size:14px}.help-text{color:#aaa;margin:0 0 5px;font-size:11px}textarea{color:#d4d4d4;resize:vertical;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;width:100%;padding:10px;font-family:monospace;font-size:12px}textarea:focus{border-color:#666}input[type=text],input[type=number],select{color:#d4d4d4;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;align-items:center;height:34px;padding:0 8px;font-size:13px;display:flex}input[type=text]:focus,input[type=number]:focus,select:focus{border-color:#666}#editor{white-space:pre;flex-grow:1;min-height:150px;overflow:auto}button{color:#fff;cursor:pointer;background:#444;border:1px solid #555;border-radius:4px;justify-content:center;align-items:center;height:34px;padding:0 12px;font-size:13px;font-weight:500;transition:background .2s;display:flex}button:hover{background:#555}button.primary{background:#06c;border-color:#05a}button.primary:hover{background:#07e}button.danger{background:#c00;border-color:#a00}button.danger:hover{background:#e00}.controls-row{flex-wrap:wrap;align-items:center;gap:10px;display:flex}.toggles{-webkit-user-select:none;user-select:none;font-size:13px}.scad-prompt-toggles{-webkit-user-select:none;user-select:none;flex-wrap:wrap;gap:8px 12px;margin-bottom:8px;font-size:13px;display:flex}.scad-prompt-toggles label{cursor:pointer;align-items:center;gap:4px;display:flex}.scad-prompt-group{background:#2a2a2a;border:1px solid #444;border-radius:4px;flex-direction:column;gap:8px;margin-bottom:8px;padding:8px;display:flex}.scad-prompt-group-header{color:#eee;border-bottom:1px solid #444;justify-content:space-between;align-items:center;padding-bottom:6px;font-size:13px;font-weight:700;display:flex}.scad-prompt-group-header label{cursor:pointer;align-items:center;gap:4px;font-size:12px;font-weight:400;display:flex}.scad-prompt-toggles.nested{margin-bottom:0}.toggles label{cursor:pointer;align-items:center;gap:4px;display:flex}.toggles label input[type=number]{color:#d4d4d4;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;width:45px;height:24px;padding:2px 4px;font-family:monospace;font-size:12px}input[type=range]{-webkit-appearance:none;background:0 0;flex:1;width:100%;margin:8px 0}input[type=range]:focus{outline:none}input[type=range]::-webkit-slider-runnable-track{cursor:pointer;background:#444;border-radius:3px;width:100%;height:6px}input[type=range]::-webkit-slider-thumb{cursor:pointer;-webkit-appearance:none;background:#06c;border-radius:50%;width:16px;height:16px;margin-top:-5px}#backend-url{flex:1;min-width:0}#backend-ui{flex-direction:column;gap:10px;margin-top:10px;display:none}#backend-ui.active{display:flex}#backend-select{flex:1;min-width:0}#backend-single-save-btn,#backend-delete-btn{flex-shrink:0}#viewer{width:100%;height:100%;overflow:hidden}#viewer canvas{display:block}#viewer-controls{z-index:10;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background:#0009;border-radius:6px;align-items:center;gap:12px;padding:6px 12px;display:flex;position:absolute;top:15px;right:15px}#viewer-controls label{color:#fff;cursor:pointer;-webkit-user-select:none;user-select:none;align-items:center;gap:4px;margin:0;font-size:13px;display:flex}#fullscreen-btn,#screenshot-btn{color:#fff;cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;height:auto;font-size:16px;display:flex}#fullscreen-btn{padding:0 4px}#screenshot-btn{padding:0 4px 5px}#fullscreen-btn:hover,#screenshot-btn:hover{color:#0af;background:0 0}#drag-overlay{color:#fff;z-index:9999;letter-spacing:1px;background:#0066ccd9;justify-content:center;align-items:center;width:100vw;height:100vh;font-size:2rem;font-weight:700;display:none;position:fixed;top:0;left:0}#drag-overlay.active{display:flex}.footer-section{align-items:center;margin-top:auto;padding-top:5px}.source-link{color:#888;font-size:12px;text-decoration:none;transition:color .2s}.source-link:hover{color:#fff}
+*{box-sizing:border-box}body{color:#ddd;background-color:#222;margin:0;font-family:system-ui,sans-serif;overflow:hidden}#app-container{flex-direction:row;width:100vw;height:100vh;display:flex}@media (width<=800px),(orientation:portrait){#app-container{flex-direction:column}}#left-panel{background:#1e1e1e;border-right:1px solid #444;flex-direction:column;flex:1;gap:15px;min-width:0;min-height:50vh;padding:15px;display:flex;overflow-y:auto}@media (width<=800px),(orientation:portrait){#left-panel{border-bottom:1px solid #444;border-right:none}}#right-panel{background:#111;flex:1;min-width:0;min-height:50vh;position:relative}.panel-section{flex-direction:column;gap:8px;display:flex}.flex-grow{flex-grow:1}h2{color:#fff;text-transform:uppercase;letter-spacing:.5px;margin:0;font-size:14px}.help-text{color:#aaa;margin:0 0 5px;font-size:11px}textarea{color:#d4d4d4;resize:vertical;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;width:100%;padding:10px;font-family:monospace;font-size:12px}textarea:focus{border-color:#666}input[type=text],input[type=number],select{color:#d4d4d4;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;align-items:center;height:34px;padding:0 8px;font-size:13px;display:flex}input[type=text]:focus,input[type=number]:focus,select:focus{border-color:#666}#editor{white-space:pre;flex-grow:1;min-height:150px;overflow:auto}button{color:#fff;cursor:pointer;background:#444;border:1px solid #555;border-radius:4px;justify-content:center;align-items:center;height:34px;padding:0 12px;font-size:13px;font-weight:500;transition:background .2s;display:flex}button:hover{background:#555}button.primary{background:#06c;border-color:#05a}button.primary:hover{background:#07e}button.danger{background:#c00;border-color:#a00}button.danger:hover{background:#e00}.controls-row{flex-wrap:wrap;align-items:center;gap:10px;display:flex}.toggles{-webkit-user-select:none;user-select:none;font-size:13px}.scad-prompt-toggles{-webkit-user-select:none;user-select:none;flex-wrap:wrap;gap:8px 12px;margin-bottom:8px;font-size:13px;display:flex}.scad-prompt-toggles label{cursor:pointer;align-items:center;gap:4px;display:flex}.scad-prompt-group{background:#2a2a2a;border:1px solid #444;border-radius:4px;flex-direction:column;gap:8px;margin-bottom:8px;padding:8px;display:flex}.scad-prompt-group-header{color:#eee;border-bottom:1px solid #444;justify-content:space-between;align-items:center;padding-bottom:6px;font-size:13px;font-weight:700;display:flex}.scad-prompt-group-header label{cursor:pointer;align-items:center;gap:4px;font-size:12px;font-weight:400;display:flex}.scad-prompt-toggles.nested{margin-bottom:0}.toggles label{cursor:pointer;align-items:center;gap:4px;display:flex}.toggles label input[type=number]{color:#d4d4d4;background:#2a2a2a;border:1px solid #444;border-radius:4px;outline:none;width:45px;height:24px;padding:2px 4px;font-family:monospace;font-size:12px}input[type=range]{-webkit-appearance:none;background:0 0;flex:1;width:100%;margin:8px 0}input[type=range]:focus{outline:none}input[type=range]::-webkit-slider-runnable-track{cursor:pointer;background:#444;border-radius:3px;width:100%;height:6px}input[type=range]::-webkit-slider-thumb{cursor:pointer;-webkit-appearance:none;background:#06c;border-radius:50%;width:16px;height:16px;margin-top:-5px}#backend-url{flex:1;min-width:0}#backend-ui{flex-direction:column;gap:10px;margin-top:10px;display:none}#backend-ui.active{display:flex}#backend-select{flex:1;min-width:0}#backend-single-save-btn,#backend-delete-btn{flex-shrink:0}#viewer{width:100%;height:100%;overflow:hidden}#viewer canvas{display:block}#viewer-controls{z-index:10;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px);background:#0009;border-radius:6px;flex-wrap:wrap;justify-content:flex-end;align-items:center;gap:12px;max-width:calc(100% - 30px);padding:6px 12px;display:flex;position:absolute;top:15px;right:15px}#viewer-controls select{color:#fff;cursor:pointer;background:#333;border:1px solid #555;border-radius:4px;outline:none;padding:2px 6px;font-size:13px}#viewer-controls label{color:#fff;cursor:pointer;-webkit-user-select:none;user-select:none;align-items:center;gap:4px;margin:0;font-size:13px;display:flex}#fullscreen-btn,#screenshot-btn{color:#fff;cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;height:auto;font-size:16px;display:flex}#fullscreen-btn{padding:0 4px}#screenshot-btn{padding:0 4px 5px}#fullscreen-btn:hover,#screenshot-btn:hover{color:#0af;background:0 0}#drag-overlay{color:#fff;z-index:9999;letter-spacing:1px;background:#0066ccd9;justify-content:center;align-items:center;width:100vw;height:100vh;font-size:2rem;font-weight:700;display:none;position:fixed;top:0;left:0}#drag-overlay.active{display:flex}.footer-section{align-items:center;margin-top:auto;padding-top:5px}.source-link{color:#888;font-size:12px;text-decoration:none;transition:color .2s}.source-link:hover{color:#fff}