# Data Conversation State Upgrade

Grammar — infoName upgrade of conversation stateIndex|State
Flags — Native | Function

Returns an upgrade associated with the given conversation state. The info name corresponds with the “Info Name” field defined in the state.

# Arguments

• string<convstateindex> — State Index
• string — Info Name

Returns — string<gamelink::Upgrade>

native string ConversationDataStateUpgrade(
	string stateIndex,
	string inInfoName,
);

# Related

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/libertystory.sc2campaign — base.sc2data/TriggerLibs/CampaignLib.galaxy:4908

    // Automatic Variable Declarations
    // Implementation
    return ConversationDataStateUpgrade(libCamp_gv_tS_ResearchConvoID[(lp_researchID)], ("Upgrade 1"));
}

campaigns/libertystory.sc2campaign — base.sc2data/TriggerLibs/CampaignLib.galaxy:4914

    // Automatic Variable Declarations
    // Implementation
    return ConversationDataStateUpgrade(libCamp_gv_tS_ResearchConvoID[(lp_researchID)], ("Upgrade 2"));
}

campaigns/libertystory.sc2campaign — base.sc2data/TriggerLibs/CampaignLib.galaxy:6633

        lv_convoID = "Upgrade1";
    }
    return ConversationDataStateUpgrade(libCamp_gf_TS_StoryTechConvoID(lp_tech), (lv_convoID));
}