# Visão geral do servidor Veja se a cidade está online, quantos jogadores estão dentro, a conexão com o recurso fivedash e os servidores da organização. Source: https://fivedash.fivex.gg/docs/pt/server/overview A **Visão geral** do módulo **Servidor** é a primeira tela de cada servidor no FiveDash. Ela mostra, num lugar só, se a cidade está de pé, quantos moradores estão dentro agora, como está a conexão com o recurso `fivedash` e os outros servidores da organização. É para o dono e a equipe que querem saber, em um olhar, se está tudo rodando. ## Antes de começar * **Onde fica:** **Servidor → Visão geral**, no endereço `//` (a página inicial do servidor no painel). * **Nível de acesso:** a área **Servidor** só tem o nível **Ver**. Quem tem acesso a ela vê o status, os jogadores e a lista de servidores. * **Conexão com o jogo:** o cartão **Conexão com o jogo** aparece só para quem é **Dono** ou **Admin** da organização. Os outros membros não veem nem mexem na chave. * **Status e jogadores:** para os números aparecerem, o servidor precisa do recurso `fivedash` conectado ou de um endereço público salvo (link `cfx.re/join` ou `IP:porta`). ## O que a página mostra ### Cabeçalho do servidor | Item | O que mostra | | ------------------- | ---------------------------------------------------------------------------------------------------- | | Nome e ícone | O nome e o ícone do servidor no FiveDash | | Endereço | O link `cfx.re/join/` ou o `IP:porta` salvo. Sem nenhum, aparece **Sem endereço público** | | **Copiar endereço** | Copia o endereço (aparece o aviso **Endereço copiado**) | | Status | **Online** (verde) ou **Sem resposta** (cinza) | | **Entrar** | Abre o link `https://cfx.re/join/`. Só aparece quando o servidor tem um código `cfx.re/join` | ### Jogadores | Item | O que mostra | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Jogadores online** | O número de jogadores agora e o máximo (**de 64**, por exemplo). Com o servidor fora do ar, aparece **Offline** | | **Ocupação** | A porcentagem de vagas ocupadas e uma barra. A barra fica amarela a partir de 90%. Sem resposta, aparece **Aparece quando o servidor responder** | ### Conexão com o jogo O cartão **Conexão com o jogo** (só **Dono** e **Admin**) resume o recurso `fivedash` instalado na cidade. | Campo | O que mostra | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Selo de status | **Conectado**, **Sem conexão** (o recurso já conectou alguma vez, mas parou de sincronizar) ou **Aguardando o servidor** (a chave existe, mas o recurso nunca conectou) | | **Framework** | A framework que o recurso detectou (ex.: **QBCore**, **ESX**, **Creative Network Enchanted**). **Nenhuma detectada** quando ele não reconheceu nenhuma | | **Whitelist pelo FiveDash** | **Ativa** (o bot libera e tira a whitelist direto no jogo), **Indisponível** (a framework tem loja, mas a whitelist dela não está pronta) ou **Sem suporte ainda** | | **Última sincronização** | Há quanto tempo o recurso falou com o painel (**agora há pouco**, **há 3 minutos**…) ou **Nunca** | | **Recurso** | A versão do recurso (ex.: `v0.6.0`) e os 4 últimos caracteres da chave (ex.: `…a1b2`) | Embaixo do cartão podem aparecer: * **Aviso de versão nova:** "Versão X do recurso disponível: o servidor baixa sozinho e ela entra no próximo restart da cidade (ou com `restart fivedash` no console). O config.lua fica como está." * **Avisos da framework**, em amarelo: problemas de configuração que o recurso encontrou na cidade (por exemplo, a whitelist da base desligada). Eles só aparecem com o recurso conectado. Veja a lista em [Frameworks](https://fivedash.fivex.gg/docs/pt/developers/frameworks). Botões do cartão: | Botão | O que faz | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | **Conectar servidor** | Abre **Conectar o servidor**, com os passos para gerar a chave e instalar o recurso | | **Gerar nova chave** | Cria outra chave. A anterior para de funcionar na hora | | **Desconectar** | Pede confirmação (**Desconectar o servidor?**). A chave atual para de funcionar e as liberações voltam a ficar só no Discord | ### Servidores da organização A tabela **Servidores da organização** lista todos os servidores, com a contagem (**3 servidores**, por exemplo). | Coluna | O que mostra | | ------------- | ------------------------------------------------------------------------------------ | | **Servidor** | Nome, ícone e endereço. O servidor aberto agora tem a etiqueta **Aberto** | | **Jogadores** | Jogadores agora e o máximo (ex.: `48/64`), com uma barrinha. `—` quando não responde | | **Status** | **Online** ou **Sem resposta** | Clique numa linha para abrir aquele servidor. ### Coluna da direita * **Organização:** o nome da organização, o número de **Servidores** (com **· 2 online**, por exemplo), a **Equipe** (rostos e total) e os **Convites pendentes** (ou **Nenhum**). * **Módulos:** atalhos para os módulos do plano, cada um com o estado: **Bot configurado** / **Configurar o bot**, **Loja configurada** / **Configurar a loja**, **Site configurado** / **Configurar o site**, **1 log** / **5 logs** / **Configurar os logs** e, na CDN, **Arquivos da cidade**. Só aparecem os módulos que você pode abrir. ## De onde vêm o status e os jogadores O painel tenta duas fontes, nesta ordem: 1. **O recurso `fivedash`:** cada sincronização manda o número de jogadores e o máximo (`sv_maxclients`). Se a última sincronização foi há menos de cerca de 75 segundos, o painel usa esses números e mostra **Online**. 2. **O endereço público:** sem sincronização recente, o painel consulta o endereço salvo no servidor (o código `cfx.re/join` pela lista pública da Cfx.re, ou o `IP:porta` direto no servidor do jogo). Sem nenhuma das duas, ou se a consulta falha, o status fica **Sem resposta** e os jogadores **Offline**. > Com o recurso conectado, os números chegam mesmo que a cidade esteja fora da lista pública ou atrás de um proxy. Por isso vale manter o `fivedash` instalado. ## Salvar o endereço do servidor O endereço serve para o status, os jogadores, o botão **Entrar** e o **Connect** do Discord. Ele é opcional. ### Abra o gerenciador de servidores No seletor de servidores da barra lateral, clique em **Gerenciar servidores** e escolha o servidor. ### Cole o endereço Em **Conexão**, preencha **Endereço (opcional)** com o link `cfx.re/join/` ou o `IP:porta` da cidade. ### Verifique Clique em **Verificar endereço**. Se a cidade responder, aparece **Encontrado · 48/64 jogadores agora** (com os números do momento). ### Salve Clique em **Salvar alterações**. > Só **Dono** e **Admin** gerenciam os servidores. Para os outros, o painel mostra "Só donos e admins podem gerenciar os servidores." ## Conectar o servidor ao jogo Enquanto o recurso não se conecta pela primeira vez, as páginas dos módulos do servidor mostram a tela **Conecte** + o nome do servidor (por exemplo, **Conecte Cidade Exemplo**, com "Um passo antes de configurar os módulos"). O passo a passo completo está em [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource). Em resumo: ### Gere a chave No cartão **Conexão com o jogo**, clique em **Conectar servidor** e depois em **Gerar chave**. A chave começa com `fdk_` e aparece uma vez só. ### Baixe o recurso Clique em **Baixar fivedash.zip**. O `config.lua` já vem com a chave deste servidor. ### Instale na cidade Extraia a pasta `fivedash` em `resources` e coloque `ensure fivedash` no `server.cfg`, depois da framework. ### Reinicie Reinicie o servidor, ou digite `refresh` e `ensure fivedash` no console. Quando o recurso conectar, a tela mostra **Conectado** e o nome da framework. > A chave dá acesso ao servidor no FiveDash. Não compartilhe o `config.lua` nem cole a chave em chats, prints ou tickets. ## Perguntas frequentes **A cidade está aberta, mas o painel mostra Sem resposta. Por quê?** O recurso não sincronizou nos últimos 75 segundos e o endereço salvo não respondeu (ou não há endereço). Confira no console do servidor com o comando `fivedash` se o recurso está **conectado**, e salve um endereço em **Gerenciar servidores**. **O número de jogadores é diferente do que aparece na lista do FiveM.** Com o recurso conectado, o painel usa a contagem do próprio servidor, que é mais nova que a da lista pública. A diferença costuma sumir em segundos. **Não vejo o cartão Conexão com o jogo.** Ele aparece só para **Dono** e **Admin** da organização. **O que acontece se eu clicar em Gerar nova chave?** A chave antiga para de funcionar na hora. O servidor fica sem conexão até você colocar a nova no `fivedash/config.lua` e reiniciar o recurso. ## Próximos passos [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource)Baixe o fivedash e conecte a cidade ao painel. [Console e jogadores](https://fivedash.fivex.gg/docs/pt/server/console-and-players)O que já existe e o que vem por aí no módulo Servidor. [Organizações e servidores](https://fivedash.fivex.gg/docs/pt/dashboard/organizations-and-servers)Adicione, renomeie e remova servidores. [Recurso FiveM](https://fivedash.fivex.gg/docs/pt/developers/fivem-resource)Como o recurso funciona, opções e convars.