# Problemas comuns

Como resolver recurso que não conecta, bot offline, entrega que não chega, Pix pendente, painel fechado e erros de login.

Source: https://fivedash.fivex.gg/docs/pt/help/troubleshooting

Quando algo não funciona, o FiveDash quase sempre diz o motivo: no painel, no console do servidor FiveM ou na tela do Discord. Esta página junta as mensagens reais que aparecem e o que fazer com cada uma. Procure pela frase que você está vendo.

## Antes de começar

* Muitas correções pedem a função **Dono** ou **Admin** (chave do servidor, plano, bot).
* Para problemas do recurso, tenha acesso ao console do servidor FiveM. O comando `fivedash status` mostra quase tudo de uma vez.

## O recurso fivedash não conecta

Primeiro, rode no console do servidor:

```bash
fivedash status
```

Ele mostra a framework, o painel (`conectado`, `conectando`, `sem conexão`, `recusado` ou `sem chave`), o servidor no FiveDash e as sincronizações.

| Mensagem no console                                                                           | Causa                                                      | O que fazer                                                                                            |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `Sem chave do painel: o servidor não está conectado ao FiveDash.`                             | O `Key` do `config.lua` está vazio                         | Gere a chave em **Servidor → Conexão com o jogo → Conectar servidor** e cole em `fivedash/config.lua`  |
| `A chave do painel não parece certa (começa com fdk_). Confira o Key no config.lua.`          | A chave foi colada errada                                  | Copie de novo, com aspas: `Key = "fdk_xxxxxxxx",`                                                      |
| `O painel recusou a conexão: chave recusada pelo painel.`                                     | A chave foi trocada ou o servidor foi desconectado         | Gere uma chave nova e troque o `Key` no `fivedash/config.lua`                                          |
| `O painel recusou a conexão: esta chave já está sendo usada por outro servidor ligado agora.` | Dois servidores com a mesma chave                          | Cada servidor tem a sua. Se você acabou de reiniciar o fivedash, ele entra sozinho em alguns segundos. |
| `O painel recusou a conexão: versão do recurso não aceita mais.`                              | Recurso muito antigo                                       | Baixe a versão nova em **Conexão com o jogo → Baixar a última versão**                                 |
| `Sem conexão com o painel (…). Tentando de novo sozinho.`                                     | Internet do servidor ou o painel fora do ar por um momento | Espere: o recurso tenta de novo sozinho                                                                |
| `O config.lua do fivedash sumiu…`                                                             | O arquivo foi apagado                                      | Baixe o recurso de novo ou crie o arquivo com a linha `Key`                                            |

| No painel                                                                              | O que fazer                                                                                                                               |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Esperando o servidor se conectar…** não sai                                          | Confira se `ensure fivedash` está no `server.cfg`, depois da framework, e se o recurso iniciou (`refresh` e `ensure fivedash` no console) |
| **Sem conexão** no cartão **Conexão com o jogo**                                       | O servidor não sincroniza há mais de cerca de 75 segundos. Veja se a cidade está ligada e rode `fivedash status`.                         |
| **Nenhuma versão do recurso publicada ainda** ou **Não foi possível baixar o recurso** | Tente de novo em instantes. Se continuar, fale com o suporte.                                                                             |
| **Só donos e admins da organização podem conectar o servidor.**                        | Peça para um dono ou admin                                                                                                                |
| **Já existe uma chave para este servidor (…).**                                        | A chave só aparece quando é gerada. Se não guardou, clique em **Gerar outra chave** (a anterior para de funcionar).                       |

## A framework não foi detectada

| Mensagem                                                                      | O que fazer                                                                                                                                                             |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nenhuma detectada** no painel / `Nenhuma framework reconhecida…` no console | A conexão funciona, mas a whitelist fica só no Discord e a loja entrega só por comandos. Inicie a framework antes do fivedash no `server.cfg` e rode `fivedash detect`. |
| `Framework "…" do config.lua não foi encontrada neste servidor`               | O valor de `Framework` no `config.lua` está errado. Use `"auto"` ou um destes: `"creative-enchanted"`, `"qbox"`, `"qbcore"`, `"esx"`, `"ox-core"`, `"vrp"`.             |
| `… ainda não tem suporte no FiveDash`                                         | A framework não é suportada: whitelist só no Discord e loja só por comandos                                                                                             |
| `Nenhum driver MySQL iniciado (oxmysql, mysql-async ou ghmattimysql)`         | Inicie um desses drivers antes do fivedash                                                                                                                              |
| **Whitelist pelo FiveDash: Indisponível** ou **Sem suporte ainda**            | A framework detectada não permite liberar a whitelist pelo jogo agora. Veja [Frameworks](https://fivedash.fivex.gg/docs/pt/developers/frameworks).                      |

## Os módulos do servidor não abrem

| O que aparece                                               | Motivo                                                              | O que fazer                                                                                                       |
| ----------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Conecte …** · **Um passo antes de configurar os módulos** | O recurso fivedash ainda não se conectou nenhuma vez neste servidor | Instale o recurso. Veja [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource). |
| Módulo com cadeado (**… · fora do plano**)                  | O módulo não está no plano                                          | Dono ou admin: **Adicionar … ao plano**                                                                           |
| Página com a etiqueta **Pro**                               | A página é do plano Pro                                             | Dono ou admin: **Mudar para o Pro**                                                                               |
| O módulo nem aparece                                        | Você não tem acesso a nenhuma página dele neste servidor            | Peça acesso a um dono ou admin                                                                                    |

## O bot do Discord está offline

Veja o status em **Discord → Bot**.

| Status             | O que significa                                                                                          | O que fazer                                                                                       |
| ------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Online**         | Conectado: entradas, sugestões, proteção e salas de entrevista chegam na hora                            | Nada                                                                                              |
| **Ligando**        | Ligando no Gateway. Leva alguns minutos e a página atualiza sozinha.                                     | Espere                                                                                            |
| **Offline**        | Os comandos continuam funcionando, mas entradas, sugestões, proteção e salas de entrevista ficam paradas | Clique em **Verificar conexão**. Se continuar, fale com o suporte.                                |
| **Token recusado** | O Discord recusou o token: os comandos param de responder                                                | Gere um token novo em **Bot → Reset Token** no Developer Portal e clique em **Salvar token novo** |

| Mensagem ao conectar o bot                                                                       | O que fazer                                                                                                      |
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **O Discord recusou esse token. Gere um novo em Bot → Reset Token e cole aqui.**                 | Gere outro token e cole                                                                                          |
| **Isso não parece um token de bot.**                                                             | Copie o token na aba **Bot** do Developer Portal                                                                 |
| **Esse bot já está conectado a outro servidor do FiveDash.**                                     | Use outro bot para este servidor                                                                                 |
| **O bot não está nesse servidor do Discord.** / **O bot não está mais em … Adicione-o de novo.** | Adicione o bot ao servidor do Discord de novo                                                                    |
| **Faltam: …** (permissões)                                                                       | Clique em **Atualizar permissões**                                                                               |
| **Ative em Bot → Privileged Gateway Intents e salve as alterações.**                             | Ligue a **Server Members Intent** (e a **Message Content Intent**, usada por logs e tickets) no Developer Portal |
| **Não conseguimos registrar os comandos.**                                                       | Clique em **Adicionar de novo**                                                                                  |
| **O Discord pediu para esperar um pouco.**                                                       | Tente de novo em alguns segundos                                                                                 |

Detalhes em [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).

## A compra da loja não chegou no jogo

Abra o pedido em **Loja → Pedidos**.

| Estado do pedido              | O que significa                                                      | O que fazer                                                                                                                                    |
| ----------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aguardando pagamento**      | O jogador ainda não pagou. O pedido expira sozinho se ninguém pagar. | Nada, ou peça para o jogador pagar                                                                                                             |
| **Pago, esperando a entrega** | A cidade entrega assim que o jogador estiver online                  | Peça para o jogador entrar na cidade. A entrega acontece alguns segundos depois de ele escolher o personagem.                                  |
| **A entrega falhou**          | O pagamento entrou, mas a cidade não conseguiu entregar              | Confira o **ID na cidade**, corrija se estiver errado e clique em **Reenviar para a cidade**. Se entregou à mão, use **Marcar como entregue**. |
| **Encerrado sem pagamento**   | O pagamento não foi feito a tempo                                    | O jogador precisa comprar de novo                                                                                                              |

Confira também:

* O recurso está **Conectado** em **Servidor → Conexão com o jogo**.
* No `fivedash/loja.lua`, `Enabled = true`. Desligado, o site da loja para de vender até você ligar de novo.
* Se `AllowedCommands` tiver uma lista, o comando do produto precisa começar com um dos itens dela.
* `fivedash status` mostra quantas entregas estão esperando jogadores.

Veja [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery) e [Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders).

## Os logs não chegam

| Causa                             | O que fazer                                                                      |
| --------------------------------- | -------------------------------------------------------------------------------- |
| Envio pelo export desligado       | No `fivedash/logs.lua`, confira `Enabled = true`                                 |
| A chave do log está em `Disabled` | Tire a chave da lista `Disabled`                                                 |
| `AllowedResources` tem uma lista  | O recurso que manda o log precisa estar na lista, ou deixe a lista vazia         |
| Chave do log errada               | Use a chave do log em **Logs → o log → Como mandar**                             |
| Limite do plano                   | Logs recebidos por mês: 1 milhão no Plus, 10 milhões no Pro, 50 milhões no Ultra |

Depois de mudar o `logs.lua`, rode `restart fivedash`. Veja [Criar logs](https://fivedash.fivex.gg/docs/pt/logs/create-logs).

## O Pix do plano não confirma

| O que aparece                                                                                                                | O que fazer                                                                              |
| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Aguardando o pagamento**                                                                                                   | A confirmação chega sozinha, em segundos, depois que o banco aprova. Não feche a janela. |
| **Expirou**                                                                                                                  | Cada QR code vale 30 minutos. Clique em **Gerar outro Pix**.                             |
| **Essa cobrança não está mais aberta. Gere outra.**                                                                          | Gere um Pix novo                                                                         |
| **Informe quem paga: nome e CPF ou CNPJ.** / **CPF ou CNPJ inválido.**                                                       | Corrija os dados em **Quem paga**                                                        |
| **O pagamento por Pix está indisponível agora. Tente de novo em instantes.** / **Não foi possível falar com a Woovi agora.** | Tente de novo em instantes                                                               |
| **A Woovi recusou o pedido: …**                                                                                              | Confira os dados de quem paga. Se continuar, fale com o suporte.                         |
| **O plano não está mais em dia. Pague o plano antes do servidor extra.**                                                     | Pague o plano primeiro                                                                   |
| **Pix em breve** / **O pagamento por Pix chega em breve.**                                                                   | O Pix ainda não está disponível para a sua organização: fale com o suporte               |

Na lista **Configurações → Plano → Pagamentos**, cada Pix aparece como **Pago**, **Aguardando**, **Expirou** ou **Substituído** (quando você gerou outro no lugar).

## O painel está fechado

| Tela                                     | Motivo                                       | O que fazer                                             |
| ---------------------------------------- | -------------------------------------------- | ------------------------------------------------------- |
| **A organização ainda não tem um plano** | Ninguém escolheu o plano                     | Peça para o dono ou um admin escolher                   |
| **Seu teste grátis acabou**              | O teste de 7 dias terminou sem pagamento     | Dono ou admin: **Pagar … com Pix**                      |
| **O plano da organização venceu**        | O período pago acabou sem pagamento          | Dono ou admin: **Pagar … com Pix** ou **Mudar o plano** |
| **Organização suspensa**                 | A equipe do FiveDash suspendeu a organização | **Falar com o suporte**                                 |

Nada é apagado nesses casos: **Seus dados, bots e configurações continuam guardados.**

## Limites do plano

| Mensagem                                                                                               | O que fazer                                                          |
| ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| **O plano … inclui até N produtos por loja. Mude de plano para ter mais.**                             | Mude de nível ou remova produtos                                     |
| **O plano … inclui até N logs por servidor.**                                                          | Mude de nível ou exclua logs                                         |
| **O plano tem 1 servidor, todos em uso. Adicione um servidor extra (…/mês) antes de cadastrar outro.** | Adicione um servidor extra ao plano                                  |
| **Não cabe no …: …**                                                                                   | O uso passa do nível escolhido. Escolha outro nível ou reduza o uso. |
| **Domínio próprio faz parte do plano Pro.**                                                            | Mude para o Pro ou Ultra                                             |

## Problemas de conta e login

| Mensagem                                                                         | O que fazer                                                                 |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Código de verificação não chega                                                  | Confira o spam e use **Reenviar** (a cada 60 segundos)                      |
| **Confirme seu e-mail para continuar.**                                          | Digite o código de 6 dígitos que chegou no e-mail                           |
| **Muitas tentativas erradas. Por segurança, espere 15 minutos e tente de novo.** | Espere 15 minutos                                                           |
| **Esta tentativa de login terminou. Entre de novo.**                             | Clique em **Entrar de novo**                                                |
| **Crie uma senha em Segurança antes: ela confirma que é você.**                  | A conta entra com Discord. Crie uma senha em **Configurações → Segurança**. |
| **Esta conta foi suspensa. Fale com o suporte: …**                               | Fale com o suporte pelo e-mail da mensagem                                  |
| **Sua sessão expirou. Entre novamente.**                                         | Entre de novo                                                               |

## Endereço do servidor recusado

| Mensagem                                                                         | O que fazer                                                  |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| **Use um link cfx.re/join ou um IP no formato 0.0.0.0:30120.**                   | Corrija o formato                                            |
| **Não encontramos um servidor com esse código.**                                 | Confira o código do `cfx.re/join`                            |
| **O servidor não respondeu. Confira se ele está online e com a porta liberada.** | Ligue o servidor e libere a porta, ou deixe o endereço vazio |
| **Esse endereço não é público.**                                                 | Use o IP público                                             |
| **Esse servidor já está em outra organização do FiveDash.**                      | Fale com o suporte pelo e-mail da mensagem                   |

## Convites

| Tela                                | O que fazer                                                               |
| ----------------------------------- | ------------------------------------------------------------------------- |
| **Este convite é para outra conta** | Entre com o e-mail que recebeu o convite (**Entrar com …**)               |
| **Convite indisponível**            | Peça um convite novo                                                      |
| **Transferência indisponível**      | Ela foi cancelada, recusada ou expirou (vale 7 dias). Peça outra ao dono. |

## Ainda com problema?

Veja [Suporte](https://fivedash.fivex.gg/docs/pt/help/support) para falar com a equipe do FiveDash. Mande junto a mensagem exata que aparece e, para o recurso, a saída do `fivedash status` (sem a chave).

## Próximos passos

[Perguntas frequentes](https://fivedash.fivex.gg/docs/pt/help/faq)

Respostas rápidas.

[Suporte](https://fivedash.fivex.gg/docs/pt/help/support)

Falar com a equipe do FiveDash.

[Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource)

Instalação passo a passo.

[Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing)

Pix, teste e vencimento.
