Installation

1. Drop the resource

Extract suty-drag into resources/[suty]/suty-drag.

2. Ensure dependencies

server.cfg:

ensure ox_lib
ensure ox_inventory
ensure ox_target
ensure suty-drag

3. Install SQL

The resource folder contains [install]/ with a SQL file. Run it once against your database to create the tuning/state tables (the file is included separately so it doesn't auto-run — gives you control over when schema changes hit prod).

mysql -u root -p YOUR_DB_NAME < "resources/[suty]/suty-drag/[install]/install.sql"

Or paste the contents into HeidiSQL / phpMyAdmin.

4. Items

suty-drag ships three items that you need to register in your inventory before they'll work in-game:

Item key	Name	Purpose
`drag_tablet`	Drag Tuning Tablet	Open the tuning UI to modify engine, top speed, traction. Use near your drag car.
`drag_nitro`	Kit de Nitro	Adds a nitrous kit to a drag car. Permanent until consumed. Overuse blows the engine.
`drag_engine_kit`	Kit de Reparación de Motor	Mechanic-only. Repairs blown drag engines via skillcheck.

Pick the tab that matches your inventory and paste the snippet into the listed file. You only need one option — the script auto-detects which framework is running.

Add to ox_inventory/data/items.lua:

["drag_tablet"] = {
    label = "Drag Tuning Tablet",
    weight = 5,
    stack = false,
    close = true,
    consume = 0,
    description = "Professional tablet for drag racing tuning. Modify engine performance, top speed, traction, and more. Stand near your drag car to use.",
    client = {
        image = "drag_tablet.png",
        export = "suty-drag.useTablet",
    },
},

["drag_nitro"] = {
    label = "Kit de Nitro",
    weight = 5000,
    stack = true,
    close = true,
    consume = 0,
    description = "Sistema de óxido nitroso para autos de carreras. Instálalo en tu auto drag para obtener impulso extra. El nitro permanece en el vehículo hasta que se agote o se remueva. ADVERTENCIA: el uso excesivo puede explotar el motor.",
    client = {
        image = "nitrous_bottle.png",
        export = "suty-drag.drag_nitro",
    },
},

["drag_engine_kit"] = {
    label = "Kit de Reparación de Motor",
    weight = 5000,
    stack = false,
    close = true,
    consume = 0,
    description = "Kit profesional para reparar motores fundidos de autos drag. Solo puede ser usado por mecánicos. Requiere completar un skillcheck para reparar exitosamente.",
},

Add to qb-core/shared/items.lua (also works for qbx_core shared items):

drag_tablet = {
    name = "drag_tablet",
    label = "Drag Tuning Tablet",
    weight = 5,
    type = "item",
    image = "drag_tablet.png",
    unique = true,
    useable = true,
    shouldClose = true,
    description = "Professional tablet for drag racing tuning. Modify engine performance, top speed, traction, and more. Stand near your drag car to use.",
},

drag_nitro = {
    name = "drag_nitro",
    label = "Kit de Nitro",
    weight = 5000,
    type = "item",
    image = "nitrous_bottle.png",
    unique = false,
    useable = true,
    shouldClose = true,
    description = "Sistema de óxido nitroso para autos de carreras. Instálalo en tu auto drag para obtener impulso extra. ADVERTENCIA: el uso excesivo puede explotar el motor.",
},

drag_engine_kit = {
    name = "drag_engine_kit",
    label = "Kit de Reparación de Motor",
    weight = 5000,
    type = "item",
    image = "drag_engine_kit.png",
    unique = true,
    useable = true,
    shouldClose = true,
    description = "Kit profesional para reparar motores fundidos de autos drag. Solo puede ser usado por mecánicos.",
},

If you're running ESX with ox_inventory, use the ox_inventory tab instead. The SQL approach below is only for ESX's default inventory.

Run this SQL once against your server's database:

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
    ('drag_tablet',     'Drag Tuning Tablet',          5,    0, 1),
    ('drag_nitro',      'Kit de Nitro',                5000, 0, 1),
    ('drag_engine_kit', 'Kit de Reparación de Motor',  5000, 0, 1);

ESX item registration is then handled automatically in server/main.lua via ESX.RegisterUsableItem() — no additional exports needed.

Make sure the image filenames (drag_tablet.png, nitrous_bottle.png, drag_engine_kit.png) exist in your inventory's image folder. If you renamed them, update the image field in the snippets accordingly.

5. Mechanic job & ECU tablet access

The ECU tablet is restricted to a job + grade. Defaults to mechanic grade 3+. Adjust in config/tablet.lua:

Config.Tablet.jobRestriction = {
    job      = 'mechanic',
    minGrade = 3,
}

Set job = false to allow anyone.

6. Verify

As an allowed mechanic, you should be able to use the tablet item to scan a drag vehicle near you.
As a regular player, use the nitro kit item near your drag car — installation animation runs and the kit is consumed.
Drive the car and press the configured key (default LSHIFT) to fire nitro.