Sync: opt-in live fleet state (fleets)

example_community_patch_settings_en.toml

@@ -928,6 +928,9 @@ buildings = true
 # Do you want to sync Haven data?
 haven = true
 
+# Do you want to sync live fleet state (mining, docked, warping...)? Opt-in, off by default
+fleets = false
+
 # Do you want to sync inventory data?
 inventory = true
 

mods/src/config.h

@@ -23,6 +23,7 @@ class SyncConfig
     Buffs,
     Buildings,
     EmeraldChain,
+    Fleets,
     Haven,
     Inventory,
     Jobs,
@@ -51,6 +52,7 @@ class SyncConfig
   bool battlelogs       = false;
   bool buffs            = false;
   bool buildings        = true;
+  bool fleets           = false;
   bool haven            = true;
   bool inventory        = false;
   bool jobs             = false;
@@ -74,6 +76,7 @@ constexpr std::array SyncOptions{
     SyncConfig::Option{SyncConfig::Type::Buffs, "buff", "buffs", &SyncConfig::buffs},
     SyncConfig::Option{SyncConfig::Type::Buildings, "module", "buildings", &SyncConfig::buildings},
     SyncConfig::Option{SyncConfig::Type::EmeraldChain, "emerald_chain", "buffs", &SyncConfig::buffs},
+    SyncConfig::Option{SyncConfig::Type::Fleets, "fleet", "fleets", &SyncConfig::fleets},
     SyncConfig::Option{SyncConfig::Type::Haven, "haven", "haven", &SyncConfig::haven},
     SyncConfig::Option{SyncConfig::Type::Inventory, "inventory", "inventory", &SyncConfig::inventory},
     SyncConfig::Option{SyncConfig::Type::Jobs, "job", "jobs", &SyncConfig::jobs},

mods/src/defaultconfig.h

@@ -240,6 +240,7 @@ namespace Sync
   constexpr bool        battlelogs         = false;
   constexpr bool        buffs              = true;
   constexpr bool        buildings          = true;
+  constexpr bool        fleets             = false; // opt-in: live fleet state from fleet_watch
   constexpr bool        haven              = true;
   constexpr bool        inventory          = true;
   constexpr bool        jobs               = true;

mods/src/patches/fleet_watch.cc

@@ -165,6 +165,23 @@ void dispatch_transition(int slot, FleetPlayerData* fleet, FleetState before, Fl
   }
 }
 
+void dispatch_baseline()
+{
+  CallbackScope callback_scope;
+  for (const auto& subscription : s_subscriptions) {
+    if (!subscription.on_baseline) {
+      continue;
+    }
+    try {
+      subscription.on_baseline();
+    } catch (const std::exception& error) {
+      spdlog::warn("[FleetWatch] baseline callback failed: {}", error.what());
+    } catch (...) {
+      spdlog::warn("[FleetWatch] baseline callback failed with an unknown exception");
+    }
+  }
+}
+
 void observe_fleet(FleetPlayerData* fleet, int requested_slot, bool publish)
 {
   if (!fleet || requested_slot < 0 || requested_slot >= kFleetSlotCount) {
@@ -360,6 +377,9 @@ void Tick()
             spdlog::info("[FleetWatchProbe] established stable baseline for {} fleet slots", baseline_count);
           }
 #endif
+          if (final_scan.manager_available) {
+            dispatch_baseline();
+          }
         }
       }
     } else if (lifetime >= kSeedLifetimeMs) {

mods/src/patches/fleet_watch.h

@@ -18,10 +18,15 @@ struct Transition {
 
 using TransitionCallback = void (*)(const Transition& transition);
 using FastPollPredicate  = bool (*)(FleetState state);
+using BaselineCallback   = void (*)();
 
 struct Subscription {
   TransitionCallback on_transition   = nullptr;
   FastPollPredicate  needs_fast_poll = nullptr;
+  // Optional. Runs on the game thread each time a stable baseline is established while the fleet service is available
+  // (after login, and again after any fleet-slot topology change). Transitions are only dispatched after a baseline, so
+  // a consumer that needs the complete fleet list reads FleetsManager here.
+  BaselineCallback   on_baseline     = nullptr;
 };
 
 // Registers a process-lifetime fleet-state observer. The first subscription joins the shared screen-update dispatcher;