@chrrxs/robloxstudio-mcp-inspector 3.0.0 → 3.0.1

package/dist/index.js

@@ -774,7 +774,6 @@ Tool descriptions explain selection. Input schemas explain arguments. This guide
 - Use canonical DataModel paths returned by the tools. Paths usually start with game.
 - Call get_connected_instances when more than one place may be connected. Pass the chosen row's id as instance_id on later calls.
 - Use get_place_info for the active place identity and settings.
-- Use get_selection only when the user's current Studio selection should set the scope.
 
 ## Discovery and edit work
 
@@ -783,6 +782,13 @@ Tool descriptions explain selection. Input schemas explain arguments. This guide
 - Use execute_luau for custom traversal, bulk edits, and work that would otherwise need many tool calls. It runs through the Studio plugin context.
 - Use set_properties when several known properties on one instance can be updated in one request.
 
+## Selection and viewport
+
+- Use selection with action=get when the user's Studio selection should define the scope.
+- Use action=set with instance paths to replace, add to, or remove from the selection. An empty paths array in set mode clears it.
+- Use action=view with a BasePart or Model path to frame it. The current viewing direction is preserved unless from or angleY overrides it. padding below 1 crops closer and above 1 pulls back.
+- For visual proof, change the instance, frame it with selection, then call capture_screenshot.
+
 ## Script changes
 
 - Read the relevant source with get_script_source before changing it.
@@ -1479,6 +1485,14 @@ function parseStudioProcessEnvironmentPatch(value) {
   }
   return { set, remove };
 }
+function parseStudioWorkingDirectory(value) {
+  if (value === void 0)
+    return void 0;
+  if (typeof value !== "string" || value.trim().length === 0 || value.includes("\0")) {
+    throw new Error("studio_working_directory must be a non-empty string without null characters.");
+  }
+  return value;
+}
 function patchedProcessEnvironment(patch) {
   const environment = { ...process.env };
   for (const name of patch.remove ?? [])
@@ -1514,7 +1528,7 @@ function quoteWindowsCommandLineArg(value) {
   }
   return `${quoted}${"\\".repeat(backslashes * 2)}"`;
 }
-function buildWindowsStudioStartScriptFromConvertedExe(windowsExe, args, processEnvironment) {
+function buildWindowsStudioStartScriptFromConvertedExe(windowsExe, args, processEnvironment, windowsWorkingDirectory) {
   const environmentPatch = parseStudioProcessEnvironmentPatch(processEnvironment);
   const commandLine = [windowsExe, ...args].map(quoteWindowsCommandLineArg).join(" ");
   return [
@@ -1714,7 +1728,7 @@ public sealed class McpSuspendedStudio : IDisposable
             throw new InvalidOperationException("Unexpected Studio process wait result: " + wait);
     }
 
-    public static McpSuspendedStudio Start(string application, string commandLine)
+    public static McpSuspendedStudio Start(string application, string commandLine, string currentDirectory)
     {
         IntPtr jobHandle = CreateJobObjectW(IntPtr.Zero, null);
         if (jobHandle == IntPtr.Zero)
@@ -1726,9 +1740,9 @@ public sealed class McpSuspendedStudio : IDisposable
             startup.cb = Marshal.SizeOf(startup);
             ProcessInformation created;
             uint flags = CREATE_SUSPENDED | CREATE_BREAKAWAY_FROM_JOB;
-            bool started = CreateProcessW(application, new StringBuilder(commandLine), IntPtr.Zero, IntPtr.Zero, false, flags, IntPtr.Zero, null, ref startup, out created);
+            bool started = CreateProcessW(application, new StringBuilder(commandLine), IntPtr.Zero, IntPtr.Zero, false, flags, IntPtr.Zero, currentDirectory, ref startup, out created);
             if (!started && Marshal.GetLastWin32Error() == 5)
-                started = CreateProcessW(application, new StringBuilder(commandLine), IntPtr.Zero, IntPtr.Zero, false, CREATE_SUSPENDED, IntPtr.Zero, null, ref startup, out created);
+                started = CreateProcessW(application, new StringBuilder(commandLine), IntPtr.Zero, IntPtr.Zero, false, CREATE_SUSPENDED, IntPtr.Zero, currentDirectory, ref startup, out created);
             if (!started)
                 throw new Win32Exception(Marshal.GetLastWin32Error(), "CreateProcessW failed");
             try
@@ -1805,7 +1819,7 @@ public sealed class McpSuspendedStudio : IDisposable
     }
 }
 '@`,
-    `$launch = [McpSuspendedStudio]::Start(${powershellStringLiteral(windowsExe)}, ${powershellStringLiteral(commandLine)})`,
+    `$launch = [McpSuspendedStudio]::Start(${powershellStringLiteral(windowsExe)}, ${powershellStringLiteral(commandLine)}, ${windowsWorkingDirectory === void 0 ? "$null" : powershellStringLiteral(windowsWorkingDirectory)})`,
     "try {",
     "[Console]::Out.WriteLine((ConvertTo-Json @{ pid = $launch.ProcessId; started = [string]$launch.StartedAtFileTime } -Compress)); [Console]::Out.Flush()",
     "$accepted = $false",
@@ -1847,9 +1861,10 @@ function buildWindowsStudioStopScript(processId, startedAt) {
 async function stopWindowsStudio(processId, startedAt) {
   await powershellAsync(buildWindowsStudioStopScript(processId, startedAt));
 }
-async function spawnWindowsStudio(exe, args, processEnvironment) {
+async function spawnWindowsStudio(exe, args, processEnvironment, studioWorkingDirectory) {
   const windowsExe = await toStudioLaunchArgAsync(exe);
-  const script = buildWindowsStudioStartScriptFromConvertedExe(windowsExe, args, processEnvironment);
+  const windowsWorkingDirectory = studioWorkingDirectory ? await toStudioLaunchArgAsync(studioWorkingDirectory) : void 0;
+  const script = buildWindowsStudioStartScriptFromConvertedExe(windowsExe, args, processEnvironment, windowsWorkingDirectory);
   const launcher = spawn("powershell.exe", ["-NoProfile", "-Command", script], {
     cwd: isWsl() && existsSync2("/mnt/c/Windows") ? "/mnt/c/Windows" : process.cwd(),
     stdio: ["pipe", "pipe", "pipe"],
@@ -2548,6 +2563,7 @@ var init_studio_instance_manager = __esm({
         const initialSnapshot = await this.getProcessSnapshot(true);
         await this.sweepRegistry(initialSnapshot);
         const processEnvironment = parseStudioProcessEnvironmentPatch(options.processEnvironment);
+        const studioWorkingDirectory = parseStudioWorkingDirectory(options.studioWorkingDirectory);
         if (options.studioExecutable !== void 0 && (typeof options.studioExecutable !== "string" || options.studioExecutable.length === 0 || options.studioExecutable.includes("\0"))) {
           throw new Error("studio_executable must be a non-empty string without null characters.");
         }
@@ -2561,7 +2577,7 @@ var init_studio_instance_manager = __esm({
         const exe = preparedOptions.studioExecutable ?? (this.processAdapter.resolveStudioExe ? await this.processAdapter.resolveStudioExe() : await resolveStudioExeAsync());
         const args = await Promise.all(buildStudioLaunchArgs(preparedOptions).map(toStudioLaunchArgAsync));
         const spawnOptions = {
-          cwd: isWsl() && existsSync2("/mnt/c/Windows") ? "/mnt/c/Windows" : process.cwd(),
+          cwd: studioWorkingDirectory ?? (isWsl() && existsSync2("/mnt/c/Windows") ? "/mnt/c/Windows" : process.cwd()),
           detached: true,
           stdio: "ignore",
           ...processEnvironment ? { env: patchedProcessEnvironment(processEnvironment) } : {}
@@ -2571,7 +2587,7 @@ var init_studio_instance_manager = __esm({
           if (this.processAdapter.spawnStudio) {
             proc = await this.processAdapter.spawnStudio(exe, args, spawnOptions);
           } else if (lifecycleCapabilities.processIdentity.launcher === "windows-retained" || lifecycleCapabilities.processIdentity.launcher === "wsl-windows-retained") {
-            proc = await this.windowsStudioLauncher(exe, args, processEnvironment);
+            proc = await this.windowsStudioLauncher(exe, args, processEnvironment, studioWorkingDirectory);
           } else {
             const child = spawn(exe, args, spawnOptions);
             proc = {
@@ -2634,6 +2650,7 @@ var init_studio_instance_manager = __esm({
           universeId: preparedOptions.universeId,
           placeVersion: preparedOptions.placeVersion,
           localPlaceFile: preparedOptions.localPlaceFile,
+          studioWorkingDirectory,
           launchedAt,
           connectionDeadlineAt: options.requireProcessIdentity ? void 0 : launchedAt + (options.connectionTimeoutMs ?? 12e4),
           state: "launching",
@@ -3215,6 +3232,7 @@ var init_studio_instance_manager = __esm({
           placeVersion: record.placeVersion,
           localPlaceFile: record.localPlaceFile,
           deleteLocalPlaceFileOnClose: record.deleteLocalPlaceFileOnClose,
+          studioWorkingDirectory: record.studioWorkingDirectory,
           launchedAt: record.launchedAt,
           attachedAt: record.connectedAt,
           connectionDeadlineAt: record.connectionDeadlineAt,
@@ -3250,6 +3268,7 @@ var init_studio_instance_manager = __esm({
           universeId: record.universeId,
           placeVersion: record.placeVersion,
           localPlaceFile: record.localPlaceFile,
+          studioWorkingDirectory: record.studioWorkingDirectory,
           launchedAt: record.launchedAt,
           connectionDeadlineAt: record.connectionDeadlineAt ?? (state === "launching" && record.processAuthorizationState === void 0 ? record.launchedAt + 12e4 : void 0),
           state,
@@ -3420,6 +3439,9 @@ function serverInstructions(definitions) {
   if (has("capture_screenshot", "simulate_mouse_input")) {
     instructions.push("Capture a screenshot before sending mouse input so its pixel coordinates match the viewport.");
   }
+  if (has("selection", "capture_screenshot")) {
+    instructions.push("Use selection action=view before capture_screenshot when the viewport must frame a specific instance.");
+  }
   if (has("get_roblox_docs")) {
     instructions.push("Use get_roblox_docs instead of guessing unfamiliar engine or Luau APIs.");
   }
@@ -3489,7 +3511,8 @@ var init_mcp_runtime = __esm({
     SIDE_EFFECTING_READ_TOOLS = /* @__PURE__ */ new Set([
       "capture_micro_profiler",
       "capture_script_profiler",
-      "export_rbxm"
+      "export_rbxm",
+      "selection"
     ]);
     NON_DESTRUCTIVE_SIDE_EFFECT_TOOLS = /* @__PURE__ */ new Set([
       "capture_device_matrix",
@@ -3497,7 +3520,8 @@ var init_mcp_runtime = __esm({
       "import_rbxm",
       "insert_asset",
       "insert_script_lines",
-      "upload_asset"
+      "upload_asset",
+      "selection"
     ]);
     IDEMPOTENT_WRITE_TOOLS = /* @__PURE__ */ new Set([
       "capture_device_matrix",
@@ -3506,7 +3530,8 @@ var init_mcp_runtime = __esm({
       "set_device_simulator",
       "set_network_profile",
       "set_properties",
-      "set_script_source"
+      "set_script_source",
+      "selection"
     ]);
     OPEN_WORLD_TOOLS = /* @__PURE__ */ new Set([
       "eval_client_runtime",
@@ -4053,7 +4078,7 @@ var init_http_server = __esm({
         return tools.deleteScriptLines(body.instancePath, startLine, endLine, body.instance_id);
       },
       get_attributes: (tools, body) => tools.getAttributes(body.instancePath, body.instance_id),
-      get_selection: (tools, body) => tools.getSelection(body.instance_id),
+      selection: (tools, body) => tools.selection(body.action, body, body.instance_id),
       execute_luau: (tools, body) => tools.executeLuau(body.code, body.target, body.instance_id),
       eval_server_runtime: (tools, body) => tools.evalServerRuntime(body.code, body.instance_id),
       eval_client_runtime: (tools, body) => tools.evalClientRuntime(body.code, body.target, body.instance_id),
@@ -8231,8 +8256,70 @@ var init_tools = __esm({
           ]
         };
       }
+      async selection(action, opts = {}, instance_id) {
+        if (action !== "get" && action !== "set" && action !== "view") {
+          throw new Error("selection requires action=get|set|view");
+        }
+        if (action === "get") {
+          return this.getSelection(instance_id);
+        }
+        if (action === "set") {
+          if (!Array.isArray(opts.paths)) {
+            throw new Error("selection action=set requires a paths array; empty clears");
+          }
+          return this.setSelection(opts.paths, opts.mode, instance_id);
+        }
+        if (!opts.path) {
+          throw new Error("selection action=view requires path");
+        }
+        return this.focusViewport(opts.path, opts.from, opts.padding, opts.angleY, instance_id);
+      }
       async getSelection(instance_id) {
-        const response = await this._callSingle("/api/get-selection", {}, void 0, instance_id);
+        const response = await this._callSingle("/api/get-selection", {}, "edit", instance_id);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(response)
+            }
+          ]
+        };
+      }
+      async setSelection(paths, mode, instance_id) {
+        if (!Array.isArray(paths) || paths.some((path6) => typeof path6 !== "string" || path6.length === 0)) {
+          throw new Error("selection paths must contain only non-empty instance paths");
+        }
+        const selectionMode = mode ?? "set";
+        if (!["set", "add", "remove"].includes(selectionMode)) {
+          throw new Error(`selection mode must be "set", "add" or "remove" (got: ${selectionMode})`);
+        }
+        const response = await this._callSingle("/api/set-selection", { paths, mode: selectionMode }, "edit", instance_id);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(response)
+            }
+          ]
+        };
+      }
+      async focusViewport(instancePath, from, padding, angleY, instance_id) {
+        if (!instancePath) {
+          throw new Error("selection action=view requires path");
+        }
+        if (padding !== void 0 && (padding <= 0 || padding > 10)) {
+          throw new Error("selection padding must be greater than 0 and at most 10");
+        }
+        if (angleY !== void 0 && (angleY < -89 || angleY > 89)) {
+          throw new Error("selection angleY must be between -89 and 89");
+        }
+        const { instanceId, clientRole } = this._resolveRuntime(instance_id);
+        const response = await this._callSingle("/api/focus-viewport", {
+          path: instancePath,
+          from,
+          padding,
+          angleY
+        }, clientRole ?? "edit", instanceId);
         return {
           content: [
             {
@@ -8981,6 +9068,7 @@ var init_tools = __esm({
           consecutive_confirmed_misses: record.consecutiveConfirmedMisses ?? 0,
           source: record.source,
           local_place_file: record.localPlaceFile,
+          studio_working_directory: record.studioWorkingDirectory,
           place_id: record.placeId,
           place_version: record.placeVersion,
           launched_at: new Date(record.launchedAt).toISOString(),
@@ -9177,6 +9265,7 @@ var init_tools = __esm({
           studioExecutable = request.studio_executable;
         }
         const processEnvironment = parseStudioProcessEnvironmentPatch(request.process_environment);
+        const studioWorkingDirectory = parseStudioWorkingDirectory(request.studio_working_directory);
         if (launchSource === "published_place" && placeId !== void 0 && await this._isLatestPublishedPlaceOpen(placeId)) {
           return this._textResult({
             error: "Place is already open.",
@@ -9200,6 +9289,7 @@ var init_tools = __esm({
           connectionTimeoutMs: timeoutMs,
           studioExecutable,
           processEnvironment,
+          studioWorkingDirectory,
           ...requireProcessIdentity ? { requireProcessIdentity: true } : {}
         });
         if (!waitForConnection) {
@@ -10744,7 +10834,11 @@ var init_server = __esm({
           boundPort = result.port;
           console.error(`HTTP server listening on ${host}:${boundPort} for Studio plugin (primary mode)`);
           console.error(`Streamable HTTP MCP endpoint: http://localhost:${boundPort}/mcp`);
-        } catch {
+        } catch (error) {
+          if (process.env.ROBLOX_STUDIO_REQUIRE_PRIMARY === "1") {
+            console.error(`Port ${basePort} is unavailable and ROBLOX_STUDIO_REQUIRE_PRIMARY=1; refusing proxy mode`);
+            throw error;
+          }
           bridgeMode = "proxy";
           primaryApp = void 0;
           const proxyBridge = new ProxyBridgeService(`http://localhost:${basePort}`, auth.token);
@@ -11136,24 +11230,62 @@ var init_definitions = __esm({
       },
       // === Selection ===
       {
-        name: "get_selection",
+        name: "selection",
         category: "read",
-        description: "Use when the current Studio selection should define the objects to work on.",
+        description: "Use to get, set, or frame selection.",
         inputSchema: {
           type: "object",
           properties: {
+            action: {
+              type: "string",
+              enum: ["get", "set", "view"],
+              description: "View frames the target."
+            },
+            paths: {
+              type: "array",
+              items: { type: "string", minLength: 1 },
+              description: "Set needs paths; empty clears in set mode."
+            },
+            mode: {
+              type: "string",
+              enum: ["set", "add", "remove"],
+              default: "set",
+              description: "How set applies paths."
+            },
+            path: {
+              type: "string",
+              minLength: 1,
+              description: "View needs a BasePart or Model path."
+            },
+            from: {
+              type: "number",
+              description: "View azimuth: 0 +X, 90 +Z."
+            },
+            padding: {
+              type: "number",
+              exclusiveMinimum: 0,
+              maximum: 10,
+              default: 1,
+              description: "View distance scale."
+            },
+            angleY: {
+              type: "number",
+              minimum: -89,
+              maximum: 89,
+              description: "View elevation in degrees."
+            },
             instance_id: {
               type: "string",
-              description: "Connected place ID; required with multiple places."
+              description: "Connected place ID if multiple are open."
             }
-          }
+          },
+          required: ["action"]
         }
       },
-      // === Luau Execution ===
       {
         name: "execute_luau",
         category: "write",
-        description: "Use for custom edit work or plugin-context access to a live server or client.",
+        description: "Use for custom Studio traversal, edits, or peer execution.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11176,7 +11308,7 @@ var init_definitions = __esm({
       {
         name: "eval_server_runtime",
         category: "write",
-        description: "Use when Luau must run in the live server Script VM and share the game's require cache.",
+        description: "Use to run Luau in the live server VM with its require cache.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11195,7 +11327,7 @@ var init_definitions = __esm({
       {
         name: "eval_client_runtime",
         category: "write",
-        description: "Use when Luau must run in a live client LocalScript VM and share the game's require cache.",
+        description: "Use to run Luau in a live client VM with its require cache.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11272,7 +11404,7 @@ var init_definitions = __esm({
       {
         name: "manage_instance",
         category: "write",
-        description: "Use to launch, inspect, authorize, or close Studio processes and list place revisions.",
+        description: "Use to manage Studio processes or list place revisions.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11314,6 +11446,10 @@ var init_definitions = __esm({
               type: "string",
               description: "Exact Studio executable for launch; otherwise auto-discovered."
             },
+            studio_working_directory: {
+              type: "string",
+              description: "Studio process working directory; isolates relative plugin folders per launch."
+            },
             process_environment: {
               type: "object",
               description: "Launch-only environment changes; never stored.",
@@ -11392,7 +11528,7 @@ var init_definitions = __esm({
       {
         name: "set_network_profile",
         category: "write",
-        description: "Use to apply simulated latency, jitter, or packet loss to playtest clients.",
+        description: "Use to simulate client latency, jitter, or packet loss.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11455,7 +11591,7 @@ var init_definitions = __esm({
       {
         name: "get_simulation_state",
         category: "read",
-        description: "Use to inspect network and device simulator state before or after simulation tests.",
+        description: "Use to inspect current network and device simulation.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11478,7 +11614,7 @@ var init_definitions = __esm({
       {
         name: "reset_simulation_state",
         category: "write",
-        description: "Use to clear network and device simulator settings between simulation tests.",
+        description: "Use to clear network and device simulation state.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11504,7 +11640,7 @@ var init_definitions = __esm({
       {
         name: "get_device_simulator_state",
         category: "read",
-        description: "Use to inspect active device simulation or list built-in device presets.",
+        description: "Use to inspect device simulation or list device presets.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11530,7 +11666,7 @@ var init_definitions = __esm({
       {
         name: "set_device_simulator",
         category: "write",
-        description: "Use to start, change, or stop device simulation in edit mode or on playtest clients.",
+        description: "Use to manage device simulation in edit or a playtest client.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11667,7 +11803,7 @@ var init_definitions = __esm({
       {
         name: "multiplayer_playtest",
         category: "write",
-        description: "Use to run or inspect a StudioTestService playtest with multiple clients.",
+        description: "Use to run or inspect a multi-client Studio playtest.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11797,7 +11933,7 @@ var init_definitions = __esm({
       {
         name: "capture_micro_profiler",
         category: "read",
-        description: "Use to attribute frame time across engine and game work on a running server or client.",
+        description: "Use to profile engine and game frame time on a live peer.",
         inputSchema: {
           type: "object",
           properties: {
@@ -11924,7 +12060,7 @@ var init_definitions = __esm({
       {
         name: "breakpoints",
         category: "write",
-        description: "Use when Studio breakpoints or logpoints are needed to trace script execution.",
+        description: "Use to trace script execution with breakpoints or logpoints.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12023,7 +12159,7 @@ var init_definitions = __esm({
       {
         name: "get_asset_details",
         category: "read",
-        description: "Use to inspect full catalog metadata for one shortlisted Creator Store asset.",
+        description: "Use to inspect a shortlisted Creator Store asset.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12090,7 +12226,7 @@ var init_definitions = __esm({
       {
         name: "generate_model",
         category: "write",
-        description: "Use to generate and stage a Roblox model from text or an image reference.",
+        description: "Use to stage a Roblox model from text or an image.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12242,7 +12378,7 @@ var init_definitions = __esm({
       {
         name: "capture_screenshot",
         category: "read",
-        description: "Use when you need the current Studio viewport as an image or input coordinate map.",
+        description: "Use to capture the Studio viewport or map input coordinates.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12339,7 +12475,7 @@ var init_definitions = __esm({
       {
         name: "get_memory_breakdown",
         category: "read",
-        description: "Use to compare Roblox memory categories across edit, server, or client peers.",
+        description: "Use to compare memory categories across Studio peers.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12362,7 +12498,7 @@ var init_definitions = __esm({
       {
         name: "get_scene_analysis",
         category: "read",
-        description: "Use to attribute scene cost to instances, scripts, triangles, animation, or audio.",
+        description: "Use to attribute scene cost across instances and content.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12464,7 +12600,7 @@ var init_definitions = __esm({
       {
         name: "find_and_replace_in_scripts",
         category: "write",
-        description: "Use to preview or apply the same text replacement across multiple scripts.",
+        description: "Use to preview or apply one replacement across scripts.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12513,7 +12649,7 @@ var init_definitions = __esm({
       {
         name: "get_roblox_skills",
         category: "read",
-        description: "Use to list or read Roblox-authored Studio Assistant skills on demand.",
+        description: "Use to read installed Roblox Studio Assistant skills.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12534,7 +12670,7 @@ var init_definitions = __esm({
       {
         name: "get_roblox_docs",
         category: "read",
-        description: "Use to look up official Roblox engine or Luau reference documentation.",
+        description: "Use to read official Roblox engine or Luau references.",
         inputSchema: {
           type: "object",
           properties: {
@@ -12565,6 +12701,29 @@ import { existsSync as existsSync7, unlinkSync } from "fs";
 import { execSync } from "child_process";
 import { join as join5 } from "path";
 import { homedir as homedir4 } from "os";
+function configurePluginAssetForPort(source, rawPort = process.env.ROBLOX_STUDIO_PORT) {
+  if (rawPort === void 0 || rawPort === "")
+    return source;
+  if (!/^\d+$/.test(rawPort)) {
+    throw new Error(`ROBLOX_STUDIO_PORT must be an integer from 1 to 65535; received ${JSON.stringify(rawPort)}`);
+  }
+  const port = Number(rawPort);
+  if (!Number.isSafeInteger(port) || port < 1 || port > 65535) {
+    throw new Error(`ROBLOX_STUDIO_PORT must be an integer from 1 to 65535; received ${JSON.stringify(rawPort)}`);
+  }
+  if (port === DEFAULT_PLUGIN_PORT)
+    return source;
+  const defaultPort = String(DEFAULT_PLUGIN_PORT);
+  const configuredPort = String(port);
+  const defaultUrl = `http://localhost:${defaultPort}`;
+  const defaultBasePort = `BASE_PORT = ${defaultPort}`;
+  const original = source.toString("utf8");
+  if (!original.includes(defaultUrl) || !original.includes(defaultBasePort)) {
+    throw new Error(`Bundled Studio plugin does not contain the expected default port ${defaultPort}`);
+  }
+  const configured = original.replaceAll(defaultUrl, `http://localhost:${configuredPort}`).replaceAll(defaultBasePort, `BASE_PORT = ${configuredPort}`).replace(SERVER_URL_SETTING_KEY_PATTERN, (key) => key.endsWith("_") ? `${key}PORT_${configuredPort}_` : `${key}_PORT_${configuredPort}`);
+  return Buffer.from(configured, "utf8");
+}
 function isWSL() {
   return getStudioPlatformCapabilities().isWsl;
 }
@@ -12618,10 +12777,13 @@ Only one MCP plugin variant should be present. If both variants are in the Studi
 Delete ${otherAssetName} manually or use the default CLI installer behavior to replace it.
 `);
 }
+var DEFAULT_PLUGIN_PORT, SERVER_URL_SETTING_KEY_PATTERN;
 var init_install_plugin_helpers = __esm({
   "../core/dist/install-plugin-helpers.js"() {
     "use strict";
     init_studio_platform();
+    DEFAULT_PLUGIN_PORT = 58741;
+    SERVER_URL_SETTING_KEY_PATTERN = /MCP_LAST_SUCCESSFUL_SERVER_URL_GLOBAL_V1|MCP_LAST_SUCCESSFUL_SERVER_URL_|MCP_SERVER_URL_/g;
   }
 });
 
@@ -12648,7 +12810,7 @@ __export(install_plugin_exports, {
   installBundledPlugin: () => installBundledPlugin,
   installPlugin: () => installPlugin
 });
-import { copyFileSync as copyFileSync2, createWriteStream, existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync7, unlinkSync as unlinkSync2 } from "fs";
+import { createWriteStream, existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync7, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname5, join as join6 } from "path";
 import { fileURLToPath } from "url";
 import { get } from "https";
@@ -12750,11 +12912,10 @@ function assertBundledPluginVersion(source) {
     );
   }
 }
-function filesMatch(a, b) {
-  if (!existsSync8(b)) return false;
-  const aBytes = readFileSync7(a);
-  const bBytes = readFileSync7(b);
-  return aBytes.length === bBytes.length && aBytes.equals(bBytes);
+function filesMatch(expected, actualPath) {
+  if (!existsSync8(actualPath)) return false;
+  const actual = readFileSync7(actualPath);
+  return expected.length === actual.length && expected.equals(actual);
 }
 async function installBundledPlugin(options = {}) {
   const log = options.log ?? console.log;
@@ -12767,8 +12928,9 @@ async function installBundledPlugin(options = {}) {
   assertBundledPluginVersion(source);
   const pluginsFolder = prepareInstall({ replaceVariant, log, warn });
   const dest = join6(pluginsFolder, ASSET_NAME);
-  if (filesMatch(source, dest)) return;
-  copyFileSync2(source, dest);
+  const configured = configurePluginAssetForPort(readFileSync7(source));
+  if (filesMatch(configured, dest)) return;
+  writeFileSync3(dest, configured);
   log(`Installed ${ASSET_NAME} to ${dest}`);
 }
 async function installPlugin(options = {}) {
@@ -12780,11 +12942,12 @@ async function installPlugin(options = {}) {
   if (bundled) {
     assertBundledPluginVersion(bundled);
     const dest2 = join6(pluginsFolder, ASSET_NAME);
-    if (filesMatch(bundled, dest2)) {
+    const configured2 = configurePluginAssetForPort(readFileSync7(bundled));
+    if (filesMatch(configured2, dest2)) {
       log(`${ASSET_NAME} already installed.`);
       return;
     }
-    copyFileSync2(bundled, dest2);
+    writeFileSync3(dest2, configured2);
     log(`Installed bundled ${ASSET_NAME} to ${dest2}`);
     return;
   }
@@ -12797,6 +12960,9 @@ async function installPlugin(options = {}) {
   const dest = join6(pluginsFolder, ASSET_NAME);
   log(`Downloading ${ASSET_NAME} from ${release.tag_name}...`);
   await download(asset.browser_download_url, dest);
+  const downloaded = readFileSync7(dest);
+  const configured = configurePluginAssetForPort(downloaded);
+  if (configured !== downloaded) writeFileSync3(dest, configured);
   log(`Installed to ${dest}`);
 }
 var REPO, ASSET_NAME, OTHER_VARIANT, TIMEOUT_MS, MAX_REDIRECTS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrrxs/robloxstudio-mcp-inspector",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "DataModel read-only MCP server for inspecting and debugging Roblox Studio from AI coding tools",
   "main": "dist/index.js",
   "type": "module",
@@ -12,7 +12,7 @@
   },
   "files": [
     "dist/**/*",
-    "studio-plugin/**/*"
+    "studio-plugin/MCPInspectorPlugin.rbxmx"
   ],
   "scripts": {
     "build": "tsup",