Sound - Prototype Docs

Sound :: struct or SoundDefinition or array[SoundDefinition] Example code

Properties

category optional	:: SoundType
priority optional	:: uint8	Sounds with higher priority will replace a sound with lower priority if the maximum sounds limit is reached. [...]
Sounds with higher priority will replace a sound with lower priority if the maximum sounds limit is reached. [...]
aggregation optional	:: AggregationSpecification
allow_random_repeat optional	:: boolean
audible_distance_modifier optional	:: double	Modifies how far a sound can be heard. [...]
Modifies how far a sound can be heard. [...]
game_controller_vibration_data optional	:: GameControllerVibrationData
advanced_volume_control optional	:: AdvancedVolumeControl
speed_smoothing_window_size optional	:: uint32
variations optional	:: SoundDefinition or array[SoundDefinition]
filename optional	:: FileName	Supported sound file formats are `.ogg` (Vorbis and Opus) and `.wav`. [...]
Supported sound file formats are `.ogg` (Vorbis and Opus) and `.wav`. [...]
volume optional	:: float	Only loaded if `variations` is not defined. [...]
Only loaded if `variations` is not defined. [...]
min_volume optional	:: float	Only loaded if `variations` and `volume` are not defined. [...]
Only loaded if `variations` and `volume` are not defined. [...]
max_volume optional	:: float	Only loaded if `variations` is not defined. [...]
Only loaded if `variations` is not defined. [...]
preload optional	:: boolean	Only loaded if `variations` is not defined.
Only loaded if `variations` is not defined.
speed optional	:: float	Speed must be `>= 1 / 64`. [...]
Speed must be `>= 1 / 64`. [...]
min_speed optional	:: float	Must be `>= 1 / 64`. [...]
Must be `>= 1 / 64`. [...]
max_speed optional	:: float	Must be `>= min_speed`. [...]
Must be `>= min_speed`. [...]
modifiers optional	:: SoundModifier or array[SoundModifier]	Only loaded if `variations` is not defined.
Only loaded if `variations` is not defined.

Properties

category :: SoundType optional

priority :: uint8 optional

Default: 127

Sounds with higher priority will replace a sound with lower priority if the maximum sounds limit is reached.

0 is the highest priority, 255 is the lowest priority.

aggregation :: AggregationSpecification optional

allow_random_repeat :: boolean optional

Default: false

audible_distance_modifier :: double optional

Default: 1.0

Modifies how far a sound can be heard. Cannot be less than zero.

game_controller_vibration_data :: GameControllerVibrationData optional

advanced_volume_control :: AdvancedVolumeControl optional

speed_smoothing_window_size :: uint32 optional

Default: 0

variations :: SoundDefinition or array[SoundDefinition] optional

filename :: FileName optional

Supported sound file formats are .ogg (Vorbis and Opus) and .wav.

Only loaded, and mandatory if variations is not defined.

volume :: float optional

Default: 1.0

Only loaded if variations is not defined.

This sets both min and max volumes.

Must be >= 0.

min_volume :: float optional

Default: 1.0

Only loaded if variations and volume are not defined.

Must be >= 0.

max_volume :: float optional

Default: 1.0

Only loaded if variations is not defined.

Only loaded if min_volume is defined.

Must be >= min_volume.

preload :: boolean optional

Only loaded if variations is not defined.

speed :: float optional

Default: 1.0

Speed must be >= 1 / 64. This sets both min and max speeds.

Only loaded if variations is not defined.

min_speed :: float optional

Default: 1.0

Must be >= 1 / 64.

Only loaded if both variations and speed are not defined.

max_speed :: float optional

Default: 1.0

Must be >= min_speed.

Only loaded if variations is not defined. Only loaded, and mandatory if min_speed is defined.

modifiers :: SoundModifier or array[SoundModifier] optional

Only loaded if variations is not defined.

Example

{
  filename = "__base__/sound/ambient/world-ambience-3.ogg",
  volume = 1.2
}

Type used in

Factorio Prototype Docs Version 2.0.72

Sound :: struct or SoundDefinition or array[SoundDefinition] Example code

Properties

Properties

category :: SoundType optional

priority :: uint8 optional

aggregation :: AggregationSpecification optional

allow_random_repeat :: boolean optional

audible_distance_modifier :: double optional

game_controller_vibration_data :: GameControllerVibrationData optional

advanced_volume_control :: AdvancedVolumeControl optional

speed_smoothing_window_size :: uint32 optional

variations :: SoundDefinition or array[SoundDefinition] optional

filename :: FileName optional

volume :: float optional

min_volume :: float optional

max_volume :: float optional

preload :: boolean optional

speed :: float optional

min_speed :: float optional

max_speed :: float optional

modifiers :: SoundModifier or array[SoundModifier] optional

Example

Prototypes

Types

Defines

Factorio Prototype DocsVersion 2.0.72

Sound :: struct or SoundDefinition or array[SoundDefinition] Example code

Properties

Properties

category :: SoundType optional

priority :: uint8 optional

aggregation :: AggregationSpecification optional

allow_random_repeat :: boolean optional

audible_distance_modifier :: double optional

game_controller_vibration_data :: GameControllerVibrationData optional

advanced_volume_control :: AdvancedVolumeControl optional

speed_smoothing_window_size :: uint32 optional

variations :: SoundDefinition or array[SoundDefinition] optional

filename :: FileName optional

volume :: float optional

min_volume :: float optional

max_volume :: float optional

preload :: boolean optional

speed :: float optional

min_speed :: float optional

max_speed :: float optional

modifiers :: SoundModifier or array[SoundModifier] optional

Example

Prototypes

Types

Defines

Factorio Prototype Docs Version 2.0.72