Skip to content
OpenTS Manual

17 — Change script...

Gives the team a fresh copy of another Script and leaves the team idle before its first line.

Editor data
Numeric ID
17
Engine ID
TMISSION_SCRIPT
Editor name
Change script...
Need token
NEED_SCRIPT
Parameters
  1. Scriptscript

Why the new Script does not start

Section titled “Why the new Script does not start”

A team moves to its next Script line only when the current line raises its advance flag, and this line never raises it. This line leaves the team before the first line of the new Script. No line runs from there, so the team does nothing on every later turn.

The one way the new Script runs

Section titled “The one way the new Script runs”

The team runs the new Script only after it is sent back to regroup and starts again. It then runs the new Script from its first line.

A team is sent back to regroup when it drops under strength after starting. A Reinforce=no team is never under strength once it has started, so only a Reinforce=yes team can ever run the new Script.

Finding a Script’s number

Section titled “Finding a Script’s number”

A Script’s number can differ from its place under [ScriptTypes]. Scripts are numbered in the order the game first reads their names:

  1. Each Script that a TeamType’s Script= names, in the order the TeamTypes are read. TeamTypes are read from AI.INI, then from AIFS.INI when Firestorm is enabled, then from the map, each file in its [TeamTypes] order.
  2. Each remaining Script listed under [ScriptTypes], in the same file order.

A Script named again later keeps the number it was first given.

Valid values

  • A Script's position in the game's list of [Scripts](/mapping/scripts/), counted from 0. [Finding a Script's number](#finding-a-scripts-number) gives the order of that list. The team gets its own copy, so other teams running the same Script are unaffected. A number past the end of the list can crash the game.
Caveats
  • The new Script does not start on its own. The team stays idle, before the first line of the new Script, until it regroups as described below or is deleted.
  • The team keeps its members, and they keep whatever orders the previous lines gave them.
  • The previous Script is discarded, and nothing records the line the team had reached.