gfx-marketplace

An in-game player-to-player marketplace system for FiveM. Players can list their inventory items for sale, browse listings from other players, purchase items, and claim earnings from sold items. Features a full NUI interface with seller profiles (Discord/Steam avatars), spam protection, and multi-framework support.

Info

Dependencies

Installation

1. Import Database

Run the marketplace.sql file in your database. This creates three tables:

• gfxmarketplace_offers -- Active marketplace listings
• gfxmarketplace_myoffers -- Per-player offer tracking
• gfxmarketplace_sellers -- Seller profiles (name, avatar)

2. Copy Files

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

3. server.cfg

ensure gfx-marketplace

Make sure your framework (qb-core or es_extended) and SQL resource start before this script.

Configuration

All configuration is in config.lua.

Framework & SQL

Config.Framework = "newqb"   -- Options: "esx", "newesx", "qb", "newqb"
Config.SQLScript = "oxmysql" -- Options: "oxmysql", "mysql-async", "ghmattimysql"

Default Image

Config.NoImage = "https://cdn.discordapp.com/attachments/.../noimage.png"

Image displayed when a seller has no profile picture.

Inventory Image Path

Config.ImagePath = "gfx-inventory/nui/assets"

Path used by the NUI to load item images.

Opening Methods

Command & Keybind

Config.Open.Command = {
    enabled = true,
    command = "market",          -- Chat command name
    key = "TAB",                 -- Keybind key (set to false to disable keybind)
    keyDescription = "Open market",
}

NPC

Config.Open.Npc = {
    enabled = true,
    ped = "s_m_m_highsec_01",   -- Ped model
    coords = {
        vector4(-697.995, 262.8207, 80.876 - 0.98, 330.67126464844),
    },
    text = "Press ~g~[E]~s~ to open the market",
    key = 46,                    -- Control key (46 = E)
}

You can add multiple NPC locations by adding more vector4 entries to the coords table.

Locales

Locales = {
    ["dont_spam"]    = "Please do not spam!",
    ["already_sold"] = "This item has already sold!",
    ["own_item"]     = "You can't buy your own item!",
}

Custom Opening

You can open the marketplace from any other script using the client-side function or event:

-- From client-side Lua
SetVisible(true)  -- Open
SetVisible(false) -- Close

-- From another script via event
TriggerClientEvent("gfx-marketplace:openUI", source) -- Server-side trigger
TriggerEvent("gfx-marketplace:openUI")                -- Client-side trigger

Exports

No exports are registered by this script.

Events

Client Events

gfx-marketplace:openUI

Opens the marketplace UI for the player. Can be triggered from client or server side.

-- Client-side
TriggerEvent("gfx-marketplace:openUI")

-- Server-side (for a specific player)
TriggerClientEvent("gfx-marketplace:openUI", source)

gfx-marketplace:notify

Displays a notification in the marketplace NUI.

-- Server-side
TriggerClientEvent("gfx-marketplace:notify", source, text)

Commands

Features

• Player-to-Player Trading -- Players can list inventory items at any price and other players can purchase them.
• Offer Management -- Players can view their active listings, delete unsold offers (items returned), and claim earnings from sold items.
• Seller Profiles -- Automatically fetches and displays seller avatars from Discord or Steam.
• Seller Levels -- Customizable GetPlayerLevel function in server/open.lua to integrate with level systems.
• NUI Interface -- Full browser-based UI for browsing, buying, selling, and managing offers.
• Spam Protection -- Server-side cooldown prevents rapid-fire requests (1 second minimum between actions).
• Multiple Opening Methods -- Open via chat command, keybind, or NPC interaction. All configurable.
• Multiple NPC Locations -- Add as many NPC marketplace vendors as needed.
• Multi-Framework -- Works with ESX (legacy + new export) and QBCore (legacy + new export).
• Multi-SQL -- Supports oxmysql, mysql-async, and ghmattimysql.
• Claim All -- Players can claim earnings from all sold items at once.

Database Schema

gfxmarketplace_offers

Stores all active marketplace listings grouped by item name.

gfxmarketplace_myoffers

Tracks each player's personal offer history and pending claims.

gfxmarketplace_sellers

Stores seller profile information for display in the UI.

Customization

Player Level System

Edit GetPlayerLevel in server/open.lua to return the player's level from your level system:

function GetPlayerLevel(identifier)
    return false -- Replace with your level system logic
end

Item Labels & Types

Edit GetItemLabel and GetItemType in server/open.lua to customize how items are labeled:

function GetItemLabel(itemName)
    return itemName -- Customize item label lookup
end

function GetItemType(itemName)
    return "item" -- Customize item type lookup
end

Troubleshooting

Source

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