Installation

Abhaengigkeiten

Ressource	Wozu	Kosten
hz_lib	Geld, Identitaet, Benachrichtigungen, Berechtigungen, Admin-Konfigurationspanel	Kostenlos
oxmysql	Persistenz (Events, Wetten, Ledger)	Kostenlos
qs-smartphone	nur fuer die optionale Handy-App	—

Schritte

Entpacken Sie hz_bets in Ihren resources-Ordner (z. B. resources/[standalone]/HZ-Bets).
Fuegen Sie es Ihrer server.cfg nach hz_lib und oxmysql hinzu:

   ensure oxmysql
   ensure hz_lib
   ensure hz_bets

Starten Sie den Server. Die MySQL-Tabellen werden beim ersten Start automatisch erstellt.

Die UI wird vorgebaut ausgeliefert (web/dist). Sie benoetigen kein Node.js und muessen keinen Build ausfuehren — einfach die Ressource per ensure laden.

Datenbank

Die Tabellen (hz_bets_events, hz_bets_selections, hz_bets_wagers, hz_bets_ledger) werden beim Start automatisch erstellt und migriert. Eine optionale sql/hz_bets.sql liegt bei, falls Sie sie lieber von Hand importieren moechten.

Admin-Berechtigung

Der Admin-Bildschirm (Events erstellen / abrechnen / annullieren) ist serverseitig abgesichert. HZ-Bets fragt hz_lib, ob der Spieler der Gruppe Config.Admin.Permission angehoert (Standard admin). Falls Ihr Bridge-Build keinen Berechtigungs-Helper hat, greift es auf den ACE-Knoten hz.bets.admin zurueck:

add_ace group.admin hz.bets.admin allow

Der Admin-Tab in der UI dient nur dem Komfort — der Server prueft die Berechtigung bei jeder Admin-Aktion erneut. Ein Spieler ohne Berechtigung, der die Callbacks direkt aufruft, wird abgewiesen.

Oeffnen der App

Jeder Ausloeser ruft dieselbe Tuer auf — alle in config/config.lua umschaltbar:

Befehl — /bets (und /betsadmin oeffnet direkt den Admin-Tab).
Tastenbelegung — setzen Sie Config.Entry.Command.Keybind = 'F7' (in den GTA-Einstellungen neu belegbar).
Buchmacher-NPC + Zone — setzen Sie Config.Entry.NPC.Enabled = true (nutzt die Target-Abstraktion von hz_lib: ox_target / qb-target / interact / integriert).

Um sie aus Ihrer eigenen Ressource zu oeffnen, siehe Exports.

Handy-App (optional)

Installieren Sie HZ-Bets App for QS Smartphone daneben, per ensure nach qs-smartphone, hz_lib und HZ-Bets. Die Bets-App erscheint dann automatisch in der App-Liste des Handys — keine zusaetzliche Konfiguration.