Command · material
material.rename
Rename a value while retaining its graph identity and layout.
scope edit:scenenot idempotentnon-destructive
Params
Typed as MaterialRenameParams. Fields marked * are required.
from*
stringExisting authored name.
required
to*
stringNew unique authored name.
required
restoreId
option<string>Diagnostic-only recovery identity after a plain-text delete/create rename.
default null
Examples
JSON (MCP ara_apply, batches)
{
"cmd": "material.rename",
"args": {
"from": "paint",
"to": "basePaint"
}
}CLI
ara do material.rename --args '{"from":"paint","to":"basePaint"}' --why "…"