dirty gun explosion

Dirty guns explode—right in your hands. Clean them or you risk spontaneous disintegration. NPC? Yes... they can explode too.

Dirty Guns Explode

🎯Mod Overview

This lightweight mod significantly improves the immersive experience of the game, adding realistic maintenance mechanics and risk elements to the weapon system.

⚙️ How it works

Core Mechanism

• **Weapon Explosion System**: A weapon may explode when its durability drops to about 50% (thresholds are different for different weapon types). Although it can still be fired, the dirtier the weapon, the higher the risk of catastrophic failure
• **Barrel Cracking System**: Introduces random events, which may trigger barrel cracking when shooting, reducing weapon durability and affecting performance

Detailed features

• Random damage multiplier ranging from 0.1 to 1
• **Residue and Dirt Accumulation**: Residue and dirt accumulate with every shot, causing performance degradation over time
• The degree of dirtiness of the weapon affects recoil, jamming probability and misfire probability
• **Environmental Impact**: Certain environments will accelerate the accumulation of dirt, leading to faster degradation
• Warm environments increase the possibility of explosions
• Cold conditions make weapons more fragile, increasing the risk of mechanical failure or barrel cracking
• **Dynamic Recoil Adjustment**: Dynamically adjust recoil mode based on weapon dirtiness and overall condition
• Poorly maintained firearms exhibit more unpredictable and exaggerated recoil patterns, making shooting more difficult to control

🎮 Recommended matching modules

• Unrestricted Shooting ~ KristianD3
• Injuries Overhaul ~ bolmin70
• Realistic Accuracy ~ RobGrant
• Ped Accuracy Overhaul ~ wickedhorseman
• Munitions - Weapon Overhaul and Ammunition Rebalance ~ Wockenheimer
• Flo ~ WickedHorseman
• Iron-Sight (1st person gun FOV fix) ~ WickedHorseman
• NITRO ~ WickedHorseman
• W.E.R.O (Western Euphoria Ragdoll Overhaul) A.C.P ~ VolaticWolf
• R.W.A.O. (Realistic Weapon Audio Overhaul) ~ Oakous
• All Weapon Models ~ Oakous
• Dismember Everyone ~ GetGibbed
• Colorful Weapon Icons ~ KristianD3
• Colored Loading ~ wickedhorseman

⚡ Explosion type configuration

You can modify the explosion type in the INI file:

```ini

[ExpoType]

pistol_expo_type = 23

shotgun_expo_type = 23

revolver_expo_type = 23

rifle_expo_type = 23

sniper_expo_type = 23

```

💡 Note: Changing the explosion type will not change the particle effects, but will modify the sound and visual effects. For example, setting the molotov number will ignite the target

🤕 NPC knockdown mechanism

To enable PED being knocked down (draining health while on the ground) instead of the standard ragdoll effect, modify:

```ini

[Ped]

disable_damage = 0

```

Setting disable_damage = 0 introduces a random chance for the explosion to cause damage, and possibly a critical hit

🔮 Future Plans

• **Special ammunition for gang enemies**
• Opportunity to loot "spiced rounds" from gang NPCs
• Special ammunition will cause more damage to the weapon's condition and accelerate wear and tear
• Has a higher chance of explosion or barrel damage
• Ammo obtained from enemies is tracked separately from player-purchased or "safe" ammo

• **Gun Jam System**
• Based on usage and condition, firearms may jam rather than immediately catastrophic failures

-Added squib loads (bullets that fail to fully exit the barrel), increasing risk and requiring concern

• **Misfire mechanism**
• Each reload or action cycle has a random chance of misfire, affected by weapon condition and ammunition quality
• misfire will trigger smoke effect as visual feedback
• misfire may cause NPCs (possibly including players) to drop weapons, introducing tactical consequences

---

🙏 Acknowledgments

• Thanks to Brofield/Simple_INI, a powerful and cross-platform C++ library
• Thanks to Femga/RDR3_Discoveries for the extensive documentation and discoveries
• Thanks to Hale …