set_light_linking
Limit which objects a light illuminates or which objects cast its shadows by setting an include or exclude object list; use an empty list to restore full lighting.
Instructions
Limit which objects a light lights, or which objects block its shadows.
Classic uses: a rim light that touches only the hero, or a fill light that skips the background. Replaces the light's list each call; an empty list removes the link so the light affects everything again.
Args: light_name: The light (or emissive object). objects: Objects in the link list, at most 1000. role: RECEIVERS (objects the light lights) or BLOCKERS (objects that cast its shadows). mode: INCLUDE (only these) or EXCLUDE (everything except these).
Returns: Dict with the light, the link collection and its objects.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"light_name": "<light_name>",
"objects": "<objects>"
},
"name": "set_light_linking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | INCLUDE | |
| role | No | RECEIVERS | |
| objects | Yes | ||
| light_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||