Skip to content
OpenTS Manual

52 — Change Light Behavior

Sets the light behavior of every spotlight-casting structure whose tag is attached to this trigger.

Editor data
Numeric ID
52
Engine ID
TACTION_CHANGE_SPOTLIGHT_BEHAVIOR
Editor name
Change Light Behavior
Need token
NEED_LIGHT_BEHAVIOR
Parameters
  1. Spotlight behaviorspotlight-behavior
Attachment
none
INI example
[Actions]
<TriggerID>=1,52,0,<Spotlight behavior>,0,0,0,0,

What is changed

Section titled “What is changed”

The action applies the behavior to every structure that meets all of these conditions:

  • It has strength remaining.
  • It is active, placed on the map and not in limbo.
  • Its type sets HasSpotlight=yes, and it has a beam.
  • It carries a tag, and that tag holds this trigger, alone or in a linked chain.

Valid values

  • One of the four [spotlight behaviors](/reference/enums/spotlight-behavior/). Any other value is accepted and leaves the beam drawn but motionless.
Caveats
  • The action changes every qualifying structure on the map, not only the structure that sprang the trigger. If no structure qualifies, nothing changes.
  • Every behavior restarts the beam's swing, even one the beam already has. A sweeping beam jumps back to the middle of its arc, and a circling beam jumps back to where its circle starts.
  • Follow aims the beam at the nearest non-allied infantry or vehicle in the beam's cell or the eight cells around it. If none is there, the beam keeps any target it already had. The beam goes back to sweeping on its next update if it has no target, or if its target is gone or [SpotlightMovementRadius](/keys/spotlightmovementradius/) or farther from the structure.