Introdução
Script de coleta de métricas server-side para o painel FiveTrack
FiveTrack
O FiveTrack é um recurso server-side para FiveM que coleta métricas do seu servidor em tempo real e envia para o painel em fivetrack.denverst.com.br.
Funciona em vRP (Lotus, Nexus, Creative Enchanted, base license), com suporte a frameworks adicionais via adapter customizado.
O resource é server_only — não envia código para o cliente. Toda a coleta acontece no servidor usando OneSync, sem impacto no frame time dos jogadores.
O que é coletado
Jogadores
Online em tempo real, entradas, saídas, sessões, retenção, churn
Economia
Cash + bank por jogador, top milionários, distribuição de riqueza (Gini), detecção de duping
Legal vs Ilegal
Distribuição entre organizações legais e ilegais, com snapshot por facção
Staff
Atendentes online, tickets de chamados, SLA, detector de burnout
Mapa de calor
Posições dos jogadores no mapa de GTA V + locais de crashes e quedas de conexão
Banimentos
Contagem de bans aplicados com histórico por dia
Stack técnica
| Item | Detalhe |
|---|---|
| Linguagem | Lua 5.4 (FiveM Citizen) |
| Tipo | server_only 'yes' |
| Transporte | PerformHttpRequest (Bearer auth) |
| Endpoint | https://api.fivetrack.denverst.com.br |
| Auth | API key gerada no painel (header Authorization: Bearer fvt_...) |
| Framework | vRP via Adapter pattern (server/adapters/<nome>.lua) |
Próximos passos
Instalação
Baixar, configurar API key e adicionar ao server.cfg
Configuração
Detalhamento de Config.ApiKey, CfxId, Adapter, Legal/Ilegal/Staff
Adapters
Adapters built-in para vRP-EX, Nexus, Creative Enchanted
Hooks no vRP
Pontos de integração obrigatórios no vRP base e em recursos auxiliares
Exports
Lista completa de exports disponíveis para uso em outros recursos
Coletores
O que cada arquivo de collectors faz e em qual intervalo
Troubleshooting
Problemas comuns: contagens zeradas, adapter errado, etc.