gfx-secondhand

A second-hand vehicle marketplace for FiveM where players can sell their owned vehicles at configurable parking lots and other players can browse, test drive, and purchase them. Includes NUI interface, license plate editing, offline selling support, and job-restricted parking lots.

Info

Dependencies

Installation

1. Copy Files

Place the gfx-secondhand folder into your server's resources directory.

2. Database

The script uses existing framework vehicle tables. No additional SQL migration is required.

• QBCore: player_vehicles (columns: license, citizenid, vehicle, hash, mods, plate, state)
• ESX: owned_vehicles (columns: owner, plate, vehicle)

Vehicle listing data is stored in database.json within the resource folder (auto-managed by the script).

3. server.cfg

ensure oxmysql           -- or ghmattimysql / mysql-async
ensure qb-core            -- or es_extended
ensure gfx-secondhand

Configuration

Configuration is done in config.lua.

Locale

Config.Locales = 'EN'  -- EN, FR, PT, TR

SQL Driver

Config.SQLScript = 'oxmysql'  -- 'oxmysql' / 'ghmattimysql' / 'mysql-async'

License Plate Editing

Config.EditPlate = true          -- Allow buyers to change the plate on purchase
Config.EditPlateCost = 5000      -- Cost to edit the license plate

Offline Selling

Config.OfflineSelling = true
-- true  = Vehicles can be purchased even if the owner is offline (money goes to DB)
-- false = Owner must be online for the transaction to complete

Payment Type

Config.BuyType = "bank"  -- "bank" or "cash"

Test Drive

Config.TestDriveTime = 60  -- Duration in seconds
Config.TestDriveVector4 = vector4(-1007.3341, -3015.9114, 13.3133, 61.0055)  -- Spawn location

Vehicle Collision

Config.Collisions = true
-- true  = Display vehicles have no collision (players can walk through them)
-- false = Display vehicles have collision enabled

Parking Lots

Define named parking lots with numbered slot positions. Each slot is a vector4 (x, y, z, heading).

Config.ParkingLot = {
    ["Franklin's"] = {
        [1] = vector4(221.4148, -806.7344, 30.0414, 247.9251),
        [2] = vector4(222.4204, -804.3123, 30.0363, 246.9260),
        -- ...up to 15 slots
    },
    ["Winston's"] = {
        [1] = vector4(-1716.6907, -898.9792, 7.0463, 139.1251),
    },
}

Job Restrictions

Restrict specific parking lots to players with a certain job. Parking lots not listed are open to everyone.

Config.Jobs = {
    ["Franklin's"] = "police"  -- Only police can sell at Franklin's
}

Interaction Type

Choose one of three interaction methods. Set useThis = true for the desired method and false for the others.

Config.InteractType = {
    ["textui"]   = { useThis = false },  -- QBCore DrawText UI
    ["drawtext"] = { useThis = true },   -- 3D world text
    ["target"]   = { useThis = false },  -- qb-target box zones
}

Notification Function

Customize the notification system for both client and server sides:

function Config.Notification(text, server, source)
    if server then
        TriggerClientEvent('esx:showNotification', source, text)
    else
        TriggerEvent('esx:showNotification', text)
    end
end

HUD Toggle

Called when opening/closing the vehicle preview UI:

function Config.Hud(bool)
    if bool then
        TriggerEvent('ShowHud')
    else
        TriggerEvent('HideHud')
    end
end

Vehicle Key Integration

Configure key assignment for test drives and purchases:

function Config.TestVehicle(model, plate)
    TriggerEvent("vehiclekeys:client:SetOwner", plate)
end

function Config.BuyVehicle(model, plate)
    TriggerServerEvent('qb-vehiclekeys:server:BuyVehicle', plate, model)
end

Vehicle List

The vehicles.lua file contains a comprehensive Config.Vehicles table mapping vehicle spawn names to display titles and categories. This table is used to show vehicle names and categories in the UI.

Config.Vehicles = {
    ["adder"] = { title = "Adder Truffade", category = "sports" },
    ["zentorno"] = { title = "Zentorno Pegassi", category = "super" },
    -- 700+ vehicles across all categories
}

Categories include: compacts, sedans, suv, coupes, muscle, sport-classic, sports, super, motorcycles, off-road, industrial, utility, vans, cycles, boats, helicopters, planes, service, emergency, military, commercial, openwheel.

Exports

Client Exports

IsParkingSlotOccupied

Checks whether a specific parking slot currently has a vehicle listed for sale. Only created when Config.InteractType["target"] is enabled (used internally for qb-target canInteract checks).

local occupied = exports['gfx-secondhand']:IsParkingSlotOccupied(parkingLotName, slotIndex)

Returns: boolean -- true if a vehicle is listed in that slot, false otherwise.

Events

Client Events

Jakrino:Client:OpenSellingPopUp

Opens the vehicle selling popup UI. The player must be in a vehicle to sell it.

-- Trigger from client
TriggerEvent('Jakrino:Client:OpenSellingPopUp', targetdata, parkindex)

Jakrino:Client:ViewVehicle

Opens the vehicle preview camera and NUI for browsing a listed vehicle at a specific parking slot.

-- Trigger from client
TriggerEvent('Jakrino:Client:ViewVehicle', targetdata, parkindex, slotindex, inUi)

Jakrino:Client:UpdateVehicles

Updates all displayed vehicles at parking lots. Called after a vehicle is listed or purchased.

-- Trigger from server to all clients
TriggerClientEvent('Jakrino:Client:UpdateVehicles', -1, data)

Jakrino:Client:DeleteVehicle

Deletes the vehicle the player is currently sitting in (used after listing a vehicle for sale).

-- Trigger from server to specific client
TriggerClientEvent('Jakrino:Client:DeleteVehicle', source)

Parameters: None

Server Events

Jakrino:Server:SaveVehicle

Lists a vehicle for sale at the nearest parking slot. Validates ownership and slot availability.

TriggerServerEvent('Jakrino:Server:SaveVehicle', vehicleProps, price, parkingLotName, slotIndex, vehicleName)

Commands

No commands are registered by this script.

Features

• Player-to-player vehicle sales -- Players can list their owned vehicles for sale at designated parking lots with a custom price
• NUI marketplace interface -- Browse listed vehicles with a full-featured UI showing vehicle details, seller info, fuel level, turbo status, and modification levels
• Vehicle preview camera -- 3D scripted camera that lets buyers view listed vehicles from different angles with left/right rotation
• Test drive system -- Take any listed vehicle for a timed test drive before purchasing, with automatic return after the timer expires
• License plate editing -- Buyers can optionally change the license plate when purchasing (configurable cost)
• Offline selling -- When enabled, vehicles can be purchased even when the seller is offline; money is deposited directly into their database record
• Online-only selling -- When disabled, the seller must be online for the transaction to complete; if offline, the buyer is refunded
• Job-restricted parking lots -- Specific parking lots can be restricted to players with a certain job
• Multiple parking lots -- Configure unlimited named parking lots with multiple numbered slots each
• Full vehicle property persistence -- All vehicle modifications, colors, neons, damage states, extras, liveries, and wheel configurations are saved and restored
• Three interaction modes -- Choose between 3D DrawText, QBCore TextUI, or qb-target box zones for interacting with parking slots
• Multi-framework support -- Works with both QBCore and ESX out of the box with auto-detection
• Multi-database support -- Supports oxmysql, ghmattimysql, and mysql-async via config switch
• JSON data storage -- Vehicle listings are stored in database.json for persistence without additional database tables
• Map blips -- Automatic blip placement for each parking lot location
• Vehicle stabilization -- Periodic thread repositions display vehicles to prevent physics drift
• Collision toggle -- Option to enable or disable collision on display vehicles
• Multi-language support -- Locale system with EN, FR, PT, TR translations
• Comprehensive vehicle list -- 700+ vehicles pre-configured with display names and categories

Troubleshooting

Source

• GitHub: https://github.com/gfx-fivem/gfx-secondhand
• Organization: GFX-Fivem