CS2 Reloading Plugin

Plugin Name: ILLUSION PLUGINS: CS2 Reloading

Version: 1.0

Author: illusionLabs.dev

Game: Counter-Strike 1.6

📋 Description

CS2 Reloading brings the Counter-Strike 2 fast reload mechanic to Counter-Strike 1.6. This plugin allows players to complete weapon reloads faster by quick-switching weapons during the reload animation, just like in CS2.

✨ Features

1. CS2-Style Fast Reloading - Quick-switch weapons to complete reloads faster
2. Smart Threshold System - Reload completes at 55% of the animation
3. 24 Weapons Supported - Works with all CS 1.6 reloadable weapons
4. Shotgun Protection - Automatically excludes M3 and XM1014 (shell-by-shell reload)
5. Death/Team Change Safety - Cleans up reload states on player death or team change
6. Zero Performance Impact - Optimized with safety checks to prevent crashes

🎮 How It Works

The CS2 Reload Mechanic

1. Start reloading your weapon (press R)
2. Wait until ~55% of the reload animation completes
3. Quick-switch to knife or another weapon (press Q or scroll wheel)
4. Switch back to your reloading weapon
5. ✅ Reload completes instantly - bullets are loaded!

Important Notes

1. If you switch too early (before 55%), the reload will NOT complete
2. You must switch back to the same weapon that was reloading
3. Once you return to the weapon, the reload state is cleared (prevents exploits)
4. Reload tracking is automatically cleared on death or team change

🔫 Supported Weapons

Pistols (6)

1. Glock18, USP, P228, Desert Eagle, Five-Seven, Dual Elites

SMGs (5)

1. MP5 Navy, TMP, MAC-10, UMP-45, P90

Rifles (6)

1. AK-47, M4A1, Galil, FAMAS, SG552, AUG

Sniper Rifles (4)

1. AWP, Scout, SG550, G3SG1

Machine Gun (1)

1. M249

❌ Not Supported

1. M3 & XM1014 (Shotguns) - These reload shell-by-shell and are excluded

Total: 24 weapons supported

📦 Installation

Requirements

1. AMX Mod X 1.8.2 or newer
2. Counter-Strike 1.6

Dependencies

⚙️ Configuration

Reload Threshold

The plugin uses a 55% threshold by default. This can be adjusted in the source code:

Adjustment Guide:

1. 0.50 (50%) - Easier, can switch earlier
2. 0.55 (55%) - Default, balanced
3. 0.60 (60%) - Harder, must wait longer
4. 0.70 (70%) - Very late, near completion

🔧 Technical Details

Safety Features

1. Division by Zero Protection - Validates reload time before calculations
2. Shotgun Exclusion - M3/XM1014 automatically excluded
3. Death Event Handler - Clears reload state on player death
4. Team Change Handler - Clears reload state on team switch
5. Player ID Validation - Checks valid player IDs (1-32)
6. Entity Validation - Validates weapon entities before use

How It Works Internally

1. Reload Start Tracking:
2. Ham_Weapon_Reload hook captures when player starts reloading
3. Stores: start time, reload duration, weapon ID, ammo counts
4. Weapon Switch Detection:
5. Ham_Item_Deploy hook captures when player switches weapons
6. Checks if returning to a weapon that was reloading
7. Progress Calculation:
8. Calculates elapsed time vs. total reload time
9. If progress ≥ 55%, completes the reload instantly
10. Ammo Application:
11. Uses set_pdata_int to set weapon clip ammo
12. Updates backpack ammo via cs_set_user_bpammo
13. Sends AmmoX message to update HUD
14. State Cleanup:
15. Clears reload flag when switching back to weapon
16. Prevents double-reload exploit

🎯 Weapon Reload Times

The plugin uses realistic reload times for accurate threshold calculation:

Full list available in source code

🐛 Known Limitations

1. Shotguns (M3/XM1014) - Not supported due to shell-by-shell reload mechanics
2. Threshold Timing - Switching too early will cancel the reload completely
3. Animation Visual - The reload animation will be interrupted, but bullets are added

🔒 Anti-Exploit Protection

1. Single-Use Tracking - Reload state is cleared after one switch-back
2. No Double Reload - Prevents reloading twice from one reload animation
3. Death Cleanup - State is cleared on death to prevent abuse
4. Team Change Cleanup - State is cleared when changing teams

💡 Tips for Players

1. Practice the timing - Get familiar with the 55% point for each weapon
2. Use Q for quick-switch - Bind a key for fast weapon switching
3. Watch the animation - Learn the visual cue for when to switch
4. Don't switch too early - Wait for at least half the animation
5. Works in combat - Use during firefights to reload faster

📞 Support

Developer: illusionLabs.dev

Plugin Version: 1.0

For bug reports, suggestions, or support, contact the developer.

📄 License

This plugin is provided as-is. Feel free to modify and redistribute with proper credit.

Enjoy faster reloads, just like in CS2! 🚀