Project Zomboid

Project Zomboid

[B42] Knox Event Expanded NPC mod [alpha v0.3.6-2]
 This topic has been pinned, so it's probably important
Snejk  [developer] Dec 31, 2024 @ 4:17pm
4
2
6
Installation guide
The mod can be added mid save. In general, it is recommended to put the mod last in the load order, since this is what in my experience has worked the best during testing. Make sure to also look at the configuration section after installing the mod. The default memory settings for Project Zomboid are typically not enough, so you need to increase the amount of available memory. This is described in the configuration section,

Also, please keep in mind that this mod is still in development. Do not use this on saves you care about, or at the very least, take backups. Preferably, start on a clean save when trying out the mod.

New installation method (recommended)

The new installation method uses the fact that the workshop item now also includes a JAR archive. By modifying a file that Steam uses to launch Project Zomboid, it's possible to override the mod's required classes without having to modify the actual game files.

The most important thing it to figure out where your workshop directory of the mod is.
For Mac, this is typically at: ~/Library/Application\ Support/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java

For Linux, this is typically at: ~/.steam/steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java

For Windows, ii you've installed the game on the C drive on your PC, it will be at:
C:/Program Files (x86)/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded
If you installed Project Zomboid to another drive, the path typically looks roughly like this: D:/SteamLibrary/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/

NOTE: If the mod is already installed using the old method, please follow the instructions above to uninstall the mod before using the new installation method.

1. Find the file ProjectZomboid64.json in the game directory and open it with your favorite text editor e.g. Notepad.
To go to the game directory, in Steam, right-click on the Project Zomboid game and select "Manage"->"Browse local files".

2. Close to the top, there is a field called "classpath". Right below that, it says: ".", It should look roughly like this:
{
"mainClass": "zombie/gameStates/MainScreenState",
"classpath": [
".",
... // More below that is not relevant
3. Above the "." line mentioned above, add the following:
"<workshop directory>/java/KnoxEventExpanded.jar",
No backslashes are allowed. For all WIndows users, this means that you need to manually change the backslashes \ into forward slashes /.
Also, make sure to keep the same indentation as the other lines.
Finally, be sure to put the path within quotes " and end the line with a comma ,

The top of the json file should now look something like this:
{
"mainClass": "zombie/gameStates/MainScreenState",
"classpath": [
"C:/Program Files (x86)/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java/KnoxEventExpanded.jar",
".",
... // More below that is not relevant

4. Save the file.
5. Start the game using the default launch method, not alternate.
6. Remember to enable the mod.

If you struggle with the installation, feel free to ask for help in the Discord[discord.gg].

New uninstall method
  1. Open your Project Zomboid directory (In Steam, right-click on the Project Zomboid game and select "Manage"->"Browse local files".
  2. Find the file ProjectZomboid64.json and open it with your favorite text editor e.g. Notepad.
  3. Remove the line you previously added above "." (not "classpath").
  4. Save the file.
  5. The mod is now uninstalled.
NOTE: Running "Verify integrity of game files", switching to the B41 branch of the game, or completely reinstalling the game will also reset the ProjectZomboid64.json file, thus removing the mod.

How to update
No action needed. The class files are automatically updated without any action from you.

Old installation method

Windows guide

How to install
  1. Make sure you are on the unstable branch (B42) of Project Zomboid, since this mod is B42 only.
  2. Open your Project Zomboid directory (In Steam, right-click on the Project Zomboid game and select "Manage"->"Browse local files"
  3. Go to the mod workshop directory: Steam\steamapps\workshop\content\108600\3397396843\mods\KnoxEventExpanded\java
  4. NOTE: Default directory should be: C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\3397396843\mods\KnoxEventExpanded\java
  5. Copy the "knox" and "zombie" directories to your Project Zomboid directory (Default: C:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid). If you are copying to the correct directory, it will ask you to replace files. Replace the files it is asking you to replace.
  6. Start the game and remember to activate the Knox Event Expanded mod in the mod list.

How to uninstall
  1. Open your Project Zomboid directory (In Steam, right-click on the Project Zomboid game and select "Manage"->"Browse local files"
  2. Remove the "knox" and "zombie" directories.
  3. In Steam, right-click on the Project Zomboid game and select "Properties"
  4. In the properties window, go to the "Installed Files" tab
  5. Press "Verify integrity of game files"
  6. Steam will now check all files and re-download all files, restoring hem to their original state.

Mac guide
The File Finder application on MacOS cannot be used to copy the files in the same way the Windows equivalent can. It will delete files not modified by the mod, hence it's not a viable option to use this.

Instead, you will use the rsync command from the terminal. The rsync command allows you to copy all files from the workshop directory into the game directory in the same way that is default for Explorer on Windows.
How to install
  1. Make sure you are on the unstable branch (B42) of Project Zomboid, since this mod is B42 only.
  2. Subscribe to the mod and make sure it's downloaded by Steam.
  3. Open up a terminal.
  4. In the terminal, run the following command: rsync -ahP ~/Library/Application\ Support/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java/* ~/Library/Application\ Support/Steam/steamapps/common/ProjectZomboid/Project\ Zomboid.app/Contents/Java
  5. Start the game and remember to activate the Knox Event Expanded mod in the mod list.

How to uninstall
  1. Open your Project Zomboid directory (In Steam, right-click on the Project Zomboid game and select "Manage"->"Browse local files".
  2. Right click the app icon to open “show package contents” then go to “contents” -> “java”.
  3. In this directory, remove the "knox" and "zombie" directories.
  4. In Steam, right-click on the Project Zomboid game and select "Properties".
  5. In the properties window, go to the "Installed Files" tab.
  6. Press "Verify integrity of game files".
  7. Steam will now check and re-download all files, restoring hem to their original state.

How to update
Since the mod is still very early in development, which classes exist and doesn't exist might change between updates. The best option is to uninstall the mod according to the instructions above followed by installing the mod again according to the first section of this page.

Configuration
Default memory settings will typically not work with this mod. If you are using mods that loads extra assets e.g. extra items, models etc. this will be even more true.

In order for the game to have good performance even with the mod, you need to increase the amount of available memory for Project Zomboid. There are plenty of guides for how to do this if you Google it. Here's one from Reddit.

Please also keep in mind that when you reinstall the mod (meaning that you use the "Verify integrity of game files"), the increase in memory allocated to Project Zomboid is reset. You will need to reapply the same settings again in order for the memory available for Project Zomboid to be increase.
Last edited by Snejk; Aug 28 @ 11:43am
< >
Showing 16-30 of 231 comments
всё получилось спасибо за ответ
Snejk  [developer] Jan 3 @ 12:20am 
Originally posted by Hayro:
So are we have to do same procedure each time mod gets updated?
Yes, but you can use the auto-updater modification at the bottom of the original post to avoid this somewhat.
Juice Jan 3 @ 12:55am 
I have a question. I followed the steps but my game will not run, is there any fix for this?
Juice Jan 3 @ 12:59am 
Originally posted by Juice:
I have a question. I followed the steps but my game will not run, is there any fix for this?
Nevermind, I realized I wasn't on B42.
romao.mcs Jan 3 @ 3:12am 
Originally posted by Airtitght:
Hey, I'm a little concerned about having to modify my game files for this mod; why does this npc mod require editing some game files whereas the others do not?

For anyone else having the same question this message was responded to on the main forum by the creator with:
'Because the mod is implemented by modifying the engine itself and not just adding lua scripts. In order to do the things I want to do with the mod, I need to do it this way, both for performance reasons and maintainability reasons.'
So dont foking download the mod mate, hahahahh what the hell wrong with ppl these days
kArMaFPS Jan 3 @ 10:18am 
@Snejk I did the whole process through the 64.json folder so that the mod updates the folders automatically, but I just noticed that even following your step by step, the zombies folder is not being updated but only the knox folder in the game directory, something solution ?
Originally posted by limnmus:
Originally posted by Pigspotdotcom:
3397396843 dont exist for me plug
To anyone who isn't able to find the mod ID folder in the directory, I've found out why. I'm pretty sure mods for B42 are NOT located within the Zomboid directory. Instead, try going to Steam\steamapps\workshop\content\108600. You should be able to find 3397396843 in there.
That is what I did and "3397396843" was not there. Oh well.
I give up
somehow broke my game. followed the auto-update instructions, and I'm no noob to altering/replacing files; but now my game won't identify any mods or the vanilla maps so game is unplayable for now even after reinstall and validation. anyone else had this issue before?
Last edited by ᚬᛏᛁᚾ; Jan 3 @ 5:33pm
Originally posted by ᚬᛏᛁᚾ:
somehow broke my game. followed the auto-update instructions, and I'm no noob to altering/replacing files; but now my game won't identify any mods or the vanilla maps so game is unplayable for now even after reinstall and validation. anyone else had this issue before?
After reinstall you selected B42 again right? happened to me one time and i was back in stable vanilla 41after reinstalling so just saying
Virsia Jan 4 @ 4:02am 
in my opinion manual update is better xD
So, I am worried about modifying my game files, but I also love the idea of slave labored survivors. So in the immortal words of MMP. Screw it, let's do it
raptor Jan 4 @ 11:05am 
Copied and pasted the folders into the correct directory, but the game started having issues. The first time I tried launching it, the game refused to. I switched to the unstable beta which launched, and then closed out of that. I switched back to no beta version and launched the game, and now the game launches but in windowed mode with no buttons to interact with. I'll try uninstalling and reinstalling the mod...
Originally posted by raptor:
Copied and pasted the folders into the correct directory, but the game started having issues. The first time I tried launching it, the game refused to. I switched to the unstable beta which launched, and then closed out of that. I switched back to no beta version and launched the game, and now the game launches but in windowed mode with no buttons to interact with. I'll try uninstalling and reinstalling the mod...

Happened to me too. Ugh i'm frickin frustrated
Last edited by thebluefz; Jan 4 @ 11:51am
Domdom Jan 4 @ 1:05pm 
Thanks !!!
< >
Showing 16-30 of 231 comments
Per page: 1530 50