Add fleet OPC highlights and mining ETA indicators on Windows and macOS

.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"
+
 #  <[======================================================================================================]> 
 #                                                                                                             
 #       *****                        *                   *               *                                    
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Forhindr "Escape" i at spørge, om spillet skal afsluttes
 disable_escape_exit = true
 
@@ -689,6 +714,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"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Verhindert, dass die Escape-Taste zum Beenden des Spiels auffordert
 disable_escape_exit = true
 
@@ -689,6 +714,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"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Prevent "escape" from prompting to exit the game
 disable_escape_exit = true
 
@@ -689,6 +714,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"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Prevent "escape" from prompting to exit the game
 disable_escape_exit = true
 
@@ -689,6 +714,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,10 @@ loadingtiphooks = true
 doubleclickassignshiphooks = true
 forbiddentechconfirmhooks = true
 audioeventhooks = true
+# Install fleet observers independently of the desktop/audio selections.
+fleetnotificationhooks = true
+# Install OPC indicator hooks independently of highlight and ETA preferences.
+opcindicatorhooks = true
 freeresizehooks = true
 game_version = true
 giftsbulkclaimhooks = true
@@ -655,6 +678,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Prevent "escape" from prompting to exit the game
 disable_escape_exit = true
 
@@ -700,6 +729,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"
+
 #  <[=====================================================]> 
 #                                                            
 #       *   *            *                                   
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Impide que "Escape" pregunte si deseas salir del juego
 disable_escape_exit = true
 
@@ -689,6 +714,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"
+
 #  <[=======================================]> 
 #                                              
 #       ****            **     **              
@@ -644,6 +663,12 @@ auto_confirm_discovery = true
 # Open the bulk gift claim flyout automatically
 auto_open_bulk_claim_flyout = false
 
+# Windows/macOS: highlight deployed fleet-bar portraits in amber when cargo exceeds protected cargo
+highlight_opc_fleets = false
+
+# Windows/macOS: show estimated time to over-protected cargo below mining fleet status
+fleet_hud_opc_eta = false
+
 # Empêcher "échap" de proposer de quitter le jeu
 disable_escape_exit = true
 
@@ -689,6 +714,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
 # --------------