> For the complete documentation index, see [llms.txt](https://vanishdev.gitbook.io/vanishdev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vanishdev.gitbook.io/vanishdev/everyday-scripts/gunjam.md).

# Gun Jam

## Features

* Weapon-specific jam chances with detailed configurations for pistols (15-25%), SMGs (24-35%), rifles (20-30%), machine guns (35-45%), shotguns (8-22%), and sniper rifles (5-10%),
* Weapon group fallback system providing default jam rates based on weapon categories when specific weapons aren't configured,
* Configurable jam duration requiring players to wait before attempting to clear jammed weapons (default: 1 second),
* Flexible check intervals allowing customization of how often jam checks occur during firing (default: every shot),
* Immersive visual effects including screen shake with adjustable intensity when weapons jam,
* Audio feedback system using GTA V's sound engine with configurable sound names and sets for jam events,
* Interactive text UI prompts guiding players to clear jammed weapons with keybind instructions,
* Comprehensive notification system with customizable messages for jam events, clearing attempts, and failure feedback,
* Manual jam clearing mechanics with success chance probability (default: 25%) and cooldown prevention of spam attempts,
* Realistic weapon clearing animations played during clearing attempts with configurable duration and blending,
* Job-based whitelisting system exempting specific professions like police, sheriff, ambulance, and mechanic from jamming,
* Identifier-based whitelisting supporting Steam, license, Discord, FiveM IDs, and ACE permission groups,
* Highly configurable settings across multiple config files for weapons, global options, whitelisting, and effects