Skip to content
OpenTS Manual

17 — Change script...

Hands the team a fresh copy of another Script and rewinds it, then leaves the team stopped on this 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”

Each team runs its own cursor over the Script its TeamType names, and a separate advance records that the team should step that cursor on. This line writes a fresh Script over the old one and rewinds the cursor to the position before the first line — the same position a stopped team sits at — and raises nothing.

On the following turn the script step finds no advance outstanding, so it does not step the cursor. It reads the line the cursor is on, and there is none, so it runs nothing at all. That repeats every turn afterward. The team is left holding a script it never opens.

The one way the new Script runs

Section titled “The one way the new Script runs”

Only the start step raises the advance from outside a team mission, and it does that for a team that has been sent back to regroup and has come back to full strength. The regroup step is reachable only by a team that is under strength, and Reinforce=no takes a team out of that condition permanently once it has started, so this route belongs to a Reinforce=yes team alone.

When it fires, the advance steps the cursor from before the first line onto the first line — of the new Script, because that is the one the team now holds. A team knocked about badly enough to regroup therefore does eventually run what this line gave it, from the top.

Valid values

  • A Script the scenario declares. The team takes a fresh copy of it, so a second team running the same Script is unaffected.
Caveats
  • The new Script never runs. The line replaces the Script and rewinds it to before its first line, but does not raise the team's advance, so the following turn finds the team pointing at no line and hands nothing to anything.
  • The team is not stopped or disbanded by this. It keeps its members and keeps whatever orders the previous line gave them, and it stays that way for the rest of the match.
  • Being sent back to regroup and started again is the one route out, and it is open only to a Reinforce=yes team. That restart runs the new Script from its first line.
  • The Script the team was running is discarded outright. Nothing remembers the line it had reached.