Este guia aborda como configurar o seu servidor dedicado de Foundry na Legion Hosting, configurar variáveis de arranque, editar o ficheiro de definições do servidor, configurar a geração de mundos, ligar-se ao servidor e gerir saves e backups. Foundry é um jogo de construção de fábricas baseado em voxels onde os jogadores extraem recursos, constroem linhas de produção automatizadas e expandem fábricas massivas num mundo gerado proceduralmente. Para controlos de administração, gestão de jogadores e resolução de problemas, consulte Foundry Admin and Server Management.

1. Primeiro Arranque

1. Inicie sessão no GPanel e selecione o seu servidor Foundry.
2. Vá ao separador Startup e reveja as variáveis configuráveis (consulte a tabela na Secção 2).
3. Defina SERVER_NAME com um nome para o seu servidor. Este aparece no navegador de servidores do Steam.
4. Defina SRV_PW se quiser restringir o acesso. Deixe em branco para um servidor público.
5. Opcionalmente, defina um MAP_SEED para controlar a geração do mundo. Deixe em branco para uma seed aleatória.
6. Volte ao separador Console e clique em Start.
7. Aguarde que a consola confirme que o servidor foi iniciado. O primeiro arranque pode demorar alguns minutos enquanto o servidor gera o mundo e cria os ficheiros de configuração iniciais.

2. Variáveis de Arranque do GPanel

As seguintes variáveis estão disponíveis no separador Startup do GPanel. Estas são passadas ao servidor em cada arranque.

3. Ficheiro de Configuração do Servidor

Para definições avançadas além do que as variáveis de arranque oferecem, pode editar o ficheiro de configuração do servidor diretamente. Pare o servidor antes de fazer alterações.

Localização do Ficheiro

App.cfg

Abra este ficheiro utilizando o separador Files no GPanel ou ligue-se via SFTP. O ficheiro utiliza um formato simples key=value com uma definição por linha. Se o ficheiro não existir, inicie e pare o servidor uma vez para o gerar.

Definições Principais no App.cfg

Exemplo de Configuração

server_name=My Legion Factory
server_password=
server_world_name=MyFoundry
server_max_players=16
server_is_public=true
server_port=3724
server_query_port=27015
map_seed=48293175
autosave_interval=300
pause_server_when_empty=true

4. Geração do Mundo

Foundry utiliza geração procedimental de mundos para criar o seu terreno de voxels. O mundo é gerado a partir de um número de seed, que determina o layout do terreno, depósitos de minério e biomas.

Map Seed

• Defina o valor map_seed no App.cfg ou a variável de arranque MAP_SEED com qualquer número inteiro.
• Usar a mesma seed produz sempre o mesmo layout de mundo, o que é útil se quiser partilhar um mundo específico com outros ou recriar um mundo após um reset.
• Deixe a seed em branco ou omita-a completamente para deixar o servidor gerar um mundo aleatório.
• A seed apenas afeta a geração inicial do mundo. Alterar a seed num mundo existente não tem efeito -- tem de criar um novo mundo (alterar server_world_name) para que uma nova seed tenha efeito.

Nome do Mundo e Múltiplos Mundos

A definição server_world_name determina qual pasta de save o servidor utiliza. Pode manter múltiplos mundos alternando entre diferentes nomes de mundo:

• Cada server_world_name único cria um mundo separado com os seus próprios dados de save, estado da fábrica e progresso dos jogadores.
• Para mudar de mundo, pare o servidor, altere o server_world_name no App.cfg e reinicie.
• Mundos anteriores são preservados e podem ser carregados novamente voltando ao seu nome.

Pausar Quando Vazio

A opção pause_server_when_empty controla se a sua fábrica continua a operar quando nenhum jogador está online:

• true (padrão) -- O mundo pausa quando todos os jogadores se desligam. As fábricas param de produzir, os recursos param de ser consumidos. Bom para poupar recursos do servidor e manter o estado do jogo previsível.
• false -- A fábrica continua a funcionar 24/7. As linhas de produção continuam, os recursos acumulam-se e o mundo progride mesmo quando ninguém está a jogar. Pode aumentar o consumo de recursos do servidor.

5. Como Ligar-se

Opção A -- Navegador de Servidores do Steam

1. Inicie o Foundry.
2. No menu principal, selecione Multiplayer.
3. Clique em Join Game para abrir o navegador de servidores.
4. Use a barra de pesquisa para encontrar o seu servidor pelo nome.
5. Selecione o seu servidor e clique em Join. Introduza a palavra-passe do servidor se estiver definida.

Opção B -- Ligação Direta

1. Inicie o Foundry.
2. No menu principal, selecione Multiplayer.
3. Escolha a opção Direct Connect.
4. Introduza o endereço IP e a porta do seu servidor a partir do separador Network do GPanel:

   <your-server-ip>:<port>

5. Introduza a palavra-passe do servidor se solicitada e clique em Connect.

6. Gestão de Saves

Gravação Automática

O servidor grava automaticamente no intervalo especificado por autosave_interval no App.cfg (padrão: a cada 300 segundos / 5 minutos). As gravações automáticas do Foundry não são intrusivas e não causam atraso percetível para a maioria dos tamanhos de fábrica.

Localização dos Ficheiros de Save

Os ficheiros de save são armazenados no servidor no caminho especificado por server_persistent_data_override_folder no App.cfg. O caminho padrão é:

serverfiles/

Este diretório contém o estado completo do mundo incluindo modificações de terreno, estruturas colocadas, máquinas de fábrica, tapetes transportadores e inventários dos jogadores.

Backups Manuais via SFTP

1. Pare o servidor no GPanel para garantir que todos os dados são escritos no disco.
2. Ligue-se ao servidor via SFTP. Consulte How to Upload Files via SFTP para instruções.
3. Descarregue o diretório de save completo do seu mundo (ex.: serverfiles/).
4. Guarde o backup num local seguro no seu computador.

Restaurar um Save

1. Pare o servidor no GPanel.
2. Ligue-se via SFTP e navegue até ao diretório serverfiles/.
3. Carregue o diretório do mundo do seu backup, substituindo o existente.
4. Certifique-se de que o nome da pasta corresponde ao server_world_name no App.cfg.
5. Inicie o servidor no GPanel. O servidor carregará o save restaurado.

7. Dicas de Desempenho

Foundry é um jogo de construção de fábricas, e o desempenho do servidor é diretamente afetado pela complexidade da fábrica. Tenha estas dicas em mente à medida que a sua fábrica cresce:

• Complexidade da fábrica: Grandes números de máquinas, tapetes transportadores e redes logísticas aumentam a carga de tick do servidor. Se notar atraso, considere consolidar ou otimizar cadeias de produção.
• Carregamento de chunks: O servidor processa todos os chunks carregados. Mais áreas de fábrica ativas espalhadas pelo mapa significa mais chunks para simular. Manter a sua fábrica compacta reduz o número de chunks que o servidor tem de rastrear.
• Número de jogadores: Mais jogadores ligados significa mais chunks carregados à volta de cada jogador. Se o desempenho degradar com muitos jogadores, considere reduzir server_max_players.
• Frequência de gravação automática: Gravações automáticas muito frequentes (menos de 60 segundos) em mundos grandes podem causar pequenos engasgos periódicos. O padrão de 300 segundos é geralmente adequado, mas pode aumentá-lo se necessário.
• Pausar quando vazio: Ativar pause_server_when_empty=true impede simulação desnecessária quando ninguém está a jogar, o que ajuda a manter um desempenho consistente durante sessões de jogo ativas.

Artigos Relacionados

• Foundry Admin and Server Management
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Server Startup Guide

Precisa de Ajuda?

Se encontrar problemas com o seu servidor Foundry 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.