QBCore Configuration

QBCore Crafting System Installation Guide

Prerequisites

Before installing the crafting system, ensure you have:

• QBCore Framework (latest version)

• One of the following inventory systems:

  • qb-inventory (default)

  • ox_inventory

  • qs-inventory

• MySQL or MariaDB database

• qb-target (comes with QB core)

Step 1: Resource Installation

1. Download the resource

2. Extract to your resources folder

3. Rename the folder to b2-crafting

4. Import the provided SQL:

-- Run this in your database
CREATE TABLE IF NOT EXISTS `crafting_tables` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `table_type` varchar(50) NOT NULL,
  `xp` int(11) DEFAULT 0,
  `durability` float DEFAULT NULL,
  `position` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL,
  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
  `blueprints` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT '[]',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;

1. Add to your server.cfg:

ensure b2-crafting

Step 2: Item Setup

Add these items to your qb-core/shared/items.lua:

-- Table Items
['table_crafting'] = {
    name = 'table_crafting',
    label = 'Crafting Table',
    weight = 1000,
    type = 'item',
    image = 'crafting_table.png',
    unique = true,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = 'A table for crafting items'
},

-- Blueprint Items
['blueprint_pistol'] = {
    name = 'blueprint_pistol',
    label = 'Pistol Blueprint',
    weight = 50,
    type = 'item',
    image = 'blueprint_pistol.png',
    unique = false,
    useable = false,
    shouldClose = false,
    combinable = nil,
    description = 'Blueprint for crafting a pistol'
},

-- Material Items
['iron'] = {
    name = 'iron',
    label = 'Iron',
    weight = 100,
    type = 'item',
    image = 'iron.png',
    unique = false,
    useable = false,
    shouldClose = false,
    combinable = nil,
    description = 'Iron material'
},

['wood'] = {
    name = 'wood',
    label = 'Wood',
    weight = 100,
    type = 'item',
    image = 'wood.png',
    unique = false,
    useable = false,
    shouldClose = false,
    combinable = nil,
    description = 'Wood material'
}

Step 3: Configuration

Basic Configuration (config/main.lua)

Config = {}

Config.Devtools = {
    debug = false     -- Enable for debug prints
}

Config.Interactions = {
    useTargeting = true,
    targetingSystem = "qb-target" -- QB's default targeting system
}

Table Configuration (config/tables.lua)

Config.Tables = {
    TableTypes = {
        ["crafting"] = {
            prop = "gr_prop_gr_bench_04b",
        },
        ["recycling"] = {
            prop = "gr_prop_gr_bench_04b",
        },
    },

    -- Default tables that spawn in the world
    ServerTables = {
        [1] = {
            tableType = "crafting",
            level = 1,
            location = vector4(313.2750, -208.8673, 54.0863, 67.6526),
        },
        [2] = {
            tableType = "recycling",
            level = 1,
            location = vector4(314.1078, -205.5243, 54.0863, 73.6446),
        },
    },

    -- XP requirements for levels
    TableLevels = {
        {level = 1, minXP = 0, maxXP = 99},
        {level = 2, minXP = 100, maxXP = 299},
        {level = 3, minXP = 300, maxXP = 599},
        {level = 4, minXP = 600, maxXP = 999},
        {level = 5, minXP = 1000}
    }
}

Recipe Configuration (config/recipes.lua)

Config.Recipes = {
    useSkillchecks = true,
    
    Items = {
        ["weapon_pistol"] = {
            name = "Pistol",
            description = "Standard 9mm pistol",
            category = "pistols",
            tableType = "crafting",
            
            requirements = {
                level = 1,
                blueprint = true,
                blueprintName = {
                    item = "blueprint_pistol", 
                    label = "Pistol Blueprint"
                }
            },

            crafting = {
                duration = 3,
                successChance = 80,
                skillChecks = {
                    enabled = true,
                    count = 2,
                    difficulty = {
                        areaSize = 35,
                        speedMultiplier = 1.25
                    }
                },
                tableXP = 25
            },
            
            ingredients = {
                {item = "iron", label = "Iron", amount = 2},
                {item = "wood", label = "Wood", amount = 1}
            },
            
            rewards = {
                primary = {
                    item = "weapon_pistol",
                    amount = 1
                }
            }
        }
    }
}

Step 4: QB-Target Integration

The system automatically integrates with QB-Target. The following options are registered automatically:

• Crafting interaction

• Table pickup

• Recycling (if enabled)

• Table repair

No additional configuration is needed for targeting to work.

Optional Enhancements

Custom Categories

Add custom categories in config/tables.lua:

Config.Tables.Categories = {
    ["crafting"] = {
        "tools",
        "basic_items",
        "components"
    },
    ["recycling"] = {
        "electronics",
        "metals",
        "materials"
    }
}

Durability System

Tables can have durability that decreases with use:

Config.Tables.RepairRequirements = {
    ["crafting"] = {
        items = {
            { name = "metal_scrap", amount = 3, label = "Metal Scrap" },
            { name = "wood", amount = 1, label = "Wood" }
        },
        repairAmount = 25,
        minDurability = -1,
        maxDurability = 100,
        repairTime = 10000
    }
}

Testing Your Setup

1. Spawn necessary items:

/giveitem table_crafting 1
/giveitem iron 10
/giveitem blueprint_pistol 1

1. Place the table using the item from your inventory

2. Approach the table and use QB-Target

3. Try crafting an item!

Common Issues & Solutions

1. Tables not spawning:

   • Verify item is registered in QB-Core items.lua

   • Check prop name in TableTypes

   • Ensure coordinates are accessible

2. Can't craft items:

   • Double-check item names match QB-Core items.lua exactly

   • Verify you have required materials

   • Check job requirements if set

   • Confirm blueprint requirements

3. QB-Target not working:

   • Ensure qb-target is started before b2-crafting

   • Check targeting configuration

   • Verify table entity exists

4. Inventory errors:

   • Check item weights in QB-Core config

   • Verify item names match exactly

   • Ensure inventory slots are available

Support

For additional support:

1. Join our Discord

2. Enable debug mode in config

3. Check server/client console for errors

Upgrading

When upgrading:

1. Backup your configs

2. Update the resource

3. Compare and merge your configs

4. Run any new SQL queries

5. Clear server cache

Need more help? Check our Discord or GitHub issues!