Materials check
No Disconnected Shader Nodes
Checks materials for shader nodes that are not connected, directly or indirectly, to an active Material Output node.
Why this check exists
Removes unused node-tree clutter and makes the material graph easier to understand and maintain; disconnected nodes do not affect the active material output.
Behavior
| Module |
materials/no_disconnected_shader_nodes.py
|
|---|---|
| Included with | Core |
| Severity | Warning |
| Automatic fix | No |
| Fix behavior | This check requires manual review or correction. |
| User settings | Yes |
| Selection support | Object |
Settings
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Ignore Muted Nodes |
ignore_muted_nodes
|
bool |
Do not report muted nodes that are disconnected from the Material Output.
|
|
| Ignore Frame Nodes |
ignore_frames
|
bool | True |
Do not report Frame nodes. A Frame is considered used when at least one node inside
it contributes to the output.
|
| Ignore Reroute Nodes |
ignore_reroutes
|
bool |
Do not report disconnected Reroute nodes.
|
|
| Ignore Materials Without Nodes |
ignore_materials_without_nodes
|
bool | True |
Ignore materials that do not have Use Nodes enabled.
|
| Active Outputs Only |
active_outputs_only
|
bool | True |
Only consider active Material Output nodes. When disabled, connections to any
Material Output are considered valid.
|