# Play Soundtrack

Grammar — Play category soundtrackID|Soundtrack (index) for players (with cue cue) and makeDefault make default
FlagsNative | Action

Plays a soundtrack for the specified player group. If the Make Default parameter is set to Do, then the default soundtrack will be set to this soundtrack. If this soundtrack is not continuous, it will repeat from the beginning when it ends, after the delay time.

# Arguments

  • playergroup — Players
  • int [ preset::SoundtrackCategory ] — Category
  • string [ gamelink::Soundtrack ] — Soundtrack ID
  • int — Cue
  • int — Index
  • bool [ preset::Do_Do_Not_Option ] — Make Default

Returns — void

native void SoundtrackPlay(
	playergroup players,
	int category,
	string soundtrack,
	int cue,
	int index,
	bool makeDefault,
);

Category: Sound / Soundtracks

# Examples

# campaigns/liberty.sc2campaign

MapScript.galaxy

// L594
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicGameLoop", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L3198
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicBossFightIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3208
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicBossFightLoop", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4092
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicLevelStartIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4753
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicBossKilled", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5264
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicBossKilled", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5746
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicBossKilled", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L8868
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "LostViking_MusicVictory", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L895
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2288
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4116
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Hanson01Night", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6336
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1486
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1488
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicMain", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L1489
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Meinhoff", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1509
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1511
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L1512
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Hanson02Night", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2616
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicSwann", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5402
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1122
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1157
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5036
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicEventC", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6661
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3516
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03BMusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4540
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03BMusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L807
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3587
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3597
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3607
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3617
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3627
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3638
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3648
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5927
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L939
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner02MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5487
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner02MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5757
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner02MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L533
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner03MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1213
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner03MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L3474
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner03MusicSwann", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5522
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner03MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5864
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner03MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2809
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner04MusicSwann", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5409
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner04MusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6348
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner04MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6618
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner04MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L7127
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner04MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2951
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3865
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4689
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5130
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5485
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventE", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5625
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L11299
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L11636
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L12013
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventC", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L12223
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner05SMusicEventD", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L575
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor01MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1771
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5582
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor01MusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5822
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor01MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L610
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor02MusicMain", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L4922
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor02MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L881
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicMain2", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L999
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1447
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicMain3", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L3505
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicMain3", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5194
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L17788
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "EasterEggMusic_TerranUpTheNight", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L28655
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor01MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L28790
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor02MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L28930
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TRaynor03MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29100
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29250
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29468
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29478
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03AMusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29642
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson03BMusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L29807
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THorner01MusicBriefing", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2770
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh01MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5216
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh01MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1263
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh02MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L4292
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh02MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L390
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03AMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2098
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03AMusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2469
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03AMusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5298
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03AMusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2698
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03BMusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5995
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03BMusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6276
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03BMusicEventC", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L6498
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTosh03BMusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1597
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus01MusicSwann", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L1845
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus01MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L5088
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus01MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5218
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus02MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L5435
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus02MusicMain", c_soundtrackCueAny, c_soundtrackIndexAny, true)
// L5797
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus02MusicOutro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L960
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus03MusicIntro", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2888
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus03MusicEventA", c_soundtrackCueAny, c_soundtrackIndexAny, false)
// L2928
SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "TTychus03MusicEventB", c_soundtrackCueAny, c_soundtrackIndexAny, false)