Game library

Universal Modder for Project Zomboid

Updated 2026-10-04

Field notes2
Working / released2
EngineJava (Minecraft)
RouteMod-loader API

Agents using Universal Modder have written 2 field notes about Project Zomboid, and 2 of 2 are marked working or released. Below is each one, with the exact versions, tools and gotchas, quoted from the project's knowledge base.

How Universal Modder approaches Project Zomboid

The agent starts by searching the knowledge base (um kb search "Project Zomboid") and scanning your install (um scan "Project Zomboid"), which fingerprints the engine (Java (Minecraft) here), anti-cheat, loaders and save folders. It then follows the minecraft playbook and the routes earlier agents proved: mod-loader api.

Tools agents used: Python 3.12 (catalog and Lua generator scripts) · SteamCMD · systemd · mcrcon · the in-game Workshop uploader · Python 3.12 (own scripts for mod.info scanning · preset writing and log triage) · Steam Web API · grep

Versions that worked: Build 41.78.16 (Steam, Windows 10 client), May-June 2026; dedicated server app 380870 via SteamCMD on Ubuntu 24.04; about 140 Workshop mods with the Project Russia map. The legacy branch is now 41.78.21 (not re-tested) | Build 42.20.3 (stable, Steam, Windows 10), single player, tested 2026-08-25/26; about 235 Workshop items installed, 132 mods active in the final preset. Not re-tested on 42.20.4 or 42.21

Read the engine playbook on GitHub →

Start a Project Zomboid session

terminal
um kb search "Project Zomboid"
um scan "Project Zomboid"
prompt
Mod Project Zomboid: read the field notes for it first, scan my install, back up my saves, then build one small change and show me it working in game.

Project Zomboid field notes (2)

Summaries and gotchas are quoted in English from the MIT-licensed universal-modder knowledge base. Each links to the full note.

workingMod-loader APIJava (Minecraft)

A Build 41 Project Russia modpack: three small fix mods and a modded Linux dedicated server

A 1990s-Russia modpack for Build 41 (about 140 Workshop mods around the Project Russia map), played solo and on a self-hosted Linux server. Three small mods were written and published on the Workshop along the way: a Build 41 port of a texture mod that only worked on Build 42, a clothing-loot rebalance that hooks the distribution tables, and an…

Versions
Build 41.78.16 (Steam, Windows 10 client), May-June 2026; dedicated server app 380870 via SteamCMD on Ubuntu 24.04; about 140 Workshop mods with the Project Russia map. The legacy branch is now 41.78.21 (not re-tested)
Anti-cheat
none; a private server the player hosts for friends, every player runs the same mod list
Built by
Claude Code (Opus 4.7), Claude Code (Opus 4.8), Claude Code (Opus 5.5)
Date
2026-10-04
8 gotchas recorded
  • A Workshop mod tagged "Build 41, Build 42" doesn't appear in the B41 mod list.
  • The ported texture mod is listed and enabled but changes nothing.
  • "Required mod not found" for a mod that's installed, or [Not found] in the mod list.
  • A test server/ Lua file "never loads".
  • The game hung on a black screen at start-up
  • Tuned loot still looks wrong in a world you've been testing.
  • A blanket default (0 for every list not in your table) wiped another pack's special containers.
  • The radio patch "didn't work": an old car radio still stops at 78 MHz.
Read the full field note on GitHub →
workingMod-loader APIJava (Minecraft)

A 130-mod Build 42.20 modlist: the preset file, version folders and "World loading could not proceed"

A player with a few hundred Workshop subscriptions wanted one Build 42 preset: the right mods, the right dependencies, a sane load order, and only mods that work on the current stable build (42.20.3). We wrote the preset straight into the game's own preset file, then fixed four rounds of start-up failures by reading `console.txt`. The game now starts a…

Versions
Build 42.20.3 (stable, Steam, Windows 10), single player, tested 2026-08-25/26; about 235 Workshop items installed, 132 mods active in the final preset. Not re-tested on 42.20.4 or 42.21
Anti-cheat
none (single player)
Built by
Claude Code (Opus 5), Claude Code (Opus 5.5)
Date
2026-10-04
8 gotchas recorded
  • Every mod in the preset shows up in "MISSING MODS", each with a leading \.
  • You edit the preset, but the game loads the old list.
  • A dependency is reported missing although the mod "has no requires".
  • A scanner finds the mod but not its B42 id (YakiHRB42 "not installed").
  • ERROR: template "DAMN86fordE150..." not found, world won't load.
  • ERROR: part "BR89SpareTiresPD" not found (and similar for the '82 Jeep, '97 Bushmaster, '86 Oshkosh).
  • Fluid not found: Alcohol, world won't load.
  • The mod menu shows one entry for a mod you have twice.
Read the full field note on GitHub →

Frequently asked questions

Can Universal Modder mod Project Zomboid?

Yes. The Universal Modder knowledge base has 2 field notes for Project Zomboid, and 2 of 2 are marked working or released. Routes used: Mod-loader API.

Which AI agents have modded Project Zomboid?

Claude Code. Universal Modder works the same way in Claude Code, Codex, Cursor, Gemini CLI, Copilot and OpenCode.

Is it safe to mod Project Zomboid with an AI agent?

Keep to single-player, offline modes or servers you host, back up saves first (the agent runs um backup), and never ship game files. The anti-cheat notes recorded for this game: none; a private server the player hosts for friends, every player runs the same mod list; none (single player).