Silencer switching special effects

Add or remove suppressors for supported weapons with a single keystroke or controller button, including full animations, sound effects, and purchase check functionality.

Toggle Suppressor FX

**Toggle Suppressor FX** is a lightweight scripting mod that allows you to attach or remove suppressors to compatible weapons **at any time** in the game. 🎮

This mod adds a complete animation immersion system, which will check whether you actually purchased the silencer, play first-person animations and sound effects, and support both **keyboard** and **gamepad** operations.

This is a small but extremely useful immersion-enhancing mod for players who want more flexibility in controlling weapon customization during gameplay. ✨

---

✨ Core Functions

• **One-Click Suppressor Switch**: Quickly install/remove suppressors on supported weapons.
• **Full platform support**: Perfectly compatible with **keyboard** and **handle** operations.
• **Immersive experience**: Optional animations and sound effects enhance the sense of immersion.
• **Purchase Verification**: If you have not purchased the silencer, it cannot be installed, which is consistent with game logic.
• **Clear Feedback**: Provides clean operational feedback via on-screen subtitles.
• **Highly Configurable**: Fully customizable via INI file.

🎮 Operation Control

• **Keyboard**: Default keys **K**
• **Controller**: Default button **Direction key left**

💡 Tip: The above buttons can be freely configured in the INI file.

📥 Installation Guide

• **Install ScriptHookV**
• **Install ScriptHookVDotNet Enhanced**
• Place the **ToggleSuppressorFX.dll** file and **ToggleSuppressorFX.ini** configuration file into your `Grand Theft Auto V Enhanced\scripts` folder (please create it yourself if it does not exist).

---

📜 Update log

**v1.1**

• Improved silencer detection for more weapons.
• Enhanced the filtering mechanism for handle input.
• Animation loading and timing are more reliable.
• INI file parsing is safer and comes with alternate defaults.
• Overall stability and performance improvements.

**v1.0**

• Initial release.
• Implement silencer switching function (keyboard + handle).
• Contains optional animations and sound effects.
• Add purchase verification.
• Complete INI configuration file support.

---

🙏 Acknowledgments

Thanks to the GTA V modding community for the documentation and code references.