Skip to content
OpenTS Manual

52 — Change Light Behavior

Sets the sweep 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 walks every structure in the scenario and applies the behavior to each one that clears all of these, in this order:

  1. It has strength remaining.
  2. It is active.
  3. It has been put down on the map.
  4. It is not in limbo.
  5. Its type sets HasSpotlight=yes.
  6. It has a beam of its own.
  7. It carries a tag.
  8. That tag is attached to this trigger.

One firing can therefore redirect several separately tagged spotlights at once, and the action reports success only if at least one structure cleared the whole list.

Valid values

  • Any spotlight behavior. The figure is stored on each beam as given, with no range check.
Caveats
  • The action sweeps every structure in the scenario and changes each one whose tag is attached to the same trigger; it is not limited to the structure that sprang it.
  • Nothing forces the trigger to be attached to an object, and one that reaches no tagged spotlight structure simply changes nothing. Nothing anywhere notices that it did not, because the result each line returns is gathered as the trigger runs and then dropped when the tag has finished with it.
  • Every behavior, including one repeating the beam's current mode, resets the angle the beam has swung through to zero, so a sweeping beam snaps back to the middle of its arc and a circling one back to where it begins its turn.
  • Asking for the follow behavior picks a target out of the nine cells around where the beam is standing at that moment. Where none of them holds a hostile soldier or vehicle, the beam keeps whatever target it had before.