Guia de Configuração do Servidor Vintage Story

Este guia aborda como configurar seu servidor dedicado de Vintage Story hospedado na Legion Hosting, incluindo primeira inicialização, variáveis do GPanel, gerenciamento de versão, configuração do servidor, configurações de mundo, conexão de jogadores e gerenciamento de saves. Para instalação de mods, veja Instalação de Mods do Vintage Story. Para configuração de admin e comandos, veja Comandos de Admin do Vintage Story.

Primeira Inicialização

Quando você iniciar seu servidor Vintage Story pela primeira vez no GPanel, o servidor irá automaticamente baixar os arquivos do jogo da API oficial do Vintage Story e gerar um mundo padrão. Esta inicialização inicial pode levar vários minutos enquanto os arquivos são baixados e extraídos.

1. Faça login no GPanel e selecione seu servidor Vintage Story.
2. Antes de iniciar, revise a aba Startup para confirmar sua branch de versão preferida (stable, unstable ou pre-release).
3. Clique em Start na aba Console. Acompanhe a saída do console para mensagens de progresso enquanto o servidor baixa e instala os arquivos do jogo.
4. Quando você vir uma mensagem indicando que o servidor está aguardando conexões, o servidor está pronto. Um arquivo serverconfig.json padrão será gerado automaticamente.

Variáveis de Inicialização do GPanel

As configurações principais do servidor são controladas pela aba Startup no GPanel. Revise e ajuste antes de iniciar seu servidor.

Após atualizar as variáveis de inicialização, reinicie o servidor pelo GPanel para que as alterações entrem em vigor.

Gerenciamento de Versão

Vintage Story oferece três branches de lançamento. Sua escolha de branch é definida pela variável de inicialização FILES_BRANCH no GPanel.

Fixando uma Versão Específica

Por padrão, RELEASE_VERSION está definido como latest, o que significa que o servidor irá baixar e instalar a versão mais recente disponível na branch escolhida toda vez que o servidor iniciar (se uma versão mais recente estiver disponível). Para evitar atualizações automáticas e fixar seu servidor em uma versão específica:

1. Vá para a aba Startup no GPanel.
2. Altere RELEASE_VERSION de latest para o número exato da versão desejada (ex.: 1.19.8).
3. Reinicie o servidor. Ele usará apenas a versão fixada, independentemente de novas versões.

serverconfig.json

O arquivo principal de configuração do servidor é o serverconfig.json, localizado no diretório raiz do servidor. Este arquivo é gerado automaticamente na primeira inicialização. Pare o servidor antes de editá-lo e reinicie para que as alterações entrem em vigor.

1. Pare o servidor pela aba Console do GPanel.
2. Abra a aba Files e clique em serverconfig.json para editá-lo.
3. Modifique as configurações necessárias (veja a tabela abaixo).
4. Salve o arquivo e inicie o servidor.

Configurações Principais

Um exemplo mínimo das configurações principais no serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

Configuração do Mundo

Vintage Story gera seu mundo com base nas configurações do serverconfig.json. A geração do mundo ocorre apenas na primeira inicialização com um determinado mundo -- alterar configurações de geração após o mundo ter sido criado não irá alterar retroativamente o terreno existente.

Configurações de Geração do Mundo

• WorldSeed: Determina o layout do terreno, posicionamento de biomas e distribuição de recursos. Defina uma seed específica para compartilhar o mesmo layout de mundo com outros, ou deixe vazia para um mundo gerado aleatoriamente.
• MapSizeX / MapSizeZ: Controlam a área jogável máxima. Valores menores criam um mundo mais contido e podem reduzir o uso de recursos. Jogadores que atingirem a borda do mapa não poderão viajar mais naquela direção.
• WorldConfig: O objeto WorldConfig dentro do serverconfig.json permite ajustar parâmetros de geração do mundo, como escala de formas de terreno, padrões climáticos e características geológicas. Estas são configurações avançadas -- os padrões funcionam bem para a maioria dos servidores.

Escolhendo uma Seed

A seed pode ser qualquer string de texto ou número. Jogadores na comunidade Vintage Story compartilham seeds para layouts de mundo interessantes. Se você quer um tipo específico de terreno ou local de spawn, pesquise nos fóruns ou sites da comunidade Vintage Story por seeds recomendadas.

Como Conectar

Os jogadores se conectam ao seu servidor Vintage Story através do menu multiplayer do jogo.

Conexão Direta

1. Inicie o Vintage Story e clique em Multiplayer no menu principal.
2. Clique em Direct Connect.
3. Digite o endereço IP e a porta do jogo do seu servidor no formato:

   your.server.ip:port

   Verifique a aba Network no GPanel para seu IP e porta atribuídos.
4. Clique em Connect. Se o servidor tiver uma senha, insira-a quando solicitado.

Navegador de Servidores

1. Inicie o Vintage Story e clique em Multiplayer no menu principal.
2. O navegador de servidores carregará uma lista de servidores públicos. Use a barra de pesquisa para encontrar seu servidor pelo nome (o valor de ServerName do serverconfig.json).
3. Clique no seu servidor na lista e clique em Join.

Gerenciamento de Saves

Os dados do mundo do Vintage Story são armazenados no seu servidor e salvos automaticamente durante o jogo.

Localização dos Dados do Mundo

Os arquivos de save do mundo são armazenados no diretório data/ do seu servidor. O caminho exato depende do nome do seu mundo. Você pode acessar esses arquivos pela aba Files do GPanel ou via SFTP.

Fazendo Backup do Seu Mundo

1. Pare o servidor para garantir um backup limpo (nenhum arquivo sendo gravado durante o save).
2. Conecte-se ao seu servidor via SFTP. Veja Como Enviar Arquivos via SFTP para instruções de conexão.
3. Baixe o diretório data/ inteiro para sua máquina local.
4. Armazene o backup em um local seguro. Considere manter múltiplos backups com data caso precise reverter para um ponto específico.

Resetando o Mundo

Para iniciar um mundo completamente novo:

1. Pare o servidor pela aba Console do GPanel.
2. Faça backup dos dados do mundo existente se quiser mantê-los (veja acima).
3. Navegue até o diretório data/ no gerenciador de arquivos do GPanel e delete os arquivos de save do mundo.
4. Opcionalmente, atualize o WorldSeed no serverconfig.json para gerar um layout de mundo diferente.
5. Inicie o servidor. Um novo mundo será gerado do zero usando suas configurações atuais.

Artigos Relacionados

• Instalação de Mods do Vintage Story
• Comandos de Admin do Vintage Story
• 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 um problema não coberto neste guia, abra um ticket de suporte e inclua o endereço IP do seu servidor, uma descrição do problema e qualquer saída relevante do console do GPanel.