# Enable/Disable Soundtrack Continuous

Grammar — Set category soundtrack to play continuous for players
Flags — Native | Action

Sets a soundtrack to play once or play continuously.

# Arguments

playergroup — Players
int<preset::SoundtrackCategory> — Category
bool<preset::ContinuouslyOnceOption> — Continuous

Returns — void

native void SoundtrackSetContinuous(
	playergroup players,
	int category,
	bool continuous,
);

Category: Sound / Soundtracks

Play Soundtrack — void — SoundtrackPlay
Pause Soundtrack — void — SoundtrackPause
Stop Soundtrack (Current) — void — SoundtrackStopCurrent
Stop Soundtrack (Current & Queued) — void — SoundtrackStop
Wait For Soundtrack — void — SoundtrackWait
Set Default Soundtrack — void — SoundtrackDefault
Enable/Disable Soundtrack Continuous — void — SoundtrackSetContinuous
Set Soundtrack Delay — void — SoundtrackSetDelay
Enable/Disable Soundtrack Shuffle — void — SoundtrackSetShuffle

# Examples

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/thanson02.sc2map/MapScript.galaxy:1490

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicMain", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Meinhoff", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    return true;
}

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/thanson02.sc2map/MapScript.galaxy:1513

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Hanson02Night", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    return true;
}

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tstory01.sc2map/MapScript.galaxy:16768


    SoundtrackDefault(PlayerGroupAll(), c_soundtrackCategoryMusic, null, c_soundtrackCueAny, c_soundtrackIndexAny);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    gf_TurnMarSaraBarBackgroundSoundOnOff(false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tstory01.sc2map/MapScript.galaxy:16769

    SoundtrackDefault(PlayerGroupAll(), c_soundtrackCategoryMusic, null, c_soundtrackCueAny, c_soundtrackIndexAny);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    gf_TurnMarSaraBarBackgroundSoundOnOff(false);
    gf_TurnLabBackgroundSoundOnOff(false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tzeratul01.sc2map/MapScript.galaxy:9901

    GameSetBackground(c_backgroundFixed, "VC_Zeratul1_Sky", 100.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Aiur", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    auto9AB25090_g = UnitGroup(null, c_playerAny, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0);
    auto9AB25090_u = UnitGroupCount(auto9AB25090_g, c_unitCountAll);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tzeratul03.sc2map/MapScript.galaxy:5248

    GameSetToDLighting("AiurFlashback");
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Char", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    CameraApplyInfo(gv_p01_USER, CameraInfoFromId(571), 0.0, -1, 10, true);
    libNtve_gf_CreateUnitsWithDefaultFacing(1, "Overmind", c_unitCreateIgnorePlacement, gv_p05_ZERG_LOW_GROUND_NOAI, PointFromId(230));

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tzeratul03.sc2map/MapScript.galaxy:5417

    GameSetBackground(c_backgroundTerrain, "BraxisAlphaSkyParallax", 100.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_BraxisAlpha", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    libNtve_gf_PlayAnimationOnDoodadsInRegion(RegionEntireMap(), "RainEmitterMedium", c_animNameDefault, "Death", c_animFlagNonLooping, c_animTimeDefault);
    CameraApplyInfo(gv_p01_USER, CameraInfoFromId(624), 0.0, -1, 10, true);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tzeratul03.sc2map/MapScript.galaxy:5493

    UnitSetHeight(gv_victoryTassadarS1, 0.0, 25.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Aiur", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    EnvironmentShow(c_environmentAll, true);
    libNtve_gf_PlayAnimationOnDoodadsInRegion(RegionEntireMap(), "RainEmitterMedium", c_animNameDefault, "Stand", 0, c_animTimeDefault);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/thanson02.sc2map — MapScript.galaxy:1490

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson01MusicMain", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Meinhoff", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    return true;
}

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/thanson02.sc2map — MapScript.galaxy:1513

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, "THanson02MusicAlt", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Hanson02Night", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    return true;
}

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tstory01.sc2map — MapScript.galaxy:16768


    SoundtrackDefault(PlayerGroupAll(), c_soundtrackCategoryMusic, null, c_soundtrackCueAny, c_soundtrackIndexAny);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    gf_TurnMarSaraBarBackgroundSoundOnOff(false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tstory01.sc2map — MapScript.galaxy:16769

    SoundtrackDefault(PlayerGroupAll(), c_soundtrackCategoryMusic, null, c_soundtrackCueAny, c_soundtrackIndexAny);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    gf_TurnMarSaraBarBackgroundSoundOnOff(false);
    gf_TurnLabBackgroundSoundOnOff(false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tzeratul01.sc2map — MapScript.galaxy:9901

    GameSetBackground(c_backgroundFixed, "VC_Zeratul1_Sky", 100.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Aiur", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    auto9AB25090_g = UnitGroup(null, c_playerAny, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0);
    auto9AB25090_u = UnitGroupCount(auto9AB25090_g, c_unitCountAll);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tzeratul03.sc2map — MapScript.galaxy:5248

    GameSetToDLighting("AiurFlashback");
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Char", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    CameraApplyInfo(gv_p01_USER, CameraInfoFromId(571), 0.0, -1, 10, true);
    libNtve_gf_CreateUnitsWithDefaultFacing(1, "Overmind", c_unitCreateIgnorePlacement, gv_p05_ZERG_LOW_GROUND_NOAI, PointFromId(230));

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tzeratul03.sc2map — MapScript.galaxy:5417

    GameSetBackground(c_backgroundTerrain, "BraxisAlphaSkyParallax", 100.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_BraxisAlpha", c_soundtrackCueAny, c_soundtrackIndexAny, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    libNtve_gf_PlayAnimationOnDoodadsInRegion(RegionEntireMap(), "RainEmitterMedium", c_animNameDefault, "Death", c_animFlagNonLooping, c_animTimeDefault);
    CameraApplyInfo(gv_p01_USER, CameraInfoFromId(624), 0.0, -1, 10, true);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tzeratul03.sc2map — MapScript.galaxy:5493

    UnitSetHeight(gv_victoryTassadarS1, 0.0, 25.0);
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryAmbience, "Ambience_Aiur", c_soundtrackCueAny, c_soundtrackIndexAny, true);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, true);
    EnvironmentShow(c_environmentAll, true);
    libNtve_gf_PlayAnimationOnDoodadsInRegion(RegionEntireMap(), "RainEmitterMedium", c_animNameDefault, "Stand", 0, c_animTimeDefault);

campaigns/swarmstoryutil.sc2mod — base.sc2data/Lib281DEC45.galaxy:237

    GameSetSpeedLocked(true);
    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    lib281DEC45_gv_zSS_CurrentMap = lp_map;

campaigns/swarmstoryutil.sc2mod — base.sc2data/Lib281DEC45.galaxy:238

    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    lib281DEC45_gv_zSS_CurrentMap = lp_map;
    libSwaC_gf_RegisterStoryEvent(libSwaC_ge_ZS_Event_CampaignDataReset, lib281DEC45_gt_ZSS_ResetStoryData);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignStoryLib.galaxy:611

    GameSetSpeedLocked(true);
    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    libVoiC_gf_RegisterCampaignEvent(libVoiC_ge_PC_Event_CampaignDataReset, libVCST_gt_PS_EventCampaignResetData);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignStoryLib.galaxy:612

    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    libVoiC_gf_RegisterCampaignEvent(libVoiC_ge_PC_Event_CampaignDataReset, libVCST_gt_PS_EventCampaignResetData);
    libVoiC_gf_RegisterCampaignEvent(libVoiC_ge_PC_Event_CampaignMapTransition, libVCST_gt_PS_SaveStoryDataCallback);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCST.galaxy:543

    GameSetSpeedLocked(true);
    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    libComC_gf_CC_EventRegister(libNovC_ge_NC_Event_CampaignDataReset, libNCST_gt_NS_EventCampaignResetData);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCST.galaxy:544

    GameSetQuitOnQuitButton(false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryMusic, false);
    SoundtrackSetContinuous(PlayerGroupAll(), c_soundtrackCategoryAmbience, false);
    libComC_gf_CC_EventRegister(libNovC_ge_NC_Event_CampaignDataReset, libNCST_gt_NS_EventCampaignResetData);
    libComC_gf_CC_EventRegister(libNovC_ge_NC_Event_CampaignMapTransition, libNCST_gt_NS_SaveStoryDataCallback);

# Enable/Disable Soundtrack Continuous

# Arguments

# Related

# Examples