docs: document macOS language fallback logic and update implementation status for music and video features

Author: Okladnoj

Platform/MacOS/docs/FILE_SYSTEM.md

@@ -154,6 +154,38 @@ On Windows, `GetStringFromGeneralsRegistry("", "InstallPath")` returns the Base
 
 On macOS, `getStringFromRegistry` is wrapped with `#ifdef __APPLE__`. For the `InstallPath` key, it returns `basePath` discovered by the detector at startup.
 
+### `GetRegistryLanguage()` (Language from Options.ini)
+
+On Windows, the game language is read from the Windows registry. On macOS, `GetRegistryLanguage()` reads the `Language` key from `~/Command and Conquer Generals Zero Hour Data/Options.ini`.
+
+```
+Language = russian
+```
+
+Fallback: if the key is not found → `"english"`.
+
+> This is called **before** `OptionPreferences` initializes, so the file is parsed manually (line-by-line scan).
+
+### Localized Asset Resolution
+
+The engine uses `GetRegistryLanguage()` to build localized paths for speech, music, and video:
+
+**Audio** (`AudioEventRTS::adjustForLocalization`):
+```
+1. Data\Audio\Speech\Russian\unit.wav    ← localized (from Language)
+2. Data\Audio\Speech\unit.wav            ← base (no language subfolder)
+3. Data\Audio\Speech\English\unit.wav    ← English fallback (#ifdef __APPLE__)
+```
+
+**Video** (`FFmpegVideoPlayer::open`):
+```
+1. Data/Russian/Movies/file.bik          ← localized
+2. Data/English/Movies/file.bik          ← English fallback
+3. Data\Movies\file.bik                  ← generic
+```
+
+> Steps 3 (audio) and 2 (video) are macOS-specific additions. Without them, non-English locales have no speech or campaign videos because `.big` archives only contain files under `English/` subfolders.
+
 ## Core / Platform Duality
 
 Two `StdLocalFileSystem` implementations exist in the project:

Platform/MacOS/docs/IMPLEMENTATION_STATUS.md

@@ -1,6 +1,6 @@
 # macOS Port — Implementation Status
 
-> Updated: 2026-04-15
+> Updated: 2026-05-27
 
 ---
 
@@ -131,7 +131,8 @@
 | ✅ | `setDeviceListenerPosition` | Listener position/orientation → AVAudioEnvironmentNode |
 | ✅ | WAV loading | PCM WAV from disk + `.big` archives, stereo→mono downmix for 3D |
 | ✅ | Buffer cache | `m_bufferCache` prevents redundant disk reads |
-| ⚠️ | Music streaming | MP3/OGG streaming not implemented — music tracks are silent |
+| ✅ | Music streaming | MP3/AAC/ADPCM via `AVAudioFile` + `avbridge_playStream` |
+| ✅ | Language fallback | `adjustForLocalization()` → English fallback for speech/music in non-English locales |
 | ⚠️ | ADPCM WAV | Only PCM (format=1) supported; ADPCM files silently skipped |
 
 ---
@@ -200,11 +201,24 @@
 
 ---
 
-## 11. Launcher & Distribution
+## 11. Video
+
+| Status | Component | Note |
+|:---|:---|:---|
+| ✅ | `FFmpegVideoPlayer` | Bink → FFmpeg decoder for `.bik` playback (intro, campaign, challenge) |
+| ✅ | `MacOSVideoAudioStream` | A/V sync via `AVAudioEngine` PCM scheduling |
+| ✅ | Language fallback | `FFmpegVideoPlayer::open()` → English fallback for localized movie paths |
+
+---
+
+## 12. Launcher & Distribution
 
 | Status | Component | Note |
 |:---|:---|:---|
 | ✅ | `GeneralsLauncher` (SwiftUI) | Folder picker + game data validation + launch with env vars |
+| ✅ | Game Language picker | 11 languages, reads/writes `Options.ini`, scope `GLOBAL` |
+| ✅ | Extended settings | Camera height/speed, FPS limiter, stats overlay, network, debug |
+| ✅ | SteamCMD integration | Automatic asset download from Steam depots |
 | ✅ | `assemble_distribution.sh` | 6-step pipeline: dylib bundling, rpath cleanup, launcher compile, asset injection, README, ZIP |
 | ✅ | `dylibbundler` integration | Copies Homebrew `.dylib` deps → `Contents/Frameworks/`, rewrites `@rpath` |
 | ✅ | `Info.plist` patching | Sets `CFBundleExecutable` to `GeneralsLauncher`, injects `AppIcon.png` |