Skip to content

Core Mechanic

Requirements

Framework
QBCoreESXQBX
Target
ox_targetqb-target
Database
MySQL

Setup

1
Add the Resource

Place core_mechanic into your server's resources folder.

resources/
  [c8re]/
    core_mechanic/
2
Import the Database

Execute the SQL file included with the resource:

sql
-- Run this in your database
SOURCE core_mechanic.sql;

Or import core_mechanic.sql through your database management tool (HeidiSQL, phpMyAdmin, etc).

3
Configure the Framework

Open config.lua and set your framework:

lua
Config = {
    Framework = 'qb-core',              -- 'qb-core' or 'esx'
    FrameworkResource = 'qb-core',      -- Resource name of your framework
    NewFrameworkVersion = true,          -- ESX only: set false for versions < 1.8
}
4
Add Items

Add the items from the [items] folder to your inventory system:

  • QBCore — Add items to qb-core/shared/items.lua
  • ESX — Execute ESX_items.sql or add items to your items table

WARNING

Every vehicle part in the config must exist as an item in your inventory system. If you add custom parts, remember to add matching items.

5
Start the Resource

Add to your server.cfg after your framework:

cfg
ensure qb-core
ensure core_mechanic

DANGER

Remove qb-vehiclefailure or any other vehicle damage script to avoid conflicts.

6
Verify
  1. Start your server
  2. Join and check for any errors in the console
  3. Use a mechanic tool or visit a workshop location to test the UI