# 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

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

# Examples

# campaigns/libertystory.sc2campaign

— CampaignLib.galaxy

// L4908
ConversationDataStateUpgrade(libCamp_gv_tS_ResearchConvoID[(lp_researchID)], ("Upgrade 1"))

// L4914
ConversationDataStateUpgrade(libCamp_gv_tS_ResearchConvoID[(lp_researchID)], ("Upgrade 2"))

// L6633
ConversationDataStateUpgrade(libCamp_gf_TS_StoryTechConvoID(lp_tech), (lv_convoID))