WENOPAL

Erros comuns em mods de Project Zomboid e como corrigir

Onde olhar quando algo dá errado, como ler os erros e uma lista de problemas reais com a solução.

Nível intermediário · Atualizado em

Todo modder passa mais tempo consertando coisas do que criando. A diferença está em saber onde olhar.

Onde ficam os erros

  1. Zomboid/console.txt: o registro da última vez que você abriu o jogo. Procure o nome do seu mod, ERROR ou Exception.
  2. Zomboid/Logs/: uma pasta por sessão com registros mais completos. Se o jogo crashar ao carregar a partida, o console.txt às vezes fica cortado e o erro de verdade está aqui, no arquivo que termina em DebugLog.txt.
  3. O modo debug (-debug) mostra os erros de Lua na tela assim que acontecem.

Problemas típicos

SintomaCausa provávelSolução
O mod não aparece na lista de modsEstrutura de pastas ou mod.info erradoConfira Contents/mods/<id>/42/mod.info e se o id= é igual ao nome da pasta
"World loading could not proceed, there are script load errors"Um item de uma receita escrito sem móduloEscreva MiMod.MiItem, não MiItem, na craftRecipe
O item aparece com um ponto de interrogaçãoFalta o ícone ou o nome não bateIcon = X procura textures/Item_X.png
Na tela aparece Tooltip_MiMod_Algo em vez do textoTradução em .txt ou JSON quebradoA B42 só lê .json; confira as vírgulas e se a chave está exata
attempted index of non-table ou tried to call nilFunção ou tabela que não existe (muitas vezes da Build 41)Procure ela nos .lua do jogo antes de usar
O item não aparece em nenhum contêinerNome da lista de loot escrito errado, ou contêineres já abertosConfira o nome em ProceduralDistributions.lua e teste numa partida nova
A roupa vestida tem buracosMáscaras do corpo sobre um UV próprio<m_MasksFolder>none</m_MasksFolder> (Roupas)
O veículo é só uma sombraModelo sem módulo no script do veículofile = MiMod.MiModelo (Veículos)
O item não aparece na mão ao equiparFalta a pose de segurarprimaryAnimMask / secondaryAnimMask (Itens)

Um método que funciona

  1. Mude uma coisa de cada vez. Se você mudar dez e algo quebrar, não vai saber qual foi.
  2. Reproduza o erro com o mínimo: desative os outros mods. Muitas vezes o problema é um conflito entre dois.
  3. Procure um exemplo no jogo base. Se o jogo faz algo parecido, copie como ele faz.
  4. Leia o erro inteiro. A primeira linha que menciona o seu arquivo costuma dizer o número exato da linha.
  5. Antes de publicar, teste numa partida nova e numa partida existente, se você diz que dá para adicionar no meio da partida.

Antes de dar um mod por terminado

  • Os modelos e texturas "vanilla" que você usa existem de verdade no jogo base, não em outro mod.
  • O loot confere se a lista existe e roda dentro de pcall.
  • As receitas usam nomes com módulo.
  • Tem tradução pelo menos em inglês e no seu idioma (como PTBR), em JSON.
  • Se é equipado na mão, aparece na mão.
  • A roupa com modelo próprio foi testada vestida, com calça e meias por cima.
  • O console.txt não mostra erros com o nome do seu mod.