robloxstudio-mcp 2.7.0-next.4 → 2.7.0-next.6

package/dist/index.js

@@ -158,7 +158,7 @@ var TOOL_HANDLERS = {
   }),
   get_script_source: (tools, body) => tools.getScriptSource(body.instancePath, body.startLine, body.endLine),
   set_script_source: (tools, body) => tools.setScriptSource(body.instancePath, body.source),
-  edit_script_lines: (tools, body) => tools.editScriptLines(body.instancePath, body.old_string, body.new_string),
+  edit_script_lines: (tools, body) => tools.editScriptLines(body.instancePath, body.old_string, body.new_string, body.startLine),
   insert_script_lines: (tools, body) => tools.insertScriptLines(body.instancePath, body.afterLine, body.newContent),
   delete_script_lines: (tools, body) => tools.deleteScriptLines(body.instancePath, body.startLine, body.endLine),
   get_attribute: (tools, body) => tools.getAttribute(body.instancePath, body.attributeName),
@@ -1629,11 +1629,14 @@ ${code}`
       ]
     };
   }
-  async editScriptLines(instancePath, oldString, newString) {
+  async editScriptLines(instancePath, oldString, newString, startLine) {
     if (!instancePath || typeof oldString !== "string" || typeof newString !== "string") {
       throw new Error("Instance path, old_string, and new_string are required for edit_script_lines");
     }
-    const response = await this.client.request("/api/edit-script-lines", { instancePath, old_string: oldString, new_string: newString });
+    const payload = { instancePath, old_string: oldString, new_string: newString };
+    if (startLine !== void 0)
+      payload.startLine = startLine;
+    const response = await this.client.request("/api/edit-script-lines", payload);
     return {
       content: [
         {
@@ -2496,17 +2499,28 @@ ${code}`
       }]
     };
   }
+  // Decal asset IDs are the wrapper asset; ImageLabel.Image needs the underlying image
+  // content ID. The only reliable cross-auth way to resolve this is InsertService:LoadAsset
+  // via the connected Studio plugin — the unauthenticated economy endpoint returns 401.
   async resolveImageId(decalAssetId) {
+    const code = `
+      local InsertService = game:GetService("InsertService")
+      local ok, result = pcall(function() return InsertService:LoadAsset(${decalAssetId}) end)
+      if not ok then return nil end
+      local decal = result:FindFirstChildWhichIsA("Decal", true)
+      local id = decal and decal.Texture:match("(%d+)") or nil
+      result:Destroy()
+      return id
+    `;
     try {
-      const resp = await fetch(`https://economy.roblox.com/v2/assets/${decalAssetId}/details`);
-      if (!resp.ok)
-        return decalAssetId;
-      const details = await resp.json();
-      if (details.TextureId)
-        return String(details.TextureId);
+      const response = await this.client.request("/api/execute-luau", { code }, "edit");
+      const returnValue = response?.returnValue;
+      if (returnValue !== void 0 && returnValue !== null && /^\d+$/.test(String(returnValue))) {
+        return String(returnValue);
+      }
     } catch {
     }
-    return decalAssetId;
+    return null;
   }
   async uploadDecal(filePath, displayName, description, userId, groupId) {
     if (!fs.existsSync(filePath)) {
@@ -2530,12 +2544,13 @@ ${code}`
         creationContext: { creator }
       }, fileContent, fileName);
       const decalId = result.response?.assetId;
-      const imageId = decalId ? await this.resolveImageId(decalId) : void 0;
+      const imageId = decalId ? await this.resolveImageId(decalId) : null;
       return {
         content: [{
           type: "text",
           text: JSON.stringify({
             ...result,
+            decalId: decalId ?? null,
             imageId
           })
         }]
@@ -2552,7 +2567,7 @@ ${code}`
               assetId: String(result.assetId),
               displayName,
               assetType: "Decal",
-              backingAssetId: String(result.backingAssetId),
+              decalId: String(result.assetId),
               imageId: String(result.backingAssetId)
             }
           })
@@ -2578,7 +2593,8 @@ ${code}`
               assetId: String(result2.assetId),
               displayName,
               assetType,
-              backingAssetId: String(result2.backingAssetId)
+              decalId: String(result2.assetId),
+              imageId: String(result2.backingAssetId)
             }
           })
         }]
@@ -2605,6 +2621,20 @@ ${code}`
       description: description || "",
       creationContext: { creator }
     }, fileContent, fileName);
+    if (assetType === "Decal") {
+      const decalId = result.response?.assetId;
+      const imageId = decalId ? await this.resolveImageId(decalId) : null;
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            ...result,
+            decalId: decalId ?? null,
+            imageId
+          })
+        }]
+      };
+    }
     return {
       content: [{
         type: "text",
@@ -3031,7 +3061,7 @@ var RobloxStudioMCPServer = class {
           case "set_script_source":
             return await this.tools.setScriptSource(args?.instancePath, args?.source);
           case "edit_script_lines":
-            return await this.tools.editScriptLines(args?.instancePath, args?.old_string, args?.new_string);
+            return await this.tools.editScriptLines(args?.instancePath, args?.old_string, args?.new_string, args?.startLine);
           case "insert_script_lines":
             return await this.tools.insertScriptLines(args?.instancePath, args?.afterLine, args?.newContent);
           case "delete_script_lines":
@@ -3784,7 +3814,7 @@ var TOOL_DEFINITIONS = [
   {
     name: "edit_script_lines",
     category: "write",
-    description: "Replace exact text in a script. old_string must match exactly once in the script (whitespace-sensitive). Use get_script_source first to see current content.",
+    description: "Replace exact text in a script. Without startLine, old_string must match exactly once in the script. Pass startLine (1-indexed, from get_script_source) to anchor the edit to a specific line when old_string is ambiguous (e.g. repeated closing braces).",
     inputSchema: {
       type: "object",
       properties: {
@@ -3794,11 +3824,15 @@ var TOOL_DEFINITIONS = [
         },
         old_string: {
           type: "string",
-          description: "Exact text to find and replace (must be unique in the script)"
+          description: "Exact text to find and replace. Must be unique in the script unless startLine is provided."
         },
         new_string: {
           type: "string",
           description: "Replacement text"
+        },
+        startLine: {
+          type: "number",
+          description: "Optional 1-indexed line where old_string begins. When provided, skips uniqueness check and requires old_string to match starting at that exact line."
         }
       },
       required: ["instancePath", "old_string", "new_string"]
@@ -4566,7 +4600,7 @@ part(0,2,0,2,1,1,"b")`,
   {
     name: "upload_decal",
     category: "write",
-    description: "Upload an image file as a Decal asset to Roblox. Supports ROBLOSECURITY cookie auth (recommended, simpler) or ROBLOX_OPEN_CLOUD_API_KEY (needs asset:write scope + creator ID). Cookie auth is used automatically when ROBLOSECURITY is set.",
+    description: "Upload an image file as a Decal asset to Roblox. Supports ROBLOSECURITY cookie auth (recommended, simpler) or ROBLOX_OPEN_CLOUD_API_KEY (needs asset:write scope + creator ID). Cookie auth is used automatically when ROBLOSECURITY is set. Response includes both decalId (Decal wrapper asset ID) and imageId (underlying image content ID \u2014 use this for ImageLabel.Image). For Open Cloud uploads, imageId is resolved via the connected Studio plugin (InsertService:LoadAsset); if the plugin is not connected, imageId is null.",
     inputSchema: {
       type: "object",
       properties: {

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "robloxstudio-mcp",
-  "version": "2.7.0-next.4",
-  "description": "MCP Server for Roblox Studio Integration - Access Studio data, scripts, and objects through AI tools",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "robloxstudio-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist/**/*",
-    "studio-plugin/**/*"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "prepack": "node ../../scripts/prepack.mjs",
-    "postpack": "node ../../scripts/postpack.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "roblox",
-    "studio",
-    "ai",
-    "model-context-protocol",
-    "game-development"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/boshyxd/robloxstudio-mcp.git"
-  },
-  "homepage": "https://github.com/boshyxd/robloxstudio-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/boshyxd/robloxstudio-mcp/issues"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "cors": "^2.8.5",
-    "express": "^4.18.2",
-    "node-fetch": "^3.3.2",
-    "uuid": "^9.0.1",
-    "ws": "^8.14.2"
-  },
-  "devDependencies": {
-    "@robloxstudio-mcp/core": "*"
-  }
-}
+{
+  "name": "robloxstudio-mcp",
+  "version": "2.7.0-next.6",
+  "description": "MCP Server for Roblox Studio Integration - Access Studio data, scripts, and objects through AI tools",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "robloxstudio-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "studio-plugin/**/*"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepack": "node ../../scripts/prepack.mjs",
+    "postpack": "node ../../scripts/postpack.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "roblox",
+    "studio",
+    "ai",
+    "model-context-protocol",
+    "game-development"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boshyxd/robloxstudio-mcp.git"
+  },
+  "homepage": "https://github.com/boshyxd/robloxstudio-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/boshyxd/robloxstudio-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "node-fetch": "^3.3.2",
+    "uuid": "^9.0.1",
+    "ws": "^8.14.2"
+  },
+  "devDependencies": {
+    "@robloxstudio-mcp/core": "*"
+  }
+}