Guias3 min de leitura
Como instalar o FiveDash no seu servidor FiveM
Do driver MySQL ao primeiro “Conectado ao FiveDash” no console: o que o servidor precisa, os quatro passos da instalação e o que fazer se algo der errado.
Equipe fiveX
Instalar o FiveDash é colocar um recurso na pasta e uma linha no server.cfg. O painel e o bot do Discord rodam com a gente, então não há nada para hospedar: na cidade fica só o recurso fivedash, que detecta a framework, liga o servidor ao painel e se atualiza sozinho.
Antes de começar
O recurso precisa de três coisas no servidor:
- Um driver MySQL: oxmysql, mysql-async ou ghmattimysql, iniciado antes do fivedash. É por ele que o recurso confere a framework e guarda as entregas da loja.
- Um FXServer atualizado: o recurso roda no Node 22 do FXServer, que vem nos artefatos recentes.
- A chave do servidor: donos e admins geram no painel, em Servidor → Conexão com o jogo. Ela começa com
fdk_e aparece uma vez só.
A conexão com o painel funciona com qualquer framework. Na Creative Network Enchanted, Qbox, QBCore, ESX, ox_core e vRP/vRPex, a loja entrega itens, veículos, dinheiro, VIP e comandos. A whitelist no jogo usa a da própria framework: na Creative e no vRPex direto; no QBCore e no Qbox, com a whitelist deles e uma permissão só dela; no ESX, com o esx_whitelist. No ox_core, ela fica no Discord.
Os quatro passos
- Gere a chave e baixe o recurso. No painel, em Servidor → Conexão com o jogo, clique em Gerar chave. O
fivedash.zipjá vem com ela noconfig.lua. - Extraia a pasta em
resources. Já tinha o recurso? Cole a chave nova noconfig.luadele. - Inicie depois do banco e da framework. No
server.cfg, o fivedash entra por último, para encontrar os dois quando ligar. - Reinicie e confira. Reinicie o servidor, ou digite
refresheensure fivedashno console. A conexão aparece no painel sozinha.
A ordem no server.cfg fica assim:
ensure oxmysql
ensure vrp # a sua framework
ensure fivedash
Os arquivos do recurso
São três arquivos que só o servidor lê. Depois de mudar algo, digite restart fivedash no console.
| Arquivo | Para que serve |
|---|---|
config.lua | A chave, a framework e as atualizações |
loja.lua | Como as compras da loja chegam na cidade |
logs.lua | O que vai junto em cada log dos scripts |
Com AutoUpdate ligado, a versão nova baixa sozinha, cada arquivo é conferido antes de entrar e ela vale a partir do próximo restart. As atualizações nunca apagam o que você configurou: opções novas aparecem sozinhas no fim dos arquivos.
Se algo der errado
O fivedash diz no console o que está acontecendo. As mensagens mais comuns:
- “Sem chave do painel”: o
Keydoconfig.luaestá vazio. Gere a chave e cole no arquivo. - “Chave recusada pelo painel”: a chave foi trocada no painel. Gere outra e troque o
Key. - “Esta chave já está sendo usada por outro servidor”: cada servidor tem a sua chave. Se você acabou de reiniciar o recurso, ele entra sozinho em alguns segundos.
- “Nenhum driver MySQL iniciado”: inicie o driver do banco antes do fivedash no
server.cfg.
Travou em outra coisa? Digite fivedash status no console e mande o resultado para o suporte. O passo a passo completo, com cada mensagem do console, está na página de instalação.