Este guia aborda como configurar seu servidor dedicado de Foundry na Legion Hosting, configurar variáveis de inicialização, editar o arquivo de configurações do servidor, configurar a geração de mundo, conectar-se ao seu servidor e gerenciar saves e backups. Foundry é um jogo de construção de fábricas baseado em voxel onde os jogadores mineram recursos, constroem linhas de produção automatizadas e expandem fábricas massivas em um mundo gerado proceduralmente. Para controles de administração, gerenciamento de jogadores e solução de problemas, consulte Administração e Gerenciamento do Servidor Foundry.

1. Primeira Inicialização

1. Faça login no GPanel e selecione seu servidor Foundry.
2. Vá até a aba Startup e revise as variáveis configuráveis (veja a tabela na Seção 2).
3. Defina SERVER_NAME com um nome para o seu servidor. Isso 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 à aba Console e clique em Start.
7. Aguarde o console confirmar que o servidor foi iniciado. A primeira inicialização pode levar alguns minutos enquanto o servidor gera o mundo e cria os arquivos de configuração iniciais.

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

As seguintes variáveis estão disponíveis na aba Startup do GPanel. Elas são passadas ao servidor a cada inicialização.

3. Arquivo de Configuração do Servidor

Para configurações avançadas além do que as variáveis de inicialização oferecem, você pode editar o arquivo de configuração do servidor diretamente. Pare seu servidor antes de fazer alterações.

Localização do Arquivo

App.cfg

Abra este arquivo usando a aba Files no GPanel ou conecte via SFTP. O arquivo usa um formato simples key=value com uma configuração por linha. Se o arquivo não existir, inicie e pare o servidor uma vez para gerá-lo.

Configurações Principais do 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 usa geração procedural de mundo para criar seu terreno em voxel. O mundo é gerado a partir de um número de seed, que determina o layout do terreno, depósitos de minério e biomas.

Seed do Mapa

• Defina o valor de map_seed no App.cfg ou a variável de inicialização MAP_SEED com qualquer número inteiro.
• Usar a mesma seed sempre produz o mesmo layout de mundo, o que é útil se você quiser compartilhar 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 afeta apenas a geração inicial do mundo. Alterar a seed em um mundo existente não tem efeito -- você deve criar um novo mundo (alterar server_world_name) para que uma nova seed tenha efeito.

Nome do Mundo e Múltiplos Mundos

A configuração server_world_name determina qual pasta de save o servidor usa. Você pode manter múltiplos mundos alternando entre diferentes nomes de mundo:

• Cada server_world_name único cria um mundo separado com seus próprios dados de save, estado da fábrica e progresso dos jogadores.
• Para trocar 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 ao voltar para o nome deles.

Pausar Quando Vazio

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

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

5. Como Conectar

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 seu servidor pelo nome.
5. Selecione seu servidor e clique em Join. Insira a senha do servidor se houver uma definida.

Opção B -- Conexão Direta

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

   <your-server-ip>:<port>

5. Insira a senha do servidor se solicitado e clique em Connect.

6. Gerenciamento de Saves

Salvamento Automático

O servidor salva automaticamente no intervalo especificado por autosave_interval no App.cfg (padrão: a cada 300 segundos / 5 minutos). Os salvamentos automáticos do Foundry são discretos e não causam lag perceptível para a maioria dos tamanhos de fábrica.

Localização dos Arquivos de Save

Os arquivos 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 da fábrica, esteiras transportadoras e inventários dos jogadores.

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. Baixe o diretório de save completo do seu mundo (ex.: serverfiles/).
4. Armazene o backup em um local seguro no seu computador.

Restaurando um Save

1. Pare o servidor pelo GPanel.
2. Conecte-se via SFTP e navegue até o diretório serverfiles/.
3. Envie 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 pelo 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 sua fábrica cresce:

• Complexidade da fábrica: Grandes quantidades de máquinas, esteiras transportadoras e redes logísticas aumentam a carga de tick do servidor. Se você notar lag, 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 sua fábrica compacta reduz o número de chunks que o servidor precisa rastrear.
• Quantidade de jogadores: Mais jogadores conectados significa mais chunks carregados ao redor de cada jogador. Se o desempenho degradar com muitos jogadores, considere reduzir server_max_players.
• Frequência de salvamento automático: Salvamentos automáticos muito frequentes (menos de 60 segundos) em mundos grandes podem causar engasgos periódicos. O padrão de 300 segundos geralmente é suficiente, mas você pode aumentá-lo se necessário.
• Pausar quando vazio: Ativar pause_server_when_empty=true previne simulação desnecessária quando ninguém está jogando, o que ajuda a manter um desempenho consistente durante sessões de jogo ativas.

Artigos Relacionados

• Administração e Gerenciamento do Servidor Foundry
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Enviar Arquivos via SFTP
• Guia de Inicialização do Servidor

Precisa de Ajuda?

Se você encontrar problemas com seu servidor Foundry que não sã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 relevantes do console do GPanel.