clip#

Defines a clip to be used in a sound script, which is a single sound file with properties that determine how it is played in the game.

module yourModule {
  sound yourSound {
    category = Animal,
    loop = true,
    is3D = true,
    clip {
      file = media/sound/RideOfTheValkyries.ogg,
      distanceMin = 20,
      distanceMax = 650,
      reverbFactor = 0.1,
      volume = 0.7,
    }
  }
}

Hierarchy#

Valid Parent Blocks:

ID Properties#

This block should not have an ID.

Parameters#

distanceMax#

Type:

integer

distanceMax and distanceMin respectively set the maximum and minimum distances between which the sound will gradually decrease in volume.

distanceMin#

Type:

integer

See distanceMax for more details.

event#

Type:

string

Specifies an event that will trigger the playback of a specific sound. Used for sounds from FMOD sound banks (vanilla sound files).

file#

Type:

string

The path to the sound file to be played, relative to the folder above the media folder. For the following file path:

📁 MyMod
  📁 media
    📁 sound
      📄 my_sound.ogg

This parameter will be:

file = media/sound/my_sound.ogg

A file can be both of file format .ogg or .wav, but .ogg is recommended for its smaller file size and better compression.

pitch#

Type:

float

The pitch of the sound.

reverbFactor#

Type:

float

reverbFactor sets the amount of reverb applied to the sound while reverbMaxRange sets the maximum distance at which the reverb will be applied.

reverbMaxRange#

Type:

float

See reverbFactor for more details.

stopImmediate#

Type:

Any

No description

volume#

Type:

float

Adjusts the volume of the sound. Preferably your sound file should be properly normalized to a volume of 1.0.