Este guia aborda como configurar seu servidor dedicado de Portal Knights na Legion Hosting, definir variáveis de inicialização, ajustar configurações do servidor, conectar-se com amigos e gerenciar seus saves de mundo. Para controles de admin e gerenciamento de jogadores, consulte Comandos de Admin do Portal Knights.

1. Primeira Inicialização

1. Faça login no GPanel e selecione seu servidor de Portal Knights.
2. Vá até a aba Startup e revise as variáveis disponíveis (veja a tabela abaixo).
3. Defina um SERVER_NAME para que você possa identificar seu servidor no navegador.
4. Altere o ADMIN_PASS do padrão. Opcionalmente defina USER_PASS ou GUEST_PASS para restringir o acesso ao seu grupo.
5. Retorne à aba Console e clique em Start.
6. Aguarde o console indicar que o servidor terminou de carregar. A primeira inicialização gerará os arquivos de configuração padrão e um novo mundo.

2. Variáveis de Inicialização do GPanel

As seguintes variáveis estão disponíveis na aba Startup do GPanel. Esses valores são aplicados cada vez que o servidor inicia.

3. Configuração do Servidor

Além das variáveis de inicialização, Portal Knights permite ajustes finos através do seu arquivo de configuração do servidor. Pare o servidor antes de fazer alterações.

Localização do Arquivo de Configuração

dedicated_server/server_config.json

Abra este arquivo usando a aba Files no GPanel ou conecte-se via SFTP. Se o arquivo não existir, inicie e pare o servidor uma vez para gerá-lo com os valores padrão.

Configurações Principais

O arquivo de configuração usa o formato JSON. As propriedades principais incluem:

Exemplo de Configuração

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

4. Configurações de Mundo

Os mundos de Portal Knights consistem em ilhas geradas proceduralmente conectadas por portais. Considerações importantes relacionadas ao mundo:

• Pasta de Save: Os dados do mundo são armazenados no diretório savedata (configurado via basicServerData.saveFolderPath na configuração).
• Modo de Jogo: Definido via variável de inicialização GAMEMODE. Adventure é a experiência RPG padrão; Creative permite construção e exploração livres.
• Tamanho do Universo: Definido via variável de inicialização UNIVERSE_SIZE. Controla o número de ilhas: Small, Normal ou Large.
• Progressão de Ilhas: Os jogadores progridem pelas ilhas coletando fragmentos de portal e ativando portais. O servidor rastreia todas as ilhas descobertas e seus estados.

5. Como Conectar

Opção A -- Navegador de Servidores no Jogo

1. Inicie o Portal Knights via Steam.
2. No menu principal, selecione Multiplayer.
3. Escolha Online Game e depois Browse Servers.
4. Procure seu servidor pelo nome ou navegue pela lista.
5. Selecione seu servidor e clique em Join. Digite a senha se solicitado.

Opção B -- Conexão Direta via IP

1. Inicie o Portal Knights via Steam.
2. No menu principal, selecione Multiplayer.
3. Escolha Online Game e depois Direct Connect.
4. Digite o IP e a porta do seu servidor da aba Network do GPanel:

   <your-server-ip>:<port>

5. Digite a senha do servidor se uma estiver definida.

6. Gerenciamento de Saves

Localização dos Arquivos de Save

Os saves do mundo são armazenados no servidor em:

dedicated_server/savedata/

Este caminho é configurado pela configuração basicServerData.saveFolderPath em server_config.json.

Backups Manuais via SFTP

1. Pare o servidor pelo GPanel para garantir que todos os dados foram gravados no disco.
2. Conecte-se ao seu servidor via SFTP. Consulte Como Enviar Arquivos via SFTP para instruções.
3. Navegue até o diretório dedicated_server/savedata/.
4. Baixe a pasta inteira do mundo que deseja fazer backup.

Restaurando um Save

1. Pare o servidor pelo GPanel.
2. Conecte-se via SFTP e navegue até dedicated_server/savedata/.
3. Envie a pasta do mundo do seu backup, substituindo a existente se necessário.
4. Certifique-se de que o nome da pasta corresponda à configuração world_name na sua configuração.
5. Inicie o servidor pelo GPanel.

Solução de Problemas

• Servidor não aparece no navegador: Confirme que o servidor está totalmente iniciado no GPanel. O navegador de servidores pode levar 2-3 minutos para indexar um novo servidor. Tente a conexão direta via IP enquanto isso.
• Não consegue conectar: Verifique o IP e a porta do seu servidor na aba Network do GPanel. Certifique-se de que o servidor está rodando e não está em estado de crash.
• Crashes na inicialização: Exclua o arquivo de configuração e reinicie para regenerar os padrões. Se o problema persistir, verifique o console do GPanel para mensagens de erro.
• Mundo não carrega: Certifique-se de que a configuração basicServerData.saveFolderPath em server_config.json aponta para o diretório correto.

Artigos Relacionados

• Comandos de Admin do Portal Knights
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Arquivos via SFTP
• Guia de Início do Servidor

Precisa de Ajuda?

Se você encontrar problemas não abordados aqui, abra um ticket de suporte e inclua o IP do seu servidor, uma descrição do problema e quaisquer mensagens de erro do console do GPanel.