HZ-BetsFiveM Script — Products

What is HZ-Bets?

HZ-Bets is a server-authoritative sports-betting resource for FiveM — a complete in-game sportsbook where your players bet on real, live sporting events using your server's virtual money. It ships with a polished sportsbook-style NUI, a strict server-owned money engine, and keyless live data for every major sport, so there is nothing to host, no API key to buy, and no way for a client to cheat the odds.

It is standalone-first: a self-contained app opened by a command, a keybind, or a bookmaker NPC, and ready to plug into a phone through one clean exports contract. An optional HZ-Bets App for QS Smartphone companion turns it into a native qs-smartphone app.

Everything stays in-game currency only on deterministic real results — no real-money gateway, no loot boxes — keeping it on the same footing as the RP casino/betting scripts openly sold for FiveM.

Why a real-data sportsbook?

Most FiveM "betting" scripts are either fake (random number generators dressed up as odds) or require a paid API key and a relay you have to host. Both are a problem: fake betting feels hollow, and paid feeds add cost, setup, and a single point of failure for your whole server.

HZ-Bets takes a different route. It pulls real fixtures and live scores from two keyless, open sources — ESPN's public scoreboard and OpenLigaDB — fetches them server-side only, caches them, and shares one board to every client. Your players bet on actual NBA finals, real Premier League matches, live UFC cards; the server auto-settles the moment the real game ends. No key, no relay, no fake RNG.

Core features

All sports, real live data, no key

Two keyless feeds cover the calendar year-round:

• ESPN (public scoreboard) — all major sports: NBA, WNBA, MLB, NHL, NFL, UFC, and worldwide football (Premier League, La Liga, Ligue 1, Bundesliga, Serie A, MLS, Brazil, Mexico…). Auto-creates fixtures, streams the live score, and auto-settles on the real result.
• OpenLigaDB — real football fixtures, live scores and top scorers (ODbL, with on-screen attribution). Great for the World Cup and Bundesliga.
• RP events — fictional events (races, fights, anything) you create from the admin screen, with your own odds. Zero external dependency.

Each league is just a config line. Off-season leagues simply return nothing; in-season ones fill the board automatically.

Sportsbook-style markets

A fixture can carry several markets, grouped under a market selector like a real sportsbook:

• Match result (1 / X / 2) for football, Winner (2-way) for the rest
• Over / Under totals
• Both teams to score
• Anytime scorer (Buteur) — a fully bettable, multi-winner market: every player who scores wins at their own odds, settled by the admin
• Custom — your own outcomes for RP events

Markets that the active source can't settle are never offered — the app never shows a bet it can't pay out.

Three odds models — including locked "live" odds

Pick the model per event:

• Live (sportsbook-style) — odds are priced live from the betting pool (they move and look realistic), but each bet locks the odds shown at that moment and is paid stake × locked odds. A winning bet always pays more than the stake, exactly like a real bookmaker. House risk is bounded by an exposure cap.
• Parimutuel — pool split, the house can never lose, odds self-balance.
• Fixed — pre-set decimal odds for hand-made RP events.

Strict server authority + restart-safe money

The server owns everything: results, stake validation (balance, deadline, min/max, concurrency, anti-spam), debit-before-persist, and payout crediting. The NUI only renders what the server sends — a client can never forge a stake, an odd, or a result.

Money is bulletproof: settlement is idempotent and ledger-guarded (no double payouts even across a crash or a double-click), open bets reload from MySQL on restart, and offline winners are paid on their next login. The whole money path was hardened by a full adversarial audit.

Premium, themeable UI — no rebuild

A clean, mobile-and-desktop NUI with live odds tiles, team crests, a Top Scorers board, and a bet slip with honest estimated/locked gains. The whole look is driven by three config colours (accent / accent-hi / gold) applied at runtime — ship the default crimson, or switch to Navy or Cyan presets by editing the config, with no web rebuild. Multi-language: English, French, Spanish.

Compatibility

• ESX (es_extended) — all versions
• QBCore (qb-core) — all versions
• QBox (qbx_core) — fully supported
• Standalone — no framework required

Dependencies: HZ-Bridge (free — money, identity, notifications, permissions, admin panel) and oxmysql (persistence). The optional phone app additionally needs qs-smartphone.

Installation

1. Drop HZ-Bets into your resources folder.
2. ensure it after HZ-Bridge and oxmysql in your server.cfg.
3. Start the server — the database tables create themselves on first boot.
4. Open with /bets (or a keybind / bookmaker NPC), and manage events from the in-game admin screen.

Full setup, the exports contract, every config value, and a security test checklist are in the documentation.

Performance

0.00ms idle. The live board is published to every client through a single GlobalState key and the client is entirely event-driven — there is no per-client polling. All ESPN / OpenLigaDB requests happen server-side only, on a configurable cadence, and are cached. Live data degrades gracefully: a bad or missing API response is ignored, never mis-settled, and the last-known board keeps serving.