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