> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dietrich-development.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Weapon progression system with skill-based damage, recoil, and accuracy scaling for RedM servers

A weapon progression system that dynamically scales weapon damage, recoil, and accuracy based on player skill levels. Features include customizable progression curves, per-weapon modifiers, and realistic reload mechanics.

<Info>
  This script rewards player skill and creates meaningful progression through customizable damage, accuracy, and recoil scaling.
</Info>

## Features

<Columns cols={2}>
  <Card title="Skill-based progression" icon="chart-line">
    Weapon stats scale dynamically based on player skill levels, creating meaningful progression from novice to expert.
  </Card>

  <Card title="Customizable curves" icon="bezier-curve">
    Support for linear, exponential, and custom progression curves to match your server's progression style.
  </Card>

  <Card title="Per-weapon modifiers" icon="crosshairs">
    Individual weapon damage and recoil multipliers for fine-tuned balance across different weapon types.
  </Card>

  <Card title="Realistic reload mechanics" icon="rotate">
    Skill-based reload failure system with configurable failure rates and speed modifiers.
  </Card>

  <Card title="Accuracy and recoil control" icon="bullseye">
    Dynamic accuracy improvement and recoil reduction based on player skill progression.
  </Card>

  <Card title="Framework integration" icon="gears">
    Compatible with VORP Core and RSG Core frameworks with modular framework bridge support.
  </Card>
</Columns>

## Limitations

* **Weapon compatibility**: Only works with weapons that support the configured stats
* **Progression range**: Values outside the min/max level range are clamped
* **Custom values**: Must define all required stats for each custom level
* **Reload mechanics**: Reload speed factor affects firing delay, not animation speed

## Next steps

<Columns cols={2}>
  <Card title="Setup" icon="screwdriver-wrench" href="/scripts/weapon-controller/setup">
    Installation, progression curves, weapon modifiers, and troubleshooting.
  </Card>

  <Card title="Developer reference" icon="code" href="/scripts/weapon-controller/developers">
    Helper functions and programmatic access to perk values.
  </Card>
</Columns>
