Este guia abrange a configuração de administração, comandos de consola, suporte a mods, gestão de jogadores, wipes do servidor e resolução de problemas para o seu servidor dedicado de CryoFall. CryoFall é um jogo de sobrevivência de colónia sci-fi num planeta alienígena hostil, com árvores tecnológicas, agricultura, crafting e jogabilidade PvP/PvE. Para a configuração inicial do servidor, configuração e instruções de conexão, consulte o Guia de Configuração do Servidor CryoFall.

1. Configuração de Administração

O CryoFall utiliza um modelo de operador de servidor onde os privilégios de administração são concedidos através de ficheiros de configuração em vez de comandos no jogo.

Adicionar Operadores de Servidor

Para conceder acesso de administração a jogadores no seu servidor:

1. Pare o servidor a partir do GPanel.
2. Abra o ficheiro de lista de operadores no diretório Data/ através do separador Files ou SFTP.
3. Adicione o nome da conta CryoFall ou ID do jogador à lista de operadores.
4. Guarde o ficheiro e reinicie o servidor.

Os operadores do servidor têm acesso a ferramentas de administração, incluindo a capacidade de expulsar, banir e gerir o mundo a partir do jogo.

2. Comandos de Consola

O CryoFall disponibiliza comandos de consola acessíveis através da consola do GPanel e no jogo para operadores. Abaixo estão os comandos principais para gestão do servidor.

3. Suporte a Mods (ModsConfig.xml)

O CryoFall suporta mods do lado do servidor que podem modificar a jogabilidade, adicionar conteúdo ou alterar o comportamento do servidor.

Instalar Mods

1. Pare o servidor a partir do GPanel.
2. Descarregue os mods desejados da comunidade de modding do CryoFall ou do Steam Workshop.
3. Carregue os ficheiros dos mods para o diretório Mods/ do servidor via SFTP. Consulte Como Carregar Ficheiros via SFTP para instruções.
4. Edite o ficheiro ModsConfig.xml no diretório Data/ para registar os mods.
5. Inicie o servidor. Verifique a consola para confirmação de que os mods foram carregados com sucesso.

Formato do ModsConfig.xml

<ModsConfig>
  <Mods>
    <Mod>ModFolderName1</Mod>
    <Mod>ModFolderName2</Mod>
  </Mods>
</ModsConfig>

Cada entrada <Mod> corresponde a um nome de pasta dentro do diretório Mods/. A ordem de carregamento segue a ordem listada no ficheiro XML.

4. Gestão de Jogadores

Expulsar e Banir

• Use /player.kick <name> para remover imediatamente um jogador perturbador.
• Use /player.ban <name> para impedir permanentemente um jogador de se reconectar.
• Use /player.unban <name> para reverter um banimento.
• A lista de banidos persiste entre reinícios do servidor.

Proteção por Palavra-passe

Para servidores privados, ative a proteção por palavra-passe no ServerSettings.yml:

IsPasswordProtected: true
ServerPassword: "YourSecretPassword"

Partilhe a palavra-passe apenas com jogadores de confiança. Reinicie o servidor após alterar as definições de palavra-passe.

5. Wipe do Servidor

Servidores PvP beneficiam frequentemente de wipes periódicos para reiniciar a economia e dar a todos os jogadores um novo começo.

Realizar um Wipe Completo

1. Pare o servidor a partir do GPanel.
2. Faça uma cópia de segurança do diretório Data/ via SFTP (caso queira restaurar mais tarde).
3. Elimine os ficheiros de gravação do mundo do diretório Data/. Mantenha ficheiros de configuração como ServerSettings.yml e ModsConfig.xml se quiser preservar as suas definições.
4. Inicie o servidor. Um novo mundo será gerado com a sua configuração existente.

Wipes Agendados

Para wipes recorrentes, estabeleça um calendário e comunique-o aos seus jogadores:

• Calendários comuns são semanais (PvP competitivo) ou quinzenais (equilibrado).
• Anuncie as datas de wipe na descrição do servidor ou através de um Discord da comunidade.
• Realize os wipes durante horas de baixa atividade para minimizar a perturbação.

6. Resolução de Problemas

O Servidor Crasha no Arranque

• Verifique a consola do GPanel para mensagens de erro. Causas comuns incluem sintaxe YAML mal formada (indentação incorreta, dois pontos em falta ou caracteres de tabulação em vez de espaços).
• Se adicionou mods recentemente, tente removê-los do ModsConfig.xml para ver se algum mod está a causar o crash.
• Elimine o ServerSettings.yml e reinicie para regenerar uma configuração nova com os valores padrão.
• Se o crash persistir, abra um ticket de suporte com o IP do seu servidor e a saída completa da consola.

Os Jogadores Não Conseguem Conectar-se

• Verifique se o servidor está a funcionar no GPanel e consulte a consola para erros.
• Confirme que o jogador está a usar o IP e porta corretos do separador Network do GPanel.
• Verifique se a palavra-passe do servidor está correta, caso a proteção por palavra-passe esteja ativada.
• Certifique-se de que tanto o servidor como o cliente estão a executar a mesma versão do CryoFall.
• Se estiver a usar mods, confirme que o jogador tem os mods necessários do lado do cliente instalados.

Crashes Relacionados com Mods

• Remova os mods adicionados recentemente um de cada vez para identificar o mod problemático.
• Verifique a compatibilidade dos mods com a sua versão atual do CryoFall.
• Certifique-se de que o ficheiro ModsConfig.xml tem sintaxe XML válida sem erros de digitação nos nomes das pastas dos mods.
• Restaure a partir de uma cópia de segurança anterior aos mods se o mundo ficar corrompido.

Problemas de Desempenho

• Reduza o MaxPlayers se o servidor tiver dificuldades com muitos jogadores em simultâneo.
• Grandes quantidades de estruturas de jogadores e reivindicações de terreno podem impactar o desempenho ao longo do tempo. Wipes agendados ajudam a reiniciar isto.
• Verifique se algum mod instalado é conhecido por causar problemas de desempenho.
• Se o desempenho continuar fraco, contacte o suporte sobre a atualização do plano do seu servidor.

Artigos Relacionados

• Guia de Configuração do Servidor CryoFall
• Como Encontrar o IP e Porta do Seu Servidor
• Como Carregar Ficheiros via SFTP
• Guia de Arranque do Servidor

Precisa de Ajuda?

Se encontrar problemas com o seu servidor CryoFall que não estejam cobertos aqui, abra um ticket de suporte e inclua o IP do seu servidor, uma descrição do problema e quaisquer mensagens de erro relevantes da consola do GPanel.