Mods no servidor de Project Zomboid (Build 42)

Para usar mods do Project Zomboid num servidor, coloque o Workshop ID de cada item em WorkshopItems= e o Mod ID em Mods=, no arquivo .ini do servidor. Mapas entram também em Map=, antes de Muldraugh, KY. No Build 42, use só mods feitos para essa versão. O servidor e os jogadores precisam da mesma versão do jogo e dos mesmos mods.

Seu próprio servidor Project Zomboid? Na HostValues a partir de €5,60 por mês, online em poucos minutos. Ver planos →

Este guia explica a diferença entre Workshop ID e Mod ID, como adicionar mods, a ordem de mods e mapas, a compatibilidade com o Build 42 e o que fazer quando um jogador não entra. Vale para o Build 42.21, a versão estável desde 28 de setembro de 2026. Conferimos tudo em 27 de outubro de 2026 na wiki oficial do Project Zomboid e nas notas da The Indie Stone, o estúdio do jogo.

Workshop ID e Mod ID: a diferença

Cada mod da Oficina Steam (a Steam Workshop em português) tem dois identificadores, e o servidor precisa dos dois. O Workshop ID, que o jogo em português chama de ID da Oficina, é o número no fim do link da página do mod. Com ele o servidor sabe qual item baixar. O Mod ID é o nome que o jogo usa para carregar o mod; ele vem do campo id= do arquivo mod.info.

Um item da Oficina pode trazer vários mods, por exemplo partes opcionais ou versões diferentes do mesmo mod. Aí há um Workshop ID e vários Mod IDs; coloque em Mods= só os que você quer carregar. Mapas ainda têm um terceiro dado, a pasta do mapa.

O gerenciador de mods do Build 42 mostra, para cada mod, o Mod ID, o Workshop ID, as versões mínima e máxima do jogo, as dependências e os mods incompatíveis. É o jeito mais seguro de copiar os IDs sem erro.

Adicionar mods no servidor de Project Zomboid passo a passo

Num servidor de Project Zomboid na HostValues, o nome do servidor é HostValues. Por isso a configuração fica em .cache/Server/HostValues.ini, ao lado de HostValues_SandboxVars.lua. O caminho é este:

1. Na aba Backups, crie uma cópia antes de qualquer mudança.
2. Na aba Console, pare o servidor.
3. Na aba File managers (ou por SFTP), abra .cache/Server/HostValues.ini.
4. Em WorkshopItems=, coloque os Workshop IDs separados por ponto e vírgula.
5. Em Mods=, coloque os Mod IDs, também separados por ponto e vírgula.
6. Se algum item for um mapa, coloque a pasta dele em Map= (veja a ordem abaixo).
7. Salve e inicie o servidor. Ele baixa e instala os itens da Oficina na inicialização.

Com dois mods, as linhas ficam assim (os valores são só marcadores):

WorkshopItems=WORKSHOP_ID_1;WORKSHOP_ID_2
Mods=MOD_ID_1;MOD_ID_2

Quando um jogador entra, o jogo mostra os itens da Oficina que o servidor exige e pede para instalá-los. Ninguém precisa baixar nada à mão.

Dois cuidados. Se a página do mod lista itens obrigatórios (Required Items), coloque também os IDs deles no servidor. E sobre o formato: a pzwiki descreve Mods= só como a lista de IDs de carregamento, sem nenhum prefixo. Alguns guias na internet colocam uma barra invertida (\) antes de cada ID no Build 42, mas eles não concordam entre si. Se o seu arquivo já tiver IDs gravados pelo próprio jogo, siga o mesmo formato.

Também dá para montar a lista no jogo, em Hospedar (Host) e depois Gerenciar configurações (Manage Settings), que tem seções para itens da Oficina, mods e mapas. O jogo grava um .ini na sua pasta Zomboid/Server; copie dele as linhas WorkshopItems=, Mods= e Map= para o HostValues.ini. Portas, admin e o resto da configuração estão no guia como criar e configurar um servidor de Project Zomboid no Build 42.

Ordem dos mods e mapas

Mods. Segundo a pzwiki sobre ordem de carregamento, a ordem quase nunca importa. Ela só pesa quando dois mods substituem os mesmos arquivos: aí o mod carregado por último sobrescreve o anterior. O gerenciador de mods do Build 42 permite definir a ordem e salvar predefinições (presets), o que ajuda a testar a mesma lista no seu PC.

Mapas. Aqui a ordem conta. Nas configurações de servidor do jogo, a The Indie Stone explica que os mapas mais perto do topo da lista têm prioridade: onde dois mapas se sobrepõem, vale o de maior prioridade. Em Map=, os mapas da Oficina vêm primeiro e o mapa base Muldraugh, KY, que cobre toda Knox Country, fica sempre no fim:

Map=MAPA_A;MAPA_B;Muldraugh, KY

Onde MAPA_A e MAPA_B se sobrepõem, vale MAPA_A. Mas a pzwiki avisa: dois mapas que usam as mesmas células entram em conflito, e a ordem não resolve isso. Algumas páginas de mapas na Oficina listam as células ocupadas; compare antes de juntar dois mapas na mesma região.

Build 42: mods compatíveis e versões

A pzwiki avisa que mods de versões antigas provavelmente não funcionam nas novas. No Build 42 há motivos concretos:

• Estrutura de pastas nova. Um mod do Build 42 tem uma pasta common e/ou uma pasta de versão, como 42, onde fica o mod.info. Segundo a wiki sobre a estrutura de mods, o jogo precisa de pelo menos uma das duas para reconhecer o mod. Um mod só com a estrutura do Build 41 não aparece, mas um mesmo mod pode trazer as duas.
• Pastas por versão. Um autor pode ter pastas como 42 e 42.12; o jogo carrega a mais próxima da versão que você roda.
• Mudanças no código. A versão 42.13, de dezembro de 2025, trouxe um sistema novo de identificadores e registros, e os autores tiveram de atualizar os mods. O hotfix 42.20.4 removeu os métodos loadstring e loadstream; a 42.21 os trouxe de volta.

Na prática: filtre a Oficina pela tag Build 42 (quem coloca a tag é o autor), veja a data da última atualização e confira no gerenciador de mods a versão mínima e máxima do jogo.

Fique com mods em Lua da Oficina. Num aviso de 21 de outubro de 2026, a The Indie Stone explicou que só dá suporte oficial a mods em Lua. Mods em Java quase sempre exigem instalação manual ou um carregador especial, quebram com as atualizações sem aviso e rodam código de terceiros direto na máquina. E mesmo na Oficina, instale só mods de autores confiáveis: em abril de 2026, a The Indie Stone removeu 14 mods que criavam arquivos maliciosos fora da pasta do jogo.

Quando o cliente não entra (mods diferentes)

Quase todo erro de conexão com mods vem de uma diferença entre o que o servidor tem e o que o jogador tem:

A pzwiki avisa que o DoLuaChecksum pode dar falsos positivos em servidores Linux, e que alguns donos desses servidores o desligam. Como ele existe por segurança, resolva antes as diferenças de mods e de versão.

Na HostValues, a atualização automática do servidor vem desligada: na aba Startup, a variável AUTO_UPDATE está em 0. Depois de cada atualização do jogo na Steam, confira se o servidor está na mesma versão dos jogadores antes de chamar o grupo.

Se nada resolver, procure o mod culpado: a pzwiki recomenda desativar os mods um por um ou pela metade, num save novo, porque remover mods de um mundo em andamento pode apagar itens para sempre. Faça um backup antes de tirar qualquer mod do servidor.

Servidor com mods na HostValues

Mods pesam na memória. Na página de planos, o Scratch, com 8 GB de RAM e 40 GB NVMe por € 11,20 por mês, é o plano indicado para mods e veículos. Para 20 jogadores ou mais com muitos mods, a HostValues indica 12 GB: o Outbreak, com 60 GB NVMe, por € 16,80 por mês. O Bite, com 4 GB por € 5,60, é para grupos pequenos.

• Contratar o Scratch (8 GB)
• Contratar o Outbreak (12 GB)

Preços com IVA, cancelamento mensal e 15% de desconto no pagamento anual. Você pode mudar para um plano maior depois, sem perder o mundo. Cada servidor tem 2 slots de backup, com backups automáticos ativados por padrão, e o suporte atende todos os dias, das 10h às 22h, por ticket e Discord.

Perguntas frequentes

Qual é a diferença entre Workshop ID e Mod ID no Project Zomboid?

O Workshop ID é o número no fim do link do mod na Oficina Steam e vai em WorkshopItems=. O Mod ID é o nome de carregamento do mod, definido no mod.info, e vai em Mods=. Um item da Oficina pode trazer vários Mod IDs.

Onde coloco os mods no servidor de Project Zomboid?

No arquivo .ini do servidor, nas linhas WorkshopItems= e Mods=, com os valores separados por ponto e vírgula. Na HostValues, o arquivo é .cache/Server/HostValues.ini. Mapas também entram em Map=, antes de Muldraugh, KY.

Os jogadores precisam instalar os mods antes de entrar?

Não. Ao entrar no servidor, o jogo mostra os itens da Oficina que o servidor exige e pede para instalá-los. Todos precisam da mesma versão do jogo e dos mesmos mods.

Mods do Build 41 funcionam no Build 42?

Em geral não. O Build 42 usa outra estrutura de pastas, e as versões 42.13 e seguintes mudaram partes do código usadas pelos mods. Use mods que o autor atualizou para o Build 42.

Por que não consigo entrar num servidor com mods?

Quase sempre há uma diferença entre você e o servidor: outra versão do jogo, um mod atualizado na Oficina depois que o servidor ligou ou arquivos diferentes. Reinicie o servidor, reinicie a Steam e confira se todos estão na mesma versão.