Skip to content
OpenTS Manual

20 — Play music theme...

Queues a music track, which starts once the current track has faded out, or at once with a crossfade.

Editor data
Numeric ID
20
Engine ID
TACTION_PLAY_MUSIC
Editor name
Play music theme...
Need token
NEED_THEME
Parameters
  1. Themetheme
Attachment
none
INI example
[Actions]
<TriggerID>=1,20,0,<Theme>,0,0,0,0,
Caveats
  • The track does not start when the trigger fires. The current track fades out first, and the queued track starts on the first update after the fade ends. With [CrossFade=](/keys/crossfade/) set, the queued track starts on the next update and fades in while the current track fades out.
  • Only one track can wait at a time. While a queued track is still waiting, a second Play music theme action is ignored, so of two such actions in one trigger only the first plays.
  • When the queued track ends, the game chooses the next track as it does after any track. A track with [Repeat=yes](/keys/repeat/), or any track while the player's repeat option is on, plays again.
  • Nothing is queued and nothing fades while the music volume is zero, or when the game found no music files.
  • The action has no effect after the player presses Stop on the sound options screen, except during an ion storm that plays the storm track. [Changing tracks](/systems/music/#changing-tracks) says when that ends.