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

# Advanced Crafting Script: XP Progression for FiveM

> Add item crafting with XP gain and recipe unlocking to your FiveM server — supports QBCore, QBox, and ESX with a full progression-gated recipe system.

Bring progression and immersion to your server with this all-in-one crafting system. Designed for QBCore, QBox, and ESX, it lets players craft items, gain XP, and unlock higher-level recipes as they progress — creating a satisfying skill loop that rewards long-term engagement.

## Features

* **XP System** — Players earn experience points every time they craft an item. XP accumulates over time and drives long-term player retention.
* **Progression-Gated Recipes** — Higher-tier recipes are locked behind XP thresholds. Players must work their way up through the crafting tiers, keeping lower-level recipes accessible while motivating continued play.
* **Fully Configurable** — Define your own recipes, required ingredients, XP rewards, XP unlock thresholds, and crafting station locations all inside `config/config.lua`.
* **Multi-Framework Support** — Works natively with QBCore, QBox, and ESX without additional modifications.
* **Eye Target Integration** — Crafting stations use eye-target for natural, context-aware player interactions.
* **Inventory Compatibility** — Supports ox\_inventory, qb-inventory, and all major community inventory systems.

## Installation

<Steps>
  <Step title="Install Dependencies">
    Download and install the following dependencies before adding the script to your server:

    * [oxmysql v2.12.0](https://github.com/overextended/oxmysql/releases/tag/v2.12.0)
    * [ox\_lib v3.30.6](https://github.com/overextended/ox_lib/releases/tag/v3.30.6)
    * `crux_lib` — included in your script download.
  </Step>

  <Step title="Configure the Script">
    Open `config/config.lua` and define your crafting recipes, required materials, XP rewards, XP unlock requirements, and crafting station coordinates.
  </Step>

  <Step title="Add Items to Your Inventory">
    Open the `install` folder and add all required items and their images to your inventory system.

    * **qb-inventory** — Copy items into `qb-core/shared/items.lua` and images into `qb-inventory/html/images`.
    * **ox\_inventory** — Copy items into `ox_inventory/data/items.lua` and images into `ox_inventory/web/images`.
    * **qs-inventory** — Copy items into `qs-inventory/` and images into `qs-inventory/html/images`.
    * **tgiann-inventory** — Copy items into `qb-core/shared/items.lua` and images into `qb-inventory/html/images`.

    See the `README` inside the script for the full item list formatted for each inventory system.
  </Step>

  <Step title="Ensure Resources">
    Add the following lines to your `server.cfg`:

    ```
    ensure ox_lib
    ensure crux_lib
    ensure crux-uwucafetv
    ensure crux-uwucafekiosk
    ensure crux-uwucafebag
    ensure crux-uwucafejobv2
    ```
  </Step>
</Steps>

## Integrations

Advanced Crafting Script supports the same wide integration ecosystem as all Crux Studio Advanced Series scripts.

| Category   | Officially Supported        |
| ---------- | --------------------------- |
| Eye Target | ox\_target, qb-target       |
| Notify     | crux\_notify, qb, ox, esx   |
| Inventory  | ox\_inventory, qb-inventory |

For the complete compatibility table covering all supported eye target, notify, and inventory scripts, see the [UWU Cat Café V2 Integrations](/restaurant-v2/uwu-cat-cafe-v2-integrations) page — Advanced Crafting Script shares the same integration coverage.