FAQ

Is HZ-Bets real-money gambling?

No. HZ-Bets bets and pays exclusively in your framework's in-game currency on deterministic real results. There is no real-money gateway and no loot-box / gacha mechanic. Wiring it to real currency is the operator's responsibility and is not supported — see Overview → Compliance.

Which sports are covered?

All major sports with real live data: NBA, WNBA, MLB, NHL, NFL, UFC, and worldwide football (Premier League, La Liga, Ligue 1, Bundesliga, Serie A, MLS, World Cup, and more), plus any RP event you create by hand.

Do I need an API key?

No. Both live sources are keyless — ESPN's public scoreboard and OpenLigaDB. No account, no relay to host, no key to manage.

Why do I only see a few sports right now?

Sports follow the real calendar. In summer, mostly baseball + football play; the NBA/NHL run Oct–Jun, the NFL Sep–Jan. Each configured league fills the board only while its season runs. To test other sports out of season, create an RP event from the admin screen.

Does the house ever lose money?

Your choice, per event. Parimutuel = the house can never lose. Live / fixed = a winning bet always pays more than the stake, with the house risk bounded by MaxPayoutPerSelection. Set that cap to what your economy can absorb.

Can a winning bet pay less than the stake?

Only in parimutuel mode, on a heavily-backed favourite — that's how pool betting works (like PMU horse racing). Use the live model (the default for auto-sources) if you want a winning bet to always pay more than the stake, Betclic-style.

Does it work with ESX / QBCore / QBox?

Yes — framework-agnostic through HZ-Bridge, plus Standalone. The money account is configurable.

What about performance?

0.00ms idle. The board is shared via one GlobalState key, the client is fully event-driven, and all API requests are server-side and cached.

What happens on a server restart?

Open events and live bets reload from MySQL, settlement is idempotent and ledger-guarded (no double payouts), and offline winners are paid on their next login. Nothing is lost.

Can players bet from their phone?

Yes — install the optional HZ-Bets-Phone companion (qs-smartphone). The desktop NUI also works standalone.

Is the ESPN feed reliable?

It's a free, keyless public endpoint, so it has no SLA. HZ-Bets handles that defensively: a bad or missing response is ignored (never mis-settled), and the last-known board keeps serving. It is opt-in, and OpenLigaDB + RP remain as fallbacks.