From 6a3b6963d70b0411a52ef91749c2798a13eeb547 Mon Sep 17 00:00:00 2001
From: Fabian Tullius <14092893+TheNytech@users.noreply.github.com>
Date: Thu, 14 Dec 2023 20:53:11 +0100
Subject: [PATCH 1/2] Create stream_audio_occlusions.md

---
 articles/tutorials/stream_audio_occlusions.md | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 articles/tutorials/stream_audio_occlusions.md

diff --git a/articles/tutorials/stream_audio_occlusions.md b/articles/tutorials/stream_audio_occlusions.md
new file mode 100644
index 0000000..7cd0fda
--- /dev/null
+++ b/articles/tutorials/stream_audio_occlusions.md
@@ -0,0 +1,42 @@
+# Stream Audio Occlusions
+
+In order to experience altV voice to its full contains, one needs to have certain files within their ressource (mainly MLOs) to enable Audio Occlusions for it.
+
+The purpose of the Audio Occlusion files is to accurately simulate sounds in consideration of obstacles or restrictions, such as rooms or portals.
+These files also allows the specific setting of sounds in rooms, such as echo.
+
+## The following files belong to Audio Occlusions:
+
+- a compiled meta file: `*.ymt`
+  
+- a audio data fale: `*.dat151.rel`
+  
+
+In order to have working Audio Occlusions, one has to also create a copy of the `*.dat151.rel` file and delete its `.rel` ending.
+
+In the end, the folder for the audio occlusion files should look like this:
+
+```
+example_mlo/
+|-> stream/
+|    |-> audio/
+|    |    |-> 385481254354.ymt
+|    |    |-> altvoice_game.dat151
+|    |    \-> altvoice_game.dat151.rel
+|    |-> REST OF THE RESSOURCE
+```
+
+*Note: It is not necessary to create a seperate folder within the stream folder for the Audio Occlusion files, but it's highly recommended due to the overview.*
+
+After importing the needed files into the stream folder, one has to add a line to the `stream.toml` for each pair of `*.dat151` and `*.dat151.rel` files.
+
+## stream.toml
+
+```toml
+files = [ 'stream/*' ]
+
+[meta]
+'stream/audio/altvoice_game.dat' = 'AUDIO_GAMEDATA'
+```
+
+Of course, the `"altvoice"` of the `*.dat151` and `*.dat151.rel` file is the name of the files for the ressource. In this case, it's just used as an example.

From 8b672ec58dcd837e13426b1038e768e61121492d Mon Sep 17 00:00:00 2001
From: Fabian Tullius <14092893+TheNytech@users.noreply.github.com>
Date: Thu, 4 Jan 2024 23:07:04 +0100
Subject: [PATCH 2/2] Update toc.yml

added AO entries
---
 articles/tutorials/toc.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/articles/tutorials/toc.yml b/articles/tutorials/toc.yml
index dce2748..44068ee 100644
--- a/articles/tutorials/toc.yml
+++ b/articles/tutorials/toc.yml
@@ -20,3 +20,5 @@
   href: stream_vehicles.md
 - name: Stream Weapons
   href: stream_weapons.md
+- name: Stream Audio Occlusions
+  href: stream_audio_occlusions.md