# Play Sound On Unit

Grammar — Play soundLink for audibleMask owned by player owningPlayer on unit with Z offset height|Z (at volume% volume, skip the first offset seconds)
FlagsNative | Action

Plays a sound at a unit for the specified player group. Use the “Last Played Sound” function to refer to this sound.

# Arguments

  • soundlink — Sound Link
  • int — Owning Player
  • playergroup — Audible Mask
  • unit — Unit
  • fixed — Height
  • fixed — Volume
  • fixed — Offset

Returns — void

native void SoundPlayOnUnitForPlayer(
	soundlink link,
	int inOwningPlayer,
	playergroup audibleMask,
	unit inUnit,
	fixed height,
	fixed volume,
	fixed offset,
);

Category: Sound / Sounds

# Examples

# campaigns/void.sc2campaign

MapScript.galaxy

// L2333
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox01", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(40), 10.0, 100.0, 0.0)
// L2335
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox012", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(39), 10.0, 100.0, 0.0)
// L2337
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox0122", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(5), 10.0, 100.0, 0.0)
// L2272
SoundPlayOnUnitForPlayer(SoundLink("Hybrid_Protoss_Death", -1), c_maxPlayers, PlayerGroupAll(), EventUnit(), 0.0, 100.0, 0.0)
// L606
SoundPlayOnUnitForPlayer(SoundLink("StoneZealot_Birth", -1), c_maxPlayers, PlayerGroupAll(), lp_construct, 0.0, 100.0, 0.0)
// L3543
SoundPlayOnUnitForPlayer(SoundLink("NydusWorm_Unload", -1), c_maxPlayers, PlayerGroupAll(), EventPlayerEffectUsedUnit(c_effectUnitCaster), 0.0, 100.0, 0.0)
// L2333
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox01", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(40), 10.0, 100.0, 0.0)
// L2335
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox012", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(39), 10.0, 100.0, 0.0)
// L2337
SoundPlayOnUnitForPlayer(SoundLink("PAiur01_ColossusEnterVox0122", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(5), 10.0, 100.0, 0.0)
// L2272
SoundPlayOnUnitForPlayer(SoundLink("Hybrid_Protoss_Death", -1), c_maxPlayers, PlayerGroupAll(), EventUnit(), 0.0, 100.0, 0.0)
// L606
SoundPlayOnUnitForPlayer(SoundLink("StoneZealot_Birth", -1), c_maxPlayers, PlayerGroupAll(), lp_construct, 0.0, 100.0, 0.0)
// L3543
SoundPlayOnUnitForPlayer(SoundLink("NydusWorm_Unload", -1), c_maxPlayers, PlayerGroupAll(), EventPlayerEffectUsedUnit(c_effectUnitCaster), 0.0, 100.0, 0.0)

# mods/core.sc2mod

NativeLib.galaxy

// L4269
SoundPlayOnUnitForPlayer(lp_soundLink, c_maxPlayers, lp_players, lp_unit, lp_height, lp_volume, lp_offset)
// L3535
SoundPlayOnUnitForPlayer(lp_soundLink, c_maxPlayers, lp_players, lp_unit, lp_height, lp_volume, lp_offset)

# mods/heroesbrawlmods/brawlmapmods/blackheartsrevenge.stormmod

LibMDoE.galaxy

// L2596
SoundPlayOnUnitForPlayer(SoundLink("Event_GhostShip_CannonBall_Loop", -1), c_maxPlayers, PlayerGroupAll(), lv_missile, 0.0, 100.0, 0.0)
// L3306
SoundPlayOnUnitForPlayer(SoundLink("Event_Mines_EnterMinesEnd", -1), c_maxPlayers, PlayerGroupAll(), lv_hero, 0.0, 100.0, 0.0)

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

LibPEB1.galaxy

// L7245
SoundPlayOnUnitForPlayer(SoundLink("Event_GhostShip_CannonBall_Loop", -1), c_maxPlayers, PlayerGroupAll(), lv_missile, 0.0, 100.0, 0.0)
// L5516
SoundPlayOnUnitForPlayer(SoundLink("Doodad_EscapeFromBraxis_Gate_Zerged_Loop", -1), c_maxPlayers, PlayerGroupAll(), libPEB1_gv_checkpoints[1].lv_entryGate, 0.0, 100.0, 0.0)
// L5518
SoundPlayOnUnitForPlayer(SoundLink("Doodad_EscapeFromBraxis_Gate_Zerged_Loop", -1), c_maxPlayers, PlayerGroupAll(), libPEB1_gv_checkpoints[1].lv_exitGate, 0.0, 100.0, 0.0)
// L5594
SoundPlayOnUnitForPlayer(SoundLink("Doodad_EscapeFromBraxis_Gate_Zerged_Loop", -1), c_maxPlayers, PlayerGroupAll(), libPEB1_gv_checkpoints[2].lv_entryGate, 0.0, 100.0, 0.0)
// L5596
SoundPlayOnUnitForPlayer(SoundLink("Doodad_EscapeFromBraxis_Gate_Zerged_Loop", -1), c_maxPlayers, PlayerGroupAll(), libPEB1_gv_checkpoints[2].lv_exitGate, 0.0, 100.0, 0.0)

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

LibPVEB.galaxy

// L246
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Direct", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)
// L249
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Indirect", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)

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

LibPVEM.galaxy

// L1230
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Direct", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)
// L1233
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Indirect", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)

# mods/heroesdata.stormmod

GameDataHelperLib.galaxy

// L4715
SoundPlayOnUnitForPlayer(SoundLink("Gen_Hearthstone_Teleport_Fizzle", -1), lv_hearthstonePlayer, PlayerGroupSingle(lv_hearthstonePlayer), lv_hearthstoneUnit, 0.0, 100.0, 0.0)

# mods/heroesdata.stormmod

GameLib.galaxy

// L3895
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Direct", -1), c_maxPlayers, PlayerGroupSingle(lp_playerKilling), lp_heroKilled, 0.0, 100.0, 0.0)
// L9131
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Direct", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)
// L9134
SoundPlayOnUnitForPlayer(SoundLink("XP_Gain_Indirect", -1), c_maxPlayers, PlayerGroupSingle(lv_itPlayer), lp_killedUnit, 0.0, 100.0, 0.0)

# mods/heroesdata.stormmod

SoundLib.galaxy

// L238
SoundPlayOnUnitForPlayer(SoundLink(lv_soundID, c_soundIndexAny), lp_speakingPlayer, lp_targetPlayerGroup, lv_heroUnit, 0.0, 100.0, 0.0)

# mods/heroesmapmods/battlegroundmapmods/alteracpass.stormmod

LibMMAP.galaxy

// L1326
SoundPlayOnUnitForPlayer(libMMAP_gv_aVSounds.lv_aVTeamSpecificSounds[lp_team].lv_coreGetHitLarge, c_maxPlayers, PlayerGroupAll(), libGame_gv_teams[lp_team].lv_core, 0.0, 100.0, 0.0)
// L1329
SoundPlayOnUnitForPlayer(libMMAP_gv_aVSounds.lv_aVTeamSpecificSounds[lp_team].lv_coreGetHitSmall, c_maxPlayers, PlayerGroupAll(), libGame_gv_teams[lp_team].lv_core, 0.0, 100.0, 0.0)
// L3067
SoundPlayOnUnitForPlayer(SoundLink("Gen_Spell_Slow_Loop_PLR", -1), lv_player, PlayerGroupSingle(lv_player), EventUnit(), 0.0, 100.0, 0.0)

# mods/heroesmapmods/battlegroundmapmods/blackheartsbay.stormmod

LibBBAY.galaxy

// L1716
SoundPlayOnUnitForPlayer(SoundLink("Event_GhostShip_CannonBall_Loop", -1), c_maxPlayers, PlayerGroupAll(), lv_missile, 0.0, 100.0, 0.0)

# mods/heroesmapmods/battlegroundmapmods/hauntedmines.stormmod

LibMHtM.galaxy

// L1744
SoundPlayOnUnitForPlayer(SoundLink("Event_Mines_EnterMinesEnd", -1), c_maxPlayers, PlayerGroupAll(), lv_heroUnit, 0.0, 100.0, 0.0)
// L1809
SoundPlayOnUnitForPlayer(SoundLink("Event_Mines_EnterMinesEnd", -1), c_maxPlayers, PlayerGroupAll(), lv_heroUnit, 0.0, 100.0, 0.0)

# mods/heroesmapmods/battlegroundmapmods/towersofdoom.stormmod

LibMTOD.galaxy

// L3177
SoundPlayOnUnitForPlayer(SoundLink("Event_Mines_EnterMinesEnd", -1), c_maxPlayers, PlayerGroupAll(), lv_hero, 0.0, 100.0, 0.0)

# mods/heroesmapmods/battlegroundmapmods/volskayadata.stormmod

LibVolV.galaxy

// L506
SoundPlayOnUnitForPlayer(SoundLink("Event_Volskaya_Vehicle_CriticalDamage", -1), c_maxPlayers, PlayerGroupSingle(lv_pilotPlayer), EventUnit(), 0.0, 100.0, 0.0)
// L510
SoundPlayOnUnitForPlayer(SoundLink("Event_Volskaya_Vehicle_CriticalDamage", -1), c_maxPlayers, PlayerGroupSingle(lv_gunnerPlayer), EventUnit(), 0.0, 100.0, 0.0)

# mods/novastoryassets.sc2mod

MapScript.galaxy

// L2790
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_artanis, 0.0, 100.0, 0.0)
// L2793
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_artanis, 0.0, 100.0, 0.0)
// L2071
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 100.0, 0.0)
// L2074
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 100.0, 0.0)
// L9637
SoundPlayOnUnitForPlayer(SoundLink("Spell_CloakField_Off", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(4741), 0.0, 400.0, 0.25)
// L9642
SoundPlayOnUnitForPlayer(SoundLink("Terran_CloakOn", -1), c_maxPlayers, PlayerGroupAll(), gv_cinematicNova, 0.0, 200.0, 0.0)
// L9659
SoundPlayOnUnitForPlayer(SoundLink("Spell_CloakField_On", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(4741), 0.0, 200.0, 0.5)
// L9694
SoundPlayOnUnitForPlayer(SoundLink("Marine_Land", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 200.0, 0.0)
// L1907
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_nova, 0.0, 100.0, 0.0)
// L1910
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_nova, 0.0, 100.0, 0.0)
// L3533
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdSmallCheering", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(537678267), 0.0, 100.0, 0.0)
// L3535
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdSmallDiscussion", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(851297348), 0.0, 100.0, 0.0)
// L3537
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdJeers_01", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(1098427410), 0.0, 100.0, 0.0)
// L2790
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_artanis, 0.0, 100.0, 0.0)
// L2793
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_artanis, 0.0, 100.0, 0.0)
// L2071
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 100.0, 0.0)
// L2074
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 100.0, 0.0)
// L9637
SoundPlayOnUnitForPlayer(SoundLink("Spell_CloakField_Off", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(4741), 0.0, 400.0, 0.25)
// L9642
SoundPlayOnUnitForPlayer(SoundLink("Terran_CloakOn", -1), c_maxPlayers, PlayerGroupAll(), gv_cinematicNova, 0.0, 200.0, 0.0)
// L9659
SoundPlayOnUnitForPlayer(SoundLink("Spell_CloakField_On", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(4741), 0.0, 200.0, 0.5)
// L9694
SoundPlayOnUnitForPlayer(SoundLink("Marine_Land", -1), c_maxPlayers, PlayerGroupAll(), gv_zeratul, 0.0, 200.0, 0.0)
// L1907
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Health_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_nova, 0.0, 100.0, 0.0)
// L1910
SoundPlayOnUnitForPlayer(SoundLink("HeroNovaMP1_Energy_Pickup", -1), c_maxPlayers, PlayerGroupAll(), gv_nova, 0.0, 100.0, 0.0)
// L3533
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdSmallCheering", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(537678267), 0.0, 100.0, 0.0)
// L3535
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdSmallDiscussion", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(851297348), 0.0, 100.0, 0.0)
// L3537
SoundPlayOnUnitForPlayer(SoundLink("Emitter_Nova07_CrowdJeers_01", -1), c_maxPlayers, PlayerGroupAll(), UnitFromId(1098427410), 0.0, 100.0, 0.0)

# mods/starcoop/starcoop.sc2mod

LibCOMI.galaxy

// L4593
SoundPlayOnUnitForPlayer(SoundLink("MusicDehakaMaxLevel", -1), lp_dehakaPlayer, PlayerGroupSingle(lp_dehakaPlayer), lp_dehakaUnit, 1.0, 100.0, 0.0)
// L16792
SoundPlayOnUnitForPlayer(SoundLink("DehakaEatDehaka", -1), c_maxPlayers, PlayerGroupAll(), lv_dehakaUnit, 1.0, 100.0, 0.0)
// L24824
SoundPlayOnUnitForPlayer(SoundLink("Medivac_Unload", -1), EventPlayer(), PlayerGroupAll(), lv_newUnit, 0.0, 100.0, 0.0)

# mods/starcoop/starcoop.sc2mod

LibCOMU.galaxy

// L12989
SoundPlayOnUnitForPlayer(SoundLink("InfestedCivilian_Moan", -1), c_maxPlayers, PlayerGroupAll(), lv_hungerTarget, 0.0, 100.0, 0.0)
// L12994
SoundPlayOnUnitForPlayer(SoundLink("InfestedCivilian_Moan", -1), c_maxPlayers, PlayerGroupAll(), lv_hungerTarget, 0.0, 100.0, 0.0)