Subscribe to download
Breakable Guns (Vscript)

Well, this mod is a request, & at the same time to complement a mod about "Melee Can Break". There's melee, so, why wasn't there one for guns? So, here's the mod for that.

Now, this is a complete version. All features are working. Only some minor updates are left.

So, about this mod. This mod allows you to set break probability on each gun, including pistols. There are 4 "Weapon Break Levels" that will be triggered, & weapon only breaks when it reaches "Weapon Break Level 4". The rest of info will be explained on the mechanisms below.

1. weapon_break_mode: This is to enable weapon break feature. Set it to 1 to enable it.
   
   
2. weapon_break_user: On which type of survivor the breakable guns will be applied (bots only/ players only/ all).
   
   
3. weapon_break_type: Which type of weapon break will be applied. This affects the final results on "Weapon Break Level 4", whether it's a "Total Ammo Loss" (ammo clip & reserve ammo are set to 0) or "Complete Destruction".
   
   
4. weapon_repair_duration: How long the "Full Repair" will take in seconds. The "Full Repair" will decrease the "Weapon Break Level" to one level.
   
   
5. weapon_fatal_break_multiplier: The multiplier for "Fatal Break". "Fatal Break" is a serious damage that instantly increases "Weapon Break Level" to one level. This one is in decimals (so you can set it to 0.3, 0.5 etc). Min value = 0, max= 1 (always triggers "Fatal Break").
   
   
6. allow_stumble_on_weapon_break: This controls whether survivor will stumble or not when guns break or get jammed.
   
   
7. allow_bot_weapon_to_break: This controls whether bot's guns can break or not. If it's set to 0, bot's guns will only get jammed.
   
   
8. reaction_on_weapon_break: When enabled, survivors will react via voicelines when their guns are jammed or broken.
   
   
9. weaponname_break_chance: Actually there are 19 more features, but I wrote this way instead as the rest of 19 feature represent each weapon (like "weapon_smg_break_chance", "weapon_pistol_break_chance" etc). This control the break probability of "Normal Break" & also affects "Fatal Break" if "weapon_fatal_break_multiplier" isn't set to 0. Min= 0 (no weapon break), max= 100 (100% chance to break).

• Each weapon break chance is controlled by each feature representing it.
  
  
• The break probability is rather tricky, like, even on 10% chance, the "Weapon Break" can still be triggered quite frequently. & it's completely random, like, even on 10% chance, there's a chance when the first shot will cause the gun to trigger "Weapon Break". So, it's recommended to set the value lower than 10 in case if you want to do some balancing on some guns.
  
  
• When "Weapon Break" is triggered, some special effects will show up depending on how serious the damage on the gun is. "Weapon Break Level 1" & "Weapon Break Level 2" only show small sparks when triggered, but "Weapon Break Level 3" will show more sparks, & "Weapon Break Level 4" will show small explosion (but it deals no damage).
  
  
• When "Weapon Break" is triggered, the survivor with the damaged gun will stumble backward. An instructor hint follows soon.
  
  
• "Weapon Break" will cause a "Jammed Gun" state that makes the survivor unable to shoot & even switch to other items. This can only be cancelled by pressing "RELOAD" button.
  
  
• There are 2 types of "Weapon Break": "Normal Break" & "Fatal Break". "Normal Break" will make the gun jammed & can be repaired by reloading. As for "Fatal Break", this is controlled by "weapon_fatal_break_multiplier". The chance to trigger "Fatal Break" is equal to "weapon chance * fatal break multiplier". For example, if you set smg chance to 10 (10%) & "weapon_fatal_break_multiplier" to 0.2, you'll get 10% chance of "Normal Break" & 2% chance of "Fatal Break" on each shot,
  
  
• There's "Full Repair" feature when survivor holds "E (Use) + RELOAD" combination keys. A notification about the time left until the "Full Repair" finishes will show up. If these combo keys are released before the timer reaches 0, the "Full Repair" will be cancelled & reset back to the full duration. "Full Repair" will decrease "Weapon Break Level" to one level, & this can't be spammed. It means that after fixing, you need to get your gun jammed first before you can do "Full Repair" again.
  
  
• When "Weapon Break Level 4" happens, the final results of the weapon break depend on the value set on "weapon_break_type". If it's set to 0, primary gun will lose all ammo (ammo clip + reserve ammo) & pistol will have the ammo clip locked to 1 (you'll only have 1 ammo clip on each reload). This state can be restored by picking ammo piles. If "weapon_break_type" is set to 1, triggering this Level 4 will result in complete destruction of the gun. Even pistol will be removed from inventory (if you use this mode, it's recommended to disable pistol break chance so you won't lose both guns & become a punching bag for zombies :D ).
  
  
• When "weapon_break_user" is set to allow bots to have their guns broken, bots will automatically repair their jammed guns on each "Weapon Break" triggered, but they can't do "Full Repair", for now. Maybe I'll update this later to make bots do automatic "Full Repair" as they can't press "E + RELOAD".

So, with this mod, you'll get another new challenge in fighting zombies, as now your guns have durability.

• A video preview & animated previews will be added later.