Guia de resolução de problemas para problemas comuns do servidor RedM, incluindo erros de chave de licença, visibilidade no navegador de servidores, falhas de recursos, ligações de clientes, problemas de base de dados e otimização de desempenho. Para instruções de configuração inicial, consulte o nosso Guia de Configuração do Servidor RedM.

Erros de Chave de Licença

Os problemas com chaves de licença são o problema mais comum ao iniciar um novo servidor RedM. Eis os erros típicos e as suas soluções:

"Invalid license key" ou "Could not authenticate"

Servidor Não Aparece no Navegador

Se o seu servidor está em execução mas os jogadores não o conseguem encontrar no navegador de servidores RedM:

Lista de Verificação

1. Aguarde pelo menos 5 minutos. Após iniciar, o servidor precisa de tempo para se registar na lista principal de servidores Cfx.re. Novos servidores podem demorar vários minutos a aparecer.
2. Verifique se a chave de licença é válida. O servidor não será listado sem uma chave de licença funcional. Verifique a consola do servidor para erros relacionados com a licença.
3. Verifique a configuração dos endpoints. Certifique-se de que endpoint_add_tcp e endpoint_add_udp no server.cfg utilizam a porta correta:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   A porta deve corresponder à atribuída no GPanel.
4. Verifique as definições de "sv_master1" ou listagem. Certifique-se de que não definiu acidentalmente o servidor para não se listar. Não deve haver sv_master1 "" na sua configuração (isto desativa o registo na lista principal).
5. Verifique se o servidor está realmente em execução. Verifique a consola do GPanel. Se o servidor crashou ou parou, não aparecerá no navegador.
6. Tente a ligação direta. Mesmo que o servidor não esteja no navegador, a ligação direta deve funcionar. Peça ao jogador para premir F8 no RedM e escrever:

   connect YOUR_SERVER_IP:PORT

Falhas no Carregamento de Recursos

Erros de recursos são comuns ao adicionar novos scripts ou frameworks ao seu servidor. Eis os problemas mais frequentes:

"Could not find resource [resource_name]"

• A pasta do recurso não existe no diretório resources/, ou está na localização errada.
• O nome da pasta não corresponde ao nome utilizado em ensure. Os nomes dos recursos são sensíveis a maiúsculas e minúsculas.
• Solução: Verifique se a pasta do recurso existe e se o nome no server.cfg corresponde exatamente. Utilize o gestor de ficheiros do GPanel ou SFTP para verificar.

"Failed to load resource [resource_name]: manifest error"

• O fxmanifest.lua ou __resource.lua do recurso tem um erro de sintaxe.
• O manifesto referencia ficheiros que não existem na pasta do recurso.
• Solução: Abra o ficheiro do manifesto e verifique se há erros de escrita, vírgulas em falta ou referências a ficheiros inexistentes. Verifique a consola do servidor para o número de linha específico do erro.

"Error loading script [filename]: [error details]"

• Um ficheiro Lua, C# ou JavaScript dentro do recurso tem um erro de sintaxe ou de execução.
• Solução: Leia a mensagem de erro completa na consola. Incluirá o nome do ficheiro e o número da linha. As causas comuns incluem:
  • Dependências em falta (outro recurso que deve ser carregado primeiro)
  • Recurso desatualizado não compatível com a versão atual do servidor RedM
  • Valores de configuração incorretos no ficheiro de configuração do recurso

Problemas de Ordem de Carregamento de Recursos

Os recursos no server.cfg são carregados na ordem em que aparecem. Se um recurso depende de outro (ex.: vorp_inventory depende de vorp_core), a dependência deve ser listada primeiro:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

Problemas de Ligação do Cliente

Quando os jogadores não conseguem conectar-se ao seu servidor:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Palavra-passe do servidor: Se sv_password estiver definida, o jogador deve introduzir a palavra-passe correta.
• Recurso de whitelist/allowlist: Se tem um recurso de whitelist ativado, o jogador deve ser aprovado antes de conectar.
• Banimento: O jogador pode estar banido. Verifique a sua lista de banimentos ou base de dados para os identificadores do jogador.

O cliente crasha ao conectar

• Um recurso no servidor está a enviar dados inválidos ou tem um erro de script do lado do cliente que causa o crash.
• Solução: Desative os recursos adicionados recentemente um de cada vez para identificar o problemático. Verifique a consola do servidor para erros durante a ligação do cliente.
• Certifique-se de que o cliente RedM do jogador está atualizado.

Erros "Could not download file"

• O servidor está a tentar enviar um ficheiro grande (ex.: um asset de streaming) que excede os limites de transferência ou a ligação é instável.
• Solução: Reduza o tamanho dos assets transmitidos, utilize um CDN/alojamento externo para ficheiros grandes se suportado, ou peça ao jogador para tentar novamente a ligação.

Problemas de Base de Dados (MySQL / oxmysql)

A maioria dos frameworks de roleplay RedM utilizam MySQL para armazenamento persistente de dados. O conector de base de dados mais comum é o oxmysql.

Erros de Falha na Ligação

Se o oxmysql (ou outro conector MySQL) falhar ao conectar, verifique o seguinte:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

Tabelas em Falta ou Erros de Esquema

Os frameworks de roleplay frequentemente requerem que as tabelas da base de dados sejam configuradas antes de poderem funcionar:

1. Consulte a documentação do framework ou o repositório GitHub para ficheiros de importação SQL (frequentemente denominados database.sql, schema.sql ou similares).
2. Importe o ficheiro SQL para a sua base de dados utilizando o phpMyAdmin ou um cliente MySQL.
3. Alguns frameworks criam tabelas automaticamente no primeiro arranque. Certifique-se de que o utilizador da base de dados tem privilégios de CREATE TABLE.

Problemas de Desempenho

Se o seu servidor RedM está a sofrer lag, baixa taxa de ticks ou desempenho geral fraco:

Identificar Problemas de Desempenho

Verifique a consola do servidor para avisos de desempenho. Os servidores RedM têm como alvo uma taxa de ticks de cerca de 30-64 ticks por segundo. Pode monitorizar isto com:

• Painel txAdmin: Se o txAdmin estiver disponível, mostra métricas de desempenho do servidor em tempo real.
• Consola do servidor: Procure avisos de "slow tick" ou "resource hitch".
• Comando resmon: Escreva resmon 1 na consola do servidor (ou consola F8) para ativar o monitor de recursos, que mostra o tempo de CPU por recurso.

Soluções Comuns de Desempenho

Práticas Recomendadas

• Agende reinícios automáticos a cada 6-12 horas utilizando a funcionalidade de agendamento do GPanel ou o txAdmin para limpar problemas acumulados de memória e entidades.
• Mantenha os recursos atualizados para beneficiar de correções de desempenho e otimizações.
• Evite funcionalidade duplicada — não execute dois recursos que fazem a mesma coisa (ex.: dois sistemas meteorológicos).
• Teste novos recursos num servidor de teste (ou com baixo número de jogadores) antes de os implementar no seu servidor principal.
• Monitorize as métricas do servidor regularmente através do GPanel ou txAdmin para detetar problemas cedo.

Dicas Gerais de Resolução de Problemas

1. Leia sempre a saída da consola do servidor. Quase todos os erros incluem uma mensagem na consola que indica o que correu mal e onde.
2. Reinicie o servidor após alterações na configuração. A maioria das alterações ao server.cfg requer um reinício completo do servidor para entrar em vigor.
3. Desative recursos um de cada vez para isolar problemas. Comente as linhas ensure no server.cfg com #.
4. Mantenha cópias de segurança das configurações funcionais antes de fazer alterações. Descarregue o seu server.cfg e base de dados antes de atualizações importantes.
5. Consulte os fóruns e documentação da Cfx.re em docs.fivem.net para documentação oficial que se aplica tanto ao FiveM como ao RedM.
6. Verifique a compatibilidade dos recursos com a versão do seu servidor. Recursos construídos para versões mais antigas podem não funcionar com as builds atuais do RedM.

Artigos Relacionados

• Guia de Configuração do Servidor RedM — Chaves de licença, configuração do server.cfg, gestão de recursos e ligação.
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Ficheiros via SFTP
• Primeiros Passos com o Seu Novo Servidor

Precisa de Ajuda?

Ainda está a ter problemas com o seu servidor RedM? Abra um ticket de suporte e inclua quaisquer mensagens de erro da consola do seu servidor. A nossa equipa irá ajudá-lo a diagnosticar e resolver o problema.