# Description

## Overview

DevHub Crafting is an advanced, feature-rich crafting system designed for FiveM servers. It provides a complete crafting experience with a modern, animated UI built with Vue.js, supporting multiple crafting stations, blueprints, weapon attachments, community-driven projects, and detailed player statistics.

## Key Features

* **Multi-Station Crafting System** - Create multiple crafting workbenches with unique recipes, props, and camera angles
* **Blueprint Collection** - Unlockable blueprints with rarity tiers and custom unlock conditions
* **Weapon Attachment System** - Full 3D preview with real-time attachment management (suppressors, scopes, grips, magazines, tints)
* **Community Projects** - Server-wide collaborative goals where players contribute materials
* **Statistics Tracking** - Comprehensive player statistics including crafted items, time spent, and leaderboards
* **Admin Panel** - Full in-game configuration editor for categories, blueprints, crafts, and workbenches. Open it with the `/craftingadmin` command (admin only).
* **Queue System** - Time-based crafting with queue management and reordering
* **Discord Integration** - Personal webhook notifications when crafts complete

## Supported Frameworks

* **ESX**
* **QBCore**
* **QBOX**
* **VRP**
* **Custom frameworks** via devhub\_lib bridge

## Supported Inventories

* ox\_inventory
* qb-inventory
* qs-inventory
* esx\_inventoryhud
* and more...
* Custom inventories via devhub\_lib

***

## UI Features

### Modern Interface

* Elegant dark theme with gold accents
* Smooth page transitions and entrance animations
* Three-panel layout (item list, 3D preview, queue/details)
* Responsive design with custom scrollbars

### Crafting Panel

* Category filtering with custom icons
* List and grid view modes
* Multiple sort options (Name, Craftable, Blueprint status)
* Real-time ingredient tracking with visual indicators
* 3D prop preview with mouse rotation

### Weapon Attachments Panel

* Real-time 3D weapon preview
* Mouse drag rotation and scroll zoom
* Dynamic bone-based attachment positioning
* Visual connection lines from UI to attachment points
* Install/remove attachments with inventory integration

### Blueprint Collection

* Visual grid display with rarity colors
* Lock/unlock status indicators
* Sorting by rarity, name, or unlock status
* Detailed tooltip with required materials

### Statistics Dashboard

* Top 5 most crafted items display
* Total crafting time tracking
* Resources used counter
* Blueprint collection progress
* Community donation totals

***

## 🛡️ Admin Panel — `/craftingadmin` Command

The Admin Panel is one of the most powerful features of DevHub Crafting. It gives administrators a full, real-time in-game interface for configuring every aspect of the crafting system — no file editing required.

### Command

```
/craftingadmin
```

### Requirements

{% hint style="info" %}
This command requires **admin permissions** only. No additional configuration is needed — just make sure you are logged in as an admin on your server.
{% endhint %}

### How to Open the Admin Panel

1. Join the server with an **admin account**
2. Open the chat and type `/craftingadmin`
3. The Admin Panel will open immediately in-game

### What Can You Configure

The Admin Panel is divided into four main tabs, each offering full CRUD (create, read, update, delete) capabilities:

#### 📂 Categories Tab

Manage the category list used to filter recipes in the crafting UI.

* Add new categories with a custom label and [FontAwesome](https://fontawesome.com/icons) icon
* Edit existing category names, icons, and display order
* Remove unused categories
* Reorder categories via the `order` field (lower number = shown first)

#### 📘 Blueprints Tab

Control which blueprints exist and how they can be unlocked.

* Create blueprints with name, description, image URL, and rarity tier
* Set required materials for each blueprint
* Toggle the `hidden` flag — hidden blueprints show as `???` until unlocked
* Define custom unlock conditions (e.g. mission completion, reputation threshold)

#### ⚒️ Crafts / Recipes Tab

Define every craftable item and its recipe.

* Add recipes with ingredients (item name + amount), output item, and crafting time
* Set `maxQuantity` to limit how many can be queued at once (`-1` = unlimited)
* Link a recipe to a blueprint requirement
* Assign a category and rarity for visual styling
* Attach a 3D prop model for the in-game preview

#### 🏭 Crafting Stations Tab

Place and configure crafting workbenches in the world.

* Set world coordinates (`vector4` — includes heading) directly in-game
* Choose the 3D prop model displayed at the station
* Configure the camera position and lookAt point for the UI camera
* Set the default and VIP queue sizes
* Enable/disable the Weapon Attachments tab per station
* Add an optional map blip (name, sprite, size, colour)

Players outside these groups will receive an access-denied notification when attempting to run the command.

{% hint style="info" %}
See the [Admin System documentation](/scripts/devhub_lib-needed-for-each-script/admin.md) to adjust which permission groups are treated as admins for your framework.
{% endhint %}

### Best Practices

* After making changes in the panel, **export your configuration** to the relevant `configs/` files so they persist after a resource restart
* Test each new recipe/station **on a development server** before pushing to production


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devhub.gg/crafting/description.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.