Este guia aborda soluções para os problemas mais comuns do servidor FiveM — problemas de acesso ao TXAdmin, erros de chave de licença CFX, falhas de ligação à base de dados, crashes do servidor, problemas de conexão dos 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 resolução de problemas: Verifique sempre primeiro a saída da consola do GPanel e os registos do TXAdmin. A maioria dos erros produz uma mensagem clara que aponta para a causa.
TXAdmin Não Carrega ou Está 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 a consola do GPanel para o URL e a porta do TXAdmin. A porta do TXAdmin é diferente da porta de jogo.
- Certifique-se de que está a utilizar
http://e nãohttps://— o TXAdmin não utiliza SSL por predefinição. - Se o TXAdmin estava a funcionar anteriormente mas deixou de carregar, tente reiniciar o servidor a partir do GPanel.
- Limpe a cache do seu navegador ou tente uma janela anónima/privada.
Perdeu a sua palavra-passe do TXAdmin? Se não conseguir iniciar sessão, poderá ter de eliminar os dados de perfil do TXAdmin e executar novamente o assistente de configuração. Verifique o separador Files do GPanel para o diretório de dados do TXAdmin e remova os seus ficheiros 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ços em branco extras | Aceda ao Keymaster, confirme que a chave está ativa e copie-a novamente com cuidado. Cole-a tanto na variável Startup do GPanel como em sv_licenseKey no server.cfg. |
License key already in use |
A chave está registada num IP de servidor diferente | Cada chave só pode ser utilizada num servidor de cada vez. Revogue a chave antiga no Keymaster e gere uma nova com o IP atual do seu servidor. |
Unable to verify license key |
Os servidores de autenticação da Cfx.re estão temporariamente indisponíveis | Aguarde alguns minutos e reinicie o servidor. Verifique status.cfx.re para interrupções. |
Dica: Certifique-se de que a chave está definida tanto na variável Startup do GPanel como no
server.cfg (sv_licenseKey). Dependendo da sua configuração, o servidor pode ler de um ou de outro.
Erros de Ligação à Base de Dados
| Mensagem de Erro | Causa | Solução |
|---|---|---|
Connection refused ou ETIMEDOUT |
Host ou porta da base de dados incorretos | Verifique novamente o endereço do host e a porta da base de dados no separador Databases do GPanel. Não utilize localhost ou 127.0.0.1. |
Access denied |
Nome de utilizador ou palavra-passe incorretos | Copie as credenciais diretamente do GPanel para evitar erros de digitação. As palavras-passe são sensíveis a maiúsculas/minúsculas. |
Unknown database |
O nome da base de dados não corresponde | Certifique-se de que o nome da base de dados na sua string de conexão corresponde exatamente ao que é apresentado no GPanel. |
Passos adicionais de resolução de problemas da base de dados:
- Se estiver a utilizar oxmysql, certifique-se de que tem o recurso
oxmysqlna sua pastaresources/e queensure oxmysqlaparece no server.cfg antes de quaisquer recursos que necessitem de uma base de dados. - Se a sua palavra-passe contiver caracteres especiais como
@,#ou%, codifique-os em formato URL na string de conexão (por exemplo,@torna-se%40). - Teste a sua string de conexão para caracteres em falta ou a mais — até um único carácter mal colocado causará uma falha.
Não utilize localhost. O servidor de base de dados é separado do servidor de jogo. Utilize sempre o endereço completo do host apresentado no separador Databases do GPanel.
O Servidor Crasha ao Iniciar
- Verifique a consola do GPanel para mensagens de erro. As causas comuns incluem um
server.cfgem falta ou mal configurado, uma chave de licença CFX inválida ou um recurso com problemas. - Tente desativar recursos personalizados comentando-os no server.cfg (adicione
#antes de cada linhaensure) e reinicie. Adicione-os de volta um a um 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
Pesquisa binária para recursos problemáticos: Se tiver muitos recursos, comente metade de cada vez em vez de um a um. Isto reduz o problema muito mais rapidamente.
Os Jogadores Não Conseguem Conectar-se
- Confirme que o servidor mostra Running no GPanel.
- Verifique o IP e a porta — os jogadores devem utilizar a porta de jogo, não a porta do TXAdmin.
- Verifique se
sv_maxclientsnão está definido como 0 ou um número excessivamente baixo. - Se estiver a utilizar uma palavra-passe de servidor (
sv_passwordno server.cfg), certifique-se de que os jogadores a conhecem. - Os jogadores devem ter o cliente FiveM instalado — não podem conectar-se utilizando o launcher normal do GTA V.
- Verifique o separador Network do GPanel e confirme que as portas em
endpoint_add_tcpeendpoint_add_udpcorrespondem. Uma discrepância impedirá as ligações.
O servidor não aparece no browser? Os novos servidores podem demorar 5-15 minutos a aparecer na lista de servidores do FiveM. Utilize a ligação direta (
IP:PORT) entretanto. Verifique também que o seu sv_licenseKey é válido.
Recursos Não Carregam
- Verifique se a pasta do recurso está dentro do diretório
resources/(ou numa subpasta apropriada). - Verifique se o nome da pasta corresponde exatamente à linha
ensureno server.cfg (sensível a maiúsculas/minúsculas). - Cada recurso deve conter um ficheiro
fxmanifest.lua(ou o mais antigo__resource.lua) válido. Se este ficheiro estiver em falta, o recurso não será carregado. - Verifique a consola do TXAdmin ou do GPanel para mensagens de erro relacionadas com o recurso. Os erros comuns incluem dependências em falta ou erros de sintaxe Lua.
- Se o recurso requer um framework (ESX, QBCore), certifique-se de que o framework é carregado antes do recurso no server.cfg.
- Se o recurso requer uma base de dados, certifique-se de que o seu recurso MySQL (oxmysql, mysql-async) está carregado e a ligação à base de dados está a funcionar.
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, utilização de memória).
- Um servidor FiveM saudável deve manter um tempo de tick do servidor (também chamado "hitch") abaixo de 20ms. Picos consistentes acima deste valor indicam que um recurso está a utilizar demasiado tempo de processamento.
- Utilize a página de Resources do TXAdmin para identificar quais recursos estão a consumir mais tempo do servidor.
- Remova ou substitua recursos mal otimizados. Recursos gratuitos de fontes desconhecidas são frequentemente a causa de problemas de desempenho.
- Reduza o número de recursos carregados se os limites de memória ou CPU do seu plano de servidor estiverem a ser atingidos.
Obter Ajuda
Se tentou as soluções acima e continua a ter problemas:
- Copie a mensagem de erro completa da consola do GPanel ou do registo do TXAdmin.
- Anote os passos de resolução de problemas que já tentou.
- Abra um ticket de suporte em https://legionhosting.net/submitticket.php com esta informação. A nossa equipa irá assisti-lo o mais rapidamente possível.
