# 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

## Preview

{% embed url="<https://www.youtube.com/watch?v=ug9ZF-69As0>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vanishdev.gitbook.io/vanishdev/everyday-scripts/gunjam.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
