Este guia abrange como configurar o seu servidor dedicado de Portal Knights na Legion Hosting, configurar variáveis de arranque, ajustar definições do servidor, conectar-se com amigos e gerir os seus ficheiros de gravação do mundo. Para controlos de administração e gestão de jogadores, consulte Portal Knights Admin Commands.
1. Primeiro Arranque
- Inicie sessão no GPanel e selecione o seu servidor de Portal Knights.
- Vá ao separador Startup e reveja as variáveis disponíveis (consulte a tabela abaixo).
- Defina um SERVER_NAME para poder identificar o seu servidor no navegador.
- Altere a ADMIN_PASS do valor predefinido. Opcionalmente, defina USER_PASS ou GUEST_PASS para restringir o acesso ao seu grupo.
- Volte ao separador Console e clique em Start.
- Aguarde que a consola indique que o servidor terminou de carregar. O primeiro arranque irá gerar ficheiros de configuração predefinidos e um novo mundo.
2. Variáveis de Arranque do GPanel
As seguintes variáveis estão disponíveis no separador Startup do GPanel. Estes valores são aplicados cada vez que o servidor inicia.
| Variável | Obrigatório | Descrição |
|---|---|---|
SERVER_NAME |
Não | O nome apresentado no navegador de servidores. Predefinido como Servername se não definido. Máximo de 32 caracteres. |
ADMIN_PASS |
Sim | Palavra-passe de administrador do servidor. O valor predefinido é admin_password_please_change -- deve alterá-lo antes de iniciar. |
USER_PASS |
Não | Palavra-passe para acesso de nível de utilizador. Deixe em branco para sem palavra-passe. |
GUEST_PASS |
Não | Palavra-passe para acesso de nível de convidado. Deixe em branco para sem palavra-passe. |
GAMEMODE |
Não | Modo de jogo do servidor. Opções: Adventure, Creative. Predefinido: Adventure. |
UNIVERSE_SIZE |
Não | Tamanho do universo do servidor. Opções: Small, Normal, Large. Predefinido: Normal. |
3. Configuração do Servidor
Para além das variáveis de arranque, Portal Knights permite ajustes detalhados através do ficheiro de configuração do servidor. Pare o servidor antes de efetuar alterações.
Localização do Ficheiro de Configuração
dedicated_server/server_config.json
Abra este ficheiro utilizando o separador Files no GPanel ou conecte-se via SFTP. Se o ficheiro não existir, inicie e pare o servidor uma vez para gerá-lo com valores predefinidos.
Definições Principais
O ficheiro de configuração utiliza o formato JSON. As propriedades principais incluem:
| Definição (caminho JSON) | Predefinido | Descrição |
|---|---|---|
basicServerData.name |
Servername |
Nome de apresentação no navegador de servidores (definido via variável de arranque SERVER_NAME). |
basicServerData.port |
(atribuído pelo GPanel) | Porta do servidor. Gerida automaticamente pelo GPanel. |
basicServerData.saveFolderPath |
./savedata |
Caminho onde os dados de gravação do mundo são armazenados. |
admins.credentials.password |
admin_password_please_change |
Palavra-passe de administrador (definida via variável de arranque ADMIN_PASS). |
users.credentials.password |
(vazio) | Palavra-passe de nível de utilizador (definida via variável de arranque USER_PASS). |
guests.credentials.password |
(vazio) | Palavra-passe de nível de convidado (definida via variável de arranque GUEST_PASS). |
gameplayMode |
Adventure |
Modo de jogo: Adventure ou Creative (definido via variável de arranque GAMEMODE). |
universeSize |
Normal |
Tamanho do universo: Small, Normal ou Large (definido via variável de arranque UNIVERSE_SIZE). |
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. Definições do Mundo
Os mundos de Portal Knights consistem em ilhas geradas proceduralmente conectadas por portais. Considerações importantes relacionadas com o mundo:
- Pasta de Gravação: Os dados do mundo são armazenados no diretório
savedata(configurado viabasicServerData.saveFolderPathna configuração). - Modo de Jogo: Definido via variável de arranque
GAMEMODE.Adventureé a experiência RPG padrão;Creativepermite construção e exploração livres. - Tamanho do Universo: Definido via variável de arranque
UNIVERSE_SIZE. Controla o número de ilhas:Small,NormalouLarge. - Progressão nas Ilhas: Os jogadores progridem pelas ilhas recolhendo fragmentos de portal e ativando portais. O servidor regista todas as ilhas descobertas e os seus estados.
5. Como Conectar
Opção A -- Navegador de Servidores no Jogo
- Inicie Portal Knights via Steam.
- No menu principal, selecione Multiplayer.
- Escolha Online Game e depois Browse Servers.
- Procure o seu servidor pelo nome ou navegue pela lista.
- Selecione o seu servidor e clique em Join. Introduza a palavra-passe se solicitado.
Opção B -- Conexão Direta via IP
- Inicie Portal Knights via Steam.
- No menu principal, selecione Multiplayer.
- Escolha Online Game e depois Direct Connect.
- Introduza o IP e a porta do seu servidor a partir do separador Network do GPanel:
<your-server-ip>:<port> - Introduza a palavra-passe do servidor se estiver definida.
6. Gestão de Gravações
Localização dos Ficheiros de Gravação
As gravações do mundo são armazenadas no servidor em:
dedicated_server/savedata/
Este caminho é configurado através da definição basicServerData.saveFolderPath em server_config.json.
Cópias de Segurança Manuais via SFTP
- Pare o servidor a partir do GPanel para garantir que todos os dados são gravados em disco.
- Conecte-se ao seu servidor via SFTP. Consulte How to Upload Files via SFTP para instruções.
- Navegue até ao diretório
dedicated_server/savedata/. - Transfira a pasta completa do mundo que pretende guardar.
Restaurar uma Gravação
- Pare o servidor a partir do GPanel.
- Conecte-se via SFTP e navegue até
dedicated_server/savedata/. - Carregue a sua pasta de gravação guardada, substituindo a existente se necessário.
- Certifique-se de que o nome da pasta corresponde à definição
world_namena sua configuração. - Inicie o servidor a partir do GPanel.
Resolução de Problemas
- Servidor não aparece no navegador: Confirme que o servidor está totalmente iniciado no GPanel. O navegador de servidores pode demorar 2-3 minutos a indexar um novo servidor. Tente a conexão direta via IP entretanto.
- Não é possível conectar: Verifique o IP e a porta do seu servidor no separador Network do GPanel. Certifique-se de que o servidor está em execução e não num estado de falha.
- Falha ao iniciar: Elimine o ficheiro de configuração e reinicie para regenerar os valores predefinidos. Se o problema persistir, verifique a consola do GPanel para mensagens de erro.
- Mundo não carrega: Certifique-se de que a definição
basicServerData.saveFolderPathemserver_config.jsonaponta para o diretório correto.
Artigos Relacionados
- Portal Knights Admin Commands
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide
Precisa de Ajuda?
Se 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 da consola do GPanel.