zomboid-bug-fixing

Diagnose and fix Project Zomboid B42.20 mod bugs from logs and crash output.

Updated Jul 5, 2026
One-click install
npx skills add https://github.com/mrStorrs/pz-ai-modding-system --skill zomboid-bug-fixing-mrstorrs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zomboid-bug-fixing
Source: https://github.com/mrStorrs/pz-ai-modding-system/tree/main/.codex/skills/zomboid-bug-fixing
Command: npx skills add https://github.com/mrStorrs/pz-ai-modding-system --skill zomboid-bug-fixing-mrstorrs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project Zomboid mods break in ways that are hard to trace: Lua errors, red context-menu options, missing assets, load failures, and loot distribution bugs. This Skill provides a structured log-first debugging workflow that locates the real working copy, matches log lines to code, and fixes root causes without breaking save compatibility. ## Core Features & Use Cases - Log-Driven Diagnosis: Reads console.txt and crash logs first, matching Lua stack traces and load errors to the exact mod file and code path before editing. - Workshop-First Patching: Compares local copies against Steam Workshop sources before patching, avoiding duplicate fixes that upstream already shipped. - Domain-Specific Fixes: Handles loot distribution bugs, roof cutaway .lotheader repairs, live symlink packaging, and save-compatible Lua fixes within the client/shared/server split. - Use Case: A player reports red context-menu options and Lua errors after loading a mod. The Skill inspects the logs, checks the Workshop source, applies a targeted fix in the project repo, validates Lua syntax, relinks the live install, and runs a post-change review. ## Quick Start Use the zomboid-bug-fixing skill to investigate the Lua errors in console.txt and fix the broken mod.

Frequently Asked Questions about zomboid-bug-fixing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a broken Project Zomboid mod from logs?

Start by reading console.txt in the Zomboid user-data folder, then match Lua stack traces, missing files, and bad item names to the mod's code path. Fix the root cause with a targeted edit rather than adding defensive guards.

How do I fix Lua errors in a Project Zomboid B42 mod?

Locate the failing file from the log's stack trace, reproduce the bug in the smallest path, and apply a targeted fix within the existing client/shared/server split. Validate changed files with lua5.1 loadfile syntax checks.

Should I patch a mod locally or update it from Steam Workshop?

Check the Workshop source first by matching mod.info IDs and comparing changed files. If upstream already fixed the issue, refresh the live copy from Workshop instead of maintaining a local patch.

Why does a building roof not cut away in Project Zomboid B42?

The roof's BuildingDef likely lacks an emptyoutside RoomDef at the roof level. With backups and approval, repair the .lotheader by appending coordinate-bounded emptyoutside rooms without renumbering existing room indexes.

Can mod fixes break existing Project Zomboid save games?

Yes, changes to item IDs, mod IDs, or save data can break saves. This workflow preserves save compatibility by default and stops to ask before any breaking change unless the user explicitly approves it.