About Universal Gun Repair
From Steam WorkshopA mod to add a method of restoring all guns whether from the base game or any mod. Overview Any gun can be restored using the process of disassembling, cleaning/repairing, and then reassembling. This…
A mod to add a method of restoring all guns whether from the base game or any mod.
Overview
Any gun can be restored using the process of disassembling, cleaning/repairing, and then reassembling. This mod is safe to add mid-game but you will need to visit new locations to find the items added by this mod as loot. If you decide to remove the mod, you should reassemble any gun parts before doing so or they will be lost.
Items added by this mod are Firearm Maintenance Kit Gunsmithing Tools Cleaning Solvent Premium Cleaning Solvent Firearm Lubricant
Disassembly
Using either a Firearm Maintenance Kit or a set of Gunsmithing Tools along with a Screwdriver, break down the gun into parts Note: Any loaded ammo, inserted magazines, or installed gun mods will be removed from the gun before disassembly The Disassembled Gun Parts will be named "{Original Gun's Name} Parts [{Current Condition}/{Max Condition}]" and will encumber you 20% more than the original gun From this point you can Clean, Repair, or Reassemble the gun parts
Cleaning
Cleaning requires a Firearm Maintenance Kit, some Cleaning Solvent, and a Ripped Sheet Additionally the gun may need at least a certain amount of Condition remaining to be able to restore Condition through cleaning (by default 5, though this is configurable in the Sandbox options) Cleaning will restore as much Condition as you have Solvent for A normal Cleaning Solvent has 10 uses and will restore 1 point of Condition per use it has remaining A Premium Cleaning Solvent has only one use but will restore all Condition when cleaning
Repairing
Repairing requires a set of Gunsmithing Tools and Scrap Metal You may need a certain level of skill in Firearm skills (Aiming or Reloading) before you are able to repair guns (default 6, though this is configurable in the Sandbox options) Additionally the gun may need at least a certain amount of Condition remaining to be able to restore Condition through repairing (by default 0 so even broken guns can be repaired, though this is configurable in the Sandbox options) Each Repair will consume 1 Scrap Metal and restore 1 Condition
Reassembly
Once you are ready to put the gun back together simply use Firearm Maintenance Kit or a set of Gunsmithing Tools along with a Screwdriver and a use of Firearm Lubricant to put the gun parts back together
Sandbox Options
In the Sandbox Options you are able to set The minimum level of Condition on a gun to be able to restore Condition through cleaning (default 5) The minimum level of Condition on a gun to be able to restore Condition through repairing (default 0) The required skill level in Aiming or Reloading to be able to perform repairing (default 6) And adjust the rarity of Firearm Maintenance Kits, Gunsmithing Tools, Cleaning Solvents, and Firearm Lubricants.
Compatibility
This mod should be compatible with all guns added by mods. I've tested it with Brita's and Vanilla Firearms Expansion. Please let me know if you encounter any incompatible guns.
Should modders want to allow their items to work as alternative restoration items for Universal Gun Repair Items tagged with UGRToolClean will be able to be used as a tool to clean guns Items tagged with UGRItemClean will be able to be used as a consumed item to restore 1 Condition per use when cleaning guns Items tagged with UGRItemCleanFull will be able to be used as a consumed item to restore all Condition per use when cleaning guns Items tagged with UGRToolRepair will be able to be used as a tool to repair guns Items tagged with UGRItemAssemble will be able to be used as a consumed item to reassemble guns
Special Thanks
Spanish translations courtesy of XpaDDer Russian translations courtesy of Avelavi Brazilian Portuguese translations courtesy of gccoiahy Italian translations courtesy of TheSanctuary0 Korean translations courtesy of BLUmountain Thai translations courtesy of Riko Prushka
Check out my other mods
Workshop ID: 2899457928 Mod ID: 2899457928/UniversalGunRepair Mod ID: UniversalGunRepair
Highlights
From source dataFootprint
Rated a light load on a server.
Last update
Its author last shipped an update 11 mo ago.
Universal Gun Repair on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Project Zomboid servers. We download it from Steam Workshop, place it, and restart the server.
- Server load
- light
- Smallest plan we suggest
- Project Zomboid — 6 GB (6 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2025-12-19, released 2025-12-19
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Workshop |
From 1 recorded build of Universal Gun Repair.
Run Universal Gun Repair on a Project Zomboid server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Compatibility
- Game
- Project Zomboid
Verified at the source
- ✓Steam WorkshopOfficial listing, checked 2026-11-01Open ↗
- ✓AuthorCosmic, as published on Steam Workshop
- ✓LicenseNot published by the sourceFree






