Instalacao

Dependencias

Recurso	Por que	Custo
hz_lib	dinheiro, identidade, notificacoes, permissoes, painel de configuracao admin	Gratuito
oxmysql	persistencia (eventos, apostas, ledger)	Gratuito
qs-smartphone	apenas para o app opcional de telefone	—

Etapas

Extraia o hz_bets para a sua pasta resources (por ex. resources/[standalone]/HZ-Bets).
Adicione-o ao seu server.cfg depois do hz_lib e do oxmysql:

   ensure oxmysql
   ensure hz_lib
   ensure hz_bets

Inicie o servidor. As tabelas do MySQL sao criadas automaticamente na primeira inicializacao.

A UI vem pre-compilada (web/dist). Voce nao precisa de Node.js nem de rodar um build — basta dar ensure no recurso.

Banco de dados

As tabelas (hz_bets_events, hz_bets_selections, hz_bets_wagers, hz_bets_ledger) sao criadas e migradas automaticamente na inicializacao. Um sql/hz_bets.sql opcional esta incluido caso voce prefira importa-las manualmente.

Permissao de admin

A tela de administracao (criar / liquidar / anular eventos) e protegida no lado do servidor. O HZ-Bets pergunta ao hz_lib se o jogador possui o grupo Config.Admin.Permission (padrao admin). Se o seu build do bridge nao tiver auxiliar de permissao, ele recorre ao no ACE hz.bets.admin:

add_ace group.admin hz.bets.admin allow

A aba de admin na UI e apenas por conveniencia — o servidor reverifica a permissao em cada acao de admin. Um jogador sem permissao que chame os callbacks diretamente e rejeitado.

Abrir o app

Cada gatilho chama a mesma porta — todos alternaveis em config/config.lua:

Comando — /bets (e /betsadmin abre direto na aba de admin).
Atalho — defina Config.Entry.Command.Keybind = 'F7' (remapeavel nas configuracoes do GTA).
NPC de apostador + zona — defina Config.Entry.NPC.Enabled = true (usa a abstracao de target do hz_lib: ox_target / qb-target / interact / integrado).

Para abri-lo a partir do seu proprio recurso, veja Exports.

App de telefone (opcional)

Instale o HZ-Bets App for QS Smartphone junto, com ensure depois do qs-smartphone, do hz_lib e do HZ-Bets. O app Bets entao aparece na lista de apps do telefone automaticamente — sem configuracao extra.