> For the complete documentation index, see [llms.txt](https://renownedgames.gitbook.io/aurora-engine/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://renownedgames.gitbook.io/aurora-engine/weapon/recoil-map.md).

# Recoil System

> To create a **Recoil Map**, go to:\
> **Create -> Aurora FPS -> Weapon -> Recoil Mapping**

![](/files/-McFaxWEfpYO11ipgtzm)

![](/files/-McK-rN0Pt7HeEDUY5fg)

**Recoil Mapping** is a list of conditions and settings for the recoil of weapons based on their conditions.

{% hint style="info" %}
To add a new condition, click on the plus sign and select the player's state.
{% endhint %}

![](/files/-McK0h1dxPVGDm3jUFSs)

After selecting the player's state (they can be combined) , you need to adjust the recoil.

![](/files/-McK0LzC9RgwuGtP8pox)

{% hint style="info" %}
There are 2 types of settings:

1. Setting up the return **(Recoil)**
2. Setting the deflection of bullets from the sight **(Spread)**
   {% endhint %}

### Recoil

This represents the recoil of the weapon.

| Property         | Description                                                                                                                                                                                                                                                                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Recoil Iteration | <p>This is the pattern selection mode. </p><p><strong>Pass</strong>: The pattern will be selected sequentially and will eventually loop over the last one. <strong>Loop</strong>: The pattern will be selected sequentially and will eventually move to the beginning and so cyclically. </p><p><strong>Random</strong>: The pattern will be selected randomly.</p> |
| Recoil Duration  | This is the transition time to another vector that is described in the **Recoil** list.                                                                                                                                                                                                                                                                             |
| Recoil           | Here you can set a list of vectors that form a recoil pattern.                                                                                                                                                                                                                                                                                                      |

In Recoil, the number of vectors for the pattern is set&#x20;

Next, each vector is filled in:&#x20;

X-is responsible for horizontal recoil. A positive value moves the sight to the right.                                         Y-is responsible for the vertical recoil. A positive value moves the sight up.

### Spread

This represents the deviation of the bullets from the sight.

| Property         | Description                                                                                                                                                                                                                                                                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Spread Iteration | <p>This is the pattern selection mode. </p><p><strong>Pass</strong>: The pattern will be selected sequentially and will eventually loop over the last one. <strong>Loop</strong>: The pattern will be selected sequentially and will eventually move to the beginning and so cyclically. </p><p><strong>Random</strong>: The pattern will be selected randomly.</p> |
| Spread           | Here the pattern of deflection of bullets is set.                                                                                                                                                                                                                                                                                                                   |

The **Spread** specifies the number of elements for the pattern\
Then each element is filled in:

![](/files/-McKiKJknlPAFMSuuU4i)

| Property | Description                                                          |
| -------- | -------------------------------------------------------------------- |
| X Axis   | Here you can set the horizontal range of bullets from **X** to **Y** |
| Y Axis   | Here you can set the vertical range of bullets from **X** to **Y**   |

### Shake Settings

Setting the camera to swing when shooting.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://renownedgames.gitbook.io/aurora-engine/weapon/recoil-map.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.