For this tutorial ive used apps:

1. Audacity

2. OpenIV

3. CodeWalker

4. Occlusion gen tool

5. Random mlo, ive used this: >LINK<

6. Templates for this tutorial: >LINK<

In many places in this tutorial will be copy from template rel file to your rel file, it doesnt matter where you put your copied xml segment and in what order organise it by yourself how it will be handy for your work.

About naming for this tutorial ive used simplified version for example:

simplesound_wavname compared to rockstar naming folderwithcontainersname_containername_wavname

simplified version will be better for beginners, advanced users will see patterns by themselfs its easy to figure out.

Important is to have unique names for all stuff cuz if chosen name already exist in vanilla files sound wil not work.

Also if you have already one mod installed with custom sounds u dont need create new dat54 file u can use direct names by calling StreamingSound or other types from one mod inside your dat151 file, its same like searching fo vanilla templates cuz custom songs are already registered in that mod with custom audio.

Its only basic tutorial i had in plans to make bigger tutorial but amount of free time what it took ive decided to stay at basics stuff, when wil have more time and mood for making tutos and there will be no any other tuto related to audio ect then will create more.

Output files you will have "game.dat151.rel.xml" and inside folder named same as your interior will be occlusion file named as numbers.ymt.pso.xml

I suggest having unique names for all of .rel files for example having format in naming like dlc name/mod name+game.dat151.rel

1. Change game.dat151.rel.xml into modname_game.dat151.rel.xml   

2. Using CodeWalker import numbers.ymt.pso.xml into location (if you dont have it, then create):

mods\update\x64\dlcpacks\modname\dlc.rpf\x64\audio\occlusion.rpf

3. Import modname_game.dat151.rel.xml into location:

mods\update\x64\dlcpacks\modname\dlc.rpf\x64\audio

4. Import modname_sounds.dat54.rel.xml from templates into same location as dat151

You can also use template dlc for this tutorial.

In dat151 u can setup for each mlo room its room tone using vanilla entries. When entering portal to room it will have desired roomtone.

You need to test by yourself what exact tone is by selecting one of vanilla setups.

Theres sound section in each mlo room. By default it has null_sound:

Change it to one of these example vanilla values:

dlc_h4_nightclub_roomtone
dlc_h4_int_sub_roomtone_general
dlc_h4_int_sub_roomtone_small
dlc_h4_office_room_tone_wrp
dlc_h4_vault_room_tone
dlc_apt_apartments_roomtone_yacht
dlc_apt_yacht_bridge_bridge_room_tone
dlc_vinewood_apartment_roomtone
dlc_vinewood_carpark
dlc_vinewood_garage
dlc_vinewood_casino_room_tone
hash_470DA449
hash_CB513B46
hash_14C4DE8E
hash_52BD77D0
hash_25B9E10A
hash_F7053865
hash_3E85112C
hash_0CDBD379
hash_8760A5FA

To find more room tones (theres many new roomtones added by different dlcs) search in dat151 files entries in interior rooms:

You can place static emitter with radio inside mlo room or at any place outside mlo. But to enable/disable it you need to use native AUDIO::SET_STATIC_EMITTER_ENABLED

1.Open template dat151.xml file and copy this section and paste into your dat151 file:

3. Rename static emitter name se_wavname_01 to unique name by replacing wavname to you custom name, also make sure your name of static emitter is same like name in StaticEmitterList (between <Item> and </Item>)

4. Do not change name of StaticEmitterList which is ambient_emitter_list_69 (in my tests safe is to change only numbers any other custom name can cause emitters to not work so better leave it as it is)

5a. If emitter will be at location outside mlo then remove entries for Interior and room changing it to:

<Interior/>

<Room/>

5b. If emitter will be inside mlo then change interiorname and interiorname_mloroomname to your actual mlo name and its room name:

Note: roomname is name from InteriorRoom NOT MloRoom name.

6. In Position section put coords for your emitter

Note: for mlo emitter use word coords not mlo offset

7. In radiostation section put one of these radio examples:

radio_16_silverlake
radio_15_motown
radio_14_dance_02
radio_13_jazz
radio_12_reggae
radio_11_talk_02
hidden_radio_10_surf
radio_09_hiphop_old
radio_08_mexican
radio_07_dance_01
radio_06_country
radio_05_talk_01
radio_04_punk
radio_03_hiphop_new
radio_02_pop
radio_01_class_rock

You can find other types by searching RadioName in any dat151 file.

8. Add to your script native which will enable static emitter for example in C#:

To play any custom audio (song/playlist of songs) you need convert them into separate mono channels.

1.Open Audacity and import mp3 song into it, you will see 2  stereo channels (ofcorse if your mp3 or supported input format will be stereo):

5. Import again mp3 file into Audacity and repeat process - convert to mono but this time delete upper channel and save it as  signed 16-bit PCM and name it wavname_right where wavname change to your name. Leave _right in name cuz it will indicate thats right mono channel.

6. Now put these two .wav files in  template folder  templates\audio wave container\awcname

7. Change name of folder awcname and awcname.oac file to your custom unique name (must be unique and different from already existing .awc containers in game)

8. Edit your .oac file and change names inside:

9. In OpenIV in edit mode turned on, go to location:

Choose import openFormats and import your .oac file:

11. Now back to CodeWalker (dont use OpenIV and CodeWalker at same time specially with edit mode cuz it can corrupt files)

Edit your modname_game.dat151.rel into location:

and change all names to your custom names of audio files, also add all custom names to .nametable otherway names will be hashed:

Note: DLCNAME is name of folder where AWCNAME is placed.

streamingsound_wavname it has no _left or _right in name cuz it contains both channels.

12. To place correct duration go to your .awc file, tab Details->MultiChannelSource->Lenght and copy this value and remove dot:

14. Change all wavname to your custom wav file name (without _left or _right)

Change dlcname to your short dlc name

15. Now copy from template file dat151.xml these values and paste it into your modname_game.dat151.rel file:

17. To enable/disable your static emitter with custom sound you need to use native  AUDIO::SET_STATIC_EMITTER_ENABLED, for example in C#:

Function.Call(Hash.SET_STATIC_EMITTER_ENABLED, "se_wavname_01", true); //setting bool to false will disable emitter

Using Ambient Zones you can add more ambient sounds to area, like animal sounds, people sounds, phone rings, background traffic city sounds and many many more.

Theres two types of Ambient Zones:

1. Exterior (main ones) - zones with prefixes az_ (have many flags like common 0xAA800424, 0xAA800420 used mostly underground places like tunnels but never use 0xAA800425)

2. Interior - zones with prefixes iz_ have always flag 0xAA800425

For proper work exterior Ambient Zones are listed and grouped in main AmbientZoneList named ambient_zone_list which contains all zones with prefixes az_ 

aside of main list you can create custom list of zones which will contain only selected area zones and then you can enable/disable whole list of zones in area using native AUDIO::SET_AMBIENT_ZONE_LIST_STATE.

Interior zones are created around mlo room inside which you want enable ambient sounds.

On above example there will be 3 ambient zone lists (one main and two custom) which will contain:

1.Main ambient zone list named ambient_zone_list

-az1

-az2

-az3

2.Custom ambient list named custom_az_list1

-az1

-az2

3.Custom ambient list named custom_az_list2

-az3

Interior zone iz_1 will be NOT listed on any list.

So if you will want to disable az_1 and az_2 you use Function.Call(Hash.SET_AMBIENT_ZONE_LIST_STATE, "custom_az_list1", 0, 0);

and if you will want to disable az_3 you use Function.Call(Hash.SET_AMBIENT_ZONE_LIST_STATE, "custom_az_list2", 0, 0);

Change name of ambient zone az_zonename_01 to your unique name (change only zonename_01, leave prefix az_ unchanged)

Change name of custom AbientZoneList <Item>name</Item> to your unique name

DO NOT CHANGE name ambient_zone_list it must stay as it is.

Change both coords to your location (it will be exterior ambient zone) rest values leave for now.

2. Copy paste to your rel151 file from template rel151.xml values:+

This will be interior ambient zone.

Change both coords into your mlo placement coords

Change name of this ambient zone from iz_mloroomname to your unique name (leaving unchanged prefix iz_) and place this name in your interior room for which you create this zone:

Reminder: place all new unique names in .nametable otherway names will be hashed

Save changes and import your dat151 file into project in CodeWalker, enable audio edition and go to your zone location:

Now adjust position and rotation of your both zones.

Adjust size manually by increasing/decreasing values in Inner size and Outer size

Outer size must be biger than inner size

Save changes and put back your file into rpf explorer and edit it. Go back to your interior ambient zone section.

Adding ambient sounds into your interior ambient zone you use AmbientRules:

StartTime 0 and EndTime 1440 means it will be played 24H

If you want to setup specific time for example from 9:35 to 17:15 you need:

9:35 -> (9+(35/60))x60 -> 575= StartTime

17:15 -> (17+(15/60)x60 -> 1035 = EndTime

To see oposite whats is time you do:

StartTime = 

Hour: 575 / 60 = 9.583333333333333 cut everything after dot to get hour in this case hour will be 9

Minutes: Take everything from above after dot and multiply by 60 (0.583333333333333x60=35) so minutes are 35

Total Start time is 9:35

EndTime =

Hour: 1035/60=17.25 cut everything after dot to get hour in this case hour will be17

Minutes: Take everything from above after dot and multiply by 60 (0.25x60=15) so minutes are 15

Total EndTime is 17:15

One of other advanced settings for playing ambient audio you can add in ExtParams, for example sound will be played if rain level will be at certain value:

Using static emitters and alarm entry in dat151 u can build alarm system. Compared to normal static emitters u dont enable or disable them. For this will be used natives:

AUDIO::START_ALARM -> this will enable main alarm and all static emitters signed to this alarm

AUDIO::STOP_ALARM -> this will disablemain alarm and all static emitters signed  to this alarm

To place own alarm system in yor mlo or area open your modname_game.dat151.rel file and open from templates dat151.xml file and copy paste to your dat151 file:

Change all selected names to unique ones and make sure to have same name for alarm in "Alarm" and "StaticEmitter"

For coords place alarm bit higher compared to static emitter cuz alarm is far sound and emitter is close sound, you can add many emitters to one alarm but in each make sure to have same alarm name.

Place also all your alarm static emitters under StaticEmitterList otherway they will not work:

Before activating alarm use AUDIO::PREPARE_ALARM

otherway u will need to call two times AUDIO::START_ALARM at first alarm start

To stop alarm use AUDIO::STOP_ALARM

C# native example: