Este guia aborda problemas comuns que pode encontrar ao executar um servidor dedicado Rust na Legion Hosting e como resolvê-los. Para configuração geral do servidor, consulte o Guia de Configuração do Servidor Rust.

O Servidor Não Aparece no Navegador de Servidores

Se o seu servidor está em execução mas os jogadores não o conseguem encontrar no navegador dentro do jogo:

• O navegador de servidores pode levar 10-20 minutos a indexar um servidor recém-iniciado. Use a conexão direta via consola F1 (client.connect IP:PORT) para verificar que o servidor está acessível enquanto o navegador atualiza.
• Certifique-se de que a variável de arranque QUERY_PORT (no separador Startup do GPanel) corresponde à porta de consulta alocada no separador Network do GPanel. Uma porta de consulta incorreta é a razão mais comum para um servidor não aparecer no navegador.
• Confirme que o servidor está totalmente iniciado — procure pela linha Server startup complete na consola antes de testar conexões.
• Verifique se server.hostname está definido no server.cfg. Servidores sem hostname podem não ser apresentados corretamente no navegador.

Não Consigo Conectar ao Servidor

Se receber um erro de conexão ou timeout ao tentar entrar:

• Verifique se o servidor está em execução e totalmente iniciado no separador Console do GPanel.
• Confirme que está a usar o endereço IP e porta do jogo corretos a partir do separador Network do GPanel.
• Se o servidor foi atualizado recentemente (especialmente durante o wipe forçado da primeira quinta-feira), certifique-se de que reiniciou o servidor após a atualização. Jogadores na nova versão do cliente não conseguem conectar-se a um servidor com uma versão mais antiga.
• Verifique se server.maxplayers não foi excedido. Se o servidor estiver cheio, novas conexões serão rejeitadas.
• Certifique-se de que não foi banido. Verifique com o administrador do servidor ou consulte bans.cfg no servidor.

Não Consigo Conectar ao RCON com uma Ferramenta Externa

Se o RustAdmin, RCON.IO ou outro cliente RCON não conseguir conectar:

• Verifique se rcon.web 1 está definido no server.cfg. A maioria das ferramentas externas requer a interface RCON WebSocket.
• Confirme que está a usar a porta RCON e não a porta do jogo. Verifique o separador Network do GPanel para ver a porta RCON atribuída.
• Verifique novamente se a palavra-passe RCON corresponde exatamente ao que está definido no server.cfg. As palavras-passe são sensíveis a maiúsculas e minúsculas.
• O servidor deve estar totalmente iniciado antes de aceitar conexões RCON. Aguarde por Server startup complete na consola.

Para instruções completas de configuração RCON, consulte Acesso RCON e Comandos de Administração no Rust.

Os Plugins Oxide Não Estão a Carregar

• Confirme que o Oxide está instalado e ativo. No separador Startup do GPanel, a variável FRAMEWORK deve estar definida como oxide. O registo da consola deve mostrar Loaded plugin Oxide.Core durante o arranque.
• Os ficheiros de plugins devem ser colocados diretamente em oxide/plugins/ com a extensão .cs exata. Ficheiros em subdiretórios ou com extensões incorretas são ignorados.
• Verifique a consola e oxide/logs/ para erros de compilação. Um plugin com um erro de sintaxe não conseguirá carregar e a mensagem de erro descreverá o problema.
• Alguns plugins têm dependências de outros plugins (por exemplo, Economics). Instale todas as dependências necessárias primeiro.
• Certifique-se de que a versão do plugin é compatível com a sua versão atual do Oxide. Plugins desatualizados podem falhar a compilar contra uma versão mais recente do Oxide.

Para instruções completas de instalação de plugins, consulte Instalação de Plugins Oxide/uMod para Rust.

O Servidor Está a Usar RAM ou CPU Excessivos

Se o seu servidor está a funcionar lentamente, com lag ou a exceder os limites de recursos:

• Reduza o tamanho do mapa. Diminua server.worldsize no server.cfg. Mapas maiores requerem substancialmente mais RAM e CPU para executar e manter. Um tamanho de mapa de 3000 é um bom equilíbrio para a maioria dos servidores.
• Audite os plugins instalados. Alguns plugins mal escritos ou desatualizados podem causar uso elevado de CPU ou fugas de memória. Use oxide.plugins para listar os plugins ativos e tente desativá-los um de cada vez para identificar o problema.
• Reduza o número de jogadores. Diminua server.maxplayers se o servidor não tiver recursos suficientes para a contagem atual de jogadores. Cada jogador conectado adiciona carga de recursos.
• Verifique a acumulação de entidades. Em servidores de longa duração, bases abandonadas e itens em decomposição podem acumular-se. Um map wipe repõe as contagens de entidades a zero.

As Alterações ao Mundo Não Estão a Ser Gravadas / Rollback Após Reinício

Se o progresso dos jogadores está a ser perdido após reinícios do servidor:

• Verifique se server.saveinterval está definido com um valor razoável no server.cfg (o padrão é 60 segundos). Defini-lo como 0 ou um número muito grande desativa efetivamente as gravações automáticas.
• Execute server.save manualmente via consola do GPanel ou RCON antes de parar o servidor para forçar uma gravação imediata.
• Certifique-se de que o servidor é parado de forma adequada a partir do GPanel em vez de ser terminado à força. Uma interrupção abrupta pode causar a perda das alterações do último intervalo de gravação.
• Verifique o espaço em disco disponível. Se o servidor ficar sem espaço em disco, não consegue escrever os ficheiros de gravação.

O Servidor Crasha no Arranque

Se o servidor inicia mas crasha imediatamente ou entra num ciclo de reinícios:

• Verifique a saída da consola para mensagens de erro. Causas comuns incluem ficheiros de gravação corrompidos, plugins incompatíveis ou ficheiros de framework em falta.
• Se o crash começou após adicionar um plugin, remova o ficheiro .cs adicionado mais recentemente de oxide/plugins/ e reinicie.
• Se o crash começou após uma atualização do jogo, certifique-se de que a variável FRAMEWORK está definida corretamente. Os ficheiros do framework podem precisar de ser transferidos novamente após uma atualização do Rust — simplesmente reinicie o servidor e o framework atualizado deve ser obtido automaticamente.
• Tente apagar os ficheiros de gravação (proceduralmap.*.sav e proceduralmap.*.map) e realizar um map wipe limpo. Ficheiros de gravação corrompidos podem impedir o servidor de arrancar.

A Geração do Mapa Demora Muito Tempo

Após um wipe, o servidor deve gerar um novo mapa procedimental. Isto é normal e esperado:

• Um tamanho de mapa de 3000 tipicamente demora 2-5 minutos a gerar.
• Mapas maiores (4000-6000) podem demorar 10+ minutos.
• Não reinicie o servidor durante a geração do mapa. Deixe-o completar totalmente. A consola mostrará Server startup complete quando estiver pronto.

Precisa de Ajuda?

Se o seu problema não está coberto aqui, a nossa equipa de suporte está disponível para ajudar. Submeta um ticket de suporte e inclua:

• O ID do seu servidor (mostrado no GPanel)
• Uma descrição do problema e quando começou
• Qualquer saída relevante da consola ou mensagens de erro
• Passos que já tentou