Prototype/Sound

From Official Factorio Wiki
Revision as of 18:30, 8 October 2021 by Bilka (talk | contribs) (Documented support sound file formats)
Jump to navigation Jump to search

Template:Prototype parent Specifies a sound that can be used with https://lua-api.factorio.com/latest/Concepts.html#SoundPath during runtime.

Template:Prototype TOC

Mandatory properties

Template:Prototype property Must be "sound".

Template:Prototype property Name of the sound. Must be unique. Used as a https://lua-api.factorio.com/latest/Concepts.html#SoundPath.

Optional properties

Template:Prototype property One of "game-effect", "gui-effect", "ambient", "environment", "walking", "alert" and "wind".

Template:Prototype property Table with the following members:

  • max_count - uint32 - Mandatory.
  • progress_threshold - float - Optional. - Default: 1.0 - If count already playing is true, this will determine maximum progress when instance is counted toward playing sounds.
  • remove - bool - Mandatory.
  • count_already_playing - bool - Optional. - Default: false - If true already playing sounds are taken into account when checking maxCount.

Template:Prototype property

Template:Prototype property

Template:Prototype property Array of tables with the following members:

  • filename - FileName - Mandatory. Support sound file formats are .ogg, .wav and .voc.
  • volume - float - Optional. - Default: 1.0
  • preload - bool - Optional.
  • speed - float - Optional. - Default: 1.0 - Speed must be >= 1 / 64. This sets both min and max speed.
  • min_speed - float - Optional. Not loaded if speed is present. - Default: 1.0 - Speed must be >= 1 / 64.
  • max_speed - float - Mandatory if min_speed is present, otherwise not loaded. - Default: 1.0 - Must be >= min_speed.

Template:Prototype property Mandatory if variations is not given.

Support sound file formats are .ogg, .wav and .voc.

Template:Prototype property Only loaded if variations is not given.

Template:Prototype property Only loaded if variations is not given.

Template:Prototype property Only loaded if variations is not given. Speed must be >= 1 / 64. This sets both min and max speed.

Template:Prototype property Only loaded if variations is not given. Not loaded if speed is present. Speed must be >= 1 / 64.

Template:Prototype property Only loaded if variations is not given. Mandatory if min_speed is present, otherwise not loaded. Must be >= min_speed.