# BurstFire

The `BurstFire` module limits a weapon to firing a set number of shots in quick succession before enforcing a cooldown period. Once the burst limit is reached, the weapon is temporarily prevented from firing until the cooldown expires and the shot counter resets. When `ForceFire` is enabled, the remaining shots in the burst are automatically fired after the initial trigger pull.

#### Configuration

| Value                      | Description                                                                                                                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `BurstAmount`              | The number of shots in a single burst before the cooldown is triggered.                                                                                                                     |
| `CoolDown`                 | The duration in seconds the player must wait after completing a burst before they can fire again.                                                                                           |
| `ForceFire`                | Set to `true` to automatically fire the remaining burst shots server-side after the first trigger pull. Set to `false` to require manual trigger pulls for each shot up to the burst limit. |
| `TimingBetweenForcedShots` | The delay in seconds between each automatically fired shot when `ForceFire` is `true`. Has no effect if `ForceFire` is `false`.                                                             |

#### Example

```yaml
custom_modules:
  BurstFire:
  - BurstAmount: 3
    CoolDown: 1.5
    ForceFire: true
    TimingBetweenForcedShots: 0.1
```


---

# 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://docs.uci.ucserver.it/uncomplicatedcustomitems/prerelease-content/custommodules/burstfire.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.