unity-open-mcp 0.1.2 → 0.3.1

package/dist/tools/spriteatlas-delete.js

@@ -0,0 +1,32 @@
+// M20 Plan 9 / T20.9.1 — SpriteAtlas domain tool. Mutating (destructive):
+// delete the .spriteatlas asset. Runs the full gate path (EditorSettle);
+// paths_hint is the asset path.
+export const spriteatlasDelete = {
+    name: "unity_open_mcp_spriteatlas_delete",
+    description: "Delete a SpriteAtlas asset (.spriteatlas). Refuses when the path does " +
+        "not point at a SpriteAtlas. Mutating (destructive): runs the full gate " +
+        "path (editor_settle); paths_hint is the asset path. There is no undo " +
+        "across a Unity restart. Built-in 2D module; the sprite2d group is hidden until " +
+        "manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path", "paths_hint"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "Assets/-rooted .spriteatlas asset path.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the asset path to delete.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=spriteatlas-delete.js.map

package/dist/tools/spriteatlas-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteatlas-delete.js","sourceRoot":"","sources":["../../src/tools/spriteatlas-delete.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,yEAAyE;AACzE,gCAAgC;AAChC,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,wEAAwE;QACxE,yEAAyE;QACzE,uEAAuE;QACvE,iFAAiF;QACjF,4BAA4B;IAC9B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;QACtC,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,4CAA4C;aAC1D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/spriteatlas-get.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const spriteatlasGet: Tool;

package/dist/tools/spriteatlas-get.js

@@ -0,0 +1,23 @@
+// M20 Plan 9 / T20.9.1 — SpriteAtlas domain tool. Read-only: the atlas
+// authoring state (packables + packing/texture/platform settings). Gate-free.
+export const spriteatlasGet = {
+    name: "unity_open_mcp_spriteatlas_get",
+    description: "Read-only: SpriteAtlas snapshot — packables (asset paths + type), " +
+        "include-in-build, is-variant, packing settings (blockOffset / padding / " +
+        "enableRotation / enableTightPacking / enableAlphaDilation), texture " +
+        "settings (maxTextureSize / anisoLevel / filterMode / generateMipMaps / " +
+        "readable / sRGB), and the default platform settings (maxTextureSize / " +
+        "format / textureCompression). Gate-free.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "Assets/-rooted .spriteatlas asset path.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=spriteatlas-get.js.map

package/dist/tools/spriteatlas-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteatlas-get.js","sourceRoot":"","sources":["../../src/tools/spriteatlas-get.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,oEAAoE;QACpE,0EAA0E;QAC1E,sEAAsE;QACtE,yEAAyE;QACzE,wEAAwE;QACxE,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/spriteatlas-list.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const spriteatlasList: Tool;

package/dist/tools/spriteatlas-list.js

@@ -0,0 +1,21 @@
+// M20 Plan 9 / T20.9.1 — SpriteAtlas domain tool. Read-only: list SpriteAtlas
+// assets under a folder (default: whole project). Gate-free; offline-routeable
+// in principle.
+export const spriteatlasList = {
+    name: "unity_open_mcp_spriteatlas_list",
+    description: "Read-only: list SpriteAtlas (.spriteatlas) asset paths under a folder " +
+        "(omit folder to search the whole project). Each entry reports path + " +
+        "name. Cap 200; truncated count reported. Gate-free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            folder: {
+                type: "string",
+                description: "Assets/-rooted folder to search under (default: 'Assets' = whole " +
+                    "project).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=spriteatlas-list.js.map

package/dist/tools/spriteatlas-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteatlas-list.js","sourceRoot":"","sources":["../../src/tools/spriteatlas-list.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,+EAA+E;AAC/E,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,wEAAwE;QACxE,uEAAuE;QACvE,qDAAqD;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mEAAmE;oBACnE,WAAW;aACd;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/spriteatlas-modify.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const spriteatlasModify: Tool;

package/dist/tools/spriteatlas-modify.js

@@ -0,0 +1,55 @@
+// M20 Plan 9 / T20.9.1 — SpriteAtlas domain tool. Mutating: patch
+// include_in_build + packing + texture settings via a structured JSON object.
+// Runs the full gate path (EditorSettle); paths_hint is the atlas asset path.
+// Unknown fields are reported, not fatal.
+export const spriteatlasModify = {
+    name: "unity_open_mcp_spriteatlas_modify",
+    description: "Mutating: patch SpriteAtlas settings — include_in_build (bool), packing " +
+        "(blockOffset / padding / enableRotation / enableTightPacking / " +
+        "enableAlphaDilation), and texture (anisoLevel / filterMode / " +
+        "generateMipMaps / readable / sRGB). settings_json is a JSON object with " +
+        "three optional sub-objects: {include_in_build, packing:{...}, texture:{...}}. " +
+        "Unknown fields are reported in `unknownFields`, not fatal. NOTE: packing and " +
+        "texture settings are applied to the in-memory asset (take effect for the " +
+        "next pack) but are NOT written to the .spriteatlas file in this Unity " +
+        "version — Unity manages them via the internal packing pipeline. Mutating: " +
+        "runs the full gate path (editor_settle); paths_hint is the .spriteatlas " +
+        "asset path. Built-in 2D module; the sprite2d group is hidden until " +
+        "manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path", "settings_json", "paths_hint"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "Assets/-rooted .spriteatlas asset path.",
+            },
+            settings_json: {
+                type: "string",
+                description: 'JSON object string. e.g. ' +
+                    '"{"include_in_build":false,"packing":{"padding":4,"enableRotation":true},"texture":{"anisoLevel":1,"filterMode":"Bilinear"}}". ' +
+                    "Top-level keys: include_in_build (bool). Sub-objects: packing " +
+                    "{blockOffset(int), padding(int), enableRotation(bool), " +
+                    "enableTightPacking(bool), enableAlphaDilation(bool)}, texture " +
+                    "{anisoLevel(int), filterMode(Point|Bilinear|Trilinear), " +
+                    "generateMipMaps(bool), readable(bool), sRGB(bool)}. NOTE: packing " +
+                    "and texture settings are applied to the in-memory asset (take effect " +
+                    "for the next pack) but are NOT written to the .spriteatlas file in " +
+                    "this Unity version — Unity manages them via the internal packing " +
+                    "pipeline. texture.maxTextureSize is not settable here (no setter on " +
+                    "the settings struct; controlled via platform settings).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the .spriteatlas asset path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=spriteatlas-modify.js.map

package/dist/tools/spriteatlas-modify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteatlas-modify.js","sourceRoot":"","sources":["../../src/tools/spriteatlas-modify.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,8EAA8E;AAC9E,8EAA8E;AAC9E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,0EAA0E;QAC1E,iEAAiE;QACjE,+DAA+D;QAC/D,0EAA0E;QAC1E,gFAAgF;QAChF,+EAA+E;QAC/E,2EAA2E;QAC3E,wEAAwE;QACxE,4EAA4E;QAC5E,0EAA0E;QAC1E,qEAAqE;QACrE,4BAA4B;IAC9B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,YAAY,CAAC;QACvD,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2BAA2B;oBAC3B,iIAAiI;oBACjI,gEAAgE;oBAChE,yDAAyD;oBACzD,gEAAgE;oBAChE,0DAA0D;oBAC1D,oEAAoE;oBACpE,uEAAuE;oBACvE,qEAAqE;oBACrE,mEAAmE;oBACnE,sEAAsE;oBACtE,yDAAyD;aAC5D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/spriteatlas-remove-packable.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const spriteatlasRemovePackable: Tool;

package/dist/tools/spriteatlas-remove-packable.js

@@ -0,0 +1,39 @@
+// M20 Plan 9 / T20.9.1 — SpriteAtlas domain tool. Mutating: remove packables
+// by asset path. Runs the full gate path (EditorSettle); paths_hint is the
+// atlas asset path. Per-path errors are accumulated.
+export const spriteatlasRemovePackable = {
+    name: "unity_open_mcp_spriteatlas_remove_packable",
+    description: "Remove packables from a SpriteAtlas by Assets/-rooted path. Each path " +
+        "resolves against the current packables list and is removed if present. " +
+        "Per-path errors are accumulated (a path that is not a packable of this " +
+        "atlas is reported, not fatal). Mutating: runs the full gate path " +
+        "(editor_settle); paths_hint is the .spriteatlas asset path. Built-in 2D " +
+        "module; the sprite2d group is hidden until manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path", "packable_paths", "paths_hint"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "Assets/-rooted .spriteatlas asset path.",
+            },
+            packable_paths: {
+                type: "array",
+                items: { type: "string" },
+                description: "Assets/-rooted paths of the packables to remove. Each must match " +
+                    "a current packable of this atlas (matched by asset path).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the .spriteatlas asset path.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=spriteatlas-remove-packable.js.map

package/dist/tools/spriteatlas-remove-packable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteatlas-remove-packable.js","sourceRoot":"","sources":["../../src/tools/spriteatlas-remove-packable.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,2EAA2E;AAC3E,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAS;IAC7C,IAAI,EAAE,4CAA4C;IAClD,WAAW,EACT,wEAAwE;QACxE,yEAAyE;QACzE,yEAAyE;QACzE,mEAAmE;QACnE,0EAA0E;QAC1E,uEAAuE;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,YAAY,CAAC;QACxD,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mEAAmE;oBACnE,2DAA2D;aAC9D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/terrain-create.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const terrainCreate: Tool;

package/dist/tools/terrain-create.js

@@ -0,0 +1,73 @@
+// M20 Plan 4 / T20.4 — Terrain domain tool. Built-in Terrain module
+// (Terrain / TerrainData / TreePrototype / TerrainLayer) — ungated in the
+// bridge (no UNITY_OPEN_MCP_EXT_TERRAIN define), always compiled. The
+// `terrain` group is hidden until manage_tools activates it. Mutating: runs
+// the full gate path; paths_hint is the new terrain's scene path + the asset
+// path (when provided). Param shape: width / length / height /
+// heightmapResolution / position / dataPath.
+const HEIGHTMAP_RESOLUTIONS = "Power-of-two plus one (33 | 65 | 129 | 257 | 513 | 1025 | 2049 | 4097).";
+export const terrainCreate = {
+    name: "unity_open_mcp_terrain_create",
+    description: "Create a Terrain (allocates TerrainData + a Terrain GameObject). Optional: " +
+        "width (X size, default 500), length (Z size, default 500), height (Y max, " +
+        "default 200), heightmap_resolution (" + HEIGHTMAP_RESOLUTIONS + " default 129), " +
+        "position ('x,y,z' world-space), asset_path (Assets/.../.asset for the " +
+        "TerrainData — when omitted, the TerrainData is in-scene only and is NOT saved " +
+        "to disk). Mutating: runs the full gate path; paths_hint is the scene path + " +
+        "the asset path (when provided). Built-in Terrain module (no package " +
+        "dependency); the terrain group is hidden until manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            terrain_name: {
+                type: "string",
+                default: "Terrain",
+                description: "Name for the new Terrain GameObject.",
+            },
+            width: {
+                type: "number",
+                default: 500,
+                description: "Terrain width in world units (X). Must be positive.",
+            },
+            length: {
+                type: "number",
+                default: 500,
+                description: "Terrain length in world units (Z). Must be positive.",
+            },
+            height: {
+                type: "number",
+                default: 200,
+                description: "Maximum terrain height in world units (Y). Must be positive.",
+            },
+            heightmap_resolution: {
+                type: "integer",
+                default: 129,
+                description: "Heightmap resolution. " + HEIGHTMAP_RESOLUTIONS,
+            },
+            position: {
+                type: "string",
+                description: "World-space position 'x,y,z' for the Terrain GameObject.",
+            },
+            asset_path: {
+                type: "string",
+                description: "Assets/.../.asset path to save the TerrainData. Must start with " +
+                    "'Assets/' and end in '.asset', and the path must be unique. When " +
+                    "omitted, the TerrainData is in-scene only and is NOT saved to disk.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the new terrain's scene path. When asset_path is " +
+                    "provided, include BOTH the scene path and the .asset path so the gate " +
+                    "validates both. No whole-project fallback.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=terrain-create.js.map

package/dist/tools/terrain-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-create.js","sourceRoot":"","sources":["../../src/tools/terrain-create.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,0EAA0E;AAC1E,sEAAsE;AACtE,4EAA4E;AAC5E,6EAA6E;AAC7E,+DAA+D;AAC/D,6CAA6C;AAC7C,MAAM,qBAAqB,GACzB,yEAAyE,CAAC;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,6EAA6E;QAC7E,4EAA4E;QAC5E,sCAAsC,GAAG,qBAAqB,GAAG,iBAAiB;QAClF,wEAAwE;QACxE,gFAAgF;QAChF,8EAA8E;QAC9E,sEAAsE;QACtE,2EAA2E;IAC7E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,sCAAsC;aACpD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,qDAAqD;aACnE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,sDAAsD;aACpE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,8DAA8D;aAC5E;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,wBAAwB,GAAG,qBAAqB;aAC9D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kEAAkE;oBAClE,mEAAmE;oBACnE,qEAAqE;aACxE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,oEAAoE;oBACpE,wEAAwE;oBACxE,4CAA4C;aAC/C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/terrain-paint-layer.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const terrainPaintLayer: Tool;

package/dist/tools/terrain-paint-layer.js

@@ -0,0 +1,85 @@
+// M20 Plan 4 / T20.4 — Terrain domain tool. Paint one terrain layer's splat
+// from a 2D alphamap. Built-in Terrain module — ungated. Mutating: runs the
+// full gate path; paths_hint is the scene path (+ the layer asset path when a
+// new layer is created)
+const targetSchema = {
+    instance_id: {
+        type: "integer",
+        default: 0,
+        description: "Host Terrain GameObject instance ID. Highest priority resolver.",
+    },
+    path: {
+        type: "string",
+        description: "Host Terrain GameObject hierarchy path \"Root/Child\".",
+    },
+    name: {
+        type: "string",
+        description: "Host Terrain GameObject name (first match). Lowest priority resolver.",
+    },
+    paths_hint: {
+        type: "array",
+        items: { type: "string" },
+        description: "Mutation scope — the host scene path. When a new TerrainLayer asset is " +
+            "created (layer_path under Assets/ and a fresh layer), include the layer " +
+            ".terrainlayer asset path too. No whole-project fallback.",
+    },
+    gate: {
+        enum: ["enforce", "warn", "off"],
+        default: "enforce",
+    },
+};
+export const terrainPaintLayer = {
+    name: "unity_open_mcp_terrain_paint_layer",
+    description: "Paint a terrain layer's splat in a region. alphamap is a row-major 2D JSON " +
+        "array of 0-1 weights for layer_index; x_offset / y_offset position the region " +
+        "inside the alphamap. When layer_index is new (>= the terrain's current layer " +
+        "count), a new TerrainLayer is added — either loaded from layer_path (an " +
+        "existing .terrainlayer asset) or created fresh at that path. The standard " +
+        "terrain shader caps layers at 8. Arrays larger than 513x513 per call are " +
+        "refused — write in tiles. Mutating: runs the full gate path; paths_hint is the " +
+        "scene path (+ the layer asset path when a new layer is created). Built-in " +
+        "Terrain module (no package dependency); the terrain group is hidden until " +
+        "manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["layer_index", "alphamap", "paths_hint"],
+        properties: {
+            ...targetSchema,
+            layer_index: {
+                type: "integer",
+                minimum: 0,
+                description: "Terrain layer index to paint. When >= the terrain's current layer count, " +
+                    "a new TerrainLayer is seeded (requires layer_path). Capped at 8 for the " +
+                    "standard terrain shader.",
+            },
+            x_offset: {
+                type: "integer",
+                default: 0,
+                description: "Start X index in the alphamap for the region write.",
+            },
+            y_offset: {
+                type: "integer",
+                default: 0,
+                description: "Start Y index in the alphamap for the region write.",
+            },
+            alphamap: {
+                type: "array",
+                items: {
+                    type: "array",
+                    items: { type: "number" },
+                },
+                description: "Row-major 2D array of normalized 0-1 weights for this layer. Each row " +
+                    "must have the same length. Capped at 513x513 per call — tile large writes.",
+            },
+            layer_path: {
+                type: "string",
+                description: "Optional Assets/.../.terrainlayer path. When layer_index is new, the " +
+                    "layer is loaded from this path (if the asset exists) or created fresh " +
+                    "there (if the path is a valid Assets/.../.terrainlayer). When omitted " +
+                    "and the index is new, an in-scene-only (unsaved) layer is created.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=terrain-paint-layer.js.map

package/dist/tools/terrain-paint-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-paint-layer.js","sourceRoot":"","sources":["../../src/tools/terrain-paint-layer.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,wBAAwB;AACxB,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,iEAAiE;KAC/E;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wDAAwD;KACtE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uEAAuE;KACrF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EACT,yEAAyE;YACzE,0EAA0E;YAC1E,0DAA0D;KAC7D;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,6EAA6E;QAC7E,gFAAgF;QAChF,+EAA+E;QAC/E,0EAA0E;QAC1E,4EAA4E;QAC5E,2EAA2E;QAC3E,iFAAiF;QACjF,4EAA4E;QAC5E,4EAA4E;QAC5E,4BAA4B;IAC9B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,CAAC;QACnD,UAAU,EAAE;YACV,GAAG,YAAY;YACf,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,2EAA2E;oBAC3E,0EAA0E;oBAC1E,0BAA0B;aAC7B;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,qDAAqD;aACnE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,qDAAqD;aACnE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,WAAW,EACT,wEAAwE;oBACxE,4EAA4E;aAC/E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uEAAuE;oBACvE,wEAAwE;oBACxE,wEAAwE;oBACxE,oEAAoE;aACvE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/terrain-place-trees.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const terrainPlaceTrees: Tool;

package/dist/tools/terrain-place-trees.js

@@ -0,0 +1,92 @@
+// M20 Plan 4 / T20.4 — Terrain domain tool. Place tree instances on a terrain.
+// Built-in Terrain module — ungated. Mutating: runs the full gate path;
+// paths_hint is the host scene path.
+const targetSchema = {
+    instance_id: {
+        type: "integer",
+        default: 0,
+        description: "Host Terrain GameObject instance ID. Highest priority resolver.",
+    },
+    path: {
+        type: "string",
+        description: "Host Terrain GameObject hierarchy path \"Root/Child\".",
+    },
+    name: {
+        type: "string",
+        description: "Host Terrain GameObject name (first match). Lowest priority resolver.",
+    },
+    paths_hint: {
+        type: "array",
+        items: { type: "string" },
+        description: "Mutation scope — the host scene path. No whole-project fallback.",
+    },
+    gate: {
+        enum: ["enforce", "warn", "off"],
+        default: "enforce",
+    },
+};
+export const terrainPlaceTrees = {
+    name: "unity_open_mcp_terrain_place_trees",
+    description: "Place tree instances on a terrain. instances is an array of {position " +
+        "('x,z' normalized 0-1 on the terrain), height_scale (default 1), " +
+        "width_scale (default 1), rotation (degrees, default 0)}. " +
+        "tree_prototype_index selects the prototype. When the index is new (>= the " +
+        "terrain's current prototype count), a prototype is seeded from " +
+        "prototype_prefab_path (a .prefab asset under Assets/). Mutating: runs the " +
+        "full gate path; paths_hint is the host scene path. Built-in Terrain module " +
+        "(no package dependency); the terrain group is hidden until manage_tools " +
+        "activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["tree_prototype_index", "instances", "paths_hint"],
+        properties: {
+            ...targetSchema,
+            tree_prototype_index: {
+                type: "integer",
+                minimum: 0,
+                description: "Tree prototype index. When >= the terrain's current prototype count, " +
+                    "a prototype is seeded from prototype_prefab_path.",
+            },
+            instances: {
+                type: "array",
+                minItems: 1,
+                items: {
+                    type: "object",
+                    properties: {
+                        position: {
+                            type: "string",
+                            description: "Tree position as 'x,z' normalized 0-1 on the terrain surface " +
+                                "(0,0 is one corner, 1,1 the opposite).",
+                        },
+                        height_scale: {
+                            type: "number",
+                            default: 1,
+                            description: "Height multiplier (1 = prototype's authored height).",
+                        },
+                        width_scale: {
+                            type: "number",
+                            default: 1,
+                            description: "Width multiplier (1 = prototype's authored width).",
+                        },
+                        rotation: {
+                            type: "number",
+                            default: 0,
+                            description: "Rotation around Y in degrees.",
+                        },
+                    },
+                    required: ["position"],
+                    additionalProperties: false,
+                },
+                description: "Tree instances to place. At least one is required.",
+            },
+            prototype_prefab_path: {
+                type: "string",
+                description: "Assets/.../.prefab path. Required when tree_prototype_index is new " +
+                    "(>= the terrain's current prototype count); the prefab's GameObject " +
+                    "becomes the prototype.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=terrain-place-trees.js.map

package/dist/tools/terrain-place-trees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-place-trees.js","sourceRoot":"","sources":["../../src/tools/terrain-place-trees.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,wEAAwE;AACxE,qCAAqC;AACrC,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,iEAAiE;KAC/E;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wDAAwD;KACtE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uEAAuE;KACrF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,kEAAkE;KAChF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,wEAAwE;QACxE,mEAAmE;QACnE,2DAA2D;QAC3D,4EAA4E;QAC5E,iEAAiE;QACjE,4EAA4E;QAC5E,6EAA6E;QAC7E,0EAA0E;QAC1E,eAAe;IACjB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,sBAAsB,EAAE,WAAW,EAAE,YAAY,CAAC;QAC7D,UAAU,EAAE;YACV,GAAG,YAAY;YACf,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,uEAAuE;oBACvE,mDAAmD;aACtD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,+DAA+D;gCAC/D,wCAAwC;yBAC3C;wBACD,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,sDAAsD;yBACpE;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,oDAAoD;yBAClE;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,OAAO,EAAE,CAAC;4BACV,WAAW,EAAE,+BAA+B;yBAC7C;qBACF;oBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;oBACtB,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,WAAW,EAAE,oDAAoD;aAClE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qEAAqE;oBACrE,sEAAsE;oBACtE,wBAAwB;aAC3B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/terrain-set-heights.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const terrainSetHeights: Tool;

package/dist/tools/terrain-set-heights.js

@@ -0,0 +1,68 @@
+// M20 Plan 4 / T20.4 — Terrain domain tool. Set a heightmap region from a 2D
+// array of normalized 0-1 values. Built-in Terrain module — ungated. Mutating:
+// runs the full gate path; paths_hint is the host scene path. Param shape:
+// xBase / yBase + 2D heights. The 2D array is row-major
+// [[r0c0,r0c1,...],[r1c0,...],...].
+const targetSchema = {
+    instance_id: {
+        type: "integer",
+        default: 0,
+        description: "Host Terrain GameObject instance ID. Highest priority resolver.",
+    },
+    path: {
+        type: "string",
+        description: "Host Terrain GameObject hierarchy path \"Root/Child\".",
+    },
+    name: {
+        type: "string",
+        description: "Host Terrain GameObject name (first match). Lowest priority resolver.",
+    },
+    paths_hint: {
+        type: "array",
+        items: { type: "string" },
+        description: "Mutation scope — the host scene path. No whole-project fallback.",
+    },
+    gate: {
+        enum: ["enforce", "warn", "off"],
+        default: "enforce",
+    },
+};
+export const terrainSetHeights = {
+    name: "unity_open_mcp_terrain_set_heights",
+    description: "Set a heightmap region. heights is a row-major 2D JSON array of normalized " +
+        "0-1 values ([[r0c0,r0c1,...],[r1c0,...],...]); x_offset / y_offset position " +
+        "the region inside the heightmap. Arrays larger than 513x513 per call are " +
+        "refused — write in tiles via repeated calls with different offsets instead. " +
+        "Mutating: runs the full gate path; paths_hint is the host scene path. Built-in " +
+        "Terrain module (no package dependency); the terrain group is hidden until " +
+        "manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["heights", "paths_hint"],
+        properties: {
+            ...targetSchema,
+            x_offset: {
+                type: "integer",
+                default: 0,
+                description: "Start X index in the heightmap for the region write.",
+            },
+            y_offset: {
+                type: "integer",
+                default: 0,
+                description: "Start Y index in the heightmap for the region write.",
+            },
+            heights: {
+                type: "array",
+                items: {
+                    type: "array",
+                    items: { type: "number" },
+                },
+                description: "Row-major 2D array of normalized 0-1 height values. Each row must have " +
+                    "the same length. The array shape defines the region size. Capped at " +
+                    "513x513 per call — tile large writes via x_offset / y_offset.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=terrain-set-heights.js.map

package/dist/tools/terrain-set-heights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-set-heights.js","sourceRoot":"","sources":["../../src/tools/terrain-set-heights.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAC3E,wDAAwD;AACxD,oCAAoC;AACpC,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,iEAAiE;KAC/E;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wDAAwD;KACtE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uEAAuE;KACrF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,kEAAkE;KAChF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,6EAA6E;QAC7E,8EAA8E;QAC9E,2EAA2E;QAC3E,8EAA8E;QAC9E,iFAAiF;QACjF,4EAA4E;QAC5E,4BAA4B;IAC9B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;QACnC,UAAU,EAAE;YACV,GAAG,YAAY;YACf,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,sDAAsD;aACpE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,sDAAsD;aACpE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,WAAW,EACT,yEAAyE;oBACzE,sEAAsE;oBACtE,+DAA+D;aAClE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/terrain-set-neighbors.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const terrainSetNeighbors: Tool;