Classes:AmbientSound

Note: Wait! Stop! Before you copy this actor's definition into your mod, remember the following things: You do not need to copy that actor, since it is already defined. In fact, it's not just useless, it's actually harmful as it can cause problems. If you want to modify it, or use a modified version, using inheritance is the way to go. The actor definitions here are put on the wiki for reference purpose only. Learn from them, don't copy them. There is only one exception: if what you want is changing Ammo capacity, you need to create a new type from Ammo.

Ambient sound
Actor type	Map spot	Game
DoomEd Number	14065	Class Name	AmbientSound

Classes: Actor → AmbientSound
 → AmbientSoundNoGravity

The AmbientSound thing plays an ambient sound determined by its first parameter. The sounds themselves must be defined in SNDINFO. While some ambient sounds are defined in ZDoom.pk3, none of them are actually added to the index of ambient sounds with the $ambient command, so a map using this thing needs a SNDINFO lump. Up to 64 ambient sounds can be used in the Doom map format, 256 otherwise.

UDMF map now allow to use sound indices above 256, so there is no limit anymore to the amount of ambient sounds. (New from 2.5.0)

The second parameter determines the volume of the sound, as a percentile value. 0 is interpreted as the default (100). (New from 2.5.0)

The third parameter determines the minimum distance for sound fading to be applied. If left to zero, the standard rolloff is used instead. (New from 2.5.0)

The fourth parameter determines the maximum distance at which the sound can be heard. If left to zero, or if lower than the third parameter, the standard rolloff is used instead. (New from 2.5.0)

The fifth and last parameter, if not null, is a scalar for the third and fourth parameters. (New from 2.5.0)

Use in a Doom-format map

In a map format where things cannot have parameters, DoomEd numbers 14001 to 14064 can be used instead: ZDoom will translate each such item in the map to an AmbientSound actor whose first parameter is equal to its number minus 14000. (So, 14001 will be interpreted as if it were 14065 with first parameter 1.)

DECORATE definition

ACTOR AmbientSound 14065 native
{
  +NOBLOCKMAP
  +NOSECTOR
  +DONTSPLASH
}

See Also

• SNDINFO
• Predefined sounds