Home · Help · Project Zomboid: Java mods with ZombieBuddy
Project Zomboid: setting up Java mods with ZombieBuddy
ZombieBuddy loads Java mods for Project Zomboid Build 42. Mods such as Project Viewpoint require it. On your server, you set up ZombieBuddy yourself and decide for each Java mod whether it is loaded.
Java mods and Workshop mods from Flex M
Requirements
- Flex M or higher: Workshop mods and file uploads are available from Flex M.
- Project Zomboid Build 42.
- The file
ZombieBuddy.jarfrom the GitHub page of the project (zed-0xff/ZombieBuddy).
Step by step
- Download
ZombieBuddy.jarfrom the GitHub page of the project. - In the customer portal, open your server, then the file manager in the card „Dateien“ (Files), and upload the file to the top-level folder. Alternatively via SFTP.
- In the „Einstellungen“ (Settings) card, enter the following in the „Java-Startparameter“ (Java start parameters) field:
-javaagent:ZombieBuddy.jar. The entry is saved automatically. If the file is not in the server's data folder, the customer portal rejects the entry. - Enter the mods as described in Setting up Project Zomboid mods: the Workshop ID 3619862853 for ZombieBuddy and the mods you want, for example Project Viewpoint (3809306528) and Surface Fix (3814398576). The Mod IDs are
ZombieBuddy,ViewpointandViewpointSurface. Start the server. - Open the card „Java-Mods“ (Java mods) with „Java-Mods anzeigen“ (Show Java mods). New Java mods are listed there as „neu“ (new) with „letzter Start: blockiert“ (last start: blocked), together with Mod ID, Workshop ID, file, date, SHA-256 checksum and signature (validly signed or unsigned).
- For each mod, select „Laden“ (Load) or „Nicht laden“ (Do not load) and restart the server. The selection applies from the next start.
After a mod update
What happens to a new version is set in the „Neustarts“ (Restarts) group under „Freigabe der Java-Mods“ (Approval of Java mods). With the default „Nur von Hand freigeben“ (Approve manually only), the list shows „geändert, nicht freigegeben“ (changed, not approved) and the new file stays blocked until you approve it again. With „Updates freigegebener Mods automatisch freigeben“ (Approve updates of approved mods automatically), the new version counts as approved if the Workshop item, Steam author and Mod ID stay the same. The third option, „Alle Java-Mods ohne Prüfung laden“ (Load all Java mods without checks), loads every Java mod. Details under Setting up game server restarts.
Notes
- Without the Java startup parameter, the card „Java-Mods“ shows „ZombieBuddy nicht aktiv“ (ZombieBuddy not active).
- Project Viewpoint is tied to one game version, currently 42.21. After an update of Project Zomboid, the mod only loads again once its author publishes a matching version.
- Java mods run their own program code on the server. The signature in the list shows whether the file is signed.
- Tested on October 25, 2026 with Build 42.21, ZombieBuddy 2.3.4, Project Viewpoint and Surface Fix on Flex L.
Frequently asked questions
- Why does my Java mod not load?
- Check in the card „Java-Mods“ whether the mod is set to „Laden“ or shows „geändert, nicht freigegeben“ after an update. The selection only applies after a server restart.
- From which tier are Java mods available?
- From Flex M, because Workshop mods and file uploads are only available from that tier.
See also: Setting up Project Zomboid mods Custom Java startup parameters Project Zomboid: sandbox settings