3D WORKBENCH [VUE]

# Risk Workbench — 3D Crafting Table & Crafting System for FiveM

**Craft on a real table, not in a menu. Build every workbench and recipe ingame, no config editing.**

Risk Workbench is a FiveM crafting script for ESX, QBCore and QBox, also known as a 3D crafting table, crafting bench or weapon crafting system. Players walk up to a workbench and the recipe sheet is drawn onto the tabletop in pencil handwriting, with the real 3D item next to it. An ingame editor, blueprints, crafting XP and offline crafting are built in, and it works with ox_inventory, qs-inventory, codem-inventory, tgiann-inventory, core_inventory, origen_inventory and qb-inventory.

---

## Why this one

- **A paper blueprint, not a panel.** The UI is a hand-drawn work order lying on the bench: pencil writing, tape, a green craft stamp. It looks like part of the map, not like an app.

- **Legal and illegal in one script.** A mechanic bench for repair kits and a gang bench for rifles paid in black money, each with its own access list. Police can't use the illegal one.

- **Tools stay, materials go.** Mark a material as "not consumed": the player needs a hammer to craft, but keeps it.

- **Offline crafting.** A 2-hour order keeps running while the player is logged off and through a server restart.

- **No config file for recipes.** Workbenches, categories and recipes are built with an ingame editor and saved in the database.

---

## Crafting on a Real Table

Press `E` or use `ox_target` / `qb-target` at the bench. The camera moves over the table, then the sheet fades in on the tabletop.

| Part of the sheet | What it shows |

| --- | --- |

| **Recipe sheet** | Categories, search field, every recipe with time and level |

| **Work order** | Materials with "have / need", amount, money, blueprint, craft button |

| **Preview** | The real 3D prop of the item, rotatable with the mouse, plus the level note |

Weapons show their real weapon model. Items without a prop show their inventory image. Values are written letter by letter with a pencil sound when you switch recipes.

---

## Ingame Crafting Editor

Type `/craftsetup` and build the whole crafting system without touching a file.

| Step | What you do |

| --- | --- |

| **Place** | A ghost workbench follows your mouse. Mouse wheel or `Q` / `E` turns it, `Enter` places it |

| **Settings** | Name, legal or illegal, job or gang access, map blip |

| **1. What is crafted?** | Pick the result from a searchable item list with images |

| **2. What is needed?** | Materials, optional money (cash or black money) and a blueprint |

| **3. Settings** | Craft time, required level and XP |

Recipes and whole categories can be copied between workbenches. Changes are saved at once and show up for every player without a restart. Up to 200 workbenches, 20 categories and 100 recipes per bench, 12 materials per recipe.

---

## Where to Use It

Every bench has its own recipes, so one script covers every crafting spot on your server.

| Bench | Example recipes |

| --- | --- |

| **Gang hideout** | Weapon crafting with blueprints, ammo, attachments, black money cost |

| **Drug lab** | Drug crafting from your own items, illegal, gang access only |

| **Mechanic shop** | Repair kits, lockpicks, tuning parts, job access only |

| **Public workshop** | Tools and basic items for new players, no level needed |

---

## Offline Crafting

Players don't have to stand at the bench and watch a progress bar.

- **Real time.** Craft time runs on the server clock. Log off, come back tomorrow, the order is done.

- **Survives restarts and crashes.** Every order is stored in the database.

- **Ready reminder.** A notify tells the player when the order is finished, and again when they join.

- **Fair cancel.** Finished pieces and their XP are kept, the materials of the open pieces come back.

- **Pick up at the bench.** A full inventory keeps the order waiting, nothing is lost.

---

## Blueprints, Levels and Money

| Feature | How it works |

| --- | --- |

| **Crafting XP** | One XP value per character, up to 50 levels, curve set in the config |

| **Locked recipes** | Shown greyed out at the bottom of the list, or hidden completely |

| **Blueprint system** | Per recipe: consumed when crafting, or kept as a permanent licence |

| **Tools** | Needed for the recipe, never taken |

| **Money** | Cash or black money per recipe, from the right account or item |

Three blueprint items (pistol, SMG, rifle) with images ship in `_items/`, ready for ox_inventory, qb-inventory and ESX.

---

## Built for Your Other Scripts

```lua

-- Give crafting XP from your job or quest script

exports['risk-workbench']:addXP(source, 250)

-- Unlock recipes for a VIP or a skill tree

exports['risk-workbench']:setLevel(source, 10)

-- Block your phone or emotes while a player crafts

if exports['risk-workbench']:isCrafting() then return end

```

Server: `getXP`, `getLevel`, `addXP`, `setLevel`. Client: `isCrafting`, `openBench(id)`.

---

## Compatibility

| | Supported |

| --- | --- |

| **Framework** | ESX · QBCore · QBox — detected automatically |

| **Inventory** | ox_inventory · qs-inventory · codem-inventory · tgiann-inventory · core_inventory · origen_inventory · qb-inventory · ESX native |

| **Target** | ox_target · qb-target · built-in `E` prompt |

| **Database** | oxmysql · mysql-async · ghmattimysql — tables created automatically |

| **Dependencies** | None besides framework and database, no ox_lib needed |

| **Languages** | 11: EN · DE · ES · FR · IT · NL · PL · PT · RO · RU · TR |

---

## Change It Yourself

These files are open, even in the escrow version.

- **Languages** — rewrite any text in `locales/`, or copy `en.lua` and add your own language.

- **Inventory** — add your own inventory in `inventory/inventory.lua` with four functions: count, add, remove, canCarry.

- **Database** — the database bridge is open, too.

- **Notify, help text and HUD** — your own functions in `Config.Functions`.

- **Items** — any item or weapon of your inventory can be a material or a result.

---

## What You Get

- ✅ 3D crafting table with a hand-drawn paper UI on the tabletop

- ✅ Rotatable 3D item preview

- ✅ Ingame editor for workbenches, categories and recipes

- ✅ Copy recipes and categories between workbenches

- ✅ Offline crafting that runs through restarts

- ✅ Ready notify on finish and on join

- ✅ Fair cancel with materials returned

- ✅ Crafting XP and level system per character

- ✅ Blueprint system, consumed or permanent

- ✅ Tools that are needed but not consumed

- ✅ Cash or black money cost per recipe

- ✅ Legal and illegal workbenches with job and gang access

- ✅ Map blips per workbench

- ✅ Custom workbench prop included

- ✅ 11 languages, open locale files

- ✅ Open inventory, database and notify bridges

- ✅ Exploit-safe, server-authoritative

- ✅ 0.00ms idle, 0.00ms performance

---

## Installation

1. Drop `risk-workbench` into your resources folder

2. Add `ensure risk-workbench` to your `server.cfg`, after your framework, database, inventory and target

3. Add the blueprint items from `_items/` and the two `add_ace` lines from the README

4. Restart the server and type `/craftsetup` ingame

Database tables are created automatically. No SQL import needed. The script streams its own workbench prop, so after changes restart the whole server, not only the resource.

**Requirements:** `oxmysql`, `mysql-async` or `ghmattimysql` · ESX, QBCore or QBox

---

## FAQ

**What is Risk Workbench?**

Risk Workbench is a FiveM crafting script for ESX, QBCore and QBox. Players craft at a 3D workbench where a hand-drawn UI lies on the tabletop, and admins build every bench and recipe ingame.

**Does it work with ESX?**

Yes. ESX, QBCore and QBox are detected automatically, no setting needed.

**Does it work with my inventory?**

Yes. ox_inventory, qs-inventory, codem-inventory, tgiann-inventory, core_inventory, origen_inventory, qb-inventory and the ESX inventory are detected automatically.

**Can I add my own inventory or language?**

Yes. The inventory bridge and all locale files are open. Add your inventory calls in `inventory/inventory.lua`, or copy `locales/en.lua` for a new language.

**Can players craft weapons and ammo?**

Yes. Any item or weapon of your inventory can be a result, including ammo and attachments. On plain ESX without an item inventory, a player can hold one weapon of each type.

**Can each workbench have its own recipes?**

Yes. Recipes and categories belong to the bench, so the gang bench and the mechanic bench show different things.

**Do I need ox_lib?**

No. Only your framework and a database resource.

**What happens if a player crashes while crafting?**

Nothing is lost. The order is stored in the database and keeps running, the items wait at the bench.

**How is the performance?**

0.00ms idle. The bench only draws while it is open, and every craft timer runs on the server.

---

https://youtu.be/IqBE1XzldJI