Guia de solução de problemas para questões comuns de servidores RedM, incluindo erros de chave de licença, visibilidade no navegador de servidores, falhas em resources, conexões de clientes, problemas de banco de dados e otimização de desempenho. Para instruções de configuração inicial, consulte nosso Guia de Configuração do Servidor RedM.

Erros de Chave de Licença

Problemas com chave de licença são o problema mais comum ao iniciar um novo servidor RedM. Aqui estão os erros típicos e suas soluções:

"Invalid license key" ou "Could not authenticate"

Servidor Não Aparece no Navegador

Se seu servidor está em execução, mas os jogadores não conseguem encontrá-lo no navegador de servidores do RedM:

Lista de Verificação

1. Aguarde pelo menos 5 minutos. Após iniciar, o servidor precisa de tempo para se registrar na lista mestre de servidores da Cfx.re. Novos servidores podem levar vários minutos para 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 o console do servidor para erros relacionados à licença.
3. Verifique a configuração dos endpoints. Certifique-se de que endpoint_add_tcp e endpoint_add_udp no server.cfg usam 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 configurações de "sv_master1" ou listagem. Certifique-se de que você não configurou acidentalmente o servidor para não se listar. Não deve haver sv_master1 "" na sua configuração (isso desabilita o registro na lista mestre).
5. Verifique se o servidor está realmente em execução. Verifique o console do GPanel. Se o servidor travou ou parou, ele não aparecerá no navegador.
6. Tente a conexão direta. Mesmo que o servidor não esteja no navegador, a conexão direta deve funcionar. Peça ao jogador para pressionar F8 no RedM e digitar:

   connect YOUR_SERVER_IP:PORT

Falhas no Carregamento de Resources

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

"Could not find resource [resource_name]"

• A pasta do resource não existe no diretório resources/, ou está no local errado.
• O nome da pasta não corresponde ao nome usado no ensure. Nomes de resources diferenciam maiúsculas de minúsculas.
• Correção: Verifique se a pasta do resource existe e se o nome no server.cfg corresponde exatamente. Use o gerenciador de arquivos do GPanel ou SFTP para verificar.

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

• O fxmanifest.lua ou __resource.lua do resource tem um erro de sintaxe.
• O manifesto referencia arquivos que não existem na pasta do resource.
• Correção: Abra o arquivo de manifesto e verifique erros de digitação, vírgulas faltando ou referências a arquivos inexistentes. Verifique o console do servidor para o número da linha específica do erro.

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

• Um arquivo Lua, C# ou JavaScript dentro do resource tem um erro de sintaxe ou de execução.
• Correção: Leia a mensagem de erro completa no console. Ela incluirá o nome do arquivo e o número da linha. Causas comuns incluem:
  • Dependências faltando (outro resource que deve ser carregado primeiro)
  • Resource desatualizado não compatível com a versão atual do servidor RedM
  • Valores de configuração incorretos no arquivo de configuração do resource

Problemas na Ordem de Carregamento de Resources

Resources no server.cfg são carregados na ordem em que aparecem. Se um resource 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 Conexão do Cliente

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

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Senha do servidor: Se sv_password estiver definida, o jogador deve inserir a senha correta.
• Resource de whitelist/allowlist: Se você tem um resource de whitelist habilitado, o jogador deve ser aprovado antes de conectar.
• Banimento: O jogador pode estar banido. Verifique sua lista de banimentos ou banco de dados para os identificadores dele.

Cliente trava ao conectar

• Um resource no servidor está enviando dados inválidos ou tem um erro de script no lado do cliente que causa o travamento.
• Correção: Desative resources adicionados recentemente um de cada vez para identificar o problemático. Verifique o console do servidor para erros durante a conexão do cliente.
• Certifique-se de que o cliente RedM do jogador está atualizado.

Erros "Could not download file"

• O servidor está tentando enviar um arquivo grande (ex.: um asset de streaming) que excede os limites de transferência ou a conexão está instável.
• Correção: Reduza o tamanho dos assets transmitidos, use uma CDN/hospedagem externa para arquivos grandes se suportado, ou peça ao jogador para tentar a conexão novamente.

Problemas de Banco de Dados (MySQL / oxmysql)

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

Erros de Falha na Conexã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 Ausentes ou Erros de Schema

Frameworks de roleplay geralmente requerem que as tabelas do banco de dados sejam configuradas antes de funcionar:

1. Verifique a documentação do framework ou o repositório GitHub para arquivos de importação SQL (geralmente nomeados database.sql, schema.sql ou similar).
2. Importe o arquivo SQL para seu banco de dados usando phpMyAdmin ou um cliente MySQL.
3. Alguns frameworks criam tabelas automaticamente na primeira inicialização. Certifique-se de que o usuário do banco de dados tem privilégios de CREATE TABLE.

Problemas de Desempenho

Se seu servidor RedM está apresentando lag, baixa taxa de tick ou desempenho geral ruim:

Identificando Problemas de Desempenho

Verifique o console do servidor para avisos de desempenho. Servidores RedM visam uma taxa de tick de cerca de 30-64 ticks por segundo. Você pode monitorar isso com:

• Painel txAdmin: Se o txAdmin estiver disponível, ele mostra métricas de desempenho do servidor em tempo real.
• Console do servidor: Fique atento a avisos de "slow tick" ou "resource hitch".
• Comando resmon: Digite resmon 1 no console do servidor (ou console F8) para habilitar o monitor de resources, que mostra o tempo de CPU por resource.

Soluções Comuns de Desempenho

Práticas Recomendadas

• Agende reinicializações automáticas a cada 6-12 horas usando o recurso de agendamento do GPanel ou txAdmin para limpar problemas acumulados de memória e entidades.
• Mantenha os resources atualizados para se beneficiar de correções de desempenho e otimizações.
• Evite funcionalidades duplicadas — não execute dois resources que fazem a mesma coisa (ex.: dois sistemas de clima).
• Teste novos resources em um servidor de testes (ou com baixa contagem de jogadores) antes de implantar no seu servidor principal.
• Monitore as métricas do servidor regularmente através do GPanel ou txAdmin para detectar problemas precocemente.

Dicas Gerais de Solução de Problemas

1. Sempre leia a saída do console do servidor. Quase todo erro inclui uma mensagem no console que informa o que deu errado e onde.
2. Reinicie o servidor após alterações na configuração. A maioria das alterações no server.cfg requer uma reinicialização completa do servidor para entrar em vigor.
3. Desative resources um de cada vez para isolar problemas. Comente as linhas ensure no server.cfg com #.
4. Mantenha backups de configurações funcionais antes de fazer alterações. Baixe seu server.cfg e banco de dados antes de grandes atualizações.
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 quanto ao RedM.
6. Verifique a compatibilidade dos resources com a versão do seu servidor. Resources criados para versões mais antigas podem não funcionar com builds atuais do RedM.

Artigos Relacionados

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

Precisa de Ajuda?

Ainda está enfrentando problemas com seu servidor RedM? Abra um ticket de suporte e inclua quaisquer mensagens de erro do console do seu servidor. Nossa equipe ajudará você a diagnosticar e resolver o problema.