ESX Configuration

ESX Crafting System Installation Guide

Prerequisites

Before installing the crafting system, ensure you have:

• ESX Legacy (1.6.0 or newer)

• One of the following inventory systems:

  • ox_inventory (recommended)

  • qs-inventory

  • ESX default inventory

• MySQL or MariaDB database

• ox_lib (if you want enhanced UI features)

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 ox_lib       # If using ox_lib
ensure b2-crafting

Step 2: Item Setup Example

Add items to your ox_inventory/data/items.lua (or your ESX items table):

-- Table Items
-- Example:
['table_crafting'] = {
    label = 'Crafting Table',
    weight = 1000,
    stack = false,
    close = true,
},

-- Blueprint Items
-- Example:
['blueprint_pistol'] = {
    label = 'Pistol Blueprint',
    weight = 50,
    stack = true,
},

-- Material Items
-- Example:
['iron'] = {
    label = 'Iron',
    weight = 100,
    stack = true,
},

Step 3: Configuration

Basic Configuration (config/main.lua)

Config = {}

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

Config.Interactions = {
    useTargeting = true,
    targetingSystem = "ox_target" -- or false for default interaction
}

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: ox_target Setup (Optional but Recommended)

If using ox_target, ensure it's properly configured in your server.cfg:

ensure ox_target

Then set in your config/main.lua:

Config.Interactions = {
    useTargeting = true,
    targetingSystem = "ox_target"
}

Optional Enhancements

ox_lib Integration

If using ox_lib, you get:

• Enhanced progress bars

• Better skill checks

• Improved notifications

Custom Categories

Add custom categories in config/tables.lua:

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

Testing Your Setup

1. Spawn a crafting table: /giveitem table_crafting 1

2. Give yourself materials: /giveitem iron 10

3. Give yourself a blueprint: /giveitem blueprint_pistol 1

4. Place the table and try crafting!

Common Issues & Solutions

1. Tables not spawning:

   • Check your vector4 coordinates

   • Ensure props are streamed

   • Verify targeting system configuration

2. Can't craft items:

   • Check inventory integration

   • Verify item names match exactly

   • Confirm blueprint requirements

3. Inventory errors:

   • Ensure items are properly registered

   • Check weight/limit configurations

   • Verify inventory system compatibility

Support

For additional support:

1. Join our Discord

2. Review debug logs (enable debug mode in config)

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 (not normally needed but may be if issues persist)

Need more help? Feel free to ask!