Este guia orienta-o na instalação de mods do Steam Workshop no seu servidor Project Zomboid alojado na Legion Hosting. Abrange os formatos de mods B42 e B41, a ferramenta Mod Organizer da Legion Hosting, notas de compatibilidade para grandes pacotes de mods e como recuperar de corrupção de mundo comum relacionada com mods.

Pré-requisitos

• Um servidor Project Zomboid ativo na Legion Hosting, acessível em gpanel.legionhosting.net
• O seu servidor deve estar Offline antes de editar as definições de mods — pare-o no GPanel primeiro
• O(s) Workshop ID(s) e Mod ID(s) do Steam para cada mod que deseja instalar (encontrados na página do Steam Workshop de cada mod)
• Uma cópia de segurança do seu save de mundo atual (fortemente recomendado — veja o aviso acima)

Passo 1 — Encontrar o Workshop ID e Mod ID de Cada Mod

Cada mod que deseja instalar requer dois identificadores separados:

• Workshop ID — o ID numérico no URL do Steam Workshop, ex.: https://steamcommunity.com/sharedfiles/filedetails/?id=2392987841
• Mod ID — o ID interno definido pelo autor do mod, encontrado na descrição do mod na página do Workshop, normalmente listado como "Mod ID:" ou dentro do ficheiro mod.info do mod

Anote ambos os IDs para cada mod antes de continuar. Um único item do Workshop por vezes contém múltiplos sub-mods, cada um com o seu próprio Mod ID.

Passo 2 — Usar o Mod Organizer da Legion Hosting (Recomendado)

A forma mais fácil de construir a sua lista de mods é o Legion Hosting Zomboid Mod Organizer. Permite-lhe pesquisar no Workshop, adicionar mods por URL ou ID, e gera automaticamente as linhas de configuração corretamente formatadas que precisa de colar no GPanel.

1. Vá a legionhosting.net/zomboid-mod-organizer.php.
2. Pesquise mods por nome ou cole um URL do Steam Workshop na caixa de pesquisa.
3. Adicione cada mod à sua lista usando o botão Add.
4. Quando a sua lista estiver completa, clique em Generate Config. A ferramenta gera linhas WorkshopItems e Mods prontas a usar, formatadas para a versão de build do seu servidor.
5. Copie as linhas geradas e prossiga para o Passo 4 para colá-las nas definições do seu servidor.

Se preferir introduzir os IDs manualmente, continue com o Passo 3 para formatá-los corretamente para a sua versão de build.

Passo 3 — Formatar a Lista de Mods Corretamente

WorkshopItems (igual para todas as builds)

A linha WorkshopItems usa um ponto e vírgula para separar os Workshop IDs. Este formato é o mesmo para B41 e B42:

Mods — Formato Build 42 (B42)

B42 usa um prefixo de barra invertida (\) antes de cada Mod ID:

Formato DLMP (B42)

Algumas configurações usam o formato DLMP, que combina Workshop IDs e Mod IDs com uma barra invertida num único campo:

Mods — Formato Build 41 (B41)

B41 usa Mod IDs simples separados por ponto e vírgula sem prefixo de barra invertida:

Passo 4 — Aplicar a Lista de Mods no Ficheiro de Definições do Servidor

1. Inicie sessão no GPanel e selecione o seu servidor Project Zomboid.
2. Certifique-se de que o servidor está Offline. Pare-o se necessário.
3. Abra o File Manager e navegue até /.cache/server/.
4. Abra o ficheiro de definições do seu servidor — tem o nome <servername>.ini (ex.: servertest.ini).
5. Encontre as linhas WorkshopItems= e Mods= no ficheiro. Cole os valores que gerou no Passo 2 ou formatou no Passo 3.
6. Guarde o ficheiro.
7. Inicie o servidor. Os downloads do Steam Workshop começarão automaticamente no arranque.

Passo 5 — Adicionar Mods Gradualmente e Testar

Não adicione toda a sua lista de mods desejada de uma só vez, especialmente num servidor ativo ou quando trabalha com uma grande coleção. Em vez disso:

1. Adicione no máximo 3–5 mods de cada vez.
2. Inicie o servidor e confirme que atinge o estado Running e que consegue conectar e jogar.
3. Verifique a Consola do GPanel para quaisquer mensagens de erro ou stack traces antes de adicionar o próximo lote.
4. Repita até que todos os mods estejam carregados e estáveis.

Esta abordagem torna muito mais fácil identificar qual mod causa um problema se algo correr mal.

Instalar Mods Fora do Workshop

Se tem um mod que não está no Steam Workshop (descarregado como pasta ou ficheiro ZIP), carregue-o via SFTP para o seguinte caminho no seu servidor:

Coloque a pasta do mod (que deve conter um ficheiro mod.info) diretamente dentro de /.cache/mods/. Pode aceder a este diretório usando as credenciais SFTP mostradas no GPanel no separador SFTP. Após o carregamento, adicione o Mod ID (do ficheiro mod.info do mod) à linha Mods= na configuração do seu servidor conforme descrito no Passo 4. Não é necessário Workshop ID para mods fora do Workshop.

Nota de Compatibilidade do Authentic Z

Authentic Z é um dos pacotes de mods mais populares de Project Zomboid, mas consiste em muitos sub-mods. Instale apenas um sub-mod de cada vez, e o sub-mod recomendado para servidores multijogador é:

Não ative múltiplos sub-mods do Authentic Z simultaneamente no mesmo servidor. Executar mais de um sub-mod desta coleção causa conflitos que podem crashar o servidor ou corromper as tabelas de loot. Se não tem a certeza de qual sub-mod está ativo, verifique a linha Mods= na sua configuração e certifique-se de que apenas Authentic Z - Current (ou o seu único sub-mod escolhido) está listado.

Verificação

Após iniciar o servidor com os seus novos mods, confirme que carregaram com sucesso:

1. No GPanel, abra o separador Console e observe o registo de arranque. Procure linhas que referenciem cada mod a ser carregado — deverá ver algo como [ModLoader] Loading mod: ModID para cada mod instalado.
2. Conecte-se ao servidor no jogo e abra o menu Mods a partir do menu principal (Esc → Mods). Os mods instalados deverão aparecer na lista.
3. Pesquise no registo da Consola pela frase STACK TRACE. Se nenhuma aparecer, o servidor arrancou de forma limpa. Se vir uma, anote o mod mencionado perto do topo do trace — esse mod é a causa provável do problema.
4. Caminhe pelo jogo e confirme que o conteúdo adicionado por mods (itens, edifícios, zombies) aparece como esperado.

Resolução de Problemas

Os mods não estão a carregar / o servidor inicia mas os mods parecem inativos

• Verifique se a linha Mods usa o formato correto para a sua build — prefixo de barra invertida (\ModID) para B42, Mod IDs simples para B41. O formato WorkshopItems é o mesmo para ambas as builds.
• Confirme que o Mod ID na linha Mods= corresponde exatamente ao ID mostrado na descrição do Workshop do mod ou no ficheiro mod.info. Os Mod IDs são sensíveis a maiúsculas e minúsculas.
• Verifique se ambos os campos WorkshopItems e Mods estão guardados — navegue para fora e volte no GPanel para confirmar que os valores persistiram.

O download do Steam Workshop falha / os mods não descarregam no arranque

Se o servidor inicia mas os mods do Workshop não parecem descarregar, a pasta de cache do Steam pode estar corrompida. Para corrigir isto:

1. Pare o servidor no GPanel.
2. Conecte-se via SFTP e navegue até /steamapps/workshop/.
3. Elimine toda a pasta workshop/ (ou o seu conteúdo).
4. Inicie o servidor novamente. O Steam irá re-descarregar todos os itens do Workshop de raiz.

WorldDictionaryException / corrupção do dicionário de mundo

Se o registo da Consola mostra um erro WorldDictionaryException, o dicionário de mundo ficou corrompido — isto pode acontecer ao adicionar ou remover mods que introduzem novos itens ou tiles.

Se precisar tentar a recuperação:

1. Pare o servidor no GPanel.
2. Faça cópia de segurança de toda a sua pasta de save via SFTP ou Cópias de Segurança do GPanel.
3. Conecte-se via SFTP e navegue até /.cache/saves/multiplayer/<YourWorldName>/.
4. Elimine WorldDictionary.bin.
5. Inicie o servidor. O Project Zomboid irá regenerar o dicionário no arranque.
6. Verifique no jogo se há itens ou veículos corrompidos. Se o mundo estiver severamente danificado, restaure a partir da cópia de segurança que criou no passo 2.

O servidor crasha no arranque com STACK TRACE no registo da consola

Um stack trace imediatamente após o arranque normalmente indica um conflito de mods ou um mod que é incompatível com a versão de build atual. Para diagnosticar:

1. No GPanel, abra o registo da Console e pesquise por STACK TRACE.
2. Leia as linhas acima do trace para o nome de ficheiro do mod ou Mod ID mencionado — este é normalmente o mod problemático.
3. Remova esse mod das linhas WorkshopItems e Mods, guarde e reinicie o servidor.
4. Se o servidor arrancar de forma limpa após a remoção, verifique a página do Workshop do mod para uma atualização compatível com B42 ou uma nota de conflito conhecida nos comentários.

Também pode abrir o ficheiro completo debug.log via SFTP em /.cache/Logs/<date>_DebugLog-server.txt para mais detalhes do que a consola do GPanel mostra.

O servidor crasha quando jogadores com mods específicos se conectam

Se o servidor funciona de forma limpa mas crasha quando um jogador entra, o jogador pode ter mods do lado do cliente que conflituam com o servidor. Peça ao jogador para desativar todos os seus mods locais de Project Zomboid a partir do menu de Mods no jogo e tentar conectar novamente. Se o crash parar, o jogador deve reativar os mods um de cada vez para encontrar o mod em conflito.

Mod removido mas o servidor ainda tenta carregá-lo

Se removeu o ID de um mod da configuração mas o servidor ainda o referencia no arranque, o item do Workshop pode ainda estar em cache. Elimine a pasta específica do item do Workshop de /steamapps/workshop/content/108600/<workshopID>/ via SFTP e depois reinicie o servidor.