gdharness 1.2.18 → 1.2.19

package/build/cli.js

@@ -642,6 +642,36 @@ function resolveSilent(requested, variables) {
   const said = envValue("GDHARNESS_SILENT", variables)?.toLowerCase();
   return said !== undefined && said !== "0" && said !== "false";
 }
+function engineFlags(given) {
+  const offered = Object.keys(ENGINE_FLAGS).join(", ");
+  for (let at = 0;at < given.length; at += 1) {
+    const flag = given[at] ?? "";
+    const takes = Object.hasOwn(ENGINE_FLAGS, flag) ? ENGINE_FLAGS[flag] : undefined;
+    if (takes === undefined) {
+      const setBy = Object.hasOwn(SET_BY_ARGUMENT, flag) ? SET_BY_ARGUMENT[flag] : undefined;
+      return {
+        ok: false,
+        reason: setBy !== undefined ? `${flag} is set by this tool's own argument, ${setBy}, rather than through engineArgs.` : `${flag} is not one of the engine flags engineArgs takes, which are those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${offered}. A value goes as the next entry, as in ["--fixed-fps", "60"].`
+      };
+    }
+    if (takes === "none") {
+      continue;
+    }
+    const value = given[at + 1];
+    const fits = value !== undefined && (takes === "number" ? /^\d+(?:\.\d+)?$/.test(value) : /^\d+x\d+$/.test(value));
+    if (!fits) {
+      return {
+        ok: false,
+        reason: `${flag} takes ${takes === "number" ? "a number" : "a size such as 1280x720"} as the next entry, and ${value === undefined ? "nothing followed it" : `${JSON.stringify(value)} is not one`}.`
+      };
+    }
+    at += 1;
+  }
+  return { ok: true };
+}
+function engineFlagsAmongGameArgs(args) {
+  return args.filter((one) => Object.hasOwn(ENGINE_FLAGS, one) || Object.hasOwn(SET_BY_ARGUMENT, one));
+}
 function runArguments(options) {
   const args = options.headless ? ["--headless", "--path", options.projectPath] : ["--path", options.projectPath];
   if (options.silent === true && !options.headless) {
@@ -650,6 +680,9 @@ function runArguments(options) {
   if (options.quitAfter !== undefined && options.quitAfter !== null) {
     args.push("--quit-after", String(options.quitAfter));
   }
+  if (options.engineArgs !== undefined) {
+    args.push(...options.engineArgs);
+  }
   if (options.scene !== null) {
     args.push(`res://${options.scene}`);
   }
@@ -692,7 +725,35 @@ function environmentFor(options, variables = process.env) {
   const base = options.savesIn === undefined ? { ...variables } : userDataIn(options.savesIn, variables);
   return { ...base, ...options.env, GDHARNESS_RUNTIME_DIR: options.runtimeDirectory };
 }
-var OPENED_BY_A_SERVER = "GDHARNESS_OPENED_BY_A_SERVER", EDITOR_PID_VARIABLE = "GDHARNESS_EDITOR_PID", RESERVED_VARIABLE_PREFIX = "GDHARNESS_", SAVES_NOT_MOVED_NOTE = "On macOS the engine reads user:// off HOME and ignores the variables that move it elsewhere, measured on Godot 4.7.2, so this run wrote its saves where the player keeps theirs. A suite that saves a game has written into the same folder as the copy being played, and one that tidies up after itself may have removed real saves.";
+var ENGINE_FLAGS, SET_BY_ARGUMENT, OPENED_BY_A_SERVER = "GDHARNESS_OPENED_BY_A_SERVER", EDITOR_PID_VARIABLE = "GDHARNESS_EDITOR_PID", RESERVED_VARIABLE_PREFIX = "GDHARNESS_", SAVES_NOT_MOVED_NOTE = "On macOS the engine reads user:// off HOME and ignores the variables that move it elsewhere, measured on Godot 4.7.2, so this run wrote its saves where the player keeps theirs. A suite that saves a game has written into the same folder as the copy being played, and one that tidies up after itself may have removed real saves.";
+var init_launch = __esm(() => {
+  ENGINE_FLAGS = Object.freeze({
+    "--verbose": "none",
+    "--quiet": "none",
+    "--debug-collisions": "none",
+    "--debug-paths": "none",
+    "--debug-navigation": "none",
+    "--debug-avoidance": "none",
+    "--debug-stringnames": "none",
+    "--debug-canvas-item-redraw": "none",
+    "--debug-mute-audio": "none",
+    "--print-fps": "none",
+    "--gpu-profile": "none",
+    "--gpu-validation": "none",
+    "--gpu-abort": "none",
+    "--disable-vsync": "none",
+    "--frame-delay": "number",
+    "--time-scale": "number",
+    "--fixed-fps": "number",
+    "--max-fps": "number",
+    "--resolution": "size"
+  });
+  SET_BY_ARGUMENT = Object.freeze({
+    "--headless": "headless",
+    "--audio-driver": "silent",
+    "--quit-after": "frames, on editor_run check"
+  });
+});
 
 // src/godot-path.ts
 import { execFile as execFile2 } from "node:child_process";
@@ -769,6 +830,7 @@ var run2;
 var init_godot_path = __esm(() => {
   init_detection();
   init_errors();
+  init_launch();
   run2 = promisify2(execFile2);
 });
 
@@ -10840,6 +10902,7 @@ function annotationsOf(spec) {
 }
 var PROJECT_INFO_SECTIONS, PROJECT_PATH, RUNNING_PROJECT_PATH, RUNNING_PID, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
 var init_tool_definitions = __esm(() => {
+  init_launch();
   PROJECT_INFO_SECTIONS = [
     "autoloads",
     "plugins",
@@ -11758,7 +11821,13 @@ var init_tool_definitions = __esm(() => {
           type: "array",
           items: { type: "string" },
           ops: ["start", "check"],
-          description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+          description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here, so a flag the engine reads goes to the game instead, and the answer says so under argsNote. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+        },
+        engineArgs: {
+          type: "array",
+          items: { type: "string" },
+          ops: ["start", "check"],
+          description: `The engine's own flags, before the separator, such as ["--verbose"] or ["--fixed-fps", "60"], a value going as the next entry. Only those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${Object.keys(ENGINE_FLAGS).join(", ")}. Any other is refused, since the engine's command line can also run scripts, open other projects and write files. A run with any is started by this server, as one with args is. A check given --verbose answers with everything printed rather than only errors and warnings, since what verbose adds, the instances leaked at exit among it, is printed as ordinary lines.`
         },
         headless: { type: "boolean", ops: ["start"], description: "start: force a window or no window." },
         visible: {
@@ -34734,6 +34803,7 @@ function runtimeRequest(endpoint, command, params, timeoutMs, keepListening = fa
 var RUNTIME_PROTOCOL = 2, ANNOUNCEMENT_PATTERN, ERROR_REPORT_PATTERN, CONSOLE_BOUNDARY = "[gdharness] runtime listening on ", ERROR_REPORT_KEEP_MS, GONE_WINDOW_MS = 120000, GONE_KEPT = 32, gone, STARTED_AFTER_ANNOUNCING_MS = 2000, CONFIRMED_FOR_MS = 60000, JUDGED_AFTER_MS = 60000, verdicts, judging = null, ENDED_WITHIN_MS = 3000, LOOK_EVERY_MS = 50, ANNOUNCE_BUDGET_MS = 5000, nextRequestId = 1, LATE_ANSWER_MS, LATE_KEPT = 50, lateAnswers;
 var init_runtime_client = __esm(() => {
   init_alive();
+  init_launch();
   init_paths();
   init_process_children();
   ANNOUNCEMENT_PATTERN = /^runtime-(\d+)\.json$/;
@@ -40746,6 +40816,7 @@ var init_lsp_client = __esm(() => {
   init_answer_json();
   init_errors();
   init_framing();
+  init_launch();
   init_paths();
   init_ports();
   LSPTimeout = class LSPTimeout extends Error {
@@ -43618,6 +43689,14 @@ function scanWaitAnswer(scanned, started = "game") {
     scanNote: !scanned.stillScanning ? undefined : started === "game" ? `${still} this game started during the scan and may have read a class cache being rewritten. If ` + 'editor_output shows "Could not find type" for a class that is declared, editor_rescan ' + "waits for the scan to finish, and a start after it reads the finished cache." : `${still} the engine answering this started during the scan and may have read a class cache being ` + "rewritten, and a class cache it wrote can be written over when the scan finishes. If " + 'engine_messages shows "Could not find type" for a class that is declared, editor_rescan waits ' + "for the scan to finish, and the same call after it reads the finished cache."
   };
 }
+function engineFlagsNote(args) {
+  const among = engineFlagsAmongGameArgs(args);
+  if (among.length === 0) {
+    return;
+  }
+  const named = among.join(", ");
+  return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
+}
 function opElsewhere(tool, requested) {
   const ops = Object.hasOwn(OPS_ELSEWHERE, tool) ? OPS_ELSEWHERE[tool] : undefined;
   const where = ops !== undefined && typeof requested === "string" && Object.hasOwn(ops, requested) ? ops[requested] : undefined;
@@ -43999,9 +44078,9 @@ function callersAnswer(totals, asked) {
     note: found.sites.length === 0 ? `No script in the project names ${asked.name} in code, outside its declaration: a call made through a string, such as call("name"), is not found by name.` : found.property ? `${byName} ${PROPERTY_PLACES}` : byName
   };
 }
-function foldedEntriesAnswer(log) {
+function foldedEntriesAnswer(log, floor = "warning") {
   const problems = log.selectFolded({
-    severity: "warning",
+    severity: floor,
     sinceLastCall: false,
     limit: MOST_ENGINE_ENTRIES
   });
@@ -45026,6 +45105,25 @@ class GodotServer {
     }
     return { ok: true, value: given };
   }
+  engineArguments(args) {
+    if (args["engineArgs"] === undefined) {
+      return { ok: true, value: [] };
+    }
+    const given = readStringArray(args, "engineArgs");
+    if (given === undefined) {
+      return {
+        ok: false,
+        response: this.createErrorResponse("engineArgs must be a list of strings.", [
+          'Pass engine flags, such as ["--verbose"] or ["--fixed-fps", "60"]'
+        ])
+      };
+    }
+    const checked = engineFlags(given);
+    if (!checked.ok) {
+      return { ok: false, response: this.createErrorResponse(checked.reason) };
+    }
+    return { ok: true, value: given };
+  }
   runEnvironment(args) {
     const savesIn = readNonEmptyString(args, "savesIn");
     if (savesIn !== undefined && !isAbsolute3(savesIn)) {
@@ -46842,6 +46940,10 @@ class GodotServer {
     if (!given.ok) {
       return given.response;
     }
+    const flags = this.engineArguments(args);
+    if (!flags.ok) {
+      return flags.response;
+    }
     const asked = this.runEnvironment(args);
     if (!asked.ok) {
       return asked.response;
@@ -46863,7 +46965,7 @@ class GodotServer {
     }
     const sceneArgument = sceneToRun?.ok ? sceneToRun.relativePath : null;
     if (op === "check") {
-      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value);
+      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value, flags.value);
     }
     await this.pickUpWhatTheEditorIsPlaying();
     let ended = null;
@@ -46890,7 +46992,7 @@ class GodotServer {
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
-    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
+    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && flags.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
       return await this.playThroughEditor(sceneArgument, refreshed.value, scanned, project.value.path, alreadyPlaying, runtimeWaitMs, ended, profiled);
     }
     const cmdArgs = runArguments({
@@ -46898,6 +47000,7 @@ class GodotServer {
       headless,
       scene: sceneArgument,
       userArgs: given.value,
+      engineArgs: flags.value,
       silent
     });
     this.logDebug(`Running Godot project: ${engine.value} ${cmdArgs.join(" ")}`);
@@ -46910,7 +47013,7 @@ class GodotServer {
     started.announcedBefore = alreadyPlaying;
     started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
-    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
+    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && (given.value.length > 0 || flags.value.length > 0) ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
     const stranded = wereHereFirst.filter((one) => one.pid !== ended?.pid && alive(one.pid));
     const alsoRunning = leftRunningNote(stranded);
@@ -46920,6 +47023,7 @@ class GodotServer {
       alsoRunning: stranded.length === 0 ? undefined : stranded.map((one) => one.pid),
       pid: started.pid,
       arguments: cmdArgs,
+      argsNote: engineFlagsNote(given.value),
       transcript: started.transcript,
       profile: profileOnStart(profiled, "gdharness", runtimeAddonRegistered(project.value.path)),
       refreshedClasses: refreshed.value,
@@ -47822,10 +47926,17 @@ class GodotServer {
   async currentRun() {
     return this.activeProcess ?? await this.adoptRecordedRun();
   }
-  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}) {
+  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}, engineArgs = []) {
     const frames = readPositiveNumber(args, "frames") ?? 3;
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 60000;
-    const cmdArgs = runArguments({ projectPath, headless: true, scene, quitAfter: frames, userArgs });
+    const cmdArgs = runArguments({
+      projectPath,
+      headless: true,
+      scene,
+      quitAfter: frames,
+      userArgs,
+      engineArgs
+    });
     const boot = this.spawnGame(godotPath, cmdArgs, needsItsOwnProcess(asked) ? environmentFor({ ...asked, runtimeDirectory: runtimeDirectory() }) : undefined);
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -47853,9 +47964,10 @@ class GodotServer {
       frames,
       errors,
       warnings,
+      argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log)
+      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
     });
   }
   async handleRunProfile(args) {
@@ -49261,6 +49373,7 @@ var init_server = __esm(() => {
   init_issues();
   init_junit();
   init_keeper_channel();
+  init_launch();
   init_lsp_client();
   init_outside();
   init_paths();

package/build/index.js

@@ -24913,6 +24913,62 @@ function resolveSilent(requested, variables) {
   const said = envValue("GDHARNESS_SILENT", variables)?.toLowerCase();
   return said !== undefined && said !== "0" && said !== "false";
 }
+var ENGINE_FLAGS = Object.freeze({
+  "--verbose": "none",
+  "--quiet": "none",
+  "--debug-collisions": "none",
+  "--debug-paths": "none",
+  "--debug-navigation": "none",
+  "--debug-avoidance": "none",
+  "--debug-stringnames": "none",
+  "--debug-canvas-item-redraw": "none",
+  "--debug-mute-audio": "none",
+  "--print-fps": "none",
+  "--gpu-profile": "none",
+  "--gpu-validation": "none",
+  "--gpu-abort": "none",
+  "--disable-vsync": "none",
+  "--frame-delay": "number",
+  "--time-scale": "number",
+  "--fixed-fps": "number",
+  "--max-fps": "number",
+  "--resolution": "size"
+});
+var SET_BY_ARGUMENT = Object.freeze({
+  "--headless": "headless",
+  "--audio-driver": "silent",
+  "--quit-after": "frames, on editor_run check"
+});
+function engineFlags(given) {
+  const offered = Object.keys(ENGINE_FLAGS).join(", ");
+  for (let at = 0;at < given.length; at += 1) {
+    const flag = given[at] ?? "";
+    const takes = Object.hasOwn(ENGINE_FLAGS, flag) ? ENGINE_FLAGS[flag] : undefined;
+    if (takes === undefined) {
+      const setBy = Object.hasOwn(SET_BY_ARGUMENT, flag) ? SET_BY_ARGUMENT[flag] : undefined;
+      return {
+        ok: false,
+        reason: setBy !== undefined ? `${flag} is set by this tool's own argument, ${setBy}, rather than through engineArgs.` : `${flag} is not one of the engine flags engineArgs takes, which are those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${offered}. A value goes as the next entry, as in ["--fixed-fps", "60"].`
+      };
+    }
+    if (takes === "none") {
+      continue;
+    }
+    const value = given[at + 1];
+    const fits = value !== undefined && (takes === "number" ? /^\d+(?:\.\d+)?$/.test(value) : /^\d+x\d+$/.test(value));
+    if (!fits) {
+      return {
+        ok: false,
+        reason: `${flag} takes ${takes === "number" ? "a number" : "a size such as 1280x720"} as the next entry, and ${value === undefined ? "nothing followed it" : `${JSON.stringify(value)} is not one`}.`
+      };
+    }
+    at += 1;
+  }
+  return { ok: true };
+}
+function engineFlagsAmongGameArgs(args) {
+  return args.filter((one) => Object.hasOwn(ENGINE_FLAGS, one) || Object.hasOwn(SET_BY_ARGUMENT, one));
+}
 function runArguments(options) {
   const args = options.headless ? ["--headless", "--path", options.projectPath] : ["--path", options.projectPath];
   if (options.silent === true && !options.headless) {
@@ -24921,6 +24977,9 @@ function runArguments(options) {
   if (options.quitAfter !== undefined && options.quitAfter !== null) {
     args.push("--quit-after", String(options.quitAfter));
   }
+  if (options.engineArgs !== undefined) {
+    args.push(...options.engineArgs);
+  }
   if (options.scene !== null) {
     args.push(`res://${options.scene}`);
   }
@@ -34767,7 +34826,13 @@ var TOOL_SPECS = [
         type: "array",
         items: { type: "string" },
         ops: ["start", "check"],
-        description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+        description: `The game's own arguments, what OS.get_cmdline_user_args() answers, such as ["--level=2"]. The separator is added here, so a flag the engine reads goes to the game instead, and the answer says so under argsNote. A run with any is started by this server rather than by the editor, which fixes the game's command line when it opens the project, so the debug_* tools do not answer for it.`
+      },
+      engineArgs: {
+        type: "array",
+        items: { type: "string" },
+        ops: ["start", "check"],
+        description: `The engine's own flags, before the separator, such as ["--verbose"] or ["--fixed-fps", "60"], a value going as the next entry. Only those that change what the engine logs, draws for debugging, checks on the GPU or how it times frames: ${Object.keys(ENGINE_FLAGS).join(", ")}. Any other is refused, since the engine's command line can also run scripts, open other projects and write files. A run with any is started by this server, as one with args is. A check given --verbose answers with everything printed rather than only errors and warnings, since what verbose adds, the instances leaked at exit among it, is printed as ordinary lines.`
       },
       headless: { type: "boolean", ops: ["start"], description: "start: force a window or no window." },
       visible: {
@@ -36317,6 +36382,14 @@ var PLAYING_STATUS_MS = 1000;
 var SCAN_START_MS = 2000;
 var SCAN_SETTLED_MS = 500;
 var REIMPORT_TIMEOUT_MS = 300000;
+function engineFlagsNote(args) {
+  const among = engineFlagsAmongGameArgs(args);
+  if (among.length === 0) {
+    return;
+  }
+  const named = among.join(", ");
+  return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
+}
 var OPS_ELSEWHERE = {
   runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
 };
@@ -36747,9 +36820,9 @@ function callersAnswer(totals, asked) {
   };
 }
 var MOST_ENGINE_ENTRIES = 200;
-function foldedEntriesAnswer(log) {
+function foldedEntriesAnswer(log, floor = "warning") {
   const problems = log.selectFolded({
-    severity: "warning",
+    severity: floor,
     sinceLastCall: false,
     limit: MOST_ENGINE_ENTRIES
   });
@@ -37777,6 +37850,25 @@ class GodotServer {
     }
     return { ok: true, value: given };
   }
+  engineArguments(args) {
+    if (args["engineArgs"] === undefined) {
+      return { ok: true, value: [] };
+    }
+    const given = readStringArray(args, "engineArgs");
+    if (given === undefined) {
+      return {
+        ok: false,
+        response: this.createErrorResponse("engineArgs must be a list of strings.", [
+          'Pass engine flags, such as ["--verbose"] or ["--fixed-fps", "60"]'
+        ])
+      };
+    }
+    const checked = engineFlags(given);
+    if (!checked.ok) {
+      return { ok: false, response: this.createErrorResponse(checked.reason) };
+    }
+    return { ok: true, value: given };
+  }
   runEnvironment(args) {
     const savesIn = readNonEmptyString(args, "savesIn");
     if (savesIn !== undefined && !isAbsolute3(savesIn)) {
@@ -39593,6 +39685,10 @@ class GodotServer {
     if (!given.ok) {
       return given.response;
     }
+    const flags = this.engineArguments(args);
+    if (!flags.ok) {
+      return flags.response;
+    }
     const asked = this.runEnvironment(args);
     if (!asked.ok) {
       return asked.response;
@@ -39614,7 +39710,7 @@ class GodotServer {
     }
     const sceneArgument = sceneToRun?.ok ? sceneToRun.relativePath : null;
     if (op === "check") {
-      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value);
+      return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value, scanned, asked.value, flags.value);
     }
     await this.pickUpWhatTheEditorIsPlaying();
     let ended = null;
@@ -39641,7 +39737,7 @@ class GodotServer {
     const editorWouldPlay = !headless || editorPlaysHeadless(project.value.file);
     const silent = resolveSilent(args["silent"], process.env) && !headless;
     const profiled = readBoolean(args, "profile") === true;
-    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
+    if (this.godotBridge.isConnected() && editorWouldPlay && given.value.length === 0 && flags.value.length === 0 && !needsItsOwnProcess(asked.value) && !silent) {
       return await this.playThroughEditor(sceneArgument, refreshed.value, scanned, project.value.path, alreadyPlaying, runtimeWaitMs, ended, profiled);
     }
     const cmdArgs = runArguments({
@@ -39649,6 +39745,7 @@ class GodotServer {
       headless,
       scene: sceneArgument,
       userArgs: given.value,
+      engineArgs: flags.value,
       silent
     });
     this.logDebug(`Running Godot project: ${engine.value} ${cmdArgs.join(" ")}`);
@@ -39661,7 +39758,7 @@ class GodotServer {
     started.announcedBefore = alreadyPlaying;
     started.bootScene = runtimeWaitMs.scene;
     this.activeProcess = started;
-    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
+    const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && (given.value.length > 0 || flags.value.length > 0) ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && needsItsOwnProcess(asked.value) ? " The editor plays a game with its own environment, so a run given one was started " + "here: the debug_* tools answer only for a game the editor is playing." : this.godotBridge.isConnected() && editorWouldPlay && silent ? " The editor cannot play a game silent, which takes an engine flag, so this one was " + `started here${args["silent"] === true ? "" : ", silent because GDHARNESS_SILENT says so"}: the debug_* tools answer only for a game the editor is playing, and silent: false plays it through the editor.` : "";
     const endedForThis = endedToStartThis(ended);
     const stranded = wereHereFirst.filter((one) => one.pid !== ended?.pid && alive(one.pid));
     const alsoRunning = leftRunningNote(stranded);
@@ -39671,6 +39768,7 @@ class GodotServer {
       alsoRunning: stranded.length === 0 ? undefined : stranded.map((one) => one.pid),
       pid: started.pid,
       arguments: cmdArgs,
+      argsNote: engineFlagsNote(given.value),
       transcript: started.transcript,
       profile: profileOnStart(profiled, "gdharness", runtimeAddonRegistered(project.value.path)),
       refreshedClasses: refreshed.value,
@@ -40573,10 +40671,17 @@ class GodotServer {
   async currentRun() {
     return this.activeProcess ?? await this.adoptRecordedRun();
   }
-  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}) {
+  async checkBoot(godotPath, projectPath, scene, args, userArgs, scanned, asked = {}, engineArgs = []) {
     const frames = readPositiveNumber(args, "frames") ?? 3;
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 60000;
-    const cmdArgs = runArguments({ projectPath, headless: true, scene, quitAfter: frames, userArgs });
+    const cmdArgs = runArguments({
+      projectPath,
+      headless: true,
+      scene,
+      quitAfter: frames,
+      userArgs,
+      engineArgs
+    });
     const boot = this.spawnGame(godotPath, cmdArgs, needsItsOwnProcess(asked) ? environmentFor({ ...asked, runtimeDirectory: runtimeDirectory() }) : undefined);
     const hung = await new Promise((resolve) => {
       const timer = setTimeout(() => {
@@ -40604,9 +40709,10 @@ class GodotServer {
       frames,
       errors,
       warnings,
+      argsNote: engineFlagsNote(userArgs),
       ...scanWaitAnswer(scanned),
       savesNote: asked.savesIn !== undefined && savesStayPut() ? SAVES_NOT_MOVED_NOTE : undefined,
-      ...foldedEntriesAnswer(boot.log)
+      ...foldedEntriesAnswer(boot.log, engineArgs.includes("--verbose") ? "info" : "warning")
     });
   }
   async handleRunProfile(args) {

package/build/keeper.js

@@ -364,6 +364,32 @@ function envValue(name, variables = process.env) {
   const value = variables[name];
   return value === undefined || value === "" ? undefined : value;
 }
+var ENGINE_FLAGS = Object.freeze({
+  "--verbose": "none",
+  "--quiet": "none",
+  "--debug-collisions": "none",
+  "--debug-paths": "none",
+  "--debug-navigation": "none",
+  "--debug-avoidance": "none",
+  "--debug-stringnames": "none",
+  "--debug-canvas-item-redraw": "none",
+  "--debug-mute-audio": "none",
+  "--print-fps": "none",
+  "--gpu-profile": "none",
+  "--gpu-validation": "none",
+  "--gpu-abort": "none",
+  "--disable-vsync": "none",
+  "--frame-delay": "number",
+  "--time-scale": "number",
+  "--fixed-fps": "number",
+  "--max-fps": "number",
+  "--resolution": "size"
+});
+var SET_BY_ARGUMENT = Object.freeze({
+  "--headless": "headless",
+  "--audio-driver": "silent",
+  "--quit-after": "frames, on editor_run check"
+});
 
 // src/runtime-client.ts
 function runtimeDirectory(variables = process.env) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "1.2.18",
+  "version": "1.2.19",
   "mcpName": "io.github.Aureliolo/gdharness",
   "description": "A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.",
   "type": "module",