A full-scale custom firearm mod for Project Zomboid, replacing vanilla guns and introducing a modular, dynamic weapon system.
This mod includes new firearms, attachments, melee variants, and mechanics, designed to enhance gameplay and offer a powerful base for other modders to build on.
This is the final Build 41 version, preserved here for multiplayer compatibility and servers not yet ready for Build 42.
⚠️ Please do not reupload, fork, or include this mod in modpacks without explicit permission from the creator.
- Overhauls all vanilla firearms, magazines, boxes, and attachments
- Custom models, textures, sounds, and unique visual identities
- Firearm Cleaning System: Use a cleaning kit and lubricant to restore weapons
- Ammo Cans: Randomized ammo types inside reusable metal cans
- Fire Mode Toggle: Switch between semi, burst, or auto fire
- Weapon Lights: Functional, toggleable flashlights on firearms
- Radial Menu & Hotkeys for intuitive firearm control
- Sandbox Tuning: Adjust damage, recoil, aim time, crit chance, and more
- All firearms can be used as melee weapons (while retaining attachments, ammo, and condition)
- Seamless switching with custom animations and balance tuning
- Comes with Hayes Firearms Extension (HFE), which adds additional guns, gear, and attachments
- Built to support community add-ons and modular expansions
- ✔️ Compatible with Project Zomboid Build 41
- ❌ Not updated for Build 42 yet (due to major changes in firearm and animation systems)
A full Build 42-compatible version is in the works and will be maintained on the
mainbranch of this repository.
This repository contains two components:
/HFO/media/lua: Core weapon logic and systems/HFO/media/scripts: Firearm and item definitions
/HayesFirearmsExtension/media/lua: Optional add-on scripts/HayesFirearmsExtension/media/scripts: Additional guns and attachments
-
Download the Build 41 release:
👉 Release vB41.0
Or Download ZIP directly -
Extract the folder(s) to your Project Zomboid mods directory: C:\Users\YourUsername\Zomboid\mods\
-
Launch the game and enable the mod(s) via the Mods menu
Hayes Firearms Overhaul is built from the ground up for customization, realism, and variety, whether you're running a realistic military playthrough, gritty roleplay, or simply want more satisfying firearms in PZ.
The Build 41 version is preserved here for legacy multiplayer support.
Build 42 support is currently under development and will take advantage of new animation systems, weapon layers, and updated sandbox parameters.
This mod is provided for reference and personal use only.
Do not copy, modify, redistribute, or repackage this mod without explicit permission from the creator.
Workshop ID: 2950018687
Mod ID: HayesFirearmsOverhaul, HayesFirearmsExtension
- ✅ Build 42 Overhaul (in progress)
- ✅ Modular compatibility with B42's firearm tags, mounts, and cleaning systems
- ✅ Retuned sandbox variables for modern balance
- ✅ Dynamic gun model systems (thanks to Bikinihorst!)
- ✅ Expanded documentation for modders and server admins
This mod wouldn’t exist without the incredible support of the Project Apocalypse Community.
Special Thanks To:
Cyridius, DeZee, Zee, Vernage, Bonelesswoof, Deek, Cadence, Fairda, Ghost Slayer, ChiefBacon, Javi-Juice, Smiley, Starwarzjunky, Altah, OrunisZetak, Clickeh, Wild, The Law, A_Secret_Lizard, Ghost Recon, Phalanx, Reltiax, Jagata, Zero1st, Maxito, Jonker, RidingHood, Epsilon29, Uriel, Alyssura, Riccio, Shadow, Snaz, Sharknado, Hellen
Special Gratitude:
- The Indie Stone – For creating Project Zomboid
- Bikinihorst – For constant support and the dynamic model swap structure that made HFO possible
If you enjoyed this mod and want to support my future creations, feel free to donate a Ko-fi.
Every bit helps and means a lot! 💙
And if you liked the mod, don’t forget to rate it on Steam!
---
*Thank you for exploring Hayes Firearms Overhaul! 🛡️🔫💥