Battlegrounds composition stats fail to load due to race condition at game start

[ChrisNolan]

Expected Behavior

Overlay should correctly and consistently show the Tier7 Comp Stats at game start / hero select.

Actual Behavior

Occasionally it fails, with a plain 'failed to load composition stats' message and then away it goes. No details, no option to retry etc.

Steps to reproduce behavior

I believe this might be related to PC performance etc. I'm on an old machine and I think that is why it happens more often for me?

I can't consistently reproduce it, but more than 50% of my games I do not get my Tier7 comps displayed.

Log/Screenshots

2:16:36 PM|Error|BattlegroundsSessionViewModel.HandleCompStatsError >> [Tier7CompStats] error: CompositionStatsException - Unable to get available races; debug=

Sorry, that is from my PR which added this detail log. That's another issue, the code is throwing mlutiple different exceptions, but the UI only ever shows a single 'failed' message.

[ChrisNolan]

Problem

When starting a Battlegrounds game, the overlay frequently displays "Failed to load compositions" error message. However, manually retrying the request (after a delay) succeeds, indicating a timing/race condition issue.

Root Cause

The composition stats fetch in BattlegroundsSessionViewModel.GetBattlegroundsCompStats is called before the game state is fully initialized. Specifically, BattlegroundsUtils.GetAvailableRaces returns null when invoked too early in the game startup sequence, causing the fetch to fail with a CompositionStatsException.

From logs:

2:16:36 PM|Error|BattlegroundsSessionViewModel.HandleCompStatsError >> [Tier7CompStats] error: CompositionStatsException - Unable to get available races; debug=<none>

After a manual retry (when game state is ready):

2:17:27 PM|Info|BattlegroundsSessionViewModel.GetBattlegroundsCompStats >> [Tier7CompStats] token=<null>; params={"minion_types":[24,18,92,23,43],"game_language":"enUS","include_toast":true}

Impact

• Poor user experience: users see error messages at game start
• Users must wait or manually refresh to get composition stats
• Telemetry shows this is a common issue (hdt_bgs_composition_stats_error)

Proposed Solution

• Add automatic retry logic with delays - wait 2s, then 3s more for game state to initialize before failing
• Add manual retry button - give users a way to retry without restarting
• Enhanced logging and debug info - display request details on error to help diagnose issues
• Better error visibility - show token/params in overlay when error occurs

Implementation

• Retry delays before throwing "Unable to get available races" exception
• UI: Retry button displayed with error message
• Property: CompStatsDebugInfo+ CompStatsDebugVisibility for overlay display

This should resolve most cases automatically while providing users a manual fallback and better diagnostic information for any remaining edge cases.