Servidor Vintage Story

Como funciona um servidor dedicado Vintage Story

O Vintage Story traz um programa de servidor à parte, ao lado do cliente do jogo. Esse programa carrega um único save de mundo, um ficheiro .vcdbs, e mantém-no disponível para toda a gente que está na whitelist, esteja ou não online quem o criou. Abrir um mundo single player em LAN ou aos amigos chega para uma noite; um servidor dedicado é o que transforma esse mundo num sítio onde a malta aparece durante a semana inteira.

Há um pormenor que apanha muitos donos novos de surpresa. Por defeito, o servidor não faz passar o tempo enquanto está vazio, por isso as colheitas, a criação de animais e as estações ficam à espera do primeiro jogador a entrar. Para um grupo pequeno que joga sempre junto, isso até dá jeito. Uma comunidade maior costuma ligar o PassTimeWhenEmpty, para o calendário continuar a avançar entre visitas.

O jogo vende-se na loja da própria Anego Studios, e não na Steam, e cada jogador entra com a sua conta Vintage Story. O servidor não depende da Steam para rigorosamente nada.

Escolher o tipo de mundo e as definições

O estilo de jogo fica fixo no momento em que o mundo é gerado, por isso vale a pena o grupo combinar tudo antes do primeiro arranque. O serverconfig.json guarda essa escolha em WorldConfig, junto com o nome do mundo, a seed, o clima e a altura.

Outros interruptores que valem para o servidor inteiro estão no mesmo ficheiro, e quase todos se mudam mais tarde com /serverconfig na consola: AllowPvP (ligado por defeito), AllowFireSpread, AllowFallingBlocks e MaxChunkRadius, que é a distância de visão máxima que qualquer jogador pode usar (12 chunks por defeito). Baixar a distância de visão é a maneira mais simples de poupar memória num servidor cheio.

Cargos, privilégios e whitelist

O Vintage Story trata as permissões com cargos (roles), e não com uma simples marca de admin. Cada cargo tem um nível de privilégio, um modo de jogo por defeito e a sua própria quota de land claim. Os jogadores novos recebem o cargo indicado em DefaultRoleCode, que é o suplayer enquanto não o mudares.

1. Na Web Console, escreve /op seguido do teu nome para ficares admin.
2. Junta jogadores com /player name whitelist on. Não é preciso reiniciar.
3. Promove quem te ajuda com /player name role sumod.
4. Ajusta os claims de cada cargo com /role name landclaimallowance e um valor.

Grupo privado ou servidor público

Desde a versão 1.20, um servidor dedicado acabado de criar vem com whitelist e não aparece no browser de servidores públicos. Para um mundo entre amigos é o arranque mais seguro: só entra quem tu juntares, e ninguém tropeça nele por acaso.

Se a ideia é fazer crescer uma comunidade, chegam dois comandos na consola: /serverconfig advertise on mete o servidor na lista e /serverconfig whitelistmode off deixa entrar qualquer pessoa. Acrescenta uma password se quiseres um servidor semiprivado, que se encontra mas onde não se entra à vontade, e define um MaxClients sensato para o mundo não ser invadido logo no primeiro dia.

Instalar e gerir mods

O suporte a mods é uma peça central do Vintage Story, e o ModDB oficial é onde mora praticamente todo o mod que existe. Os mods são ficheiros zip que o servidor carrega da pasta Mods, e o jogo mostra a lista do servidor a quem entra, por isso raramente alguém tem de trocar ficheiros à mão.

• Instalar: /moddb install modid na Web Console.
• Descobrir um ID: /moddb search palavra-chave lista os mods que batem certo, com os respetivos IDs.
• Fixar uma versão: /moddb install modid 1.0.12 instala essa release exata.
• Mods só de cliente: cada jogador junta-os ao seu próprio jogo.
• Testa aos poucos: mete alguns mods, reinicia, joga um bocado e só depois acrescenta mais.

Os mods de worldgen mudam a forma como o terreno novo nasce, por isso entram antes de o mapa ser criado. Os mods de conteúdo e de código podem chegar mais tarde, mas faz sempre um /genbackup antes de mexer nos mods de um mundo de que as pessoas gostam.

Passar para uma versão nova

Para se ligarem, os jogadores precisam da mesma versão do jogo que o servidor, por isso cada update pede alguma coordenação. A Anego publica release candidates antes de cada versão grande e depois uma série de patches estáveis; a 1.22 passou por dez release candidates antes de a 1.22.0 sair, a 21 de abril de 2026.

1. Faz um backup com /genbackup.
2. Confirma no ModDB que cada code mod tem uma build compatível com a versão nova.
3. Atualiza o servidor e os mods de uma vez e reinicia.
4. Pede aos jogadores que atualizem o jogo antes de entrarem.

A partir da 1.22, o jogo precisa do runtime .NET 10, o que conta para quem aloja o servidor por conta própria em Linux ou macOS. Os servidores públicos, em especial, devem acompanhar os patches: as versões de julho de 2026 corrigiram vários exploits de griefing.

Saves, backups e mudar mundos de sítio

O mundo é um único ficheiro de base de dados .vcdbs na pasta Saves, e o caminho define-se em SaveFileLocation no serverconfig.json. Por defeito, o servidor faz autosave a cada 300 segundos, um valor que vive no servermagicnumbers.json, e o /autosavenow obriga a gravar na hora.

O /genbackup copia o mundo atual para a pasta de backups, com um nome feito da data e da hora, a menos que lhe dês outro. Ganha o hábito de o correr antes de updates, mudanças de mods e eventos grandes, e descarrega as cópias mais antigas com o File Manager. Por cima disso, os nossos backups externos cobrem os últimos 7 dias.

Mudar um mundo de sítio, num sentido ou no outro, é uma questão de copiar um ficheiro: desliga o servidor, envia ou descarrega o .vcdbs, acerta o SaveFileLocation e volta a ligar.

O que comparar antes de alugar um servidor Vintage Story

O Vintage Story pede pouco hardware, mas exige muito em definições e mods. São estes os pontos que separam um bom hosting de um que é só barato.

1. Acesso à consolaQuase todo o trabalho de admin passa por comandos do servidor. Garante que o host te dá uma consola ao vivo, e não apenas um botão de restart.
2. Memória por jogadorPõe a RAM lado a lado com a estimativa oficial de 1 GB mais 300 MB por jogador, e deixa espaço para os teus mods.
3. Número de jogadores flexívelOs grupos de Vintage Story crescem em números ímpares. Um seletor que aceita qualquer valor evita que pagues lugares que nunca vais encher.
4. Acesso aos ficheirosVais querer enviar saves e editar o serverconfig.json tu mesmo, por isso procura SFTP e um gestor de ficheiros.
5. Localização e latênciaFaz um teste de ping a partir de onde vivem os teus jogadores; um centro de dados perto pesa mais do que a velocidade bruta do CPU.
6. Condições de faturaçãoCompara o mensal com os prazos mais longos e procura taxas de instalação ou contratos mínimos.

Vintage Story: glossário para admins

serverconfig.json

O ficheiro principal de definições: nome, porta, password, whitelist, cargos e opções do mundo.

.vcdbs

O formato de ficheiro de um save de mundo do Vintage Story.

ModDB

A base de dados oficial de mods, em mods.vintagestory.at.

Role (cargo)

Um conjunto de permissões, como suplayer, sumod ou admin, atribuído a cada jogador.

Whitelist

A lista de jogadores autorizados a entrar. Vem ligada por defeito nos servidores dedicados.

PlayStyle

O preset de mundo escolhido na geração, da sobrevivência normal à construção criativa.

PassTimeWhenEmpty

A definição que mantém o calendário do jogo a correr sem ninguém online.

Land claim

Uma área que um jogador protege dos outros, com o tamanho dado pela quota do seu cargo.

Knapping

Lascar sílex ou pedra para fazer as primeiras ferramentas, o primeiro passo de crafting num mundo novo.

Release candidate

Uma build de teste quase final que a Anego publica antes de cada versão grande.

Onde encontrar ajuda para o Vintage Story

Documentação oficial e guias nossos. A wiki, o ModDB e o nosso guia de mods estão em inglês.

• Guia do servidor dedicado, wiki oficial do Vintage StoryPortas, whitelist e requisitos.
• Referência do Server Config, wiki oficialTodas as definições do serverconfig.json, uma a uma.
• ModDB do Vintage StoryA base de dados oficial de mods.
• Instalar mods no teu servidor Vintage StoryO nosso guia passo a passo (em inglês).
• Painel de controlo da Gaming DeluxeComo funciona o painel e como entrar (página em inglês).
• Falar com o suporteAjuda com mundos, mods e definições (página em inglês).