Todo modder pasa más tiempo arreglando cosas que creándolas. La diferencia está en saber dónde mirar.
Dónde están los errores
Zomboid/console.txt: el registro de la última vez que abriste el juego. Busca el nombre de tu mod,ERRORoException.Zomboid/Logs/: una carpeta por sesión con registros más completos. Si el juego se cae al cargar la partida,console.txta veces queda cortado y el error de verdad está aquí, en el archivo que termina enDebugLog.txt.- El modo debug (
-debug) muestra los errores de Lua en pantalla apenas pasan.
Problemas típicos
| Síntoma | Causa probable | Solución |
|---|---|---|
| El mod no aparece en la lista de mods | Estructura de carpetas o mod.info mal | Revisa Contents/mods/<id>/42/mod.info y que id= sea igual al nombre de la carpeta |
| "World loading could not proceed, there are script load errors" | Un ítem de una receta escrito sin módulo | Escribe MiMod.MiItem, no MiItem, en craftRecipe |
| El ítem aparece con un signo de pregunta | Falta el ícono o el nombre no calza | Icon = X busca textures/Item_X.png |
En pantalla se ve Tooltip_MiMod_Algo en vez del texto | Traducción en .txt o JSON roto | B42 solo lee .json; revisa comas y que la clave sea exacta |
attempted index of non-table o tried to call nil | Función o tabla que no existe (muchas veces de Build 41) | Búscala en los .lua del juego antes de usarla |
| El ítem no aparece en ningún contenedor | Nombre de lista de loot mal escrito, o contenedores ya abiertos | Revisa el nombre en ProceduralDistributions.lua y prueba en una partida nueva |
| La ropa puesta tiene hoyos | Máscaras del cuerpo sobre un UV propio | <m_MasksFolder>none</m_MasksFolder> (Ropa) |
| El vehículo es solo una sombra | Modelo sin módulo en el script del vehículo | file = MiMod.MiModelo (Vehículos) |
| El ítem no se ve en la mano al equiparlo | Falta la pose de agarre | primaryAnimMask / secondaryAnimMask (Ítems) |
Un método que funciona
- Cambia una sola cosa a la vez. Si cambias diez y algo se rompe, no sabrás cuál fue.
- Reproduce el error con lo mínimo: desactiva los otros mods. Muchas veces el problema es un choque entre dos.
- Busca un ejemplo en el juego base. Si el juego hace algo parecido, copia cómo lo hace.
- Lee el error completo. La primera línea que menciona tu archivo suele decir el número de línea exacto.
- Antes de publicar, prueba en una partida nueva y en una partida existente si dices que se puede agregar a mitad de partida.
Antes de dar un mod por terminado
- Los modelos y texturas "vanilla" que usas existen de verdad en el juego base, no en otro mod.
- El loot revisa que la lista exista y corre dentro de
pcall. - Las recetas usan nombres con módulo.
- Hay traducción al menos en español e inglés, en JSON.
- Si se equipa en la mano, se ve en la mano.
- La ropa con modelo propio se probó puesta, con pantalón y calcetines encima.
console.txtno muestra errores con el nombre de tu mod.