# Effect Used

Grammar — Player p uses Effect effect
Flags — Native | Event

This event fires when the specified effect is used by the specified player.

# Arguments

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

Returns — void

native void TriggerAddEventPlayerEffectUsed(
	trigger t,
	int player,
	string inEffect,
);

# Event parameters

• Triggering Effect Used — EventPlayerEffectUsed
• Triggering Effect Point — EventPlayerEffectUsedPoint
• Triggering Effect Unit — EventPlayerEffectUsedUnit
• Triggering Effect Item — EventPlayerEffectUsedItem
• Triggering Effect Impact Unit — EventPlayerEffectUsedUnitImpact
• Triggering Effect Launch Unit — EventPlayerEffectUsedUnitLaunch
• Triggering Effect Unit Owner — EventPlayerEffectUsedUnitOwner
• Triggering Effect Unit Type — EventPlayerEffectUsedUnitType
• Triggering Effect Item Type — EventPlayerEffectUsedItemType
• Triggering Effect Amount (Integer) — EventPlayerEffectUsedAmountInt
• Triggering Effect Amount (Real) — EventPlayerEffectUsedAmountFixed
• Triggering Effect Source Behavior — EventPlayerEffectUsedSourceBehavior
• Triggering Effect Weapon — EventPlayerEffectUsedWeapon
• Triggering Effect Ability — EventPlayerEffectUsedAbil
• Triggering Player — EventPlayer

# Related

Category: Environment / Effects

• [F] — void — Create Explosion At Point — ( libNtve_gf_CreateExplosionAtPoint )
• [F] — void — Create Effect At Point (From Player) — ( PlayerCreateEffectPoint )
• [F] — void — Create Effect On Unit (From Player) — ( PlayerCreateEffectUnit )
• [F] — void — Create Effect At Point (From Unit) — ( UnitCreateEffectPoint )
• [F] — void — Create Effect On Unit (From Unit) — ( UnitCreateEffectUnit )
• [F] — void — Damage Unit (From Unit) — ( UnitDamage )
• [F] — bool — Player Can Create Effect At Point — ( libNtve_gf_PlayerCanCreateEffectAtPoint )
• [F] — bool — Player Can Create Effect On Unit — ( libNtve_gf_PlayerCanCreateEffectOnUnit )
• [F] — bool — Unit Can Create Effect At Point — ( libNtve_gf_UnitCanCreateEffectAtPoint )
• [F] — bool — Unit Can Create Effect On Unit — ( libNtve_gf_UnitCanCreateEffectOnUnit )
• [F] — void — Destroy Effects — ( GameDestroyEffects )
• [F] — void — Effect Used — ( TriggerAddEventPlayerEffectUsed )
• [F] — void — Effect Used From Scope — ( TriggerAddEventPlayerEffectUsedFromScope )
• [F] — string [ gamelink::Effect ] — Triggering Effect Used — ( EventPlayerEffectUsed )
• [F] — point — Triggering Effect Point — ( EventPlayerEffectUsedPoint )
• [F] — unit — Triggering Effect Unit — ( EventPlayerEffectUsedUnit )
• [F] — unit — Triggering Effect Item — ( EventPlayerEffectUsedItem )
• [F] — unit — Triggering Effect Impact Unit — ( EventPlayerEffectUsedUnitImpact )
• [F] — unit — Triggering Effect Launch Unit — ( EventPlayerEffectUsedUnitLaunch )
• [F] — int — Triggering Effect Unit Owner — ( EventPlayerEffectUsedUnitOwner )
• [F] — string [ gamelink::Unit ] — Triggering Effect Unit Type — ( EventPlayerEffectUsedUnitType )
• [F] — string [ gamelink::Unit ] — Triggering Effect Item Type — ( EventPlayerEffectUsedItemType )
• [F] — int — Triggering Effect Amount (Integer) — ( EventPlayerEffectUsedAmountInt )
• [F] — fixed — Triggering Effect Amount (Real) — ( EventPlayerEffectUsedAmountFixed )
• [F] — string [ gamelink::Behavior ] — Triggering Effect Source Behavior — ( EventPlayerEffectUsedSourceBehavior )
• [F] — string [ gamelink::Weapon ] — Triggering Effect Weapon — ( EventPlayerEffectUsedWeapon )
• [F] — string [ gamelink::Abil ] — Triggering Effect Ability — ( EventPlayerEffectUsedAbil )

# Examples

# campaigns/swarm.sc2campaign

— MapScript.galaxy

// L2289
TriggerAddEventPlayerEffectUsed(gt_SpawnHybrid, 0, "HybridReleaseImpact")

// L2289
TriggerAddEventPlayerEffectUsed(gt_SpawnHybrid, 0, "HybridReleaseImpact")

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L17369
TriggerAddEventPlayerEffectUsed(libSwaC_gt_ZS_HatcheryEggModels, 1, "ZerglingRespawnEggCheck")

// L17395
TriggerAddEventPlayerEffectUsed(libSwaC_gt_ZS_HatcheryEggBirths, 1, "ZerglingRespawnEggBirth")

# campaigns/void.sc2campaign

— MapScript.galaxy

// L8754
TriggerAddEventPlayerEffectUsed(gt_CavernsRockTowerBehavior, 0, "RockCrushSearch")

// L1642
TriggerAddEventPlayerEffectUsed(gt_PerformanceHandleTimeStopApply, 1, "SOATimeFreeze")

// L2472
TriggerAddEventPlayerEffectUsed(gt_CoreDestroyedFinalCore, gv_pLAYER_02_DOMINION2, "GenericDontDieDummy")

// L3201
TriggerAddEventPlayerEffectUsed(gt_MakeRockTowerInvulnAfterFalling, 0, "RockCrushSearch")

// L3609
TriggerAddEventPlayerEffectUsed(gt_VoidThrasherAttacksScreenShake, gv_pLAYER_04_THRASHER, "VoidThrasherLightningAoECreatePersistent")

// L3016
TriggerAddEventPlayerEffectUsed(gt_ShrineDestroyed, gv_pLAYER_02_TAL_NORTH, "GenericDontDieDummy")

// L7392
TriggerAddEventPlayerEffectUsed(gt_GroundSlamSpawnAdds, gv_pLAYER_02_DOMINION, "XelNagaConstructSearch")

// L7443
TriggerAddEventPlayerEffectUsed(gt_EntropicBlastSpawnAdds, gv_pLAYER_02_DOMINION, "EntropicBlastSearch")

// L7638
TriggerAddEventPlayerEffectUsed(gt_StatsResurgenceActivated, gv_pLAYER_01_USER, "ArtanisResurgenceSet")

// L3558
TriggerAddEventPlayerEffectUsed(gt_EasterEggCarbotZergling, c_playerAny, "ZerglingCarbotSpawnRB")

// L2842
TriggerAddEventPlayerEffectUsed(gt_PerformanceHandleTimeStopApply, 1, "SOATimeFreeze")

// L4342
TriggerAddEventPlayerEffectUsed(gt_VictoryDefeatNarudCompleted, c_playerAny, "NarudEpilogueLowHPSet")

// L3803
TriggerAddEventPlayerEffectUsed(gt_CelestialBeamSoundRegionClear, c_playerAny, "CelestialBeamWeaponFinalPersistantEnd")

// L3861
TriggerAddEventPlayerEffectUsed(gt_CelestialBeamSoundFiring, c_playerAny, "CelestialBeamWeaponFinalPersistant")

// L8754
TriggerAddEventPlayerEffectUsed(gt_CavernsRockTowerBehavior, 0, "RockCrushSearch")

// L1642
TriggerAddEventPlayerEffectUsed(gt_PerformanceHandleTimeStopApply, 1, "SOATimeFreeze")

// L2472
TriggerAddEventPlayerEffectUsed(gt_CoreDestroyedFinalCore, gv_pLAYER_02_DOMINION2, "GenericDontDieDummy")

// L3201
TriggerAddEventPlayerEffectUsed(gt_MakeRockTowerInvulnAfterFalling, 0, "RockCrushSearch")

// L3609
TriggerAddEventPlayerEffectUsed(gt_VoidThrasherAttacksScreenShake, gv_pLAYER_04_THRASHER, "VoidThrasherLightningAoECreatePersistent")

// L3016
TriggerAddEventPlayerEffectUsed(gt_ShrineDestroyed, gv_pLAYER_02_TAL_NORTH, "GenericDontDieDummy")

// L7392
TriggerAddEventPlayerEffectUsed(gt_GroundSlamSpawnAdds, gv_pLAYER_02_DOMINION, "XelNagaConstructSearch")

// L7443
TriggerAddEventPlayerEffectUsed(gt_EntropicBlastSpawnAdds, gv_pLAYER_02_DOMINION, "EntropicBlastSearch")

// L7638
TriggerAddEventPlayerEffectUsed(gt_StatsResurgenceActivated, gv_pLAYER_01_USER, "ArtanisResurgenceSet")

// L3558
TriggerAddEventPlayerEffectUsed(gt_EasterEggCarbotZergling, c_playerAny, "ZerglingCarbotSpawnRB")

// L2842
TriggerAddEventPlayerEffectUsed(gt_PerformanceHandleTimeStopApply, 1, "SOATimeFreeze")

// L4342
TriggerAddEventPlayerEffectUsed(gt_VictoryDefeatNarudCompleted, c_playerAny, "NarudEpilogueLowHPSet")

// L3803
TriggerAddEventPlayerEffectUsed(gt_CelestialBeamSoundRegionClear, c_playerAny, "CelestialBeamWeaponFinalPersistantEnd")

// L3861
TriggerAddEventPlayerEffectUsed(gt_CelestialBeamSoundFiring, c_playerAny, "CelestialBeamWeaponFinalPersistant")

# campaigns/voidstory.sc2campaign

— VoidCampaignMissionLib.galaxy

// L4736
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoATargetingEffectFired, 1, "SOAOrbitalStrikeCP")

// L4737
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoATargetingEffectFired, 1, "SOAGravitonBombLM")

// L4845
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoATargetingCameraShake, 1, "SOAOrbitalStrikeImpactSearch")

// L4846
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoATargetingCameraShake, 1, "SOAGravitonBombCP")

// L4968
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoATimeFreezeCast, 1, "SOATimeFreeze")

// L5159
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoAStrafeActivated, c_playerAny, "SOAStrafeAttackCreateTargeter")

// L5200
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_SoASuperShieldsActivated, 1, "SOASuperShieldDummy")

// L5220
TriggerAddEventPlayerEffectUsed(libVCMI_gt_ConfusionEndSuicide, c_playerAny, "IssueAIOrderSuicide")

// L5325
TriggerAddEventPlayerEffectUsed(libVCMI_gt_PM_HandleAlarakAvatarFinal, c_playerAny, "AlarakAvatarFinalDummy")

// L5358
TriggerAddEventPlayerEffectUsed(libVCMI_gt_AlarakKnockback4, c_playerAny, "AlarakKnockbackBy4")

# mods/frontiers.sc2mod

— Lib6CB3363F.galaxy

// L1790
TriggerAddEventPlayerEffectUsed(lib6CB3363F_gt_SuppliesPickupTriggered, c_playerAny, "FrontiersPickupSupplies")

// L1822
TriggerAddEventPlayerEffectUsed(lib6CB3363F_gt_HydraliskFireWeapon, c_playerAny, "EnemyHydraliskNeedleSpines")

# mods/heroes.stormmod

— MapScript.galaxy

// L4788
TriggerAddEventPlayerEffectUsed(gt_RegenGlobePickedUp, c_playerAny, "RegenGlobePickupImpactDummySet")

// L2399
TriggerAddEventPlayerEffectUsed(gt_TributeCollectInterrupted, c_playerAny, "CaptureMacguffinDummyDamageResponse")

// L2429
TriggerAddEventPlayerEffectUsed(gt_TributeCollectComplete, c_playerAny, "CaptureMacGuffinCastComplete")

// L4532
TriggerAddEventPlayerEffectUsed(gt__1D_AOEFountainUsed, c_playerAny, "MoonwellDrinkStartingSet")

// L5947
TriggerAddEventPlayerEffectUsed(gt__1E_RoamingFountainUsed, libStEx_gv_pLAYER_01_USER, "MoonwellDrinkStartingSet")

// L4788
TriggerAddEventPlayerEffectUsed(gt_RegenGlobePickedUp, c_playerAny, "RegenGlobePickupImpactDummySet")

// L2399
TriggerAddEventPlayerEffectUsed(gt_TributeCollectInterrupted, c_playerAny, "CaptureMacguffinDummyDamageResponse")

// L2429
TriggerAddEventPlayerEffectUsed(gt_TributeCollectComplete, c_playerAny, "CaptureMacGuffinCastComplete")

// L4532
TriggerAddEventPlayerEffectUsed(gt__1D_AOEFountainUsed, c_playerAny, "MoonwellDrinkStartingSet")

// L5947
TriggerAddEventPlayerEffectUsed(gt__1E_RoamingFountainUsed, libStEx_gv_pLAYER_01_USER, "MoonwellDrinkStartingSet")

# mods/heroesbrawlmods/arenamodemods/arenamode.stormmod

— LibAREN.galaxy

// L2271
TriggerAddEventPlayerEffectUsed(libAREN_gt_ARM_WheresWeirdoDied, c_playerAny, "WeirdoTimedLifeFate")

# mods/heroesbrawlmods/arenamodemods/gardenarena.stormmod

— LibAMGT.galaxy

// L1599
TriggerAddEventPlayerEffectUsed(libAMGT_gt_ARMGardenSeedPickup, c_playerAny, "SeedPickupSet")

# mods/heroesbrawlmods/arenamodemods/trialgrounds.stormmod

— LibAMVS.galaxy

// L2496
TriggerAddEventPlayerEffectUsed(libAMVS_gt_TrCoTributeObtained, c_playerAny, "CaptureMacGuffinCastComplete")

// L2754
TriggerAddEventPlayerEffectUsed(libAMVS_gt_ArtiPickedUp, c_playerAny, "OddballImpactSet")

# mods/heroesbrawlmods/brawlmapmods/blackheartsrevenge.stormmod

— LibMDoE.galaxy

// L2554
TriggerAddEventPlayerEffectUsed(libMDoE_gt_AttackCoreTracker, c_playerAny, "AttackCoreLaunchMissile")

// L2856
TriggerAddEventPlayerEffectUsed(libMDoE_gt_DoEsCannonballHandedIn, c_playerAny, "CaptureMacGuffinCastComplete")

// L2909
TriggerAddEventPlayerEffectUsed(libMDoE_gt_DoEsHeroPicksUpCannonball, c_playerAny, "DoubloonPickupSet")

// L3010
TriggerAddEventPlayerEffectUsed(libMDoE_gt_DoEsHeroLootsAmmoCacher, c_playerAny, "CaptureMacGuffinCastComplete")

// L3039
TriggerAddEventPlayerEffectUsed(libMDoE_gt_CannonballTimesOut, 11, "StormSuicide")

// L3040
TriggerAddEventPlayerEffectUsed(libMDoE_gt_CannonballTimesOut, 12, "StormSuicide")

// L3319
TriggerAddEventPlayerEffectUsed(libMDoE_gt_DoEs_HeroUsedTeleporter, c_playerAny, "CaptureMacGuffinTwoCastComplete")

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

— LibPEB1.galaxy

// L4981
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PVEMinionWaveCreateThinkTree, c_playerAny, "PVEMinionMonitorInCombatDummy")

// L7604
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ArchangelBaseDropshipUsed, c_playerAny, "CaptureMacGuffinCastComplete")

// L10537
TriggerAddEventPlayerEffectUsed(libPEB1_gt_EFBPlayVOSoundforPlayer, c_playerAny, "PvEMiniNukeCreatePersistent")

// L10612
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ReinforcementsUsed, c_playerAny, "PvEReinforcementsDummySet")

// L10658
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PvEMiniNukeInitialSet")

// L10659
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PvEReinforcementsInitialSet")

// L10660
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PvERejuvenationPulseInitialSet")

// L10661
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PvEPsiEmitterInitialSet")

// L10662
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PvETeamStimpackInitialSet")

// L10663
TriggerAddEventPlayerEffectUsed(libPEB1_gt_ItemUsed, c_playerAny, "PVESecondChanceInitialSet")

// L6868
TriggerAddEventPlayerEffectUsed(libPEB1_gt_CocoonHatched, c_playerAny, "ZergCocoonHatchedPodInitialSet")

// L6944
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1Phase2Finished, c_playerAny, "SlivanBossMovetoCenterDummySet")

// L6979
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1StartPhase3, c_playerAny, "SlivanBossUnburrowedDummySet")

// L7011
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1Phase3Finished, c_playerAny, "SlivanBossPhase4Apply")

// L7102
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1Phase2DetermineBosses, c_playerAny, "SlivanBossBurrowedInvulnerableApplyBehavior")

// L7261
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1Phase2SpawnZerg, c_playerAny, "SlivanNydusWormSpawnZergDummySet")

// L7334
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1Phase2NydusWormTimedLifeExpires, c_playerAny, "SlivanNydusWormSpawnBossDummySet")

// L7546
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1BossImpaleUsed, c_playerAny, "SlivanBossImpaleDummyCastSet")

// L7617
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1BossDropPodUsed, c_playerAny, "SlivanBossBurrowedDropPodDummySet")

// L7647
TriggerAddEventPlayerEffectUsed(libPEB1_gt_PEB1SpawnPodsUsed, c_playerAny, "SlivanBossSpawnPodsTriggerDummySet")

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

— LibPVEB.galaxy

// L2041
TriggerAddEventPlayerEffectUsed(libPVEB_gt_PvEPickupItemPickedUp, c_playerAny, "CaptureMacGuffinCastComplete")

// L2358
TriggerAddEventPlayerEffectUsed(libPVEB_gt_PvEResurrectRevivePlayer, c_playerAny, "CaptureMacGuffinTwoCastComplete")

// L2424
TriggerAddEventPlayerEffectUsed(libPVEB_gt_PvEResurrectNotifyTargetPlayerReviveStart, c_playerAny, "CaptureMacGuffinTwoInitialSet")

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

— LibPVEM.galaxy

// L1913
TriggerAddEventPlayerEffectUsed(libPVEM_gt_PvEResurrectRevivePlayer, c_playerAny, "CaptureMacGuffinTwoCastComplete")

// L1977
TriggerAddEventPlayerEffectUsed(libPVEM_gt_PvEResurrectNotifyTargetPlayerReviveStart, c_playerAny, "CaptureMacGuffinTwoInitialSet")

// L2399
TriggerAddEventPlayerEffectUsed(libPVEM_gt_PvEPickupItemPickedUp, c_playerAny, "CaptureMacGuffinCastComplete")

# mods/heroesbrawlmods/brawlmapmods/lunarfestival.stormmod

— LibLNYF.galaxy

// L1395
TriggerAddEventPlayerEffectUsed(libLNYF_gt_EnvelopeIsOpened, 0, "LunarFestivalEnvelopePickupSet")

// L1932
TriggerAddEventPlayerEffectUsed(libLNYF_gt_StunActivatedorReactivated, c_playerAny, "LunarFestivalApplyStunBehavior")

# mods/heroesbrawlmods/brawlmapmods/onelane/onelanemapshared.stormmod

— LibOLMS.galaxy

// L304
TriggerAddEventPlayerEffectUsed(libOLMS_gt_AddRegenGlobeGoals, c_playerAny, "GenerateRegenGlobeCreateSet")

# mods/heroesbrawlmods/brawlmapmods/pullparty.stormmod

— LibMMPP.galaxy

// L147
TriggerAddEventPlayerEffectUsed(libMMPP_gt_TracerEasterEgg, c_playerAny, "TracerProcSet")

// L174
TriggerAddEventPlayerEffectUsed(libMMPP_gt_TychusEasterEgg, c_playerAny, "TychusProcSet")

# mods/heroesdata.stormmod

— GameDataHelperLib.galaxy

// L4271
TriggerAddEventPlayerEffectUsed(libGDHL_gt_HeroGenericCameraShakeLightTarget, c_playerAny, "CameraShakeLightTauntingTotemSet")

// L4300
TriggerAddEventPlayerEffectUsed(libGDHL_gt_HeroGenericCameraShakeMediumTarget, c_playerAny, "CameraShakeMediumTauntingTotemSet")

// L4329
TriggerAddEventPlayerEffectUsed(libGDHL_gt_HeroGenericCameraShakeHeavyTarget, c_playerAny, "CameraShakeHeavyTauntingTotemSet")

// L4358
TriggerAddEventPlayerEffectUsed(libGDHL_gt_HeroGenericCameraShakeAutoCaster, c_playerAny, "CameraShakeAutoCasterDummySet")