Stumble Shot (Vscript)

This mod is a request from a friend. So, this mod allows you to make zombies stumble when shot. All guns except grenade launcher have each feature to modify the stumble chance. Well, I'll explain further later on the mechanisms below.



List of features available on "stumble shot.txt" cfg file:
1.	stumble_shot_user: Which type of survivor can use "Stumble Shot" (bots/ players/ all).

2.	stumble_shot_on_common: When enabled, this allow common infected to stumble. This also works as a multiplier of weapon stumble chance (example: If you set "weapon_smg_stumble_chance" to 100 & then set "stumble_shot_on_common" to 0.1, common infected will only have 10% chance to stumble). The value is in float/ decimals. Max value = is 1.

3.	stumble_shot_on_smoker: Same as above, but this is for smoker.

4.	stumble_shot_on_boomer: Same as above, but this is for boomer.

5.	stumble_shot_on_hunter: Same as above, but this is for hunter.

6.	stumble_shot_on_spitter: Same as above, but this is for spitter.

7.	stumble_shot_on_jockey: Same as above, but this is for jockey.

8.	stumble_shot_on_charger: Same as above, but this is for charger.

9.	stumble_shot_on_tank: Same as above, but this is for tank.

10.	stumble_shot_on_witch: Same as above, but this is for witch.

11.	stumble_shot_extra_effect: When enabled, the moment the shot triggers "Stumble Shot", a special effect will be generated. Basically this is like a "hit mark" to indicate that the "Stumble Shot" hits a target.

12.	weaponname_stumble_chance: Each gun except grenade launcher has a feature representing it. This control the chance. Min value= 0 (off, no stumble), max= 100 (100%, always stumble).

13. stumble_shot_shockwave: When it's set above 0, every time stumble shot is successfully triggered, common infected near target will also stumble. Special for snipers, m60 & magnum pistol, these guns will always cause stumble shockwave when the common infected target is killed. The value also affects the shockwave radius. Value can be in decimals/ floats. Max value is 5 (5= shockwave radius is 500).



Simple mechanisms of "Stumble Shot":
•	When "weaponname_stumble_chance" is set to value above 0, the gun represented by this feature will have a chance to stumble a zombie (examples: "weapon_smg_stumble_chance = 50").

•	Specific features for specific zombies (like "stumble_shot_on_common") also work as multiplier. For example, if you set "stumble_shot_on_common" to 0.1 & then your ak47 has 50% stumble chance, the result will be the common infected having only 5% (0.1 * 50%) chance to stumble.

•	When "Stumble Shot" is triggered, the stumble is activated the moment the bullet hits a target.

•	The stumble chance of each gun can vary based on fire rate, pene tration power & number of pellets shot (for shotguns). For example, smg with 5% stumble chance will trigger stumble more often than military sniper with 5% chance. Shotguns with 5% chance will trigger stumble more often than smg with 5% chance if most or all pellets hit one target.

•	The special effect triggered by "stumble_shot_extra_effect" works on each bullet/ pellet that triggers "Stumble Shot". It means that if you shoot with a rifle that has 100% stumble chance & the bullet penetrates 3 zombies, special effect will be generated on all 3 zombies.

•	The "Stumble Shot" bypasses riot/ police zombie's armor. So, this zombie will still stumble if "Stumble Shot" is triggered even if shot from the front.


So with this mod, you can customize your guns to make them more useful when shooting lots of zombies.