IN THIS ARTICLE
Find by Name
Find by Name
Finds and returns the material with the specified name. The material must be loaded into memory in order to be found.
In some cases, the Find by Name node might not find the material as expected.
Example
You have an entity named
Cratethat has a material file namedcrate.mtl.In your script, you use the Find by Name node to access the
crate.mtlfile. You want to trigger the node when the graph starts with the On Graph Start node. However, it’s possible that the Find by Name node can’t load the material immediately. It might take additional frames before the entity finishes loading the material file.In this example, you can use one of the following nodes to detect when the
Crateentity finishes loading thecrate.mtlfile:- Use the Load by Name node instead of the Find by Name node.
- Use the On Ready node instead of the On Graph Start node.
In some cases, you might need to store the material for later use. For more information, see Material Variables.
Contents

Inputs
| Pin | Type | Description |
|---|---|---|
| In | Event | Triggers the node. |
| Material Name | String | The path name of a material to find. For more information, see Finding the Material Name. |
Outputs
| Pin | Type | Description |
|---|---|---|
| Out | Event | Sends when the node is finished. |
| Material | Material | The material that was found. Returns Invalid if the material is not found. |