Comece aqui
Instalar o recurso
Baixe o recurso fivedash, coloque no server.cfg, configure o config.lua e ligue a sua cidade ao painel.
Baixe o recurso fivedash, coloque no server.cfg, configure o config.lua e ligue a sua cidade ao painel.
O recurso fivedash é o resource que liga a sua cidade FiveM ao painel. Ele detecta a framework sozinho e faz valer no jogo o que o FiveDash decide: libera e tira a whitelist (inclusive de quem sai do Discord), entrega as compras da loja no ID do jogador e manda os logs dos scripts. Esta página é para quem cuida do servidor (dono ou admin) e tem acesso aos arquivos da cidade.
resources e ao server.cfg do servidor FiveM.oxmysql, mysql-async ou ghmattimysql.Você pode conectar por dois caminhos. Os dois mostram os mesmos passos.
| Caminho | Como chegar |
|---|---|
| Pela tela de bloqueio | Abra qualquer módulo do servidor (ex.: Discord). A tela Conecte + nome do servidor aparece no lugar das páginas. |
| Pela visão geral do servidor | Servidor → Visão geral → cartão Conexão com o jogo → Conectar servidor. Abre a janela Conectar o servidor. |
Clique em Gerar chave. A chave começa com fdk_ e já vem dentro do recurso para download.
Em Baixe o recurso, clique em Baixar fivedash.zip. O arquivo já vem com a chave deste servidor no config.lua e funciona com qualquer framework.
Descompacte o zip e coloque a pasta fivedash dentro de resources do servidor. Mantenha o nome da pasta fivedash. Já tinha o recurso instalado? Só cole a chave no fivedash/config.lua (veja abaixo).
Adicione a linha abaixo no server.cfg, depois da linha que inicia a sua framework.
Reinicie a cidade, ou digite refresh e depois ensure fivedash no console. A tela mostra Esperando o servidor se conectar… e muda para Conectado sozinha. Os módulos abrem na hora.
Linha do server.cfg:
# depois da sua framework (ex.: ensure qb-core, ensure es_extended, ensure vrp)
ensure fivedash
Se você já tinha o recurso, a linha para colar no fivedash/config.lua é:
Key = "fdk_xxxxxxxx",
O arquivo fivedash/config.lua é lido só pelo servidor: nunca vai para os jogadores. Depois de mudar algo, digite restart fivedash no console.
FiveDash = {
Key = "fdk_xxxxxxxx",
Framework = "auto",
AutoUpdate = true,
Debug = false,
}
| Campo | O que faz | Padrão |
|---|---|---|
Key | A chave do painel, gerada em Servidor → Conexão com o jogo → Conectar servidor. Sem ela, o servidor não se conecta ao FiveDash. | Vazia (o download feito pelo painel já vem preenchido) |
Framework | A framework da cidade. "auto" detecta sozinho. Para forçar uma: "creative-enchanted", "qbox", "qbcore", "esx", "ox-core" ou "vrp". | "auto" |
AutoUpdate | Instala sozinho as versões novas do recurso. O config.lua fica como está. | true |
Debug | Mostra cada sincronização e comando no console. | false |
Junto do config.lua vêm mais dois arquivos de configuração: loja.lua (entrega das compras da loja) e logs.lua (logs enviados pelo export). Veja Entrega no jogo e Recurso FiveM.
Com Framework = "auto", o recurso procura a framework sozinho. Hoje ele reconhece:
| Framework | Valor para forçar |
|---|---|
| Creative Network Enchanted | "creative-enchanted" |
| Qbox | "qbox" |
| QBCore | "qbcore" |
| ESX | "esx" |
| ox_core | "ox-core" |
| vRP / vRPex | "vrp" |
Sem framework reconhecida, a conexão com o painel funciona, mas a whitelist fica só no Discord e a loja entrega só por comandos. Detalhes de cada uma em Frameworks.
Em Servidor → Visão geral, o cartão Conexão com o jogo mostra o estado da cidade.
| Campo | O que mostra |
|---|---|
| Status | Conectado, Sem conexão ou Aguardando o servidor. O servidor conta como conectado enquanto a última sincronização for recente (até cerca de 75 segundos). |
| Framework | A framework detectada, ou Nenhuma detectada |
| Whitelist pelo FiveDash | Ativa, Indisponível ou Sem suporte ainda |
| Última sincronização | Nunca, agora há pouco, há 1 minuto, há N minutos, há N horas |
| Recurso | A versão instalada do recurso |
| Botão | O que faz |
|---|---|
| Gerar nova chave | Cria outra chave. A anterior para de funcionar. |
| Desconectar | Pede confirmação (Desconectar o servidor?). A chave atual para de funcionar e as liberações voltam a ficar só no Discord. Para conectar de novo, gere outra chave. |
| Baixar a última versão | Baixa o recurso mais novo sem chave no config.lua |
Quando sai uma versão nova, o cartão avisa: o servidor baixa sozinho e ela entra no próximo restart da cidade (ou com um comando no console). O config.lua fica como está.
| Comando | O que faz |
|---|---|
fivedash status | Mostra a framework, o estado da conexão com o painel, o servidor no FiveDash, o idioma, as sincronizações e as entregas da loja esperando jogadores |
fivedash detect | Procura a framework de novo e mostra as evidências encontradas |
fivedash loja | Comandos da entrega da loja |
fivedash logs | Comandos dos logs |
restart fivedash | Recarrega o recurso depois de mudar o config.lua ou para aplicar uma versão baixada |
Preciso de uma chave por servidor? Sim. Cada servidor da organização tem a sua chave. Usar a mesma chave em dois servidores ligados ao mesmo tempo faz o painel recusar a conexão.
Posso usar convars em vez do config.lua? Sim. fivedash_key, fivedash_framework, fivedash_debug e fivedash_locale funcionam e valem mais que o arquivo. Use set, nunca sets, para a chave não ficar pública.
O console diz que a chave não parece certa. A chave precisa começar com fdk_. Copie de novo ou gere outra. Veja Problemas comuns.