Installation

Step 1: Subscribe to ZombieBuddy on Steam Workshop

Step 2: Installation is required ONLY ONCE for ZombieBuddy itself.

🪟 **Windows:

Option A: Automated Installer (Recommended)

• Download the latest ZombieBuddyInstaller.exe from SourceForge/GitHub Releases
• Run the installer and choose Install or update ZombieBuddy.
• Choose what launch mode to patch:
  • Both (recommended): patches Normal Launch and Alternate Launch.
  • Normal Launch: then choose ProjectZomboid64.json, Steam launch options, or both.
  • Alternate Launch: patches ProjectZomboid64.bat.
• The installer shows every system change first and asks for confirmation before applying it.
• If Steam launch options need to be changed, the installer will ask you to close Steam at that point.
• The same installer can also uninstall ZombieBuddy later: run it again and choose Uninstall ZombieBuddy.

Option B: Manual Installation

• Copy ZombieBuddy.jar and zbNative.dll from

C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\3619862853\mods\ZombieBuddy\libs\

• to your Project Zomboid folder:

C:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid\

• Open Project Zomboid's launch options in Steam
• Add this launch option:

• -agentlib:zbNative --

• ⚠️ IMPORTANT: The -- at the end is mandatory - do not omit it!

• If you use the game's Alternate Launch option on Windows, set the ProjectZomboid64.bat _JAVA_OPTIONS line to:
  SET _JAVA_OPTIONS=-agentlib:zbNative

🍎 macOS / 🐧 Linux:

• Copy ZombieBuddy.jar from the mod's libs/ directory to:
  * macOS: ~/Library/Application Support/Steam/steamapps/common/ProjectZomboid/Project/Zomboid.app/Contents/Java/
  * Linux: ~/.steam/steam/steamapps/common/ProjectZomboid/projectzomboid/
• Open Project Zomboid's launch options in Steam
• Add this JVM argument: -javaagent:ZombieBuddy.jar --
• ⚠️ IMPORTANT: The -- at the end is mandatory - do not omit it!

Step 3: After this setup, all mods that require ZombieBuddy will work automatically!