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

# APEX Crafting

> Category-based workbenches with XP progression.

A workbench crafting system for FiveM / ESX with category-based recipes, per-category XP/level progression, job-gated recipes, timed progressbars, and an in-game UI. Players unlock recipes as they level, and different workbenches can be restricted to different jobs.

## Features

* Category-based recipes — melee, handguns, attachments out of the box
* Per-category XP — 100 XP = 1 level, recipes gated by level
* Job + grade gating per workbench and per recipe
* Timed progressbar with optional distance-based cancellation
* Blueprint support — optional DB-backed blueprint items (`<item>_blueprint`)
* Success rate per recipe (chance of consumed ingredients without output)
* Permanent items — configurable tools that don't get consumed (e.g. wrench)
* Opacity / hide logic — hide un-craftable recipes or grey them out
* MySQL-persisted XP across sessions

## Requirements

<Card title="Required" icon="circle-check">
  `es_extended`, `ox_lib`, `oxmysql`
</Card>

## Configuration

```lua config.lua theme={null}
Config.ExperiancePerCraft       = 50    -- 100 = 1 level
Config.CraftingStopWithDistance = true
Config.HideWhenCantCraft        = false
Config.UseLimitSystem           = false
Config.PermanentItems           = { wrench = true }
```

Ships with 3 default categories (melee, handguns, attachments) and approximately 14 recipes. Per-recipe configures level, category, time, success rate, blueprint requirement, and ingredients. Per-workbench configures coords, jobs, excluded jobs, recipe whitelist, blip, and radius.

## Resource info

<Note>
  Code accessible: Yes — `client/main.lua`, `server/main.lua`, `config.lua` are all in `escrow_ignore`. Approximately 1200 lines of Lua + NUI. German (localizable via `Config.Text`).
</Note>