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

# Introduction

A fully customizable, standalone progress bar for FiveM with 16 visual styles, drop-in replacement support for `esx_progressbar`, `progressbar` (QB), and `ox_lib`'s `lib.progressBar` / `lib.progressCircle`.

{% hint style="info" %}
This resource provides both `esx_progressbar` and `progressbar`, meaning you can remove those resources entirely and keep using their exports/events without changing any of your existing scripts.
{% endhint %}

### Features

* 16 progress bar variants (9 linear, 7 ring styles)
* Rounded or sharp corner shapes
* Fully themeable colors (default, interrupted, failed) — set globally, or overridden individually per progress bar
* 9 screen positions
* Prop and animation/scenario support while a progress bar is active
* Configurable control locks (movement, sprint, vehicle, combat, mouse)
* Cancel key (default: `X`)
* Client **and** server exports
* Drop-in compatible with `esx_progressbar`, QB `progressbar`, and `ox_lib`