Files
2026-06-30 22:12:46 +08:00

2.8 KiB

name, description
name description
assets-move Move or rename assets at the given project paths. Refreshes the AssetDatabase at the end. Use 'assets-find' to locate the assets first.

Assets / Move

Move the assets at paths in the project. Should be used for asset rename. Does AssetDatabase.Refresh() at the end. Use 'assets-find' tool to find assets before moving.

Inputs

  • sourcePaths — paths of the assets to move.
  • destinationPaths — target paths (must match sourcePaths length).

Behavior

Each pair is moved independently via AssetDatabase.MoveAsset. Per-pair failures (Unity's MoveAsset returns a non-empty error string) are surfaced in response.Errors; successful moves accumulate into response.MovedPaths.

How to Call

unity-mcp-cli run-tool assets-move --input '{
  "sourcePaths": "string_value",
  "destinationPaths": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool assets-move --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool assets-move --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Name Type Required Description
sourcePaths any Yes The paths of the assets to move.
destinationPaths any Yes The paths of moved assets.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "sourcePaths": {
      "$ref": "#/$defs/System.String-1"
    },
    "destinationPaths": {
      "$ref": "#/$defs/System.String-1"
    }
  },
  "$defs": {
    "System.String-1": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "sourcePaths",
    "destinationPaths"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/AIGD.MoveAssetsResponse"
    }
  },
  "$defs": {
    "System.Collections.Generic.List(System.String)": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "AIGD.MoveAssetsResponse": {
      "type": "object",
      "properties": {
        "MovedPaths": {
          "$ref": "#/$defs/System.Collections.Generic.List(System.String)",
          "description": "List of destination paths of successfully moved assets."
        },
        "Errors": {
          "$ref": "#/$defs/System.Collections.Generic.List(System.String)",
          "description": "List of errors encountered during move operations."
        }
      }
    }
  },
  "required": [
    "result"
  ]
}