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] 31 Dec, 2024 @ 4:17pm
4
2
5
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.

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.

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.

New installation method
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.

First, you need to find the workshop directory.
If 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/

  1. 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.
  2. 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".
  3. Close to the top, there is a field called "classpath". Right below that, it says: ".",
  4. Above the "." line mentioned above, add the following:
    "<workshop directory>/java/KnoxEventExpanded.jar",
    NOTE: Windows paths normally contains backslashes \. All of these must be replaced with forward slashes /. Otherwise the game will not start.
  5. 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",
    ".",
    "commons-compress-1.27.1.jar",
    ... // More below that is not relevant
  6. Save the file
  7. The mod is now installed and will automatically update together with the workshop item itself.

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.

New update method
No action needed. The class files are automatically updated without any action from you.

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; 4 Aug @ 6:31am
< >
Showing 196-210 of 222 comments
Josh0706 30 Jun @ 8:09am 
used and loved this mod plenty in the past, however after reinstalling for the ragdoll update of b42 my game launches and leaves me locked in the main menu w/out any menu options
Originally posted by Josh0706:
used and loved this mod plenty in the past, however after reinstalling for the ragdoll update of b42 my game launches and leaves me locked in the main menu w/out any menu options
Happens to my game too, waiting for the fix :D
Mr.Mike 30 Jun @ 12:09pm 
I'm also getting the locked mainmenu without options. This is the error that shows up when starting the game. It only happens when replacing zombie and knox files. Validating the game for original files with knox enabled still works it's only something with the new class files.

LOG : General f:0, t:1751310078337> -----------------------------------------
STACK TRACE
-----------------------------------------
function: create -- file: MapSpawnSelect.lua line # 806 | Vanilla
function: instantiate -- file: MainScreen.lua line # 700 | Vanilla
function: addToUIManager -- file: ISUIElement.lua line # 1368 | Vanilla
function: LoadMainScreenPanelInt -- file: MainScreen.lua line # 2114 | Vanilla
function: LoadMainScreenPanel -- file: MainScreen.lua line # 2004 | Vanilla

ERROR: General f:0, t:1751310078347> ExceptionLogger.logException> Exception thrown
java.lang.RuntimeException: attempted index: ENGLISH of non-table: null at KahluaThread.tableget(KahluaThread.java:1667).
Stack trace:
se.krka.kahlua.vm.KahluaThread.tableget(KahluaThread.java:1667)
se.krka.kahlua.vm.KahluaThread.luaMainloop(KahluaThread.java:479)
se.krka.kahlua.vm.KahluaThread.call(KahluaThread.java:173)
se.krka.kahlua.vm.KahluaThread.pcall(KahluaThread.java:1963)
se.krka.kahlua.vm.KahluaThread.pcallvoid(KahluaThread.java:1790)
se.krka.kahlua.integration.LuaCaller.pcallvoid(LuaCaller.java:66)
se.krka.kahlua.integration.LuaCaller.protectedCallVoid(LuaCaller.java:139)
zombie.Lua.Event.trigger(Event.java:72)
zombie.Lua.LuaEventManager.triggerEvent(LuaEventManager.java:281)
zombie.gameStates.MainScreenState.enter(MainScreenState.java:394)
zombie.gameStates.GameStateMachine.update(GameStateMachine.java:123)
zombie.GameWindow.logic(GameWindow.java:382)
zombie.GameWindow.frameStep(GameWindow.java:916)
zombie.GameWindow.mainThreadStep(GameWindow.java:642)
zombie.MainThread.mainLoop(MainThread.java:76)
java.base/java.lang.Thread.run(Unknown Source)
Mod worked great for like 3 days then it started crashing. I tried uninstalling like instructed, but now the 108600 folder doesn't exist.
KirrieD 11 Jul @ 5:21pm 
Originally posted by ABALDUY:
блин кто нибудь сделайте гайд на русском

Братан, мод не работает больше. Я сделал все правильно и в итоге он был мертв в утробе матери зомбойда.

Короче, выдает ошибки прогрузки "Зомби". Тем более из-за того, что изменяются ванильные файлы, придется удалять все через "Проверку игры на целостность".

Нужно походу ждать, когда челик восстановит все.
KirrieD 11 Jul @ 5:23pm 
Originally posted by KirrieD:
Originally posted by ABALDUY:
блин кто нибудь сделайте гайд на русском

Братан, мод не работает больше. Я сделал все правильно и в итоге он был мертв в утробе матери зомбойда.

Короче, выдает ошибки прогрузки "Зомби". Тем более из-за того, что изменяются ванильные файлы, придется удалять все через "Проверку игры на целостность".

Нужно походу ждать, когда челик восстановит все.


Я так же попробую установить чисто только этот мод и проверю, что такое. Может получится запустить. Но в целом, скорее всего ...уй там плавал :)
KirrieD 11 Jul @ 11:27pm 
Originally posted by Villrok:
C:\Program Files\Steam\steamapps\common а дальше не чего нету!
если создаю папку и кидаю то в игре всё равно идут ошибки


У тебя 1 HHD или SSD ?

Если у тебя на основном диске в стиме нет папки, значит ищи "Steam Libery", эта папка создается, когда ты назначаешь иное место хранения данных скаченных со стима
KirrieD 12 Jul @ 2:09am 
Для Русско говорящего населения планеты!
Я создал небольшой гайд, надеюсь он достаточно подробно все описывает.
Так же решил проблемы, с которыми столкнулся.

Можете тут в обсуждениях найти "ГАЙД + ТЕСТ" или вот ссылка: ГАЙД + ТЕСТ
I encountered an error where everything was installed correctly, but when I enabled the mod, an error occurred stating that the mods were missing. When I enabled the new game world, the NPCs were not loaded, and the game simply started running with the mod's features.
crizis199 19 Jul @ 11:25pm 
How to install a mod on a steam deck?
VulDev 24 Jul @ 5:19am 
If you are trying to play this mod on Mac and it's just loading for you after trying to insert the Npc's. Tried this slightly modified version of the terminal code that worked for me.

Command :
rsync -ahP "$HOME/Library/Application Support/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java/" "$HOME/Library/Application Support/Steam/steamapps/common/ProjectZomboid/Project Zomboid.app/Contents/Java/" copy and paste whole command directly into terminal.
The phrase
Originally posted by Snejk:
"C:/Program Files (x86)/Steam/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java/KnoxEventExpanded.jar"
is only an example I think.
If your mod is not downloaded into disk C, then you need to change the location manually.
For example, I'm using disk D for steam, then it should be:
"D:/SteamLibrary/steamapps/workshop/content/108600/3397396843/mods/KnoxEventExpanded/java/KnoxEventExpanded.jar",

I guess that should work, at least I'm not encountering the errors after changing the path.
I'm not a native English user, so maybe I used some wrong words. But I think I'm not getting guys confused?
Last edited by Give you up, Let you down; 27 Jul @ 10:31am
@Snejk, it needs to be noted that any modification to files in the games root folder, in files such as ProjectZomboid64.json, will be reset when Steam validates the game files. This can be used to uninstall the new method to load the jar class file, but also means it requires to redo this installation method when Steam has replaced it after validation. I am not 100% but I think even small game updates do reset these files. I am sure though that validation resets any modification, including custom ram settings.
the new instalation doesnt make sense, where is the json file? it just says find it
Originally posted by SENSITIVENANNIES:
the new instalation doesnt make sense, where is the json file? it just says find it
It clearly explains how to easily find it, and where to find it:
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".

Also in my comment just before yours it could have been deducted where it is to find.^^
< >
Showing 196-210 of 222 comments
Per page: 1530 50