NotAlone – NPC Mod

Please read the description before leaving a comment.

This mod adds friendly survivor NPCs to the world of Project Zomboid.
Find companions in the lonely apocalypse, fight together, and survive.
NPC hunger, thirst, and fatigue recover automatically.
Please only worry about injuries and illness.
NPC health gradually recovers while they are stationed at the base.

───── How to Play ─────

1. Set a Base
Set a safe location as your Base from the right-click menu.
You cannot recruit NPCs until a base has been set.

2. Find and Recruit Survivors
NPCs wander around the world.
After setting a base, you can recruit them from the right-click menu.
Recruited NPCs can either follow you or wait at the base.
Following NPCs stay near the player and try to fight nearby enemies.
You can also encounter NPCs by consuming a walkie-talkie.

3. Custom NPC
You can create one Custom NPC.
After setting a base, you can create them from the right-click menu while you are inside the base.

4. Shared Storage
Shared Storage is a withdrawal-only container used to receive items collected by NPCs.
It can only be opened from the right-click menu while the player is inside the base.
NPCs stationed at the base have a low chance to collect items.
The collection interval and amount can be adjusted in the sandbox settings.
In addition, some occupations may bring back extra items through their base traits, separate from normal collection.

5. Survivor Management Notebook
This notebook contains NPC records.
It is used to restore companions’ names, status, equipment, and inventory.
There is an automatic recovery system in case it is lost, but please try to keep it with you.

6. Base Support Abilities
Some occupations have base support abilities such as healing, vehicle maintenance, generator maintenance, crop watering, and item generation.
These abilities generally only work while the player is inside the same base.
Game balance can be adjusted in the sandbox settings.

───── Occupation Abilities ─────

Each NPC occupation has different combat traits, follow abilities, and base support abilities.
Some abilities work while the NPC is following you, while others work when the NPC is stationed at your base.

Fire Officer
・Combat: axe attacks always knock down zombies.
・At base: refills rain barrels.

Police Officer
・Combat: firearms may knock down zombies.
・At base: rarely collects ammunition.

Park Ranger
・Combat: firearm range +10%.
・Following: improves nearby foraging support.

Construction Worker
・Following: increases the player’s carry capacity.

Security Guard
・At base: melee damage x1.5.
・At base: improves firearm damage and accuracy.
・At base: patrols assigned guard points.

Carpenter
・At base: has a chance to add nails.

Burglar
・Following: can help unlock doors and vehicle doors.

Chef
・At base: has a chance to add cooked meals.

Repairman
・At base: repairs doors, windows, and barricades.

Livestock Farmer
・At base: waters crops.
・At base: has a chance to add meat.

Crop Farmer
・At base: waters crops.
・At base: has a chance to add vegetables or fruit.

Fisherman
・At base: has a chance to add fish.

Doctor
・Combat: blade damage x1.5.
・At base: heals the player and NPCs inside the base.

Veteran
・Combat: improves firearm damage and accuracy.
・At base: rarely collects ammunition.

Nurse
・At base: improves healing if a doctor is at the base.

Lumberjack
・Combat: axe damage x1.5.
・At base: has a chance to add planks.

Fitness Instructor
・Combat: sports weapon damage x1.5.
・Following: increases the player’s carry capacity.

Burger Flipper
・At base: has a chance to add a fast food set.

Electrician
・At base: repairs and refuels generators.

Engineer
・At base: repairs and refuels generators.

Metalworker
・At base: has a chance to add metal materials.

Blacksmith
・At base: has a chance to add a katana.

Mechanic
・At base: repairs vehicle parts.
・At base: has a chance to add spare vehicle parts.

Tailor
・At base: has a chance to add thread or ripped sheets.

───── Player Death ─────

By default, even if the player dies, NPCs stationed at the base and the contents of Shared Storage will be preserved.
NPCs who were following the player will disappear.

───── Known Issues / Important Notes ─────

・Please back up your save data before using this mod.
・This mod can be added to an existing save, but starting a new game is recommended for better stability.
・NPCs may sometimes attack or kill zombies through walls.
・Animations are still generally unstable.
　NPCs may sometimes freeze during attack animations, and in many cases the weapon animation and the actual attack hit detection may not match properly.
・You can change NPC clothing and weapons, but the save system is still not fully reliable.
・NPC behavior and combat AI are complex, so performance may vary depending on your environment.
・Using this mod together with other NPC mods is not recommended.
・This is a personal project, and AI tools are used during development.
・I may not be able to handle advanced fixes or complex feature requests.

───── Weapon Mod Compatibility ─────

This mod can be used with various weapon mods.
If you want to optimize reload times for modded weapons, please refer to “NotAlone_CustomReloadPatch_Template.lua”.
Even without a patch, the mod will use a fallback calculation, but the balance may not be optimal.

───── Questions ─────

Build 42?
There are currently no plans to support Build 42.

Multiplayer?
There are no plans to make this mod multiplayer-compatible.

Hostile NPCs?
There are no hostile NPCs in this mod.
There are currently no plans to add them.

It doesn’t work.
I cannot investigate the issue with only that information.
I need more details, such as the error, the situation where it happened, and your mod list.
If an error appears, please close the game and check the following file:
C:Users<YourWindowsUserName>Zomboidconsole.txt
The error is usually near the end of the file.

───── Permissions ─────

You do not need to ask for permission to create modified versions of this mod.
Translations, adjustments, fixes, and separate versions are allowed.

───── Credits ─────

This mod is strongly inspired by “Superb Survivors!” and “Superb Survivors Continued”.
I respect and thank the original authors.
Please do not insult other mods in the comments.

Workshop ID: 3720923377
Mod ID: NotAlone_NPC