Sound模组制作

音效定义位于/Hearts of Iron IV/sound中。音频文件应保存为WAV文件，立体声、单声道、44100Hz、32 位浮点。

所有音效定义文件都必须保存为.asset文件。

音效

sound条目用于定义声音。它遵循以下格式：

sound = {
    name = <name>
    file = <path>
    always_load = <bool>
    volume = <float>
}

name是被其他文件引用的音效定义名称。

file是音频文件的路径，相对于 Hearts of Iron IV 的sound文件夹。

always_load定义该声音是否始终加载。

volume定义该声音的音量。

音效

soundeffect条目用于定义音效。它遵循以下格式：

soundeffect = {
    name = <name>
    falloff = <name>
    sounds = {
        sound = <name>
        weighted_sound = { 
            sound = <name> 
            weight = int 
        }
    }
    
    loop = <bool>
    is3d = <bool>
    random_sound_when_looping = <bool>
    
    max_audible = <int>
    max_audible_behaviour = <type>
    
    volume = <float>
    fade_in = <float>
    fade_out = <float>
    
	looping_delay_random_offset = <bool>
    delay_random_offset = {
        <float>
        <float>
    }
    
	looping_playbackrate_random_offset = <bool>
    playbackrate_random_offset = {
        <float>
        <float>
    }
    
    volume_random_offset = {
        <float>
        <float>
    }
    
    prevent_random_repetition = <bool>
}

name是音效的名称。

falloff是该音效所使用的衰减条目。

sounds是该音效所使用的音效条目。

loop定义该音效是否循环。

is3d定义该音效是否应使用 3D 声音。

random_sound_when_looping定义该音效在循环时是随机选取声音，还是按顺序依次选取。

max_audible定义同一时刻该音效实例的最大数量。

max_audible_behaviour定义当同时发生超过max_audible个实例时会发生什么。它始终为fail。

volume定义该音效的音量。

fade_in定义该音效的淡入时长。

fade_out定义该音效的淡出时长。

looping_delay_random_offset ???

delay_random_offset定义声音循环之间延迟的随机偏移最小与最大值。

looping_playbackrate_random_offset ???

playbackrate_random_offset定义声音循环之间播放速率的随机偏移最小与最大值。

volume_random_offset定义声音循环之间音量的随机偏移最小与最大值。

prevent_random_repetition防止同一声音在刚播放后立即再次播放

Falloff

衰减条目定义声音的衰减属性。它们被添加到音效中，并遵循以下格式：

falloff = {
    name = <name>
    
    min_distance = <float>
    max_distance = <float>
    height_scale = <float>
}

name是衰减条目的名称。

min_distance是应用衰减之前的最小距离，即最大音量

max_distance是完全听不到声音之前的最大距离。

height_scale是声源与玩家摄像机之间高度的缩放系数。

Categories

音效可以被放入对声音应用特定压缩器的音效类别中。类别遵循以下格式：

category = {
    name = <name>
    soundeffects = {
        <name>
    }
    compressor = {
        enabled = yes
        pregain = <float>
        postgain = <float>
        ratio = <float>
        threshold = <float>
        attacktime = <float>
        releasetime = <float>
    }
}

name是音效类别的名称。

soundeffects是属于该类别的音效列表。

compressor是用于该类别的压缩器，关于各属性的更多信息见下文。

Compressors

有两个全局压缩器：master_compressor用于音效，music_compressor用于音乐。可以按类别为音效定义各自的压缩器。

压缩器使用以下格式：

<name> = {
    pregain = <float>
    postgain = <float>
    ratio = <float>
    threshold = <float>
    attacktime = <float>
    releasetime = <float>
}