light_skill

Overview

This skill creates and configures lights inside Unity scenes, and provides single-object and batch operations for common lighting tasks. It supports Directional, Point, Spot, and Area light types and returns useful identifiers for further automation. Use batch variants when modifying two or more lights to reduce API calls and improve performance.

How this skill works

You can create lights, query existing lights, toggle enable state, and set properties like color, intensity, range, spot angle, and shadow mode. Each operation accepts either a name or an instanceId (instanceId is preferred) and batch endpoints accept an items array to apply changes in a single call. Responses include identifiers and current settings so you can chain actions reliably.

When to use it

• Create new lights for scene setup or procedural generation
• Adjust visual properties (color, intensity, range) during runtime or setup
• Enable/disable multiple lights quickly (use batch for 2+ lights)
• Query existing lights to inspect configuration or build UI tools
• Apply consistent changes to many lights for optimization or theme shifts

Best practices

• Prefer instanceId when available to avoid ambiguity with duplicate names
• Always use *_batch skills when modifying two or more lights to minimize API calls
• Limit real-time shadow usage for performance; use soft/hard selectively
• Use Directional for main global illumination and Point/Spot for local sources
• Remember Area lights require light baking and are not real-time

Example use cases

• Create a sun directional light for outdoor scenes with soft shadows
• Spawn and configure ceiling point lights for an indoor environment
• Turn off all torches in a level using light_set_enabled_batch
• Bulk-adjust intensity and color of multiple lights to switch day/night mood
• Find all spot lights to audit shadow settings with light_find_all