📜 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

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 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.

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