Este guia orienta você na configuração do seu servidor dedicado Hytale na Legion Hosting, incluindo a etapa de autenticação obrigatória na primeira vez, configuração básica do servidor e como os jogadores se conectam ao seu servidor.

Pré-requisitos

• Um servidor Hytale ativo na Legion Hosting
• Suas credenciais do GPanel do e-mail de boas-vindas (verifique sua pasta de spam se não encontrar)
• Hytale instalado no seu PC
• O endereço IP e a porta do seu servidor obtidos no GPanel (acesse em gpanel.legionhosting.net)

Passo 1 — Faça Login no GPanel e Inicie o Servidor

1. Abra seu navegador e acesse https://gpanel.legionhosting.net.
2. Insira o E-mail e a Senha do seu e-mail de boas-vindas e clique em Login.
3. Clique no seu servidor Hytale na lista de servidores para abri-lo.
4. Na aba Console, o indicador de status mostrará Offline. Clique no botão Start.
5. Aguarde o servidor baixar e instalar os arquivos necessários. A primeira inicialização pode levar de 2 a 5 minutos enquanto os arquivos do servidor Hytale são configurados.
6. Observe a saída do console. O servidor eventualmente pausará e exibirá um prompt de autenticação com uma URL e um código de dispositivo. Não feche ou reinicie o servidor neste momento.

Passo 2 — Autentique Seu Servidor

Hytale requer autenticação do servidor na primeira inicialização. O servidor não aceitará conexões de jogadores até que você complete esta etapa.

1. No console do GPanel, procure uma mensagem contendo uma URL e um código de dispositivo. Será semelhante a:

   To authenticate, visit: https://auth.hytale.com/device
   Enter the code: XXXX-XXXX

2. Abra a URL de autenticação no seu navegador em qualquer dispositivo (PC, celular, tablet).
3. Faça login com sua conta Hytale (a conta que você usa para jogar).
4. Insira o código de dispositivo exibido no console quando solicitado.
5. Confirme a autenticação. O navegador mostrará uma mensagem de sucesso.
6. Volte ao GPanel e observe o console. Em poucos segundos, o servidor deve continuar o processo de inicialização e o status mudará para Running.

Passo 3 — Encontre Seus Detalhes de Conexão

1. No GPanel, clique na aba Console (ou na área de visão geral do servidor).
2. Anote o Endereço IP e a Porta exibidos próximo ao topo da página.
3. O formato é IP:Port, por exemplo 192.0.2.10:25565. Você compartilhará esses detalhes com qualquer pessoa que queira entrar no seu servidor.

Para um passo a passo detalhado sobre como localizar seus detalhes de conexão, consulte Como Encontrar o IP e a Porta do Seu Servidor.

Passo 4 — Configuração Básica do Servidor

Servidores dedicados Hytale expõem configurações principais através da aba Startup do GPanel. Essas variáveis controlam as opções mais comuns do servidor sem necessidade de edição manual de arquivos.

Usando Variáveis de Inicialização

1. No GPanel, clique na aba Startup.
2. Você verá uma lista de variáveis configuráveis. Edite qualquer valor e clique em Save ou pressione Enter.
3. Após fazer alterações, reinicie o servidor pela aba Console para que as novas configurações entrem em vigor.

Configurações Comuns

Editando Arquivos de Configuração

Para configurações avançadas não disponíveis na aba Startup, você pode editar os arquivos de configuração do servidor diretamente pelo gerenciador de arquivos do GPanel.

1. Clique na aba Files no GPanel.
2. Navegue até o diretório raiz do servidor e procure os arquivos de configuração (estes podem variar conforme Hytale recebe atualizações).
3. Clique em um arquivo para abri-lo no editor de texto integrado. Faça suas alterações e clique em Save Content.
4. Pare e reinicie o servidor para que as alterações entrem em vigor.

Para transferências em massa ou uploads grandes, conecte via SFTP em vez do gerenciador de arquivos do navegador. Consulte Como Enviar Arquivos via SFTP para instruções.

Passo 5 — Conecte ao Seu Servidor Hytale

1. Abra o Hytale no seu PC.
2. No menu principal, navegue até a opção Multiplayer ou Server Browser.
3. Selecione Direct Connect (ou a opção equivalente para entrar por IP).
4. Insira o IP:Port do seu servidor do Passo 3 — por exemplo, 192.0.2.10:25565.
5. Se você definiu uma senha de servidor no Passo 4, insira-a quando solicitado.
6. Clique em Connect. Você deve carregar no mundo do servidor em poucos segundos.

Verificação

Após conectar, confirme que tudo está funcionando:

1. Seu personagem deve carregar no mundo do jogo com sucesso.
2. Verifique a aba Console do GPanel — você deve ver uma entrada de log indicando que seu jogador entrou no servidor.
3. Peça a um amigo para conectar usando o mesmo IP e porta para verificar a conectividade externa.
4. O status do servidor deve permanecer Running sem erros na saída do console.

Solução de Problemas

O servidor não inicia ou fica travado durante a inicialização

• Verifique a saída do console para mensagens de erro. Na primeira instalação, o servidor pode levar vários minutos para baixar os arquivos necessários.
• Se o servidor estiver aguardando autenticação, complete o login do dispositivo descrito no Passo 2.
• Se os erros persistirem após a autenticação, tente reinstalar o servidor pela aba Settings no GPanel (isso excluirá os dados do servidor — faça backup de arquivos importantes primeiro).

O código de autenticação expirou ou falhou

• O código de dispositivo é válido apenas por tempo limitado. Se expirar, reinicie o servidor para gerar um novo código.
• Certifique-se de que está fazendo login com uma conta Hytale válida que possui o jogo.
• Tente usar um navegador diferente ou limpar o cache do navegador se a página de autenticação não carregar.

Não consegue conectar ao servidor

• Confirme que o status do servidor mostra Running no GPanel. Se mostrar Offline ou Starting, aguarde a inicialização completa.
• Verifique novamente o endereço IP e a porta — certifique-se de incluir o número da porta após os dois pontos.
• Certifique-se de que o servidor completou a etapa de autenticação com sucesso antes de tentar conectar.
• Se o servidor acabou de ser iniciado, aguarde 1-2 minutos para que ele inicialize completamente antes de tentar conectar.
• Consulte Como Encontrar o IP e a Porta do Seu Servidor para ajuda em localizar os detalhes corretos de conexão.

Alterações nas configurações não estão sendo aplicadas

• Alterações nas variáveis de inicialização requerem uma reinicialização completa do servidor. Use o botão Restart na aba Console após salvar.
• Se estiver editando arquivos de configuração diretamente, certifique-se de que o servidor está parado antes de salvar as alterações. Alguns jogos sobrescrevem os arquivos de configuração ao desligar, o que pode desfazer suas edições.

O servidor trava ou fica offline inesperadamente

• Verifique a saída do console para mensagens de erro ou logs de travamento antes do servidor ficar offline.
• Hytale está em acesso antecipado — travamentos podem ocorrer devido a bugs do jogo. Tente reiniciar o servidor.
• Se os travamentos acontecerem repetidamente, copie as mensagens de erro e abra um ticket de suporte para que nossa equipe possa investigar.

Precisa de Ajuda?

Se encontrar um problema não coberto acima, abra um ticket de suporte e inclua:

• O nome do seu servidor no GPanel
• Uma descrição do problema e quando começou
• Quaisquer mensagens de erro do console do GPanel (copie e cole as linhas relevantes)