How do I install mods in Project Zomboid?

To use mods in Project Zomboid, your server must be in the Advanced Mode. Make sure this is set before adding any mods.

As an example, we will use the mod Fluffy Hair.

Find the Workshop ID and Mod ID

For each mod you need two different entries:

• Workshop ID: The sequence of numbers that identifies the mod’s Steam Workshop entry.
• Mod ID: The internal name Project Zomboid uses to enable the mod. This does not always match the mod’s display name.

You can usually find both in the description on the mod’s Steam Workshop page, often at the beginning or end of the text. For our example mod, they look like this:

Workshop ID: 2447729538
Mod ID: FH

Enter the values exactly as shown. Put the Workshop ID on the WorkshopItems= line and the Mod ID on the Mods= line. Do not use the mod’s visible name for Mods=; use the listed Mod ID.

Add the mod to the server configuration

1. Stop your server in the 4NetPlayers customer panel.

2. Click your server’s name.

3. On the left, open the servertest.ini file.

4. In the text editor on the right, find the line WorkshopItems=.

5. Enter the Workshop ID after the equals sign. For Fluffy Hair, the line reads:

   WorkshopItems=2447729538
   

6. Next, find the line Mods=.

7. Enter the Mod ID after the equals sign. For Fluffy Hair, the line reads:

   Mods=FH
   

8. Click Save.

Add multiple mods

List multiple Workshop IDs and Mod IDs separated with a semicolon (;). Enter the values without spaces. Make sure the order of the mods matches the order of the Workshop IDs. A single Workshop entry can contain multiple mods. In that case, list all associated Mod IDs directly one after another before the mods from the next Workshop entry.

Example:

WorkshopItems=2447729538;1234567890
Mods=FH;ModID2;ModID3

If these lines already contain other mods, do not delete them. Add the new values with a semicolon. In the example, ModID2 and ModID3 both belong to the second Workshop entry.

Map mods

Map mods add new areas or maps to the game world. First, add them just like other mods: put the Workshop ID in WorkshopItems= and the Mod ID in Mods=.

Additionally, you must enter the map name on the Map= line in the servertest.ini file. You can usually find the required map name in the mod description as well. Make sure to copy it exactly. It may differ from the Workshop ID and Mod ID.

List map mods before the existing vanilla maps. A configuration might look like this:

WorkshopItems=WorkshopIDderModkarte
Mods=ModIDderModkarte
Map=NameDerModkarte;Muldraugh, KY

If a map mod lists multiple map names, enter all the names in the specified order.

Important: Add map mods before the server’s first start. They are only activated when the save is created. They have no effect on an already running save.

Start the server only after you have saved your changes. This applies to both map mods and regular mods.