# Preload Data Conversation Lines

Grammar — Preload available lines for conversation conversation
Flags — Native | Action

Preloads sound files for all lines available to be run within the given conversation.

# Arguments

string<gamelink::Conversation> — Conversation

Returns — void

native void ConversationDataPreloadLines(string convId);

Category: Conversation / Data Conversation Tools

Mark Data Conversation Choice As Read/Unread — void — ConversationDataChoiceSetState
Mark Data Conversation Choice As Picked/Unpicked — void — ConversationDataChoiceSetPicked
Set Data Conversation Choice Picked Count — void — ConversationDataChoiceSetPickedCount
Set Data Conversation Line Picked Count — void — ConversationDataLineSetPickedCount
Set Data Conversation Line Players — void — ConversationDataLineSetPlayers
Reset Data Conversation Line Players — void — ConversationDataLineResetPlayers
Show/Hide Data Conversation Line For Observers — void — ConversationDataLineHideForObservers
Set Data Conversation Listener Gender — void — ConversationDataSetListenerGender
Save Data Conversation State Value — void — ConversationDataSaveStateValue
Load Data Conversation State Value — void — ConversationDataLoadStateValue
Save Data Conversation State Values — void — ConversationDataSaveStateValues
Load Data Conversation State Values — void — ConversationDataLoadStateValues
Reset Data Conversation State Values — void — ConversationDataResetStateValues
Save Data Conversation Lines And Choices — void — ConversationDataSaveNodeState
Load Data Conversation Lines And Choices — void — ConversationDataLoadNodeState
Reset Data Conversation Lines And Choices — void — ConversationDataResetNodeState
Preload Data Conversation Lines — void — ConversationDataPreloadLines
Preload Data Conversation Lines For Next Map — void — ConversationDataPreloadLinesQueue
Simulate Data Conversation — void — ConversationDataSimulateRun
Data Conversation State — int — ConversationDataStateGetValue
Data Conversation State Count — int — ConversationDataStateIndexCount
Data Conversation State Name — text — ConversationDataStateName
Data Conversation State Custom Value — fixed — ConversationDataStateFixedValue
Data Conversation State Image — string<filepath> — ConversationDataStateImagePath
Data Conversation State Movie — string<filepath> — ConversationDataStateMoviePath
Data Conversation State Model — string<gamelink::Model> — ConversationDataStateModel
Data Conversation State Text — text — ConversationDataStateText
Data Conversation State Text Tag Edge — int<preset::TextTagEdge> — ConversationDataStateImageEdge
Data Conversation State Upgrade — string<gamelink::Upgrade> — ConversationDataStateUpgrade
Data Conversation State Ability Command — abilcmd — ConversationDataStateAbilCmd
Data Conversation State Attachment Point — string<preset::AttachPoints> — ConversationDataStateAttachPoint
Data Conversation Can Be Run — bool — ConversationDataCanRun
Data Conversation Choice Count — int — ConversationDataChoiceCount
Data Conversation Choice Name — string — ConversationDataChoiceId
Data Conversation Choice Picked — bool<preset::PickedState> — ConversationDataChoiceGetPicked
Data Conversation Choice Picked Count — int — ConversationDataChoiceGetPickedCount
Data Conversation Choice State — int<preset::ReplyState> — ConversationDataChoiceGetState
Data Conversation Line Count — int — ConversationDataLineCount
Data Conversation Line Name — string — ConversationDataLineId
Data Conversation Line Picked Count — int — ConversationDataLineGetPickedCount
Data Conversation Lines With Tag
Data Conversation Sound — string<gamelink::Sound> — ConversationDataGetSound
Data Conversation Speaker — string<gamelink::Character> — ConversationDataGetSpeaker
Active Data Conversation Camera — string<convstateindex> — ConversationDataActiveCamera
Active Data Conversation Line — string<convline> — ConversationDataActiveLine
Active Data Conversation Sound — string<gamelink::Sound> — ConversationDataActiveSound
Last Data Conversation Was Skipped — bool — ConversationDataWasSkipped

# Examples

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

    auto6FDC4961_val = libCamp_gf_LastMission();
    if (auto6FDC4961_val == libCamp_ge_MapID_MapTTychus02) {
        ConversationDataPreloadLines("Scriptedsceneslab");
    }
    else {

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

    }
    else {
        ConversationDataPreloadLines("Debriefs");
    }
}

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

    gf_SetWorldMode(ge_WorldMode_WorldModeSubspaceConversation);
    SoundPlay(SoundLink("UI_GenericTransitionEnter_Normal", c_soundIndexAny), PlayerGroupAll(), 100.0, 0.0);
    ConversationDataPreloadLines("CharFidgetsArtifact");
    gf_HotspotZoom(gf_RoomUnit(ge_RoomID_RoomChar), "Zoom_01", "Fly 01", 0.0);
    libNtve_gf_SetAnimationTimeScale(libNtve_gf_MainActorofUnit(gf_RoomUnit(ge_RoomID_RoomChar)), gv_aNIMID_ZOOM, 0.4);

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

    }
    else {
        ConversationDataPreloadLines("LabFidgetsArtifact");
        gf_ResetActorToLocation(ge_ActorID_ActorStetmann, PointFromId(404));
        gf_ResetActorToLocation(ge_ActorID_ActorRaynor, gf_LabRaynorHome());

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


    if ((gv_cantinaState == ge_CantinaStates_Broken)) {
        ConversationDataPreloadLines("CantinaTychus");
        gf_MakeUnitLookAtPointWithDebugControl(gf_ActorUnit(ge_ActorID_ActorRaynor), "InstantHeadOnly", libNtve_gf_PointWithZOffset(UnitGetPosition(gf_ActorUnit(ge_ActorID_ActorTychus)), 0.7));
    }

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorRaynor));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor01_00.ogv", false);
    ConversationDataPreloadLines("TRaynor01Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor02_00.ogv", false);
    ConversationDataPreloadLines("TRaynor02Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor03_00.ogv", false);
    ConversationDataPreloadLines("TRaynor03Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_thanson01_00.ogv", false);
    ConversationDataPreloadLines("THanson01Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorHanson));
    PreloadMovie("Assets\\Textures\\video_briefingportrait_thanson02.ogv", false);
    ConversationDataPreloadLines("THanson02Briefing");
    return true;
}

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

    auto6FDC4961_val = libCamp_gf_LastMission();
    if (auto6FDC4961_val == libCamp_ge_MapID_MapTTychus02) {
        ConversationDataPreloadLines("Scriptedsceneslab");
    }
    else {

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

    }
    else {
        ConversationDataPreloadLines("Debriefs");
    }
}

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

    gf_SetWorldMode(ge_WorldMode_WorldModeSubspaceConversation);
    SoundPlay(SoundLink("UI_GenericTransitionEnter_Normal", c_soundIndexAny), PlayerGroupAll(), 100.0, 0.0);
    ConversationDataPreloadLines("CharFidgetsArtifact");
    gf_HotspotZoom(gf_RoomUnit(ge_RoomID_RoomChar), "Zoom_01", "Fly 01", 0.0);
    libNtve_gf_SetAnimationTimeScale(libNtve_gf_MainActorofUnit(gf_RoomUnit(ge_RoomID_RoomChar)), gv_aNIMID_ZOOM, 0.4);

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

    }
    else {
        ConversationDataPreloadLines("LabFidgetsArtifact");
        gf_ResetActorToLocation(ge_ActorID_ActorStetmann, PointFromId(404));
        gf_ResetActorToLocation(ge_ActorID_ActorRaynor, gf_LabRaynorHome());

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


    if ((gv_cantinaState == ge_CantinaStates_Broken)) {
        ConversationDataPreloadLines("CantinaTychus");
        gf_MakeUnitLookAtPointWithDebugControl(gf_ActorUnit(ge_ActorID_ActorRaynor), "InstantHeadOnly", libNtve_gf_PointWithZOffset(UnitGetPosition(gf_ActorUnit(ge_ActorID_ActorTychus)), 0.7));
    }

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorRaynor));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor01_00.ogv", false);
    ConversationDataPreloadLines("TRaynor01Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor02_00.ogv", false);
    ConversationDataPreloadLines("TRaynor02Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_traynor03_00.ogv", false);
    ConversationDataPreloadLines("TRaynor03Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorTychus));
    PreloadMovie("Assets\\Textures\\briefing_video_thanson01_00.ogv", false);
    ConversationDataPreloadLines("THanson01Briefing");
    return true;
}

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

    gf_PreloadUnitStoryMap(gf_ActorUnit(ge_ActorID_ActorHanson));
    PreloadMovie("Assets\\Textures\\video_briefingportrait_thanson02.ogv", false);
    ConversationDataPreloadLines("THanson02Briefing");
    return true;
}

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zlab01.sc2map/MapScript.galaxy:1368

    gv_mapMusicTrack = "ZLab01MusicAlt";
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, gv_mapMusicTrack, c_soundtrackCueAny, c_soundtrackIndexAny, true);
    ConversationDataPreloadLines("zBriefing_Lab01");
    ConversationDataPreloadLines("zMission_Lab01");
    return true;

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zlab01.sc2map/MapScript.galaxy:1369

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, gv_mapMusicTrack, c_soundtrackCueAny, c_soundtrackIndexAny, true);
    ConversationDataPreloadLines("zBriefing_Lab01");
    ConversationDataPreloadLines("zMission_Lab01");
    return true;
}

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zstoryhybrid.sc2map/MapScript.galaxy:606

    CinematicFade(false, 0.0, c_fadeStyleNormal, Color(0.00, 0.00, 0.00), 0.0, true);
    Wait(0.0625, c_timeGame);
    ConversationDataPreloadLines("zDebrief_Hybrid02");
    SoundLengthQueryWait();
    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomMainSet);

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zlab01.sc2map — MapScript.galaxy:1368

    gv_mapMusicTrack = "ZLab01MusicAlt";
    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, gv_mapMusicTrack, c_soundtrackCueAny, c_soundtrackIndexAny, true);
    ConversationDataPreloadLines("zBriefing_Lab01");
    ConversationDataPreloadLines("zMission_Lab01");
    return true;

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zlab01.sc2map — MapScript.galaxy:1369

    SoundtrackPlay(PlayerGroupAll(), c_soundtrackCategoryMusic, gv_mapMusicTrack, c_soundtrackCueAny, c_soundtrackIndexAny, true);
    ConversationDataPreloadLines("zBriefing_Lab01");
    ConversationDataPreloadLines("zMission_Lab01");
    return true;
}

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zstoryhybrid.sc2map — MapScript.galaxy:606

    CinematicFade(false, 0.0, c_fadeStyleNormal, Color(0.00, 0.00, 0.00), 0.0, true);
    Wait(0.0625, c_timeGame);
    ConversationDataPreloadLines("zDebrief_Hybrid02");
    SoundLengthQueryWait();
    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomMainSet);

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

            lv_indexCharacter = UserDataInstance("Character", auto8770F5D4_ai);
            if ((lib281DEC45_gf_CharacterIsEnabled(lv_indexCharacter) == true) && (lv_indexCharacter != "Evolution Master")) {
                ConversationDataPreloadLines(lib281DEC45_gf_ZSS_CharacterConversation(lv_indexCharacter));
            }
            else {

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

    }
    else if (autoCDCBB29A_val == lib281DEC45_ge_Rooms_StoryRoomEggRoom) {
        ConversationDataPreloadLines(lib281DEC45_gf_ZSS_CharacterConversation("Evolution Master"));
    }
    else {

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

    }
    lib281DEC45_gv_zSS_LastConversationSkipped = false;
    ConversationDataPreloadLines(lib281DEC45_gf_ZSS_CharacterConversation(lp_character));
    SoundLengthQueryWait();
    ConversationDataSaveNodeState(lib281DEC45_gf_ZSS_CharacterConversation(lp_character), lib281DEC45_gf_ZSS_TempConversationBank(), ("StoryConversations"));

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

    else {
    }
    ConversationDataPreloadLines(lp_conversation);
    SoundLengthQueryWait();
    if ((lp_fade == true)) {

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

        lv_indexClickable = UserDataInstance("Clickable", autoE3F8C74A_ai);
        if ((libVCST_gf_ClickableInRoom(lv_indexClickable, lp_room) == true) && (libVCST_gf_PS_ClickableIsEnabled(lv_indexClickable) == true)) {
            ConversationDataPreloadLines(libVCST_gf_PS_ClickableConversation(lv_indexClickable));
            ConversationDataPreloadLines(libVCST_gf_PS_ClickableResponse(lv_indexClickable));
        }

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

        if ((libVCST_gf_ClickableInRoom(lv_indexClickable, lp_room) == true) && (libVCST_gf_PS_ClickableIsEnabled(lv_indexClickable) == true)) {
            ConversationDataPreloadLines(libVCST_gf_PS_ClickableConversation(lv_indexClickable));
            ConversationDataPreloadLines(libVCST_gf_PS_ClickableResponse(lv_indexClickable));
        }

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


    libVCST_gv_pS_LastConversationSkipped = false;
    ConversationDataPreloadLines(libVCST_gf_PS_ClickableConversation(lp_clickable));
    SoundLengthQueryWait();
    libVCST_gv_pS_ConvoActive = true;

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

    // Implementation
    ConversationDataStop();
    ConversationDataPreloadLines(lp_conversation);
    libVCST_gv_pS_ConvoActive = true;
    libVCST_gv_pS_LastConversationSkipped = false;

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:1722

    ConversationDataRegisterPortrait(libVoiC_gf_PC_ClickableConversationLink("Artanis"), PortraitGetPlanetPanel());
    PlanetPanelSetBackgroundImage(PlayerGroupAll(), "Assets\\Textures\\ui_planetpanel_frame_backdrop_space.dds");
    ConversationDataPreloadLines("pPitch_Epilogue02");
    SoundLengthQueryWait();
    UISetFrameVisible(PlayerGroupAll(), c_syncFrameTypePlanetPanel, true);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:2076

    }

    ConversationDataPreloadLines(libVoiC_gf_MissionPitch(lp_mission));
    if ((lp_mission == "PAiur01") && (lp_mission == "PAiur02") && (lp_mission == "PAiur03") && (lp_mission == "SC2Epilogue01")) {
        PreloadLayout("UI\\Layout\\Custom\\VoidShared_MissionLaunchUI2D.SC2Layout", false);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:3158

                auto5CC1E984_ai = auto5CC1E984_ai + 1;
            }
            ConversationDataPreloadLines(libVoiC_gf_StoryPlanetNonmissionPitch(lv_indexLocation));
            auto369378D5_val = lv_indexLocation;
            if (auto369378D5_val == "Korhal") {

mods/heroes.stormmod — base.stormmaps/maps/heroes/singleplayermaps/startingexperience/tutorialveteran.stormmap/MapScript.galaxy:2004

    GameSetSpeedValue(c_gameSpeedNormal);
    GameSetSpeedLocked(true);
    ConversationDataPreloadLines("TutorialVO");
    libGame_gv_pickingHeroesCallback = gt_InitPlayers;
    libCore_gv_sYSGameMode = libCore_ge_GameModes_TutorialVeteran;

mods/heroes.stormmod — base.stormmaps/maps/heroes/singleplayermaps/startingexperience/tutorialveteran.stormmap/MapScript.galaxy:2172

    GameSetLighting("StormKingsCrestALL", 0.0);
    GameSetBackground(c_backgroundTerrain, null, 100.0);
    ConversationDataPreloadLines("TutorialVO");
    return true;
}

mods/heroes.stormmod/base.stormmaps/maps/heroes/singleplayermaps/startingexperience/tutorialveteran.stormmap — MapScript.galaxy:2004

    GameSetSpeedValue(c_gameSpeedNormal);
    GameSetSpeedLocked(true);
    ConversationDataPreloadLines("TutorialVO");
    libGame_gv_pickingHeroesCallback = gt_InitPlayers;
    libCore_gv_sYSGameMode = libCore_ge_GameModes_TutorialVeteran;

mods/heroes.stormmod/base.stormmaps/maps/heroes/singleplayermaps/startingexperience/tutorialveteran.stormmap — MapScript.galaxy:2172

    GameSetLighting("StormKingsCrestALL", 0.0);
    GameSetBackground(c_backgroundTerrain, null, 100.0);
    ConversationDataPreloadLines("TutorialVO");
    return true;
}

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

        lv_indexClickable = UserDataInstance("Clickable", autoE3F8C74A_ai);
        if ((libNCST_gf_ClickableInRoom(lv_indexClickable, lp_room) == true) && (libNCST_gf_NS_ClickableIsEnabled(lv_indexClickable) == true)) {
            ConversationDataPreloadLines(libNCST_gf_NS_ClickableConversation(lv_indexClickable));
            ConversationDataPreloadLines(libNCST_gf_NS_ClickableResponse(lv_indexClickable));
        }

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

        if ((libNCST_gf_ClickableInRoom(lv_indexClickable, lp_room) == true) && (libNCST_gf_NS_ClickableIsEnabled(lv_indexClickable) == true)) {
            ConversationDataPreloadLines(libNCST_gf_NS_ClickableConversation(lv_indexClickable));
            ConversationDataPreloadLines(libNCST_gf_NS_ClickableResponse(lv_indexClickable));
        }

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


    libNCST_gv_nS_LastConversationSkipped = false;
    ConversationDataPreloadLines(libNCST_gf_NS_ClickableConversation(lp_clickable));
    SoundLengthQueryWait();
    libNCST_gv_nS_ConvoActive = true;

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

    // Implementation
    ConversationDataStop();
    ConversationDataPreloadLines(lp_conversation);
    libNCST_gv_nS_ConvoActive = true;
    libNCST_gv_nS_LastConversationSkipped = false;

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:1336

    }

    ConversationDataPreloadLines(libComC_gf_MissionPitch(lp_mission));
}

# Preload Data Conversation Lines

# Arguments

# Related

# Examples