pz-icon-maker 1.0.0

Render Project Zomboid 3D item models into inventory icons that look like they belong in
the game. Standalone: no Project Zomboid instance, no Blender, no Python.

Install

1. Download pz-icon-maker-1.0.0-win-x64.zip below and unzip it.
2. Run pz-icon-maker.exe, pick a mod folder.
3. Click Game folder… once and point it at your Project Zomboid install, so vanilla
   assets that mods reuse can resolve.

pz-icon-maker-cli.cmd in the same folder is the headless CLI.

What it does

• Matches the game's look — the isometric icon camera, the item shader (flat ambient +
  one key light, alpha cutout, no shadows), and the left-handed mesh convention are all
  reproduced offline.
• Resolves assets by path, from the mod's own item/model scripts, exactly as the game
  does. Mods can use any subfolders; nothing is matched by filename.
• Weapon attachments — render an item fully assembled, e.g. a bicycle with wheels,
  chain, pedals, basket and crate, or a sidecar with an animal in it.
• Live preview at 32/64/128/256/512, all at true 1:1, over an adjustable backdrop.
  Tune angle, framing and lighting; overrides save to the mod's icons.config.json.
• Batch generate one icon or a whole mod, at any sizes, into the mod as
  Item_<icon>.png or into any folder as <icon>_<size>.png for posters and promo art.
• .x meshes are converted automatically via a bundled assimp.

Notes

• Windows x64. Rendering uses the GPU through a hidden window, so it needs a desktop
  session; it is "headless" in the sense of no game and no visible UI, not a display-less
  server.
• Cross-mod parts (a part whose texture lives in another mod) resolve by adding that mod's
  folder to defaults.extraRoots in icons.config.json.
• Unsigned binary, so Windows SmartScreen will warn on first run.

GPL-3.0-or-later. Unofficial fan tool, not affiliated with The Indie Stone. Ships no game assets.