Guia de Configuração do Servidor Vintage Story

Este guia abrange como configurar o seu servidor dedicado de Vintage Story alojado na Legion Hosting, incluindo o primeiro arranque, variáveis do GPanel, gestão de versões, configuração do servidor, definições do mundo, ligação de jogadores e gestão de saves. Para instalação de mods, consulte Vintage Story Mod Installation. Para configuração de administrador e comandos, consulte Vintage Story Admin Commands.

Antes de começar: Certifique-se de que o seu servidor está criado no GPanel. Se precisar de ajuda para encontrar o endereço IP e a porta do seu servidor, consulte How to Find Your Server IP and Port.

Primeiro Arranque

Quando inicia o seu servidor Vintage Story pela primeira vez a partir do GPanel, o servidor irá automaticamente descarregar os ficheiros do jogo a partir da API oficial do Vintage Story e gerar um mundo predefinido. Este arranque inicial pode demorar vários minutos enquanto os ficheiros são descarregados e extraídos.

Inicie sessão no GPanel e selecione o seu servidor Vintage Story.
Antes de iniciar, reveja o separador Startup para confirmar o ramo de versão pretendido (stable, unstable ou pre-release).
Clique em Start no separador Console. Observe a saída da consola para mensagens de progresso enquanto o servidor descarrega e instala os ficheiros do jogo.
Assim que vir uma mensagem a indicar que o servidor está a aguardar ligações, o servidor está pronto. Um ficheiro serverconfig.json predefinido será gerado automaticamente.

O primeiro arranque demora mais do que o habitual. O servidor precisa de descarregar o pacote completo do servidor Vintage Story antes de poder iniciar. Os arranques seguintes serão muito mais rápidos, a menos que altere a versão ou o ramo.

Variáveis de Arranque do GPanel

As definições principais do servidor são controladas através do separador Startup no GPanel. Reveja e ajuste estas definições antes de iniciar o seu servidor.

Variável	Predefinição	Descrição
`SERVER_PORT`	(atribuída)	A porta do jogo que os jogadores utilizam para se ligarem. É atribuída automaticamente pelo GPanel — verifique o separador Network para a sua porta atribuída.
`MAX_CLIENTS`	`16`	Número máximo de jogadores simultâneos. Pode ser definido até 256. Deve corresponder aos recursos do seu plano de alojamento.
`FILES_BRANCH`	`stable`	Qual ramo de lançamento utilizar. Opções: `stable`, `unstable` ou `pre`. Consulte a secção de Gestão de Versões abaixo para mais detalhes.
`RELEASE_VERSION`	`latest`	A versão específica a instalar. Defina como `latest` para utilizar sempre a versão mais recente no ramo escolhido, ou introduza um número de versão específico (ex.: `1.19.8`) para fixar nessa versão.
`OPTIONS`	(vazio)	Argumentos adicionais de linha de comandos passados ao processo do servidor no arranque. Deixe vazio a menos que necessite de flags de arranque específicas.
`SQLITE_TMPDIR`	(auto)	Diretório temporário utilizado pelo SQLite para operações de base de dados. Normalmente não precisa de ser alterado.

Após atualizar as variáveis de arranque, reinicie o servidor a partir do GPanel para que as alterações tenham efeito.

Gestão de Versões

O Vintage Story oferece três ramos de lançamento. A sua escolha de ramo é definida através da variável de arranque FILES_BRANCH no GPanel.

Ramo	Valor	Descrição
Stable	`stable`	O ramo recomendado para a maioria dos servidores. Estas versões foram testadas exaustivamente e são as mais fiáveis para mundos de longa duração.
Unstable	`unstable`	Versões beta com novas funcionalidades e alterações que ainda estão a ser testadas. Podem conter bugs. Utilize este ramo se pretender acesso antecipado a novo conteúdo e aceitar alguma instabilidade.
Pre-release	`pre`	Versões de desenvolvimento inicial. São as menos testadas e podem ter problemas significativos. Recomendado apenas para fins de teste — não para servidores de produção.

Fixar uma Versão Específica

Por predefinição, RELEASE_VERSION está definida como latest, o que significa que o servidor irá descarregar e instalar a versão mais recente disponível no ramo escolhido sempre que o servidor arrancar (se uma versão mais recente estiver disponível). Para evitar atualizações automáticas e bloquear o servidor numa versão específica:

Vá ao separador Startup no GPanel.
Altere RELEASE_VERSION de latest para o número exato da versão pretendida (ex.: 1.19.8).
Reinicie o servidor. Utilizará apenas a versão fixada independentemente de versões mais recentes.

Compatibilidade de mods: Se estiver a utilizar mods, é recomendado fixar uma versão específica. Atualizações do jogo podem quebrar a compatibilidade dos mods, e atualizar a meio de uma partida pode causar problemas. Verifique se os seus mods suportam a versão alvo antes de atualizar. Consulte Vintage Story Mod Installation para mais detalhes.

Mudar de ramo pode exigir um reset do mundo. Alternar entre ramos stable e unstable pode introduzir alterações no formato do mundo. Faça sempre uma cópia de segurança do mundo antes de mudar de ramo. Se a nova versão for incompatível com o mundo existente, poderá ter de iniciar um novo.

serverconfig.json

O ficheiro de configuração principal do servidor é o serverconfig.json, localizado no diretório raiz do servidor. Este ficheiro é gerado automaticamente no primeiro arranque. Pare o servidor antes de o editar e reinicie para que as alterações tenham efeito.

Pare o servidor a partir do separador Console do GPanel.
Abra o separador Files e clique em serverconfig.json para o editar.
Modifique as definições que necessitar (consulte a tabela abaixo).
Guarde o ficheiro e inicie o servidor.

Definições Principais

Definição	Valor de Exemplo	Descrição
`ServerName`	`"My Legion VS Server"`	O nome apresentado no navegador de servidores do jogo. Torne-o descritivo para que os jogadores possam encontrar o seu servidor.
`WelcomeMessage`	`"Welcome to the server!"`	Mensagem mostrada aos jogadores quando entram. Suporta formatação básica.
`MaxClients`	`16`	Número máximo de jogadores simultâneos. Deve corresponder à variável de arranque `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Palavra-passe necessária para entrar no servidor. Deixe como string vazia (`""`) para um servidor público.
`AllowPvP`	`true`	Defina como `true` para ativar o combate entre jogadores, ou `false` para um servidor apenas PvE.
`SpawnRadius`	`50`	Raio (em blocos) em torno do ponto de spawn do mundo onde novos jogadores podem aparecer. Um valor maior espalha mais os jogadores ao entrar.
`MapSizeX`	`1024000`	Largura do mundo em blocos. O valor predefinido cria um mundo muito grande. Reduzir este valor limita a distância que os jogadores podem viajar de este a oeste.
`MapSizeZ`	`1024000`	Profundidade do mundo em blocos. O valor predefinido cria um mundo muito grande. Reduzir este valor limita a distância que os jogadores podem viajar de norte a sul.
`WorldSeed`	`"myseed123"`	Seed utilizada para a geração do mundo. A mesma seed produz o mesmo mundo. Deixe como string vazia para uma seed aleatória.

Um exemplo mínimo das definições principais em serverconfig.json:

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

O ficheiro deve ser JSON válido. Certifique-se de que todas as strings estão entre aspas duplas, os booleanos estão em minúsculas (true/false) e não existem vírgulas finais após o último item num objeto ou array. Se o servidor não arrancar após a edição, verifique se existem erros de sintaxe JSON.

Configuração do Mundo

O Vintage Story gera o seu mundo com base nas definições em serverconfig.json. A geração do mundo só ocorre no primeiro arranque com um determinado mundo — alterar as definições de geração após o mundo ter sido criado não irá alterar retroativamente o terreno existente.

Definições de Geração do Mundo

WorldSeed: Determina o layout do terreno, posicionamento dos biomas e distribuição de recursos. Defina uma seed específica para partilhar 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. Os jogadores que alcançarem a borda do mapa não poderão viajar mais nessa 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 definições avançadas — os valores predefinidos funcionam bem para a maioria dos servidores.

As definições de geração do mundo ficam bloqueadas após a criação. Definições como WorldSeed, MapSizeX e MapSizeZ só têm efeito quando o mundo é gerado pela primeira vez. Para aplicar novas definições de geração, deve criar um novo mundo (consulte Gestão de Saves abaixo).

Escolher uma Seed

A seed pode ser qualquer string de texto ou número. Os jogadores da comunidade Vintage Story partilham seeds para layouts de mundo interessantes. Se pretender um tipo específico de terreno ou localização de spawn, pesquise nos fóruns do Vintage Story ou em sites da comunidade por seeds recomendadas.

Como Ligar

Os jogadores ligam-se ao seu servidor Vintage Story através do menu multijogador no jogo.

Ligação Direta

Inicie o Vintage Story e clique em Multiplayer no menu principal.
Clique em Direct Connect.
Introduza o endereço IP e a porta do seu servidor no formato:
```
your.server.ip:port
```
Verifique o separador Network no GPanel para o IP e porta atribuídos.
Clique em Connect. Se o servidor tiver uma palavra-passe, introduza-a quando solicitado.

Navegador de Servidores

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

O servidor não aparece no navegador? O navegador de servidores pode demorar vários minutos a indexar um servidor recém-iniciado. Utilize a Ligação Direta para acesso imediato. Confirme também que não definiu uma palavra-passe — servidores protegidos por palavra-passe podem não aparecer no navegador público dependendo das definições do servidor.

Gestão de Saves

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

Localização dos Dados do Mundo

Os ficheiros de save do mundo são armazenados no diretório data/ do seu servidor. O caminho exato depende do nome do seu mundo. Pode aceder a estes ficheiros através do separador Files do GPanel ou via SFTP.

Fazer Cópia de Segurança do Mundo

Pare o servidor para garantir uma cópia de segurança limpa (sem ficheiros a serem escritos durante o save).
Ligue-se ao seu servidor via SFTP. Consulte How to Upload Files via SFTP para instruções de ligação.
Descarregue todo o diretório data/ para o seu computador local.
Guarde a cópia de segurança num local seguro. Considere manter várias cópias de segurança datadas caso precise de reverter para um ponto específico.

Cópias de segurança regulares são fortemente recomendadas. Corrupção do mundo, griefing acidental ou atualizações falhadas de mods podem resultar em perda de dados. Faça uma cópia de segurança do mundo antes de fazer quaisquer alterações significativas, como atualizar a versão do jogo, adicionar ou remover mods, ou alterar definições do mundo.

Reiniciar o Mundo

Para iniciar um mundo completamente novo:

Pare o servidor a partir do separador Console do GPanel.
Faça uma cópia de segurança dos dados do mundo existente se pretender mantê-los (veja acima).
Navegue até ao diretório data/ no gestor de ficheiros do GPanel e elimine os ficheiros de save do mundo.
Opcionalmente, atualize o WorldSeed no serverconfig.json para gerar um layout de mundo diferente.
Inicie o servidor. Um novo mundo será gerado de raiz utilizando as suas definições de configuração atuais.

Eliminar ficheiros do mundo é permanente. Uma vez eliminados, o mundo não pode ser recuperado a menos que tenha uma cópia de segurança. Descarregue sempre uma cópia de segurança antes de realizar um reset do mundo.

Precisa de Ajuda?

Se encontrar um problema não abordado 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 da consola do GPanel.

Guia de Configuração do Servidor Vintage Story - Base de Conhecimento

Suporte

Categorias

Guia de Configuração do Servidor Vintage Story