# Unit Research Progress

Grammar — u research progress is stage
Flags — Native | Event

This event fires when a unit’s research progress reaches a certain point. Use “Triggering Player” to get the player that started the research. Use “Triggering Unit” to get the unit that is doing the research. Use “Triggering Progress Upgrade” to get the upgrade being researched.

# Arguments

• unitref [ unit ] — Unit
• int [ preset::Unit_Progress ] — Stage

Returns — void

native void TriggerAddEventUnitResearchProgress(
	trigger t,
	unitref u,
	int stage,
);

# Event parameters

• Triggering Game User — EventGameUser
• Triggering Player — EventPlayer
• Triggering Progress Unit — EventUnitProgressUnit
• Triggering Progress Upgrade — libNtve_gf_TriggeringProgressUpgrade

# Related

Category: Unit / Progress And Queues

• [F] — void — Set Unit Progress — ( UnitSetProgressComplete )
• [F] — fixed — Unit Progress (Percent) — ( UnitGetProgressComplete )
• [F] — void — Pause/Resume/Cancel Unit Progress Bar — ( UnitSetProgressStage )
• [F] — bool — Unit Progress Bar Check — ( UnitCheckProgressState )
• [F] — bool — Unit Is Under Construction — ( libNtve_gf_UnitIsUnderConstruction )
• [F] — void — Unit Arming Progress — ( TriggerAddEventUnitArmMagazineProgress )
• [F] — void — Unit Construction Progress — ( TriggerAddEventUnitConstructProgress )
• [F] — void — Unit Learn Progress — ( TriggerAddEventUnitLearnProgress )
• [F] — void — Unit Research Progress — ( TriggerAddEventUnitResearchProgress )
• [F] — void — Unit Revive Progress — ( TriggerAddEventUnitReviveProgress )
• [F] — void — Unit Specialization Progress — ( TriggerAddEventUnitSpecializeProgress )
• [F] — void — Unit Training Progress — ( TriggerAddEventUnitTrainProgress )
• [F] — string [ gamelink ] — Triggering Progress Object — ( EventUnitProgressObjectType )
• [F] — string [ gamelink::Abil ] — Triggering Progress Ability — ( libNtve_gf_TriggeringProgressAbility )
• [F] — string [ gamelink::Effect ] — Triggering Progress Effect — ( libNtve_gf_TriggeringProgressEffect )
• [F] — unit — Triggering Progress Unit — ( EventUnitProgressUnit )
• [F] — string [ gamelink::Unit ] — Triggering Progress Unit Type — ( libNtve_gf_TriggeringProgressUnitType )
• [F] — string [ gamelink::Upgrade ] — Triggering Progress Upgrade — ( libNtve_gf_TriggeringProgressUpgrade )
• [F] — int — Number Of Items In Training Queue Slot — ( UnitQueueItemCount )
• [F] — string [ gamelink ] — Queued Object In Training Queue Slot — ( UnitQueueItemGet )
• [F] — string [ gamelink::Behavior ] — Queued Behavior Type In Training Queue Slot — ( libNtve_gf_QueuedBehaviorTypeInTrainingQueueSlot )
• [F] — string [ gamelink::Unit ] — Queued Unit Type In Training Queue Slot — ( libNtve_gf_QueuedUnitTypeInTrainingQueueSlot )
• [F] — string [ gamelink::Upgrade ] — Queued Upgrade Type In Training Queue Slot — ( libNtve_gf_QueuedUpgradeTypeInTrainingQueueSlot )
• [F] — int — Training Queue Property Of Unit — ( UnitQueueGetProperty )
• [F] — bool — Training Queue Slot Type Check — ( UnitQueueItemTypeCheck )
• [F] — fixed — Training Queue Time — ( UnitQueueItemTime )

# Examples

# campaigns/swarm.sc2campaign

— MapScript.galaxy

// L5530
TriggerAddEventUnitResearchProgress(gt_EvolutionUpgradePurchased, null, c_unitProgressStageStart)

// L5530
TriggerAddEventUnitResearchProgress(gt_EvolutionUpgradePurchased, null, c_unitProgressStageStart)

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L18823
TriggerAddEventUnitResearchProgress(libSwaC_gt_ZS_CampaignStatsWeaponArmorUpgrades, null, c_unitProgressStageComplete)

# mods/starcoop/starcoop.sc2mod

— LibCOMI.galaxy

// L15182
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Abathur_MeleeBonusUpgrade, null, c_unitProgressStageComplete)

// L18089
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_AchievementCarrierResearched, null, c_unitProgressStageComplete)

// L18837
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ChampionUpgradeResearched, null, c_unitProgressStageComplete)

// L19263
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ConclaiveTrainStart, null, c_unitProgressStageStart)

// L19264
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ConclaiveTrainStart, null, c_unitProgressStageResume)

// L19293
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ConclaiveTrainStop, null, c_unitProgressStagePause)

// L19294
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ConclaiveTrainStop, null, c_unitProgressStageCancel)

// L19295
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Fenix_ConclaiveTrainStop, null, c_unitProgressStageComplete)

// L26195
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Tychus_UltimateAchievement, null, c_unitProgressStageComplete)

// L26393
TriggerAddEventUnitResearchProgress(libCOMI_gt_CM_Tychus_TriUnitSpeed_Upgrade, null, c_unitProgressStageComplete)

# mods/starcoop/starcoop.sc2mod

— LibCOOC.galaxy

// L6424
TriggerAddEventUnitResearchProgress(libCOOC_gt_CC_SharedUpgradesRecheck, null, c_unitProgressStageComplete)

# mods/starcoop/starcoop.sc2mod

— LibCOUI.galaxy

// L9357
TriggerAddEventUnitResearchProgress(libCOUI_gt_CU_TychusEquipmentUpgraded, null, c_unitProgressStageComplete)