# Connect Publique no Discord um painel fixo com o status da cidade, os jogadores online, o connect e botões de link, atualizado a cada minuto. Source: https://fivedash.fivex.gg/docs/pt/discord/connect O **Connect** é a placa na entrada da cidade: uma mensagem fixa num canal do Discord que mostra se o servidor está online, quantos jogadores estão jogando e o endereço para digitar no F8. O bot atualiza o painel sozinho a cada minuto. Esta página é para o dono e a equipe que cuidam do Discord do servidor. ## Antes de começar * **Plano:** o módulo Discord precisa estar no plano da organização (vale para Plus, Pro e Ultra). * **Bot conectado:** o bot da cidade precisa estar conectado ao servidor do Discord. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot). * **Endereço do servidor no FiveDash:** o status e os jogadores vêm do campo **Endereço (opcional)** do servidor no FiveDash ("Link cfx.re/join ou IP:porta, para o status, os jogadores e o Connect"). Com um link `cfx.re/join`, o painel também ganha o botão de entrar na cidade. * **Nível de acesso** na área **Connect**: | Nível | O que permite | | -------------- | ------------------------------------------------------------- | | **Ver** | Painel e status | | **Configurar** | Endereço, botões e painel (salvar, publicar, mover e remover) | ## O que aparece no Discord O painel é um embed com: * o **Título** e o **Texto** (padrão: o nome do servidor e "Conecte-se na cidade!"); * o bloco **Status**, com uma bolinha (🟢 online, 🔴 offline, 🟡 manutenção) e o texto do status; * o bloco **Jogadores** (ex.: `48/128`), só com **Mostrar jogadores** ligado e o servidor online; * o bloco **Connect**, com `connect` seguido do **Endereço do connect**; * os botões de link embaixo, cinco por linha. O bot consulta o servidor a cada minuto. Antes de mostrar offline, ele tenta de novo depois de um instante, para um soluço não virar "Offline" no painel. O painel só é editado quando algo muda (ou sempre, com **Horário da última verificação** ligado). ## Publicar o painel ### Abra a página No painel, vá em **Discord → Connect**. ### Escolha o canal Em **Painel → Canal**, escolha o **Canal do painel**. ### Escreva o endereço Em **Servidor → Endereço do connect**, escreva o que os jogadores digitam no F8. Pode ser um IP, um domínio ou o link cfx.re (ex.: `jogar.cidadeexemplo.com.br`). Se você colar "connect jogar…", o "connect" é tirado sozinho. ### Adicione botões (opcional) Em **Botões**, ligue o **Botão de entrar na cidade** e clique em **Adicionar link (loja, regras, Instagram…)** para os links. Arraste para mudar a ordem. ### Ligue e salve Ligue a chave no topo (**Ativo**) e clique em **Salvar**. O bot publica o painel e mostra **Painel publicado**: "Em #canal. Ele se atualiza sozinho a cada minuto." Depois de publicado: * salvar de novo republica o painel com o novo visual e apaga o antigo, para não aparecer "(editado)"; * trocar o canal e salvar move o painel (**Painel movido**: a mensagem antiga é apagada); * desligar a chave e salvar remove o painel (**Painel removido**) e as verificações param; * o botão **Abrir no Discord** leva direto à mensagem; * se alguém apagar o painel à mão no Discord, o bot publica de novo. ## Modo manutenção Ligue **Servidor → Modo manutenção** e salve. O painel mostra "Em manutenção" na hora, com a cor amarela, seja qual for a resposta do servidor. Desligue e salve quando a cidade voltar: o bot consulta o servidor antes de atualizar o painel. ## Configurações ### Painel | Campo | O que faz | Padrão | | ------------------------------- | -------------------------------------------------- | ------ | | **Canal** (**Canal do painel**) | Onde a mensagem fixa fica. Obrigatório para ligar. | Nenhum | ### Servidor | Campo | O que faz | Limite | Padrão | | ----------------------- | ------------------------------------------------------------------------------------------------- | ------ | --------- | | **Endereço do connect** | O que os jogadores digitam no F8 para entrar. IP, domínio ou link cfx.re. Obrigatório para ligar. | 120 | Vazio | | **Mostrar jogadores** | Quantos estão jogando agora e o máximo, enquanto estiver online. | — | Ligado | | **Modo manutenção** | Mostra "Em manutenção" no painel assim que salvar. | — | Desligado | ### Botões | Campo | O que faz | Limite | Padrão | | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------------------------- | | **Botão de entrar na cidade** | Botão que abre o FiveM direto na cidade (`cfx.re/join/código`). Só para servidores com código cfx.re. | — | Ligado | | **Texto do botão** (em **Editar botão de entrar**) | Precisa de texto ou emoji. | 80 | "Entrar na cidade" | | Emoji (em **Editar botão de entrar**) | Ícone do pacote do bot, emoji comum ou emoji do servidor. | — | Ícone de connect do pacote | | Links | Botões que abrem um link (loja, regras, Instagram…). Cada um com **Texto** (até 80), emoji opcional e **Link** começando com `https://`. | 5 links | Nenhum | ## Mensagens Na coluna da direita, **Mensagens** (**Texto, status e imagens**) abre **Personalizar mensagens**, com duas partes. Use **Restaurar padrão** para voltar aos textos originais no idioma da cidade. ### Texto e imagens | Campo | O que faz | Limite | Padrão | | ------------- | ------------------------------------------------------------------------------------------- | ------ | ----------------------- | | **Título** | Linha de título do painel. | 120 | `{servidor}` | | **Texto** | Texto embaixo do título. O painel precisa de título ou texto. | 1000 | "Conecte-se na cidade!" | | **Imagem** | Opcional. Larga (2:1), aceita GIF de até 3 MB. | — | Nenhuma | | **Miniatura** | Quadrada, aceita GIF de até 1 MB: **Ícone do servidor**, **Imagem própria** ou **Nenhuma**. | — | **Ícone do servidor** | Imagens PNG, JPG ou WebP vão até 1 MB. ### Status | Campo | O que faz | Limite | Padrão | | ----------------------------------------- | ----------------------------------------------------------------- | ------ | --------------- | | **Títulos dos blocos** → **Status** | A linha acima do bloco de status. O ícone do status muda sozinho. | 40 | "Status" | | **Títulos dos blocos** → **Jogadores** | A linha acima do bloco de jogadores. | 40 | "Jogadores" | | **Títulos dos blocos** → **Connect** | A linha acima do bloco do connect. | 40 | "Connect" | | **Texto de cada status** → **Online** | Vai dentro do bloco de código, ao lado da bolinha. | 60 | "Online" | | **Texto de cada status** → **Offline** | Idem. | 60 | "Offline" | | **Texto de cada status** → **Manutenção** | Idem. | 60 | "Em manutenção" | Os textos de status ficam num bloco de código: não mostram formatação nem emojis do pacote. Os três são obrigatórios. ### Variáveis | Variável | O que vira | | ------------- | ---------------------------------------------- | | `{servidor}` | O nome do servidor FiveM | | `{jogadores}` | Quantos estão jogando agora (— quando offline) | | `{vagas}` | O máximo de jogadores do servidor | ## Embed **Embed** abre **Personalizar embed**. | Campo | O que faz | Padrão | | --------------------------------- | ---------------------------------------------------------------------- | ---------------------------- | | **Cor pelo status** | Verde online, vermelho offline e amarelo em manutenção. | Ligado | | **Cor** | A barra lateral do painel, quando **Cor pelo status** está desligado. | Cor do bot | | **Cabeçalho do servidor** | Nome e ícone do servidor do Discord no topo. | Desligado | | **Horário da última verificação** | No rodapé, para todo mundo ver que o status está fresco. | Ligado | | **Rodapé** | Texto curto (até 100 caracteres), com ícone opcional do pacote do bot. | "Atualizado automaticamente" | ## Prévia A prévia ao lado mostra o painel como fica no Discord. Em **Ver como**, troque entre **Online**, **Offline** e **Manutenção** para conferir cada status. Essa troca vale só na prévia. ## Avisos na página | Aviso | O que significa | | ------------------------------------------------------------ | ------------------------------------------ | | "O serviço que atualiza o painel está fora do ar…" | O status fica parado até o serviço voltar. | | "O bot não pode enviar ou editar mensagens nesse canal…" | Confira as permissões do bot no canal. | | "Esse canal não existe mais. Escolha outro." | O canal foi apagado no Discord. | | "O Discord pediu para esperar…" / "O Discord não respondeu…" | O painel atualiza na próxima verificação. | ## Perguntas frequentes **O painel mostra Offline, mas a cidade está no ar.** O status vem do **Endereço (opcional)** cadastrado no servidor do FiveDash, não do **Endereço do connect** do painel. Confira se esse endereço está certo. **Não aparece o Botão de entrar na cidade.** Ele só existe para servidores com código cfx.re. Cadastre o link `cfx.re/join/…` no endereço do servidor no FiveDash. **Qual a diferença para o comando /ip?** O `/ip` responde na hora, no canal onde foi usado, com o endereço do servidor cadastrado no FiveDash. O Connect é uma mensagem fixa que se atualiza sozinha. Veja [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands). ## Próximos passos [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands) Todos os comandos de barra do bot, como /status e /ip. [Boas-vindas](https://fivedash.fivex.gg/docs/pt/discord/welcome) Receba quem entra no Discord. [Servidor](https://fivedash.fivex.gg/docs/pt/server/overview) Status, console e jogadores da cidade. [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot) Cor e pacote de emojis usados no painel.