HZ-Bets
HZ-Bets is a server-authoritative sportsbook for FiveM. Players bet on real, live sporting events using your server's in-game currency, with live odds, real scores, and automatic settlement — and no API key to manage.
Standalone-first. A self-contained NUI opened by a command, keybind or bookmaker NPC. The optional HZ-Bets-Phone companion adds a native qs-smartphone app on top of the same server.
What it does
- All sports, live, keyless — ESPN's public scoreboard (NBA, MLB, NHL, NFL, UFC, worldwide football) + OpenLigaDB (football). Fetched server-side, cached, shared to every client.
- Real markets — match result (1/X/2), winner, over/under, both-teams-to-score, anytime scorer (bettable), and custom RP markets.
- Three odds models — live (Betclic-style locked odds), parimutuel (house never loses), fixed.
- Bulletproof money — server owns results & validation, debit-before-persist, idempotent ledger-guarded payouts, offline-winner claims, restart recovery.
- 0.00ms idle, multi-framework (ESX / QBCore / QBox / Standalone), multi-language (en / fr / es), config-themeable.
Compliance
In-game currency only. HZ-Bets bets and pays exclusively in your framework's virtual money on deterministic real results. It contains no real-money gateway and no loot-box / gacha mechanic. Wiring it to real currency is the server operator's responsibility and is not supported.
This keeps HZ-Bets on the same footing as the RP casino/betting scripts openly sold for FiveM, under Rockstar's Creator Platform License. The PLA does not override the game's EULA/TOS — operators remain responsible for how they deploy it.
Documentation
| Page | What's inside |
|---|---|
| Installation | Dependencies, server.cfg, database, admin permission, opening the app |
| Configuration | config.lua, the HZ-Bridge panel, brand themes |
| Event sources | ESPN (all sports), OpenLigaDB (football), RP (admin) |
| Markets & odds | Every market, the three odds models, exposure caps |
| Exports | The open/close contract + phone integration |
| FAQ | Common questions |
| Changelog | Version history |