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

# Introduction

## Overview

***

**Adaptive Recoil & Spread (ARS)** is a professional-grade Unreal Engine 5 plugin developed by **Alemdar Labs**, purpose-built to transform how weapon mechanics are designed, visualized, and executed across all gameplay perspectives — **FPS, TPS, VR, and even 2D**.

Whether you're crafting a modern tactical shooter, an immersive VR experience, or a stylized mobile game, ARS delivers the control, flexibility, and polish required to achieve **AAA-level weapon behavior** with **minimal development overhead**.

{% embed url="<https://www.youtube.com/watch?v=4KxZYDnKOnc>" %}

<p align="center"><em>See ARS in action – weapon recoil patterns, spread tuning, and multiplayer sync</em></p>

***

### ✨ Key Benefits

* 🔧 **Designer-Friendly**: Use intuitive in-editor tools to define behavior visually. No need to write a single line of code to create polished results.
* ⚙️ **Developer-Powered**: Full access to C++ source and Blueprint API ensures deep integration and customization when needed.
* 📊 **Performance Verified**: Lightning-fast weapon updates across all platforms — even mobile.
* 🌐 **Multiplayer Ready**: Built with client-side prediction and server-side validation — thoroughly tested in 100+ player scenarios.

***

### 🚀 Core Highlights

✅ **Cross-Platform Support**: PC, Console, VR, and Mobile\
✅ **Context-Sensitive Behavior**: Reacts to player stance, movement, attachments\
✅ **Advanced Debugging**: Visual tools, network reconciliation, and profiling\
✅ **Reusable Patterns**: Design once, apply across multiple weapons\
✅ **Seamless UE5 Integration**: Works out of the box with projects like Lyra

***

### 📊 Verified Performance (60 FPS baseline)

| Platform | Avg. Update Time | Max Supported Weapons |
| -------- | ---------------- | --------------------- |
| Windows  | 0.015ms          | 150+                  |
| Android  | 0.038ms          | 75+                   |
| iOS      | 0.041ms          | 65+                   |
| Consoles | 0.025ms          | 100+                  |

{% hint style="info" %}

## ⚡ Optimized for large-scale combat: Lightweight runtime lets you simulate 100+ weapons per frame without performance loss.

{% endhint %}

***

### ⚙️ Technical Overview

| Category        | Details                                                                 |
| --------------- | ----------------------------------------------------------------------- |
| **Platforms**   | Windows, Linux, macOS, Android, iOS, PlayStation, Xbox, Oculus, SteamVR |
| **UE Version**  | Unreal Engine 5.1+                                                      |
| **Network**     | Dedicated server support, stress-tested for 100+ players                |
| **Code Access** | Full C++ source + Blueprint integration                                 |

***

### 🚀 Get Started in Minutes

1. **Install** via [Marketplace](/adaptiverecoilandspread/getting-started/installation.md#method-1-marketplace-installation) or [manual plugin import](/adaptiverecoilandspread/getting-started/installation.md#method-2-manual-installation)
2. **Explore** playable demos (Windows):
   * [Lyra](https://drive.google.com/file/d/1dyA0TJ_7QP518QjoTmeNqomhFBphkVds/view)
   * [FP](https://drive.google.com/file/d/10-cxkKsTBi2JISez--T6yUcCJLnMJD1O/view)
   * [VR](https://drive.google.com/file/d/1UR5FmBkNK6JKzjzuKFs-gGyJHuJU13HX/view)
3. **Join** our developer community:\
   [![Discord](https://img.shields.io/badge/DISCORD_SUPPORT-5865F2?style=for-the-badge\&logo=discord\&logoColor=white)](https://discord.gg/dQ6NYSnD)


---

# 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://alemdarlabs.gitbook.io/adaptiverecoilandspread/readme.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.