STFC-Mod · netniV · Oct 5, 2026 · Aug 29, 2026 · Aug 29, 2026 · Sep 2, 2026
diff --git a/example_community_patch_settings_da.toml b/example_community_patch_settings_da.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[======================================================================================================]> 
 #                                                                                                             
 #       *****                        *                   *               *                                    

diff --git a/example_community_patch_settings_de.toml b/example_community_patch_settings_de.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_en-GB-x-cockney.toml b/example_community_patch_settings_en-GB-x-cockney.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_en-x-minionese.toml b/example_community_patch_settings_en-x-minionese.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_en.toml b/example_community_patch_settings_en.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_es.toml b/example_community_patch_settings_es.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=====================================================]> 
 #                                                            
 #       *   *            *                                   

diff --git a/example_community_patch_settings_fr.toml b/example_community_patch_settings_fr.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_nl.toml b/example_community_patch_settings_nl.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              

diff --git a/example_community_patch_settings_ru.toml b/example_community_patch_settings_ru.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[============================================================]> 
 #                                                                   
 #                                                                   

diff --git a/example_community_patch_settings_tlh.toml b/example_community_patch_settings_tlh.toml
@@ -37,6 +37,15 @@ disabled_events = ""
 # Write audio event names to the trace log for troubleshooting
 trace_events = false
 
+# Optional generated notification cues; "none" disables an alert.
+# Available sounds: default, info, success, warning, alarm, arrival, soft, ping, repair
+# Requires patches.toastbannerhooks = true.
+alert_victory = "none"
+alert_defeat = "none"
+alert_armada_created = "none"
+alert_armada_battle_won = "none"
+alert_armada_battle_lost = "none"
+
 #  <[=====================================================]> 
 #                                                            
 #       *   *          ****         *               *        

diff --git a/mods/src/config.cc b/mods/src/config.cc
@@ -32,6 +32,26 @@ namespace DCS  = DefaultConfig::Sync;
 namespace DCSC = DefaultConfig::SystemConfig;
 namespace DCSH = DefaultConfig::Shortcuts;
 
+namespace
+{
+struct ToastAudioAlertConfig {
+  int                       toast_state;
+  std::string_view          config_name;
+  std::string_view          default_sound;
+  NotificationSound Config::* config_member;
+};
+
+constexpr auto kToastAudioAlerts = std::to_array<ToastAudioAlertConfig>({
+    {ToastState::Victory, "alert_victory", DCA::alert_victory, &Config::alert_victory},
+    {ToastState::Defeat, "alert_defeat", DCA::alert_defeat, &Config::alert_defeat},
+    {ToastState::ArmadaCreated, "alert_armada_created", DCA::alert_armada_created, &Config::alert_armada_created},
+    {ToastState::ArmadaBattleWon, "alert_armada_battle_won", DCA::alert_armada_battle_won,
+     &Config::alert_armada_battle_won},
+    {ToastState::ArmadaBattleLost, "alert_armada_battle_lost", DCA::alert_armada_battle_lost,
+     &Config::alert_armada_battle_lost},
+});
+} // namespace
+
 static const eastl::tuple<const char*, int> bannerTypes[] = {
     {"All", ToastState::All},
     {"Standard", ToastState::Standard},
@@ -128,6 +148,12 @@ Config& Config::Get()
   return config;
 }
 
+NotificationSound Config::NotificationSoundForToast(int toast_state) const
+{
+  const auto alert = std::ranges::find(kToastAudioAlerts, toast_state, &ToastAudioAlertConfig::toast_state);
+  return alert == kToastAudioAlerts.end() ? NotificationSound::None : this->*(alert->config_member);
+}
+
 MissionHudVisibility Config::MissionHudButtonVisibility(std::string_view button_name) const
 {
   const auto it = this->mission_hud_buttons.find(std::string(button_name));
@@ -324,6 +350,25 @@ T get_config_or_default(toml::table& config, toml::table& new_config, std::strin
   return (T)final_value;
 }
 
+NotificationSound get_notification_sound(toml::table& config, toml::table& new_config, std::string_view item,
+                                         std::string_view default_value, bool write_log)
+{
+  const auto value = get_config_or_default<std::string>(config, new_config, "audio", item,
+                                                         std::string(default_value), false);
+  auto sound = notification_sound_from_name(StripAsciiWhitespace(value));
+  if (!sound.has_value()) {
+    spdlog::warn("invalid config value audio.{}: '{}'; using {}", item, value, default_value);
+    sound = notification_sound_from_name(default_value);
+  }
+
+  const auto result = sound.value_or(NotificationSound::None);
+  new_config["audio"].as_table()->insert_or_assign(item, notification_sound_name(result));
+  if (write_log) {
+    spdlog::debug("config value audio.{} value: {}", item, notification_sound_name(result));
+  }
+  return result;
+}
+
 template <typename T>
 T get_config_or_default_with_alias(toml::table& config, toml::table& new_config, std::string_view section,
                                    std::string_view item, std::string_view alias, T default_value, bool write_log)
@@ -1052,6 +1097,15 @@ void Config::Load()
       this->disabled_audio_events.emplace_back(stripped);
     }
   }
+  bool any_toast_audio_alert_configured = false;
+  for (const auto& alert : kToastAudioAlerts) {
+    const auto sound = get_notification_sound(config, parsed, alert.config_name, alert.default_sound, write_config);
+    this->*(alert.config_member) = sound;
+    any_toast_audio_alert_configured |= sound != NotificationSound::None;
+  }
+  if (!this->installToastBannerHooks && any_toast_audio_alert_configured) {
+    spdlog::warn("audio alerts require patches.toastbannerhooks = true");
+  }
   this->auto_open_bulk_claim_flyout = get_config_or_default(config, parsed, "ui", "auto_open_bulk_claim_flyout",
                                                             DCU::auto_open_bulk_claim_flyout, write_config);
 

diff --git a/mods/src/config.h b/mods/src/config.h
@@ -8,6 +8,8 @@
 
 #include <toml++/toml.h>
 
+#include "patches/notification_audio.h"
+
 #if _WIN32
 #include <Windows.h>
 #endif
@@ -158,6 +160,7 @@ class Config final
   void        AdjustUiViewerScale(bool scaleUp);
 
   [[nodiscard]] MissionHudVisibility MissionHudButtonVisibility(std::string_view button_name) const;
+  [[nodiscard]] NotificationSound    NotificationSoundForToast(int toast_state) const;
 
   // Disallow copying/moving to enforce singleton
   Config(const Config&)            = delete;
@@ -217,6 +220,11 @@ class Config final
   bool                     disable_toast_banners;
   bool                     trace_audio_events;
   std::vector<std::string> disabled_audio_events;
+  NotificationSound alert_victory            = NotificationSound::None;
+  NotificationSound alert_defeat             = NotificationSound::None;
+  NotificationSound alert_armada_created     = NotificationSound::None;
+  NotificationSound alert_armada_battle_won  = NotificationSound::None;
+  NotificationSound alert_armada_battle_lost = NotificationSound::None;
   bool                     auto_open_bulk_claim_flyout;
   bool                     auto_confirm_ft_upgrade;
 

diff --git a/mods/src/defaultconfig.h b/mods/src/defaultconfig.h
@@ -11,6 +11,11 @@ namespace Audio
 {
   constexpr const char* disabled_events = "";
   constexpr bool        trace_events    = false;
+  constexpr const char* alert_victory = "none";
+  constexpr const char* alert_defeat = "none";
+  constexpr const char* alert_armada_created = "none";
+  constexpr const char* alert_armada_battle_won = "none";
+  constexpr const char* alert_armada_battle_lost = "none";
 } // namespace Audio
 
 namespace SystemConfig

diff --git a/mods/src/notification_audio_mac.mm b/mods/src/notification_audio_mac.mm
@@ -0,0 +1,27 @@
+#ifdef __APPLE__
+
+#include "patches/notification_audio_platform.h"
+
+#import <AppKit/AppKit.h>
+
+bool notification_audio_platform_play(const uint8_t* data, size_t size)
+{
+  @autoreleasepool {
+    static NSSound* current_sound = nil;
+
+    NSData* sound_data = [NSData dataWithBytesNoCopy:const_cast<uint8_t*>(data) length:size freeWhenDone:NO];
+    NSSound* sound      = [[NSSound alloc] initWithData:sound_data];
+    if (!sound) return false;
+
+    [current_sound stop];
+#if __has_feature(objc_arc)
+    current_sound = sound;
+#else
+    [current_sound release];
+    current_sound = sound;
+#endif
+    return [current_sound play];
+  }
+}
+
+#endif