Library Utilities

-- String utilities
local trimmed = qbx.string.trim('  hello  ')  -- "hello"

-- Math utilities
local rounded = qbx.math.round(3.7)  -- 4

-- Table utilities
local size = qbx.table.size({a = 1, b = 2, c = 3})  -- 3

-- Vehicle utilities
local plate = qbx.getVehiclePlate(vehicle)  -- "ABC 123"

qbx.string.trim(str)

local text = '  Hello World  '
local trimmed = qbx.string.trim(text)  -- "Hello World"

local plate = '  ABC123  '
local cleanPlate = qbx.string.trim(plate)  -- "ABC123"

qbx.string.capitalize(str)

local name = 'john'
local capitalized = qbx.string.capitalize(name)  -- "John"

local status = 'active'
local formatted = qbx.string.capitalize(status)  -- "Active"

qbx.math.round(num, decimalPlaces?)

-- Round to nearest integer
local rounded = qbx.math.round(3.7)  -- 4
local rounded2 = qbx.math.round(3.2)  -- 3

-- Round to specific decimal places
local price = qbx.math.round(19.99567, 2)  -- 20.00
local precise = qbx.math.round(3.14159, 3)  -- 3.142

qbx.table.size(tbl)

local players = {
    ['abc123'] = {name = 'John'},
    ['def456'] = {name = 'Jane'},
    ['ghi789'] = {name = 'Bob'}
}

local count = qbx.table.size(players)  -- 3

-- For arrays, use # operator instead
local array = {1, 2, 3, 4}
local arraySize = #array  -- 4

qbx.table.mapBySubfield(tbl, subfield)

local vehicles = {
    {model = 'adder', type = 'super'},
    {model = 't20', type = 'super'},
    {model = 'bmx', type = 'bicycle'},
    {model = 'scorcher', type = 'bicycle'}
}

local byType = qbx.table.mapBySubfield(vehicles, 'type')
-- Result:
-- {
--     super = {
--         {model = 'adder', type = 'super'},
--         {model = 't20', type = 'super'}
--     },
--     bicycle = {
--         {model = 'bmx', type = 'bicycle'},
--         {model = 'scorcher', type = 'bicycle'}
--     }
-- }

print(#byType.super)  -- 2
print(#byType.bicycle)  -- 2

qbx.array.contains(arr, val)

local jobs = {'police', 'ambulance', 'mechanic'}

if qbx.array.contains(jobs, 'police') then
    print('Police job found')  -- This will print
end

if qbx.array.contains(jobs, 'taxi') then
    print('Taxi job found')  -- This won't print
end

qbx.getVehiclePlate(vehicle)

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local plate = qbx.getVehiclePlate(vehicle)  -- "ABC123" (trimmed)

qbx.generateRandomPlate(pattern?)

-- Generate random 8-character plate
local plate1 = qbx.generateRandomPlate()  -- "XY7Z9ABC"

-- Generate with custom pattern
local plate2 = qbx.generateRandomPlate('11AAA111')  -- "73ABC492"

qbx.getCardinalDirection(entity)

local ped = PlayerPedId()
local direction = qbx.getCardinalDirection(ped)

if direction == 'North' then
    print('Facing north')
elseif direction == 'South' then
    print('Facing south')
elseif direction == 'East' then
    print('Facing east')
else
    print('Facing west')
end

qbx.spawnVehicle(params)

-- Spawn at coordinates
local netId, veh = qbx.spawnVehicle({
    model = `adder`,
    spawnSource = vec4(100.0, 200.0, 30.0, 90.0),
    props = {
        plate = 'MYPLATE',
        color1 = 12,
        color2 = 12
    }
})

-- Spawn and warp player into it
local ped = GetPlayerPed(source)
local netId, veh = qbx.spawnVehicle({
    model = `t20`,
    spawnSource = ped,
    warp = true,  -- Warp the ped into the vehicle
    bucket = 1
})

qbx.deleteVehicle(vehicle)

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local deleted = qbx.deleteVehicle(vehicle)

if deleted then
    print('Vehicle deleted successfully')
else
    print('Failed to delete vehicle')
end

qbx.getVehicleDisplayName(vehicle)

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local name = qbx.getVehicleDisplayName(vehicle)  -- "Adder"

qbx.getVehicleMakeName(vehicle)

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local make = qbx.getVehicleMakeName(vehicle)  -- "Truffade"

-- Set a single extra
qbx.setVehicleExtra(vehicle, extra, enable)

-- Enable all extras
qbx.resetVehicleExtras(vehicle)

-- Set multiple extras
qbx.setVehicleExtras(vehicle, extras)

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)

-- Enable extra 1 (e.g., roof rack)
qbx.setVehicleExtra(vehicle, 1, true)

-- Set multiple extras at once
qbx.setVehicleExtras(vehicle, {
    [1] = true,   -- Enable extra 1
    [2] = false,  -- Disable extra 2
    [3] = true    -- Enable extra 3
})

qbx.drawText2d(params)

CreateThread(function()
    while true do
        qbx.drawText2d({
            text = 'Press E to interact',
            coords = vec2(0.5, 0.9),  -- Bottom center
            scale = 0.5,
            color = vec4(255, 255, 255, 255),
            enableOutline = true
        })
        Wait(0)
    end
end)

qbx.drawText3d(params)

local targetCoords = vec3(100.0, 200.0, 30.0)

CreateThread(function()
    while true do
        qbx.drawText3d({
            text = 'Vehicle Shop',
            coords = targetCoords,
            scale = 0.5,
            color = vec4(255, 255, 0, 255),  -- Yellow
            enableOutline = true
        })
        Wait(0)
    end
end)

qbx.getStreetName(coords)

local coords = GetEntityCoords(PlayerPedId())
local streets = qbx.getStreetName(coords)

print(streets.main)   -- "Vinewood Blvd"
print(streets.cross)  -- "Mirror Park Blvd"

qbx.getZoneName(coords)

local coords = GetEntityCoords(PlayerPedId())
local zone = qbx.getZoneName(coords)  -- "Vinewood"

qbx.isWearingGloves()

if qbx.isWearingGloves() then
    print('No fingerprints will be left')
else
    print('Fingerprints detected')
end

qbx.isWearingDuffelbag()

if qbx.isWearingDuffelbag() then
    print('Can carry extra items')
end

qbx.getEntityAndNetIdFromBagName(bagName)

local entity, netId = qbx.getEntityAndNetIdFromBagName('entity:12345')

qbx.entityStateHandler(keyFilter, cb)

qbx.entityStateHandler('vehicleLocked', function(entity, netId, locked, bagName)
    if locked then
        print('Vehicle', entity, 'was locked')
    else
        print('Vehicle', entity, 'was unlocked')
    end
end)