Overview

When live scoring is enabled for a match, the server polls the PoolStat.net.au API at regular intervals and pushes score updates to the OBS overlay via MQTT. Scores update automatically without any operator input.

Prerequisites

  • The Live Scoring feature flag must be enabled in Admin (Feature Flags)
  • You must have a valid PoolStat Competition ID and Match ID for the match
  • The server must have network access to PoolStat.net.au

Setting up live scoring for a match

  1. On the Match Info screen (Step 3), enable the Live Scoring toggle
  2. Enter the PoolStat Competition ID (the numeric ID of your competition)
  3. Enter the PoolStat Match ID (the numeric ID of this specific match)
  4. Complete the remaining wizard steps and go live as normal

When the match is published, the server automatically starts polling PoolStat.

How to find your Competition ID and Match ID

  1. Log in to poolstat.net.au
  2. Navigate to your competition
  3. The Competition ID is in the URL: poolstat.net.au/competitions/**1234**/...
  4. Open the specific match — the Match ID is the numeric parameter in the match URL

What gets updated

The live scoring service reads home and away scores from the PoolStat match data and publishes them to the rig’s MQTT topic. The overlay updates the scoreboard in real time.

Other match fields (player names, event, format) are not overwritten by live scoring — only the numeric scores.

Monitoring

The Live Dashboard shows a green LS badge on any rig where live scoring is actively polling. If the badge is missing, polling may have stopped due to a network error — check the server logs.

Stopping live scoring

Live scoring polling stops automatically when you click ■ Stop on the match. If the match ends on PoolStat before you stop it in the app, polling continues until you stop the match or the server restarts.