Este guia orienta-o na configuração do seu servidor dedicado Hytale na Legion Hosting, incluindo o passo de autenticação obrigatório 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
- As suas credenciais do GPanel do email de boas-vindas (verifique a pasta de spam se não o encontrar)
- Hytale instalado no seu PC
- O endereço IP e a porta do seu servidor a partir do GPanel (inicie sessão em gpanel.legionhosting.net)
Passo 1 — Iniciar Sessão no GPanel e Arrancar o Servidor
- Abra o seu navegador e aceda a https://gpanel.legionhosting.net.
- Introduza o Email e a Palavra-passe do seu email de boas-vindas e clique em Login.
- Clique no seu servidor Hytale na lista de servidores para o abrir.
- No separador Console, o indicador de estado mostrará Offline. Clique no botão Start.
- Aguarde que o servidor descarregue e instale quaisquer ficheiros necessários. O primeiro arranque pode demorar 2 a 5 minutos enquanto os ficheiros do servidor Hytale são configurados.
- Observe a saída da consola. O servidor acabará por pausar e apresentar um pedido de autenticação com um URL e um código de dispositivo. Não feche nem reinicie o servidor neste ponto.
Passo 2 — Autenticar o Seu Servidor
O Hytale requer autenticação do servidor no primeiro arranque. O servidor não aceitará ligações de jogadores até completar este passo.
- Na consola do GPanel, procure uma mensagem contendo um URL e um código de dispositivo. Terá um aspeto semelhante a:
To authenticate, visit: https://auth.hytale.com/device Enter the code: XXXX-XXXX - Abra o URL de autenticação no seu navegador web em qualquer dispositivo (PC, telemóvel, tablet).
- Inicie sessão com a sua conta Hytale (a conta que usa para jogar o jogo).
- Introduza o código de dispositivo apresentado na consola quando solicitado.
- Confirme a autenticação. O navegador mostrará uma mensagem de sucesso.
- Volte ao GPanel e observe a consola. Em poucos segundos, o servidor deverá continuar o seu processo de arranque e o estado mudará para Running.
Passo 3 — Encontrar os Detalhes de Ligação
- No GPanel, clique no separador Console (ou na área de visão geral do servidor).
- Anote o Endereço IP e a Porta apresentados na parte superior da página.
- O formato é
IP:Port, por exemplo192.0.2.10:25565. Irá partilhar estes detalhes com quem quiser juntar-se ao seu servidor.
Para um guia detalhado sobre como localizar os seus detalhes de ligação, consulte Como Encontrar o IP e a Porta do Seu Servidor.
Passo 4 — Configuração Básica do Servidor
Os servidores dedicados Hytale expõem definições principais através do separador Startup do GPanel. Estas variáveis controlam as opções mais comuns do servidor sem necessidade de edição manual de ficheiros.
Usar Variáveis de Arranque
- No GPanel, clique no separador Startup.
- Verá uma lista de variáveis configuráveis. Edite qualquer valor e clique em Save ou pressione Enter.
- Após fazer alterações, reinicie o servidor a partir do separador Console para que as novas definições tenham efeito.
Definições Comuns
| Definição | O Que Faz | Valor de Exemplo |
|---|---|---|
| Server Name | O nome apresentado no navegador de servidores e aos jogadores que se conectam | My Legion Server |
| Max Players | Número máximo de jogadores permitidos online em simultâneo | 16 |
| Server Password | Requer que os jogadores introduzam uma palavra-passe para se juntarem. Deixe em branco para um servidor público. | MySecret123 |
Editar Ficheiros de Configuração
Para definições avançadas não disponíveis no separador Startup, pode editar os ficheiros de configuração do servidor diretamente através do gestor de ficheiros do GPanel.
- Clique no separador Files no GPanel.
- Navegue até ao diretório raiz do servidor e procure ficheiros de configuração (estes podem variar à medida que o Hytale é atualizado).
- Clique num ficheiro para o abrir no editor de texto integrado. Faça as suas alterações e clique em Save Content.
- Pare e reinicie o servidor para que as alterações tenham efeito.
Para transferências de ficheiros em massa ou carregamentos grandes, conecte via SFTP em vez do gestor de ficheiros do navegador. Consulte Como Carregar Ficheiros via SFTP para instruções.
Passo 5 — Conectar ao Seu Servidor Hytale
- Inicie o Hytale no seu PC.
- No menu principal, navegue até à opção Multiplayer ou Server Browser.
- Selecione Direct Connect (ou a opção equivalente para se juntar por IP).
- Introduza o
IP:Portdo seu servidor do Passo 3 — por exemplo,192.0.2.10:25565. - Se definiu uma palavra-passe no Passo 4, introduza-a quando solicitado.
- Clique em Connect. Deverá carregar no mundo do servidor em poucos segundos.
Verificação
Após conectar, confirme que tudo está a funcionar:
- O seu personagem deverá carregar no mundo do jogo com sucesso.
- Verifique o separador Console do GPanel — deverá ver uma entrada de registo indicando que o seu jogador se juntou ao servidor.
- Peça a um amigo para se conectar usando o mesmo IP e porta para verificar a conectividade externa.
- O estado do servidor deverá permanecer Running sem erros na saída da consola.
Resolução de Problemas
O servidor não arranca ou fica preso durante o arranque
- Verifique a saída da consola para mensagens de erro. Na primeira instalação, o servidor pode demorar vários minutos a descarregar os ficheiros necessários.
- Se o servidor está à espera de autenticação, complete o início de sessão do dispositivo descrito no Passo 2.
- Se os erros persistirem após a autenticação, tente reinstalar o servidor a partir do separador Settings no GPanel (isto irá eliminar os dados do servidor — faça cópia de segurança dos ficheiros importantes primeiro).
O código de autenticação expirou ou falhou
- O código de dispositivo é válido apenas por um tempo limitado. Se expirar, reinicie o servidor para gerar um novo código.
- Certifique-se de que está a iniciar sessão com uma conta Hytale válida que possui o jogo.
- Tente usar um navegador diferente ou limpar a cache do navegador se a página de autenticação não carregar.
Não é possível conectar ao servidor
- Confirme que o estado do servidor mostra Running no GPanel. Se mostrar Offline ou Starting, aguarde que arranque completamente.
- Verifique novamente o endereço IP e a porta — certifique-se de que inclui o número da porta após os dois pontos.
- Certifique-se de que o servidor completou o passo de autenticação com sucesso antes de tentar conectar.
- Se o servidor acabou de ser iniciado, aguarde 1-2 minutos para que inicialize completamente antes de tentar conectar.
- Consulte Como Encontrar o IP e a Porta do Seu Servidor para ajuda a localizar os detalhes de ligação corretos.
As alterações de definições não estão a ser aplicadas
- As alterações nas variáveis de arranque requerem um reinício completo do servidor. Utilize o botão Restart no separador Console após guardar.
- Se estiver a editar ficheiros de configuração diretamente, certifique-se de que o servidor está parado antes de guardar as alterações. Alguns jogos substituem os ficheiros de configuração ao encerrar, o que pode desfazer as suas edições.
O servidor crasha ou fica offline inesperadamente
- Verifique a saída da consola para mensagens de erro ou registos de crash antes de o servidor ficar offline.
- O Hytale está em acesso antecipado — podem ocorrer crashes devido a bugs do jogo. Tente reiniciar o servidor.
- Se os crashes ocorrerem repetidamente, copie as mensagens de erro e abra um ticket de suporte para que a nossa equipa 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 da consola do GPanel (copie e cole as linhas relevantes)