> For the complete documentation index, see [llms.txt](https://akila.gitbook.io/fps-framework/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://akila.gitbook.io/fps-framework/tutorials/character/firearm/other/spray-pattern.md).

# Spray pattern

A scriptable object that represents the spray pattern of the firearm.

A **spray pattern** is preset data for the firearm that helps improve the player's muscle memory. As players use the weapon more, they learn the spray patterns, making the game easier to master.

To create a spray pattern, start by opening the **Create Asset** menu. Right-click in the Project window, then go to **Akila > FPS Framework > Weapons > Spray Pattern**. This will generate a new spray pattern asset, and here's what you should see once it's created:

<div align="left"><figure><img src="https://512600823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLQgz9gGwkU5HhRwKT3te%2Fuploads%2F1XqxaUCSgX08D1qq8vPI%2FScreenshot%202025-04-12%20190808.png?alt=media&amp;token=7d175632-4739-4026-b385-ab74da7a9f69" alt="" width="547"><figcaption><p>Newly created spray pattern</p></figcaption></figure></div>

## Fields

<table><thead><tr><th width="218">Name</th><th>Description</th></tr></thead><tbody><tr><td>Total Amount</td><td>The <strong>power</strong> of the spray pattern determines how wide the spray is. The higher the value, the wider the spray will be, causing the bullets to spread more. A lower value results in a more concentrated spray.</td></tr><tr><td>Passive Multiplier</td><td>The <strong>minimum spray</strong> represents the starting point for the bullet spread. As you shoot, the spray increases, causing the bullets to spread more. When you stop shooting, the spray resets back to this minimum value, helping to control the weapon's accuracy.</td></tr><tr><td>Ramp-Up Time</td><td>The <strong>time taken</strong> to go from the maximum spray to the minimum spray. Determines how quickly the bullet spread resets after you stop shooting. A shorter time will cause the spread to return to the minimum quickly, while a longer time will make the reset slower.</td></tr><tr><td>Is Randomized</td><td>If the spray pattern is <strong>not randomized</strong>, the curves will be used instead to define the bullet spread. When the spray pattern is randomized, the spread will vary with each shot based on the pattern data.</td></tr><tr><td>Vertical recoil</td><td>Refers to the upward movement of the firearm when firing, typically caused by the force of the shot.</td></tr><tr><td>Horizontal recoil</td><td>refers to the sideways movement of the firearm when firing, typically caused by the force of the shot.</td></tr></tbody></table>

{% hint style="success" %}
To use the spray pattern, assign it to the **"Spray Pattern"** or **"Aim Spray Pattern"** field in the firearm preset of your gun.
{% endhint %}