# Button Pressed

Grammar — Player player presses button
Flags — Native | Event

Only register for this event when you absolutely need it, as it will generate network traffic from all players for every button they press. This event fires when a player presses a command card button. Use “Button Pressed” to get the button that was pressed.

# Arguments

• int — Player
• string [ gamelink::Button ] — Button

Returns — void

native void TriggerAddEventButtonPressed(
	trigger t,
	int player,
	string button,
);

# Event parameters

• Triggering Game User — EventGameUser
• Triggering Player — EventPlayer
• Button Pressed — EventButtonPressed

# Related

Category: UI / Input

• [F] — void — Key Pressed — ( TriggerAddEventKeyPressed )
• [F] — void — Hotkey Pressed — ( TriggerAddEventHotkeyPressed )
• [F] — void — Button Pressed — ( TriggerAddEventButtonPressed )
• [F] — void — Mouse Clicked — ( TriggerAddEventMouseClicked )
• [F] — void — Mouse Moved — ( TriggerAddEventMouseMoved )
• [F] — void — Mouse Wheel — ( TriggerAddEventMouseWheel )
• [F] — string [ gamelink::Button ] — Button Pressed — ( EventButtonPressed )
• [F] — int [ preset::Key ] — Key Pressed — ( EventKeyPressed )
• [F] — int [ preset::Key ] — Hotkey Pressed — ( EventHotkeyPressed )
• [F] — bool — Control Key Pressed — ( EventKeyControl )
• [F] — bool — Alt Key Pressed — ( EventKeyAlt )
• [F] — bool — Shift Key Pressed — ( EventKeyShift )
• [F] — int [ preset::MouseButton ] — Mouse Clicked Button — ( EventMouseClickedButton )
• [F] — int — Mouse Clicked UI Pos X — ( EventMouseClickedPosXUI )
• [F] — int — Mouse Clicked UI Pos Y — ( EventMouseClickedPosYUI )
• [F] — fixed — Mouse Clicked World Pos X — ( EventMouseClickedPosXWorld )
• [F] — fixed — Mouse Clicked World Pos Y — ( EventMouseClickedPosYWorld )
• [F] — fixed — Mouse Clicked World Pos Z — ( EventMouseClickedPosZWorld )
• [F] — int — Mouse Moved UI Pos X — ( EventMouseMovedPosXUI )
• [F] — int — Mouse Moved UI Pos Y — ( EventMouseMovedPosYUI )
• [F] — fixed — Mouse Moved World Pos X — ( EventMouseMovedPosXWorld )
• [F] — fixed — Mouse Moved World Pos Y — ( EventMouseMovedPosYWorld )
• [F] — fixed — Mouse Moved World Pos Z — ( EventMouseMovedPosZWorld )
• [F] — fixed — Mouse Wheel Spin — ( EventMouseWheelSpin )

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L1721
TriggerAddEventButtonPressed(gt_ButtonFlashGrenadesOff, c_playerAny, "TossGrenade")

// L1777
TriggerAddEventButtonPressed(gt_ButtonFlashPlasmaGunOff, c_playerAny, "ExperimentalPlasmaGun")

// L1833
TriggerAddEventButtonPressed(gt_ButtonFlashChronosOff, c_playerAny, "TheMorosDevice")

// L1887
TriggerAddEventButtonPressed(gt_ButtonFlashBreachingChargeOff, c_playerAny, "PlantC4Charge")

// L1612
TriggerAddEventButtonPressed(gt_BuildRefineryButtonPressed, gv_pLAYER_01_USER, "Refinery")

// L1642
TriggerAddEventButtonPressed(gt_BuildSCVButtonPressed, gv_pLAYER_01_USER, "SCV")

// L1672
TriggerAddEventButtonPressed(gt_BuildMarineButtonPressed, gv_pLAYER_01_USER, "Marine")

// L4295
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffMindblast, c_playerAny, "MindBlast")

// L4323
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffConsumption, c_playerAny, "Consumption")

// L4351
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffPsiShield, c_playerAny, "VoodooShield")

// L4379
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffNuke, c_playerAny, "NukeCalldown")

// L4899
TriggerAddEventButtonPressed(gt_Combat02AttackIssued, c_playerAny, "Attack")

// L5428
TriggerAddEventButtonPressed(gt_Combat03AttackIssued, c_playerAny, "Attack")

// L6244
TriggerAddEventButtonPressed(gt_Construction02BuildStructurePressed, c_playerAny, "TerranBuild")

// L7154
TriggerAddEventButtonPressed(gt_Collection02BuildStructurePressed, c_playerAny, "TerranBuild")

// L7182
TriggerAddEventButtonPressed(gt_Collection02BuildRefineryPressed, c_playerAny, "Refinery")

// L9625
TriggerAddEventButtonPressed(gt_Supply01BuildStructurePressed, c_playerAny, "TerranBuild")

// L9653
TriggerAddEventButtonPressed(gt_Supply01BuildSupplyDepotPressed, c_playerAny, "SupplyDepot")

// L1252
TriggerAddEventButtonPressed(gt_ButtonFlashBlinkOff, c_playerAny, "ZeratulBlink")

// L1308
TriggerAddEventButtonPressed(gt_ButtonFlashVoidPrisonOff, c_playerAny, "ZeratulStun")

// L2861
TriggerAddEventButtonPressed(gt_Playerselectspylonbutton, gv_p1_USER, "Pylon")

// L3014
TriggerAddEventButtonPressed(gt_FlashButtonPylonOff, c_playerAny, "Pylon")

// L1721
TriggerAddEventButtonPressed(gt_ButtonFlashGrenadesOff, c_playerAny, "TossGrenade")

// L1777
TriggerAddEventButtonPressed(gt_ButtonFlashPlasmaGunOff, c_playerAny, "ExperimentalPlasmaGun")

// L1833
TriggerAddEventButtonPressed(gt_ButtonFlashChronosOff, c_playerAny, "TheMorosDevice")

// L1887
TriggerAddEventButtonPressed(gt_ButtonFlashBreachingChargeOff, c_playerAny, "PlantC4Charge")

// L1612
TriggerAddEventButtonPressed(gt_BuildRefineryButtonPressed, gv_pLAYER_01_USER, "Refinery")

// L1642
TriggerAddEventButtonPressed(gt_BuildSCVButtonPressed, gv_pLAYER_01_USER, "SCV")

// L1672
TriggerAddEventButtonPressed(gt_BuildMarineButtonPressed, gv_pLAYER_01_USER, "Marine")

// L4295
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffMindblast, c_playerAny, "MindBlast")

// L4323
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffConsumption, c_playerAny, "Consumption")

// L4351
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffPsiShield, c_playerAny, "VoodooShield")

// L4379
TriggerAddEventButtonPressed(gt_ButtonFlashTurnoffNuke, c_playerAny, "NukeCalldown")

// L4899
TriggerAddEventButtonPressed(gt_Combat02AttackIssued, c_playerAny, "Attack")

// L5428
TriggerAddEventButtonPressed(gt_Combat03AttackIssued, c_playerAny, "Attack")

// L6244
TriggerAddEventButtonPressed(gt_Construction02BuildStructurePressed, c_playerAny, "TerranBuild")

// L7154
TriggerAddEventButtonPressed(gt_Collection02BuildStructurePressed, c_playerAny, "TerranBuild")

// L7182
TriggerAddEventButtonPressed(gt_Collection02BuildRefineryPressed, c_playerAny, "Refinery")

// L9625
TriggerAddEventButtonPressed(gt_Supply01BuildStructurePressed, c_playerAny, "TerranBuild")

// L9653
TriggerAddEventButtonPressed(gt_Supply01BuildSupplyDepotPressed, c_playerAny, "SupplyDepot")

// L1252
TriggerAddEventButtonPressed(gt_ButtonFlashBlinkOff, c_playerAny, "ZeratulBlink")

// L1308
TriggerAddEventButtonPressed(gt_ButtonFlashVoidPrisonOff, c_playerAny, "ZeratulStun")

// L2861
TriggerAddEventButtonPressed(gt_Playerselectspylonbutton, gv_p1_USER, "Pylon")

// L3014
TriggerAddEventButtonPressed(gt_FlashButtonPylonOff, c_playerAny, "Pylon")

// L3191
TriggerAddEventButtonPressed(gt_PlayerPressedAberrationButton, c_playerAny, "Aberration")

// L2835
TriggerAddEventButtonPressed(gt_TurnoffConsumeBlinkyLyote, c_playerAny, "Consume")

// L3594
TriggerAddEventButtonPressed(gt_TurnoffConsumeBlinkyUrsadon, c_playerAny, "Consume")

// L2360
TriggerAddEventButtonPressed(gt_ButtonClickedBasicMutation, gv_pLAYER_01_USER, "ZergBuild")

// L3844
TriggerAddEventButtonPressed(gt_OverlordSelectLarvaClicked, gv_pLAYER_01_USER, "Larva")

// L4648
TriggerAddEventButtonPressed(gt_SpawningPoolBasicMutationClicked, gv_pLAYER_01_USER, "ZergBuild")

// L4696
TriggerAddEventButtonPressed(gt_SpawningPoolButtonClicked, gv_pLAYER_01_USER, "SpawningPool")

// L5628
TriggerAddEventButtonPressed(gt_ZerglingSelectLarvaClicked, gv_pLAYER_01_USER, "Larva")

// L2248
TriggerAddEventButtonPressed(gt_ButtonFlashCrushingGripOff, c_playerAny, "PsionicLift")

// L2312
TriggerAddEventButtonPressed(gt_ButtonFlashKineticBlastOff, c_playerAny, "MindBolt")

// L2737
TriggerAddEventButtonPressed(gt_FirstKineticBlastUsed, gv_pLAYER_01_USER, "MindBolt")

// L3440
TriggerAddEventButtonPressed(gt_FirstCrushingGripUsed, gv_pLAYER_01_USER, "PsionicLift")

// L2742
TriggerAddEventButtonPressed(gt_SpineCrawlerButtonPressed, gv_pLAYER_01_USER, "SpineCrawler")

// L2066
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters")

// L2067
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters2")

// L2068
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters3")

// L2192
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato")

// L2193
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato2")

// L2194
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato3")

// L1749
TriggerAddEventButtonPressed(gt_DeepBurrowPressedStopFlashing, c_playerAny, "SwarmHostDeepBurrow")

// L1384
TriggerAddEventButtonPressed(gt_SwarmlingMorphToSwarmlingButtonClicked, c_playerAny, "MorphToSwarmling")

// L1597
TriggerAddEventButtonPressed(gt_SwarmlingMorphedMore, c_playerAny, "MorphToSwarmling")

// L1749
TriggerAddEventButtonPressed(gt_DeepBurrowPressedStopFlashing, c_playerAny, "SwarmHostDeepBurrow")

// L1384
TriggerAddEventButtonPressed(gt_SwarmlingMorphToSwarmlingButtonClicked, c_playerAny, "MorphToSwarmling")

// L1597
TriggerAddEventButtonPressed(gt_SwarmlingMorphedMore, c_playerAny, "MorphToSwarmling")

// L3191
TriggerAddEventButtonPressed(gt_PlayerPressedAberrationButton, c_playerAny, "Aberration")

// L2835
TriggerAddEventButtonPressed(gt_TurnoffConsumeBlinkyLyote, c_playerAny, "Consume")

// L3594
TriggerAddEventButtonPressed(gt_TurnoffConsumeBlinkyUrsadon, c_playerAny, "Consume")

// L2360
TriggerAddEventButtonPressed(gt_ButtonClickedBasicMutation, gv_pLAYER_01_USER, "ZergBuild")

// L3844
TriggerAddEventButtonPressed(gt_OverlordSelectLarvaClicked, gv_pLAYER_01_USER, "Larva")

// L4648
TriggerAddEventButtonPressed(gt_SpawningPoolBasicMutationClicked, gv_pLAYER_01_USER, "ZergBuild")

// L4696
TriggerAddEventButtonPressed(gt_SpawningPoolButtonClicked, gv_pLAYER_01_USER, "SpawningPool")

// L5628
TriggerAddEventButtonPressed(gt_ZerglingSelectLarvaClicked, gv_pLAYER_01_USER, "Larva")

// L2248
TriggerAddEventButtonPressed(gt_ButtonFlashCrushingGripOff, c_playerAny, "PsionicLift")

// L2312
TriggerAddEventButtonPressed(gt_ButtonFlashKineticBlastOff, c_playerAny, "MindBolt")

// L2737
TriggerAddEventButtonPressed(gt_FirstKineticBlastUsed, gv_pLAYER_01_USER, "MindBolt")

// L3440
TriggerAddEventButtonPressed(gt_FirstCrushingGripUsed, gv_pLAYER_01_USER, "PsionicLift")

// L2742
TriggerAddEventButtonPressed(gt_SpineCrawlerButtonPressed, gv_pLAYER_01_USER, "SpineCrawler")

// L2066
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters")

// L2067
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters2")

// L2068
TriggerAddEventButtonPressed(gt_LaunchFighterButtonClicked, c_playerAny, "SJHyperionFighters3")

// L2192
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato")

// L2193
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato2")

// L2194
TriggerAddEventButtonPressed(gt_LaunchYamatoButtonClicked, c_playerAny, "SJHyperionYamato3")

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L16580
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "Queen")

// L16581
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "Roach")

// L16582
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToCorpser")

// L16583
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToVile")

// L16584
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "Hydralisk")

// L16585
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToHydraliskImpaler")

// L16586
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToHydraliskLurker")

// L16587
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "Mutalisk")

// L16588
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToMutaliskBroodlord")

// L16589
TriggerAddEventButtonPressed(libSwaC_gt_ZS_PlayerNeedOverlordButtonClickedFood2, 1, "MorphToMutaliskViper")

# campaigns/void.sc2campaign

— MapScript.galaxy

// L6500
TriggerAddEventButtonPressed(gt_TerranMakeSCVsTrainingStarted, gv_p01_USER, "SCV")

// L7037
TriggerAddEventButtonPressed(gt_TerranMakeSupplyBuildMenu, gv_p01_USER, "TerranBuild")