Source-checkedQuality of life & UI

Universal Gun Repair

by Cosmic · for Project Zomboid

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…

413KDownloads
11 mo agoLast updated
Steam WorkshopSource

About Universal Gun Repair

From Steam Workshop

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…

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 data

Footprint

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

LoaderGame versionsNewest
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 catalog
Listed on Steam Workshop as “QoL”

Quality 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

Universal Gun Repair, answered

Generated from the mod’s own source data.

Is it free?

Yes. Universal Gun Repair is free to download from Steam Workshop.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Universal Gun Repair on a Project Zomboid server.

Deploy in about a minute from $9.00 a month, then add Universal Gun Repair in one click.