Skip to main content

Sound

Namespace: DeadworksManaged.Api

Deadlock's audio system exposes one primary way to play sounds: soundevents — named entries in the game's audio manifest (e.g. Mystical.Piano.AOE.Explode, Male.AnnTemp.Core_Damaged). You cannot play raw .vsnd files directly.

Playing a Soundevent on an Entity​

The simplest case — play a sound on a pawn, NPC, or world entity:

pawn.EmitSound("Mystical.Piano.AOE.Warning");
pawn.EmitSound("Damage.Send.Crit", pitch: 100, volume: 0.5f, delay: 0f);
ParameterTypeDefaultDescription
soundNamestring—Full soundevent name
pitchint100100 = normal pitch
volumefloat1.00.0–1.0
delayfloat0.0Seconds before the sound actually starts

The sound plays in 3D space attached to the entity. Nearby players hear it with positional falloff.

Playing a Soundevent Globally (Any Position)​

EmitSound requires an entity. For a sound that plays from an arbitrary world position, spawn a point_soundevent and let it clean itself up:

void PlayAt(string soundName, Vector3 position)
{
    var sound = CBaseEntity.CreateByDesignerName("point_soundevent");
    if (sound == null) return;

    var ekv = new CEntityKeyValues();
    ekv.SetString("soundName", soundName);
    ekv.SetBool("startOnSpawn", true);
    ekv.SetVector("origin", position);

    // Auto-remove after playback finishes so we don't leak entities.
    sound.AcceptInput("addoutput", value: "OnSoundFinished>!self>Kill>>0>-1");
    sound.Spawn(ekv);
}

Silent Soundevent Problems​

If EmitSound appears to return success but you hear nothing:

  • Check the volume on the soundevent itself. Some internal soundevents are authored at very low dB (Music.Base.Attack is -6 dB). The volume parameter multiplies an already-quiet source.
  • Verify with soundinfo <soundname> in the console — it will tell you whether the soundevent resolved to a playable sound and at what volume.
  • Soundevents that are 3D-positional are inaudible when the listener is far from the entity. Attach to the player pawn or use the global recipe above.

Finding Soundevent Names​

  • soundinfo <name> in the server console — tests whether a name resolves and prints its sound file
  • Extract soundevents_*.vsndevts_c with source2viewer-cli or browse via s2v.app
  • In-game community references sometimes list popular ones (announcer lines, hero abilities)

See Also​

  • Entities — EmitSound is defined on CBaseEntity
  • Precaching — Soundevents usually don't need precaching, but the underlying .vsnd files sometimes do