Este guia cobre soluções para os problemas mais comuns de servidores FiveM — problemas de acesso ao TXAdmin, erros de chave de licença CFX, falhas de conexão com banco de dados, crashes do servidor, problemas de conexão de jogadores e recursos que não carregam. Para a configuração inicial do servidor, consulte o Guia de Configuração do Servidor FiveM.
Dica geral de solução de problemas: Sempre verifique a saída do console do GPanel e os logs do TXAdmin primeiro. A maioria dos erros produz uma mensagem clara que aponta para a causa.
TXAdmin Não Carrega ou Inacessível
- Verifique se o servidor está em execução no GPanel — o TXAdmin só inicia quando o processo do servidor FiveM está ativo.
- Verifique no console do GPanel a URL e a porta do TXAdmin. A porta do TXAdmin é diferente da porta do jogo.
- Certifique-se de que está usando
http://e nãohttps://— o TXAdmin não usa SSL por padrão. - Se o TXAdmin estava funcionando antes mas parou de carregar, tente reiniciar o servidor pelo GPanel.
- Limpe o cache do navegador ou tente uma janela anônima/privada.
Perdeu sua senha do TXAdmin? Se você não consegue fazer login, pode ser necessário excluir os dados do perfil do TXAdmin e executar o assistente de configuração novamente. Verifique a aba Files do GPanel para o diretório de dados do TXAdmin e remova seus arquivos de perfil, depois reinicie o servidor.
Erros de Chave de Licença CFX
| Mensagem de Erro | Causa | Solução |
|---|---|---|
Invalid license key |
Chave copiada incorretamente ou espaço em branco extra | Acesse o Keymaster, confirme que a chave está ativa e copie-a novamente com cuidado. Cole-a tanto na variável Startup do GPanel quanto no sv_licenseKey do server.cfg. |
License key already in use |
Chave registrada em um IP de servidor diferente | Cada chave só pode ser usada em um servidor por vez. Revogue a chave antiga no Keymaster e gere uma nova com o IP atual do seu servidor. |
Unable to verify license key |
Servidores de autenticação da Cfx.re temporariamente indisponíveis | Aguarde alguns minutos e reinicie o servidor. Verifique status.cfx.re para interrupções. |
Dica: Certifique-se de que a chave esteja definida tanto na variável Startup do GPanel quanto no
server.cfg (sv_licenseKey). Dependendo da sua configuração, o servidor pode ler de um ou de outro.
Erros de Conexão com o Banco de Dados
| Mensagem de Erro | Causa | Solução |
|---|---|---|
Connection refused ou ETIMEDOUT |
Host ou porta do banco de dados incorretos | Verifique novamente o endereço do host e a porta do banco de dados na aba Databases do GPanel. Não use localhost ou 127.0.0.1. |
Access denied |
Usuário ou senha incorretos | Copie as credenciais diretamente do GPanel para evitar erros de digitação. As senhas diferenciam maiúsculas de minúsculas. |
Unknown database |
Nome do banco de dados não corresponde | Certifique-se de que o nome do banco de dados na sua string de conexão corresponde exatamente ao que é mostrado no GPanel. |
Passos adicionais para solução de problemas do banco de dados:
- Se estiver usando oxmysql, certifique-se de que o recurso
oxmysqlestá na pastaresources/e queensure oxmysqlaparece no server.cfg antes de quaisquer recursos que necessitem de um banco de dados. - Se sua senha contém caracteres especiais como
@,#ou%, codifique-os em URL na string de conexão (ex:@se torna%40). - Teste sua string de conexão para caracteres faltando ou extras — mesmo um caractere mal posicionado causará uma falha.
Não use localhost. O servidor de banco de dados é separado do servidor de jogo. Sempre use o endereço completo do host mostrado na aba Databases do GPanel.
Servidor Crasha na Inicialização
- Verifique o console do GPanel para mensagens de erro. Causas comuns incluem um
server.cfgausente ou mal configurado, uma chave de licença CFX inválida ou um recurso com problema. - Tente desabilitar recursos personalizados comentando-os no server.cfg (adicione
#antes de cada linhaensure) e reinicie. Adicione-os de volta um por vez para identificar o recurso problemático. - Certifique-se de que as portas em
endpoint_add_tcpeendpoint_add_udpcorrespondem à porta atribuída no GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Busca binária para recursos problemáticos: Se você tem muitos recursos, comente metade de cada vez em vez de um por um. Isso reduz o problema muito mais rápido.
Jogadores Não Conseguem Conectar
- Confirme que o servidor mostra Running no GPanel.
- Verifique o IP e a porta — os jogadores devem usar a porta do jogo, não a porta do TXAdmin.
- Verifique se
sv_maxclientsnão está definido como 0 ou um número excessivamente baixo. - Se estiver usando uma senha de servidor (
sv_passwordno server.cfg), certifique-se de que os jogadores a conheçam. - Os jogadores devem ter o cliente FiveM instalado — eles não podem se conectar usando o launcher padrão do GTA V.
- Verifique a aba Network do GPanel e confirme que as portas em
endpoint_add_tcpeendpoint_add_udpcorrespondem. Uma incompatibilidade impedirá as conexões.
Servidor não aparece no navegador? Novos servidores podem levar de 5 a 15 minutos para aparecer na lista de servidores do FiveM. Use a conexão direta (
IP:PORT) enquanto isso. Também verifique se seu sv_licenseKey é válido.
Recursos Não Carregam
- Verifique se a pasta do recurso está dentro do diretório
resources/(ou uma subpasta apropriada). - Verifique se o nome da pasta corresponde exatamente à linha
ensureno server.cfg (diferencia maiúsculas de minúsculas). - Cada recurso deve conter um
fxmanifest.luaválido (ou o antigo__resource.lua). Se este arquivo estiver ausente, o recurso não carregará. - Verifique o console do TXAdmin ou GPanel para mensagens de erro relacionadas ao recurso. Erros comuns incluem dependências faltando ou erros de sintaxe Lua.
- Se o recurso requer um framework (ESX, QBCore), certifique-se de que o framework está carregado antes do recurso no server.cfg.
- Se o recurso requer um banco de dados, certifique-se de que seu recurso MySQL (oxmysql, mysql-async) está carregado e a conexão com o banco de dados está funcionando.
Verifique a estrutura de pastas. Um erro comum é enviar um recurso e acabar com uma pasta duplamente aninhada como
resources/my-resource/my-resource/fxmanifest.lua. O manifesto deve estar diretamente dentro da pasta do recurso: resources/my-resource/fxmanifest.lua.
Problemas de Desempenho do Servidor
- Abra o TXAdmin e verifique o Dashboard para métricas de desempenho (tempo de tick, contagem de jogadores, uso de memória).
- Um servidor FiveM saudável deve manter um tempo de tick do servidor (também chamado de "hitch") abaixo de 20ms. Picos consistentes acima disso indicam que um recurso está usando tempo de processamento demais.
- Use a página de Resources do TXAdmin para identificar quais recursos estão consumindo mais tempo do servidor.
- Remova ou substitua recursos mal otimizados. Recursos gratuitos de fontes desconhecidas frequentemente são a causa de problemas de desempenho.
- Reduza o número de recursos carregados se os limites de memória ou CPU do plano do seu servidor estão sendo atingidos.
Obtendo Ajuda
Se você tentou as soluções acima e ainda está enfrentando problemas:
- Copie a mensagem de erro completa do console do GPanel ou do log do TXAdmin.
- Anote quais passos de solução de problemas você já tentou.
- Abra um ticket de suporte em https://legionhosting.net/submitticket.php com essas informações. Nossa equipe ajudará você o mais rápido possível.
