editor_toolset.toolsets.material.MaterialTools¶
Provides tools for creating and editing Material and MaterialFunction assets.
22 tool(s).
editor_toolset.toolsets.material.MaterialTools.add_expression¶
Adds a new expression node to a Material or MaterialFunction graph.
Use list_expression_classes to discover available types.
Args:
material_or_function: The Material or MaterialFunction to add the expression to.
expression_class: The type of expression node to create.
x: Horizontal position in the graph editor.
y: Vertical position in the graph editor.
Returns:
The newly created MaterialExpression node.
Input schema
{
"properties": {
"expression_class": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Class",
"type": "object"
},
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
},
"x": {
"default": 0,
"type": "integer"
},
"y": {
"default": 0,
"type": "integer"
}
},
"required": [
"material_or_function",
"expression_class"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.connect_expressions¶
Connects an expression node's output pin to another expression node's input pin.
Args:
from_expression: The expression providing the output value.
from_output_name: The output pin name. Pass an empty string to use the
default (first) output.
to_expression: The expression receiving the input.
to_input_name: The input pin name to connect to. Use get_expression_input_names
to discover valid names.
Input schema
{
"properties": {
"from_expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"from_output_name": {
"type": "string"
},
"to_expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"to_input_name": {
"type": "string"
}
},
"required": [
"from_expression",
"from_output_name",
"to_expression",
"to_input_name"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.connect_to_output¶
Connects an expression node's output to one of the material's output properties.
Args:
expression: The expression whose output will drive the property.
output_name: The output pin name. Pass an empty string to use the
default (first) output.
material_property: The material output property to connect to.
Input schema
{
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"material_property": {
"enum": [
"MP_EmissiveColor",
"MP_Opacity",
"MP_OpacityMask",
"MP_DiffuseColor",
"MP_SpecularColor",
"MP_BaseColor",
"MP_Metallic",
"MP_Specular",
"MP_Roughness",
"MP_Anisotropy",
"MP_Normal",
"MP_Tangent",
"MP_WorldPositionOffset",
"MP_WorldDisplacement_DEPRECATED",
"MP_TessellationMultiplier_DEPRECATED",
"MP_SubsurfaceColor",
"MP_CustomData0",
"MP_CustomData1",
"MP_AmbientOcclusion",
"MP_Refraction",
"MP_CustomizedUVs0",
"MP_CustomizedUVs1",
"MP_CustomizedUVs2",
"MP_CustomizedUVs3",
"MP_CustomizedUVs4",
"MP_CustomizedUVs5",
"MP_CustomizedUVs6",
"MP_CustomizedUVs7",
"MP_PixelDepthOffset",
"MP_ShadingModel",
"MP_FrontMaterial",
"MP_SurfaceThickness",
"MP_Displacement",
"MP_MaterialAttributes",
"MP_CustomOutput",
"MP_LastCustomizedUVs",
"MP_NumCustomizedUVs"
],
"title": "EMaterialProperty",
"type": "string"
},
"output_name": {
"type": "string"
}
},
"required": [
"expression",
"output_name",
"material_property"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.create_function¶
Creates a new empty MaterialFunction asset.
Args:
folder_path: The content-browser path to the folder for the new asset.
asset_name: The name of the new asset.
Returns:
The newly created MaterialFunction.
Input schema
{
"properties": {
"asset_name": {
"type": "string"
},
"folder_path": {
"type": "string"
}
},
"required": [
"folder_path",
"asset_name"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialFunction",
"type": "object"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.create_material¶
Creates a new empty Material asset.
Warning: Each new Material increases shader compile times. Prefer creating
a MaterialInstance from an existing Material where possible.
Args:
folder_path: The content-browser path to the folder for the new asset.
asset_name: The name of the new asset.
Returns:
The newly created Material.
Input schema
{
"properties": {
"asset_name": {
"type": "string"
},
"folder_path": {
"type": "string"
}
},
"required": [
"folder_path",
"asset_name"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.Material",
"type": "object"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.create_parameter_collection¶
Creates a new empty MaterialParameterCollection (MPC) asset.
An MPC holds named Scalar and Vector parameters with default values
that materials can reference at runtime without recompiling shaders.
Args:
folder_path: The content-browser path to the folder for the new asset.
asset_name: The name of the new asset.
Returns:
The newly created MaterialParameterCollection.
Input schema
{
"properties": {
"asset_name": {
"type": "string"
},
"folder_path": {
"type": "string"
}
},
"required": [
"folder_path",
"asset_name"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialParameterCollection",
"type": "object"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.delete_expression¶
Removes an expression node from a Material or MaterialFunction graph.
Args:
material_or_function: The Material or MaterialFunction that owns the expression.
expression: The expression node to remove.
Input schema
{
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function",
"expression"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.delete_parameter_group¶
Removes a parameter group, ungrouping all parameters that belong to it.
The parameter expressions themselves are not deleted - only their group assignment
is cleared.
Note: triggers an internal recompile; no separate call to recompile/update is needed.
Args:
material_or_function: The Material or MaterialFunction to modify.
group_name: The name of the group to delete.
Input schema
{
"properties": {
"group_name": {
"type": "string"
},
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function",
"group_name"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.delete_unused_expressions¶
Deletes all expression nodes not connected to any material output.
Useful for cleaning up a material graph after reorganising or after the AI
has added experimental nodes that were later abandoned.
Note: triggers no recompile - call recompile() afterwards if needed.
Args:
material: The Material to clean up.
Input schema
{
"properties": {
"material": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.Material",
"type": "object"
}
},
"required": [
"material"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.disconnect_expressions¶
Disconnects the input pin of an expression node, removing whatever is connected to it.
Args:
to_expression: The expression whose input pin should be disconnected.
to_input_name: The input pin name to disconnect. Use get_expression_input_names
to discover valid names. Pass an empty string to disconnect the first input.
Input schema
{
"properties": {
"to_expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"to_input_name": {
"type": "string"
}
},
"required": [
"to_expression",
"to_input_name"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.disconnect_from_output¶
Disconnects the expression currently connected to a material output property.
Args:
material: The Material to modify.
material_property: The material output property to disconnect.
Input schema
{
"properties": {
"material": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.Material",
"type": "object"
},
"material_property": {
"enum": [
"MP_EmissiveColor",
"MP_Opacity",
"MP_OpacityMask",
"MP_DiffuseColor",
"MP_SpecularColor",
"MP_BaseColor",
"MP_Metallic",
"MP_Specular",
"MP_Roughness",
"MP_Anisotropy",
"MP_Normal",
"MP_Tangent",
"MP_WorldPositionOffset",
"MP_WorldDisplacement_DEPRECATED",
"MP_TessellationMultiplier_DEPRECATED",
"MP_SubsurfaceColor",
"MP_CustomData0",
"MP_CustomData1",
"MP_AmbientOcclusion",
"MP_Refraction",
"MP_CustomizedUVs0",
"MP_CustomizedUVs1",
"MP_CustomizedUVs2",
"MP_CustomizedUVs3",
"MP_CustomizedUVs4",
"MP_CustomizedUVs5",
"MP_CustomizedUVs6",
"MP_CustomizedUVs7",
"MP_PixelDepthOffset",
"MP_ShadingModel",
"MP_FrontMaterial",
"MP_SurfaceThickness",
"MP_Displacement",
"MP_MaterialAttributes",
"MP_CustomOutput",
"MP_LastCustomizedUVs",
"MP_NumCustomizedUVs"
],
"title": "EMaterialProperty",
"type": "string"
}
},
"required": [
"material",
"material_property"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_expression_input_names¶
Returns the names of all input pins on a material expression node.
Use these names as to_input_name when calling connect_expressions.
Args:
expression: The expression node to query.
Returns:
The input pin names available on the expression.
Input schema
{
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
}
},
"required": [
"expression"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_expression_inputs¶
Returns the current wiring of each input pin on a material expression.
Use after building or modifying a graph to verify the wiring matches
expectations.
Args:
material_or_function: The Material or MaterialFunction that owns the expression.
expression: The expression whose input wiring to read.
Returns:
One entry per input pin, in declaration order matching
get_expression_input_names. The expression field is None for
unwired pins.
Input schema
{
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function",
"expression"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"input_name": {
"type": "string"
},
"output_name": {
"type": "string"
}
},
"required": [
"output_name",
"expression",
"input_name"
],
"title": "MaterialInputSource",
"type": "object"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_expression_output_names¶
Returns the names of all output pins on a material expression node.
Use these names as from_output_name when calling connect_expressions or
connect_to_output. The empty string represents the default (first) output
of nodes that expose only an unnamed output.
Args:
expression: The expression node to query.
Returns:
The output pin names available on the expression.
Input schema
{
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
}
},
"required": [
"expression"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_expressions¶
Returns all expression nodes in a Material or MaterialFunction graph.
Args:
material_or_function: The Material or MaterialFunction to query.
Returns:
All MaterialExpression nodes in the graph.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_property_input¶
Returns the expression and output pin feeding a material output property.
Use to inspect what drives MP_EmissiveColor, MP_Opacity, MP_BaseColor, etc.
Args:
material: The Material to query.
material_property: The material output property.
Returns:
A MaterialInputSource with input_name empty. Its expression field is
None when the output property is disconnected.
Input schema
{
"properties": {
"material": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.Material",
"type": "object"
},
"material_property": {
"enum": [
"MP_EmissiveColor",
"MP_Opacity",
"MP_OpacityMask",
"MP_DiffuseColor",
"MP_SpecularColor",
"MP_BaseColor",
"MP_Metallic",
"MP_Specular",
"MP_Roughness",
"MP_Anisotropy",
"MP_Normal",
"MP_Tangent",
"MP_WorldPositionOffset",
"MP_WorldDisplacement_DEPRECATED",
"MP_TessellationMultiplier_DEPRECATED",
"MP_SubsurfaceColor",
"MP_CustomData0",
"MP_CustomData1",
"MP_AmbientOcclusion",
"MP_Refraction",
"MP_CustomizedUVs0",
"MP_CustomizedUVs1",
"MP_CustomizedUVs2",
"MP_CustomizedUVs3",
"MP_CustomizedUVs4",
"MP_CustomizedUVs5",
"MP_CustomizedUVs6",
"MP_CustomizedUVs7",
"MP_PixelDepthOffset",
"MP_ShadingModel",
"MP_FrontMaterial",
"MP_SurfaceThickness",
"MP_Displacement",
"MP_MaterialAttributes",
"MP_CustomOutput",
"MP_LastCustomizedUVs",
"MP_NumCustomizedUVs"
],
"title": "EMaterialProperty",
"type": "string"
}
},
"required": [
"material",
"material_property"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"properties": {
"expression": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialExpression",
"type": "object"
},
"input_name": {
"type": "string"
},
"output_name": {
"type": "string"
}
},
"required": [
"output_name",
"expression",
"input_name"
],
"title": "MaterialInputSource",
"type": "object"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.get_referencing_materials¶
Returns asset data for all Materials that reference this MaterialFunction.
Args:
material_function: The MaterialFunction to query.
Returns:
Asset data for each Material that uses this function.
Input schema
{
"properties": {
"material_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/Engine.MaterialFunction",
"type": "object"
}
},
"required": [
"material_function"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"properties": {
"assetClass": {
"type": "string"
},
"assetClassPath": {
"description": "The path of the asset's class, e.g. /Script/Engine.StaticMesh",
"properties": {
"assetName": {
"description": "Name of the asset within the package e.g. 'AssetName'",
"type": "string"
},
"packageName": {
"description": "Name of the package containing the asset e.g. /Path/To/Package",
"type": "string"
}
},
"required": [
"packageName",
"assetName"
],
"title": "TopLevelAssetPath",
"type": "object"
},
"assetName": {
"description": "The name of the asset without the package",
"type": "string"
},
"objectPath": {
"type": "string"
},
"packageName": {
"description": "The name of the package in which the asset is found, this is the full long package name such as /Game/Path/Package",
"type": "string"
},
"packagePath": {
"description": "The path to the package in which the asset is found, this is /Game/Path with the Package stripped off",
"type": "string"
}
},
"required": [
"objectPath",
"packageName",
"packagePath",
"assetName",
"assetClass",
"assetClassPath"
],
"title": "AssetData",
"type": "object"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.layout_expressions¶
Automatically arranges all expression nodes in a Material or MaterialFunction graph.
Args:
material_or_function: The Material or MaterialFunction whose graph should be tidied.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.list_expression_classes¶
Returns MaterialExpression subclasses valid for the given context.
Use the results with add_expression. Pass a search string to filter by name,
e.g. 'Multiply' or 'Parameter'.
Args:
material_or_function: The Material or MaterialFunction to filter by context.
search: Optional case-insensitive substring filter on the class path.
Returns:
Matching MaterialExpression subclass paths.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
},
"search": {
"type": "string"
}
},
"required": [
"material_or_function",
"search"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "Class@/Script/CoreUObject.Object",
"type": "object"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.list_parameter_groups¶
Returns the unique parameter group names defined in a Material or MaterialFunction.
Parameters are organised into groups in the Material Instance editor. This returns
the distinct set of group names found across all parameter expressions in the graph.
The empty string represents parameters that have not been assigned to a named group.
Args:
material_or_function: The Material or MaterialFunction to query.
Returns:
A sorted list of unique group names.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function"
],
"type": "object"
}
Output schema
{
"properties": {
"returnValue": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"returnValue"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.recompile¶
Recompiles a Material or MaterialFunction after edits.
For Materials, raises if the shader fails to compile. For MaterialFunctions,
also recompiles any Materials that reference the function.
Call this once after a set of graph modifications is complete - after adding or
deleting expressions, making connections, or changing expression properties such as
parameter names or default values.
Args:
material_or_function: The Material or MaterialFunction to recompile.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
}
},
"required": [
"material_or_function"
],
"type": "object"
}
editor_toolset.toolsets.material.MaterialTools.rename_parameter_group¶
Renames a parameter group across all parameter expressions in a Material or MaterialFunction.
All parameters currently in old_name will be moved to new_name. If new_name
already exists, the parameters are merged into it.
Note: triggers an internal recompile; no separate call to recompile/update is needed.
Args:
material_or_function: The Material or MaterialFunction to modify.
old_name: The current name of the group to rename.
new_name: The new name for the group.
Input schema
{
"properties": {
"material_or_function": {
"description": "Represents a reference to a UObject or UClass.",
"properties": {
"refPath": {
"description": "The reference stored as a soft path string.",
"type": "string"
}
},
"required": [
"refPath"
],
"title": "/Script/CoreUObject.Object",
"type": "object"
},
"new_name": {
"type": "string"
},
"old_name": {
"type": "string"
}
},
"required": [
"material_or_function",
"old_name",
"new_name"
],
"type": "object"
}