Tech Tree Crafting System

A crafting backbone for FiveM built to run a full server economy, not just a single bench in the back of a workshop. Static and placeable workbenches with database persistence, branching tech trees, a blueprint system with durability stored in item metadata, shared queues where players take turns, and a crafting stash that can be shared or personal. Framework agnostic and auto-detected on install.

Compatibility

Auto-detected on boot.

• Frameworks: ESX, QBCore, Qbox
• Targeting: ox_target, qb-target, q-target
• Library: ox_lib
• Inventories: ox_inventory, qb-inventory, ps-inventory, lj-inventory, esx_inventory (esx_addoninventory), codem-inventory, origen_inventory, jaksam_inventory, qs-inventory, qs-inventory-pro, tgiann-inventory

Adding another inventory is a message away.

Performance

• 0.00ms idle
• 0.00ms with the UI open
• Up to 0.01ms during active crafting operations

Server-side caching keeps database load low while tracking stays responsive.

Workbenches

Static

Place workbenches at fixed locations in the config. Each station carries its own recipe pool, its own tech tree pool, and optional map blips. Good for public crafting spots.

Placeable

Players buy portable workbenches and drop them anywhere. Each type has:

• A unique prop model
• Custom recipe tables and tech trees
• Gizmo and raycast placement
• Database persistence that survives restarts

Permissions

Placed benches are owner-controlled by default. Owners grant and revoke access from a dedicated tab, with the access list stored in the database. Flip a setting to disable permissions and let anyone use any placed bench.

Job and Gang Restrictions

Lock any static workbench to specific jobs, specific gangs, or a minimum grade. Restrictions can also be edited on the fly from the admin menu.

Tech Trees

Unlock recipes through branching progression trees. Players earn tech points by crafting, spend them across multiple skill branches, and follow prerequisite chains. Each workbench type gets its own tree. Turn on shared mode and one player's unlock opens the node for every user of that bench.

Blueprint System

Rare recipes only appear when the matching blueprint is attached. With ox_inventory, blueprints track durability as item metadata. The legacy random-destruction option is still there. Bench-type restrictions keep the right paper in the right shop.

Blueprint Image Creator

A bundled Node.js tool generates blueprint-style inventory images. It auto-detects your inventory system, overlays existing item images, and batch-processes with custom sizing, color tinting, and multiple templates.

Crafting Mechanics

Leveling and XP

Every craft grants XP. Recipes can require levels, unlock through progression, and specialize per workbench. A shared global leveling option is available.

Queue

Queue multiple crafts and process them in order, with real-time progress tracking, material refunds on cancellation, an optional UI lock, and a radius restriction that cancels the queue if the player walks off. Shared queue mode has players take turns per bench, with ownership tracked per player.

Metadata Support

Attach any metadata field to any item: durability, quality, grade, or custom values. Craft variants of the same base item, for example weed with og_kush metadata alongside weed with skywalker_og metadata. Managed from the admin menu.

Crafting Stash

A crafting-focused wrapper around the player's real inventory. Real-time updates, drag-and-drop materials, recipe ingredient filtering, item search, weight management, shared or personal stash modes, and database persistence that survives restarts. Inspired by ProdigyRP.

Admin Panel

Real-time admin interface via /craftadmin. No restart required, everything syncs through net events.

Players

View players, edit XP, levels, tech points, unlocked nodes, and run bulk resets.

Queue

Live monitoring, force complete, cancel with refund, remove without refund.

Stations

View every static, player-placed, and admin-created bench. Teleport, edit, or delete.

Placement Tools

In-game placement mode, scroll wheel rotation, arrow key rotation, hold shift for 1° adjustments.

Recipe Management

Full CRUD over ingredients, tools, craft times, level requirements, XP rewards, tech points, failure chances, blueprints, costs, images, and output amounts.

Tech Tree Editor

Visual node canvas with zoom and pan, SVG prerequisite connections, and full node editing.

Shop System

Configure NPC vendors to sell portable workbenches and raw materials. Custom pricing, cash or bank payment. Players stock up before heading to their crafting spot.

Logging

Built-in logging to Discord (formatted embeds), Fivemerr, FiveManage, Grafana, and Loki. A separate logs.lua file picks destinations and the exact actions that get recorded.

Localization

Full locales system ships with German (de) and English (en). Adding a new language takes a few minutes.

Configuration

Every feature, toggle, and value is exposed in the config. The full files are browsable on the docs site.

Dependencies

• Framework (one of): qb-core, qbx_core, es_extended
• Targeting (one of): qb-target, q-target, ox_target
• Library: ox_lib
• Inventory (auto-detected): any of the ten supported inventories above