Este guia explica como alternar o seu servidor de Project Zomboid entre a Build 41 (B41) e a Build 42 (B42) através do GPanel. Abrange a compatibilidade de saves, o backup do seu mundo e como realizar a mudança por conta própria.
Antes de Alternar: Compreender o Problema de Compatibilidade de Saves
O Project Zomboid armazena todos os dados do mundo e dos jogadores numa pasta de save associada à versão da build em que foi criado. As duas builds utilizam formatos diferentes para chunks do mapa, definições de itens e dados de personagens.
| Build | Steam Beta Branch | Pode Usar Saves de B41? | Pode Usar Saves de B42? |
|---|---|---|---|
| Build 41 (B41) | (em branco/vazio) | Sim | Não |
| Build 42 (B42) | unstable |
Não | Sim |
O beta branch é definido no separador Startup do seu servidor no GPanel.
Quando a mudança estiver concluída, o seu servidor começará do zero na nova build. Qualquer mundo existente na build anterior continuará presente na pasta de save, mas o servidor não o carregará. Não será eliminado automaticamente — simplesmente não será utilizado. Deve alterar o nome do servidor ou eliminar os dados de save existentes antes de iniciar na nova build.
Passo 1 — Fazer Backup do Seu Mundo Atual
Antes de alternar entre builds, descarregue uma cópia do seu save atual. Mesmo que não planeie voltar à build antiga, ter um backup protege contra perda acidental de dados e dá-lhe algo para restaurar caso as circunstâncias mudem.
Opção A: Backup via GPanel
- Inicie sessão no GPanel e selecione o seu servidor de Project Zomboid.
- Pare o servidor utilizando o botão Stop no separador Console e aguarde até que o estado mostre Offline.
- Navegue até ao separador Backups no GPanel.
- Clique em Create Backup e aguarde que seja concluído. O backup aparecerá na lista abaixo.
- Assim que o backup estiver listado, clique no ícone de download para guardá-lo localmente.

Opção B: Descarregar a Pasta de Save via SFTP
Se pretende descarregar apenas os dados do save do mundo em vez de um backup completo do servidor, conecte-se ao seu servidor via SFTP e descarregue a pasta de save manualmente.
- No GPanel, vá ao separador SFTP e anote o hostname, porta, nome de utilizador e palavra-passe do SFTP.
- Abra um cliente SFTP como o FileZilla e conecte-se utilizando essas credenciais.
- Navegue até ao diretório de save do mundo:
/home/container/.cache/saves/multiplayer/<YourWorldName>/ - Descarregue toda a pasta
<YourWorldName>para a sua máquina local.
Passo 2 — Alterar a Build no GPanel
A alternância entre B41 e B42 é feita através das opções de arranque do seu servidor. Não é necessário um ticket de suporte.
- Inicie sessão no GPanel e selecione o seu servidor de Project Zomboid.
- Certifique-se de que o servidor está parado.
- Vá ao separador Startup.
- Localize o campo Beta Branch:
- Para mudar para B41: deixe o campo Beta Branch em branco (vazio).
- Para mudar para B42: introduza
unstableno campo Beta Branch.
- Altere o Server Name no separador Startup para um novo nome diferente do atual. Isto evita que a nova build tente carregar dados de save incompatíveis.
- Vá ao separador Settings e clique em Reinstall Server. Isto descarrega os ficheiros de jogo corretos para a build selecionada.
- Inicie o servidor. Ele irá gerar um mundo novo com o novo nome do servidor.
.cache/, e depois reinstalar. A pasta .cache/ contém a configuração do seu servidor, por isso isto preserva as suas definições enquanto garante uma instalação de jogo limpa para a nova build. Utilize este método apenas se não quiser alterar o nome do servidor — note que os dados de save com o nome de servidor antigo terão de ser eliminados manualmente de .cache/saves/multiplayer/.
Compatibilidade de Mods Após a Mudança
Os mods não são compatíveis entre builds. Um mod feito para B41 não funcionará na B42, e vice-versa. Após a mudança, terá de rever e substituir toda a sua lista de mods.
- Mudar de B41 para B42: A maioria dos mods populares de B41 foram atualizados ou substituídos por versões para B42. Verifique a Steam Workshop para versões específicas de B42 dos mods que estava a utilizar. Note que o formato
WorkshopItemstambém mudou na B42 — consulte o guia de instalação de mods para o formato correto da B42. - Mudar de B42 para B41: Os mods de B42 não carregarão na B41. Deve encontrar e instalar as versões originais de B41 de quaisquer mods que pretenda utilizar. Verifique a Steam Workshop para autores de mods que mantêm branches separados para B41.
Perguntas Frequentes
Posso manter o meu mundo B41 e também ter um mundo B42?
Não no mesmo servidor simultaneamente — uma única instância de servidor executa uma build de cada vez. No entanto, os seus ficheiros de save de B41 permanecem no disco após mudar para B42. Se voltar para B41 no futuro e restaurar o nome original do servidor, o save antigo pode ser carregado novamente. Os seus dados de save anteriores estão armazenados em .cache/saves/multiplayer/ e não são eliminados automaticamente durante uma mudança de build.
Voltar para B41 terá algum custo?
Não. A mudança de build é feita inteiramente através do GPanel sem custos adicionais. Os slots de servidor de Project Zomboid B41 e B42 têm o mesmo preço na Legion Hosting.
Os meus jogadores estão a receber um erro de incompatibilidade de versão após a mudança
Isto significa que o servidor e o cliente de jogo do jogador estão em versões de build diferentes. Os jogadores precisam de fazer corresponder o seu Steam beta branch com a build do servidor:
- No Steam, clique com o botão direito em Project Zomboid e selecione Properties.
- Clique no separador Betas.
- No menu suspenso, selecione None — isto dá-lhe a build padrão atual (B41).
- Se o servidor estiver a executar B42, selecione unstable em vez disso.
- Aguarde que o Steam atualize o jogo, depois inicie e conecte-se.
Ainda precisa de ajuda?
Se encontrar problemas durante a mudança, abra um ticket de suporte e nós iremos ajudá-lo.