Add fleet transition notifications

.github/workflows/ci.yaml

@@ -206,6 +206,13 @@ jobs:
       - name: Build
         run: xmake build -y stfc-community-mod
 
+      - name: Test fleet observation trackers
+        run: |
+          xmake build -y miner-opc-tests
+          xmake build -y fleet-arrival-tests
+          xmake run miner-opc-tests
+          xmake run fleet-arrival-tests
+
       - name: Test x64 trampoline relocation
         shell: pwsh
         run: |
@@ -521,6 +528,13 @@ jobs:
         shell: bash
         run: sccache --show-stats
 
+      - name: Test fleet observation trackers
+        run: |
+          xmake build -y miner-opc-tests
+          xmake build -y fleet-arrival-tests
+          xmake run miner-opc-tests
+          xmake run fleet-arrival-tests
+
       - name: Report Swift module cache
         shell: bash
         run: |

example_community_patch_settings_da.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[======================================================================================================]> 
 #                                                                                                             
 #       *****                        *                   *               *                                    
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_de.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_en-GB-x-cockney.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_en-x-minionese.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_en.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -263,6 +282,8 @@ loadingtiphooks = true
 doubleclickassignshiphooks = true
 forbiddentechconfirmhooks = true
 audioeventhooks = true
+# Install fleet observers independently of the desktop/audio selections.
+fleetnotificationhooks = true
 freeresizehooks = true
 game_version = true
 giftsbulkclaimhooks = true
@@ -700,6 +721,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_es.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=====================================================]> 
 #                                                            
 #       *   *            *                                   
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_fr.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_nl.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------
 

example_community_patch_settings_ru.toml

@@ -37,6 +37,25 @@ 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"
+
+# Fleet cues are independent of desktop notifications and toastbannerhooks.
+# Use the sound names above; "none" disables a cue. Windows and macOS.
+alert_fleet_arrived_in_system = "none"
+alert_fleet_arrived_at_destination = "none"
+alert_fleet_started_mining = "none"
+alert_fleet_node_depleted = "none"
+alert_fleet_docked = "none"
+alert_fleet_repair_complete = "none"
+alert_fleet_miner_opc = "none"
+
 #  <[============================================================]> 
 #                                                                   
 #                                                                   
@@ -689,6 +708,10 @@ disabled_banner_types = ""
 # Specifies banner types that should trigger notifications (comma separated)
 notify_banner_types = ""
 
+# Fleet events that should trigger Windows/macOS notifications (comma separated, or "All")
+# Options: ArrivedInSystem, ArrivedAtDestination, StartedMining, NodeDepleted, Docked, RepairComplete, MinerOPC
+notify_fleet_events = ""
+
 # Subgroup: Chat
 # --------------