Como adicionar mods a um servidor de Project Zomboid

Como funcionam os mods em um servidor de Project Zomboid: Workshop ID e Mod ID

• Workshop ID — o número no final do endereço do mod na Steam Workshop, por exemplo 2169435993. Ele diz ao servidor o que baixar.
• Mod ID — o nome que o mod usa dentro do jogo, informado na página da Workshop (geralmente perto do final, como Mod ID:) e no arquivo mod.info do mod. Ele diz ao servidor o que carregar.

Um item da Workshop pode conter vários mods, cada um com seu próprio Mod ID. Adicione só os Mod IDs que você quer; muitas vezes a própria página diz qual escolher.

Adicionar mods no servertest.ini

O arquivo de configurações do servidor é Zomboid/Server/servertest.ini (leva o nome do seu servidor). Pare o servidor e preencha duas linhas:

WorkshopItems=2169435993;2392709985
Mods=ModA;ModB

• WorkshopItems — os Workshop IDs, separados por ponto e vírgula, sem espaços.
• Mods — os Mod IDs desses itens, também separados por ponto e vírgula.

Inicie o servidor. Ele baixa os itens da Workshop e carrega os mods, e os jogadores recebem tudo automaticamente ao se conectar.

Build 42 ou Build 41: o que muda para os mods

A Build 42 é a versão estável atual (42.21); a Build 41 continua disponível como branch legacy para listas de mods mais antigas.

• Os mods são feitos para uma build ou para a outra. Um mod da Build 42 tem os arquivos em uma pasta common ou 42; um mod da Build 41 não. Alguns itens da Workshop trazem os dois. Um mod que não foi feito para a build do seu servidor é ignorado.
• A barra invertida. A Build 42 mostra os Mod IDs com uma barra invertida na frente, como \ModA. Em um servidor Build 42 você pode escrever com ou sem ela: o servidor remove a barra. Em um servidor Build 41 nunca adicione: lá ela vira parte do nome e o mod não é encontrado.
• Confira a página da Workshop para ver qual build um mod suporta antes de adicioná-lo, e mantenha a lista inteira em uma só build.

Mods de mapa e ordem de carregamento

Mapas precisam de uma terceira linha. Além do Workshop ID e do Mod ID, adicione o nome da pasta do mapa em Map=, mantendo o mapa base na lista:

Map=MyMapFolder;Muldraugh, KY

A página do mapa na Workshop informa o nome da pasta e em que posição da lista ele deve ficar; siga essas instruções, principalmente ao combinar vários mapas.

A ordem de carregamento segue a ordem de Mods=. Se um mod depende de outro, o servidor carrega essa dependência primeiro por conta própria, mas só se ela estiver instalada, então o Workshop ID dela também precisa estar em WorkshopItems. Um mod sem a dependência é ignorado.

Mantendo os mods atualizados

Quando um mod da Workshop é atualizado, os jogadores baixam a nova versão, mas o servidor mantém a antiga até ser reiniciado, e um jogador cuja cópia não bate mais pode ter problemas para entrar.

• Reinicie para atualizar. A cada inicialização o servidor baixa qualquer item da Workshop que esteja faltando ou desatualizado.
• Verifique sem reiniciar: o comando de admin checkModsNeedUpdate pergunta à Steam se algum dos seus itens mudou e escreve a resposta no chat e no log. Ele só informa; não atualiza nada.
• Avise os jogadores e reinicie quando ele indicar uma atualização, de preferência em horário programado.

Quando um mod não carrega

• ID errado na linha errada — Workshop IDs (números) vão em WorkshopItems, Mod IDs em Mods.
• Espaços ou um ponto e vírgula faltando em qualquer uma das listas.
• O mod é para a outra build — confira a página da Workshop; na Build 41, remova qualquer barra invertida.
• Falta uma dependência — adicione também o Workshop ID e o Mod ID do mod necessário.
• Leia o log — o servidor registra quais mods carregou, quais ignorou e por quê.

Mods em um servidor de Project Zomboid da HytHost

1. Coloque os IDs na aba Startup. Ela tem um campo para os itens da Workshop e outro para Mods. O painel grava esses valores no servertest.ini a cada inicialização, então adicione os mods ali: mods digitados direto no arquivo são substituídos na próxima inicialização.
2. Mapas são a exceção: edite a linha Map= do servertest.ini pelo gerenciador de arquivos.
3. Reinicie pelo painel. O servidor baixa os mods ao iniciar, e o próprio jogo também é atualizado antes de cada inicialização.
4. Escolha a build ao fazer o pedido: Build 42 ou a branch legacy da Build 41. Trocar depois exige reinstalação, então faça um backup antes.

As demais configurações do servidor são explicadas em configurações do servidor de Project Zomboid, e os planos estão em hospedagem de Project Zomboid.