# Key Pressed

Grammar — Player player presses key key down|up/down with shift s2|Enabled, control c2|Enabled, alt a2|Enabled
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 the specified key. Use “Key Pressed” to get the key that was pressed. Use “Alt Key Pressed”, “Control Key Pressed”, and “Shift Key Pressed” to find out what modifier keys were pressed.

# Arguments

• int — Player
• int [ preset::Key ] — Key
• bool [ preset::UpDownOption ] — Down
• int [ preset::KeyModifierState ] — Shift
• int [ preset::KeyModifierState ] — Control
• int [ preset::KeyModifierState ] — Alt

Returns — void

native void TriggerAddEventKeyPressed(
	trigger t,
	int player,
	int key,
	bool down,
	int s,
	int c,
	int a,
);

# Event parameters

• Triggering Game User — EventGameUser
• Triggering Player — EventPlayer
• Key Pressed — EventKeyPressed
• Hotkey Pressed — EventHotkeyPressed
• Control Key Pressed — EventKeyControl
• Alt Key Pressed — EventKeyAlt
• Shift Key Pressed — EventKeyShift

# 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

// L7477
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keySpace, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7478
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keyNumPad0, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7479
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keyV, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7499
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keySpace, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7500
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keyNumPad0, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7501
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keyV, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7568
TriggerAddEventKeyPressed(gt_FighterBombKeyDown, c_playerAny, c_keyControl, true, c_keyModifierStateExclude, c_keyModifierStateIgnore, c_keyModifierStateExclude)

// L7569
TriggerAddEventKeyPressed(gt_FighterBombKeyDown, c_playerAny, c_keyB, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7588
TriggerAddEventKeyPressed(gt_FighterMoveLeftKeyDown, c_playerAny, c_keyLeft, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L7589
TriggerAddEventKeyPressed(gt_FighterMoveLeftKeyDown, c_playerAny, c_keyA, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L15032
TriggerAddEventKeyPressed(gt_PinboardItemBack, c_playerAny, c_keyNone, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L7477
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keySpace, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7478
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keyNumPad0, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7479
TriggerAddEventKeyPressed(gt_FighterAttackKeyDown, c_playerAny, c_keyV, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7499
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keySpace, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7500
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keyNumPad0, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7501
TriggerAddEventKeyPressed(gt_FighterAttackKeyUp, c_playerAny, c_keyV, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7568
TriggerAddEventKeyPressed(gt_FighterBombKeyDown, c_playerAny, c_keyControl, true, c_keyModifierStateExclude, c_keyModifierStateIgnore, c_keyModifierStateExclude)

// L7569
TriggerAddEventKeyPressed(gt_FighterBombKeyDown, c_playerAny, c_keyB, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

// L7588
TriggerAddEventKeyPressed(gt_FighterMoveLeftKeyDown, c_playerAny, c_keyLeft, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L7589
TriggerAddEventKeyPressed(gt_FighterMoveLeftKeyDown, c_playerAny, c_keyA, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L15032
TriggerAddEventKeyPressed(gt_PinboardItemBack, c_playerAny, c_keyNone, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L4262
TriggerAddEventKeyPressed(gt_CenterOnHyperion, gv_pLAYER_01_USER, c_keySpace, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L4262
TriggerAddEventKeyPressed(gt_CenterOnHyperion, gv_pLAYER_01_USER, c_keySpace, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# campaigns/voidstory.sc2campaign

— VoidCampaignMissionLib.galaxy

// L6711
TriggerAddEventKeyPressed(libVCMI_gt_PM_TurnOffFlyoverMode, c_playerAny, c_keyB, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# campaigns/voidstory.sc2campaign

— VoidCampaignUILib.galaxy

// L10449
TriggerAddEventKeyPressed(libVCUI_gt_PU_LoreCreditsSkip, c_playerAny, c_keyEscape, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/frontiers.sc2mod

— Lib6CB3363F.galaxy

// L1035
TriggerAddEventKeyPressed(lib6CB3363F_gt_SprintPressed, c_playerAny, c_keyShift, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1036
TriggerAddEventKeyPressed(lib6CB3363F_gt_SprintPressed, c_playerAny, c_keyNumPad0, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1055
TriggerAddEventKeyPressed(lib6CB3363F_gt_SprintReleased, c_playerAny, c_keyShift, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1056
TriggerAddEventKeyPressed(lib6CB3363F_gt_SprintReleased, c_playerAny, c_keyNumPad0, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1087
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpPressed, c_playerAny, c_keyW, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1088
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpPressed, c_playerAny, c_keyUp, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1089
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpPressed, c_playerAny, c_keyNumPad8, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1108
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpReleased, c_playerAny, c_keyW, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1109
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpReleased, c_playerAny, c_keyUp, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L1110
TriggerAddEventKeyPressed(lib6CB3363F_gt_UpReleased, c_playerAny, c_keyNumPad8, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/heroesbrawlmods/brawlmapmods/coop/pvebrawlmod.stormmod

— LibPVEB.galaxy

// L3032
TriggerAddEventKeyPressed(libPVEB_gt_DebugPlayerSelection, c_playerAny, c_keyNone, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

# mods/heroesbrawlmods/brawlmapmods/coop/pvemod.stormmod

— LibPVEM.galaxy

// L3120
TriggerAddEventKeyPressed(libPVEM_gt_PvEDebugPlayerSelection, c_playerAny, c_keyNone, false, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateExclude)

# mods/heroesdata.stormmod

— StartingExperienceLib.galaxy

// L3026
TriggerAddEventKeyPressed(libStEx_gt_SE_TrainingModeTipAbilitiesQWERUsed, c_playerAny, c_keyQ, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateIgnore)

// L3027
TriggerAddEventKeyPressed(libStEx_gt_SE_TrainingModeTipAbilitiesQWERUsed, c_playerAny, c_keyW, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateIgnore)

// L3028
TriggerAddEventKeyPressed(libStEx_gt_SE_TrainingModeTipAbilitiesQWERUsed, c_playerAny, c_keyE, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateIgnore)

// L3029
TriggerAddEventKeyPressed(libStEx_gt_SE_TrainingModeTipAbilitiesQWERUsed, c_playerAny, c_keyR, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateIgnore)

# mods/heroesdata.stormmod

— SupportLib.galaxy

// L8498
TriggerAddEventKeyPressed(libSprt_gt_DEBUGClearDPSTrackerStats, c_playerAny, c_keyNumPad5, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/heroesdata.stormmod

— UILib.galaxy

// L13724
TriggerAddEventKeyPressed(libUIUI_gt_InputBackslashKeyDown, c_playerAny, c_keyBackSlash, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L14871
TriggerAddEventKeyPressed(libUIUI_gt_UIOnFireDEBUGCycleDefenseOnFire, c_playerAny, c_keyI, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L14937
TriggerAddEventKeyPressed(libUIUI_gt_UIOnFireDEBUGCycleOffenseOnFire, c_playerAny, c_keyO, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L15003
TriggerAddEventKeyPressed(libUIUI_gt_UIOnFireDEBUGCycleUtilityOnFire, c_playerAny, c_keyP, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/missionpacks/novacampaign.sc2mod

— LibNCMI.galaxy

// L5829
TriggerAddEventKeyPressed(libNCMI_gt_NM_TurnOffFlyoverMode, c_playerAny, c_keyB, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/missionpacks/novacampaign.sc2mod

— LibNCUI.galaxy

// L5310
TriggerAddEventKeyPressed(libNCUI_gt_NU_MissionEscPressed, c_playerAny, c_keyEscape, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L5548
TriggerAddEventKeyPressed(libNCUI_gt_NU_MissionNewsCanceledESC, c_playerAny, c_keyEscape, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L7377
TriggerAddEventKeyPressed(libNCUI_gt_NU_EndCreditsEnds, c_playerAny, c_keyEscape, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

# mods/starcoop/starcoop.sc2mod

— LibCOUI.galaxy

// L7070
TriggerAddEventKeyPressed(libCOUI_gt_CU_MasteryShiftTrackDown, c_playerAny, c_keyShift, true, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L7091
TriggerAddEventKeyPressed(libCOUI_gt_CU_MasteryShiftTrackUp, c_playerAny, c_keyShift, false, c_keyModifierStateIgnore, c_keyModifierStateIgnore, c_keyModifierStateIgnore)

// L9738
TriggerAddEventKeyPressed(libCOUI_gt_CU_MinimapAllyViewCamera, c_playerAny, c_keyV, true, c_keyModifierStateExclude, c_keyModifierStateExclude, c_keyModifierStateRequire)