💿Installation

🛠️ Installation Guide

Follow this guide to correctly install and configure the Market Place and Black Market Scripts.

---

📦 1. Download from Keymaster

Begin by downloading the following scripts from your CFX Keymaster:

• 0bug-core (Required for all systems)

• 0bug_MarketPlace (Legal marketplace script)

• 0bug_BlackMarketPlace (Black market script)

• bl_ui from GitHub for Minigames (Black market script)

⚠️ Each script is modular and can function independently.

---

🧩 2. Configure 0bug-core

Open config.lua and set your framework and database.

WIZ_CONFIG = {
    Framework = "QBCore", -- QBCore, QBox, ESX
    MySQL = "oxmysql", -- ghmattimysql , mysql-async
    DefaultAvatar = "https://w0.peakpx.com/wallpaper/163/205/HD-wallpaper-street-fivem-gta-gta-v-roleplay.jpg",
    Lang = "en", -- Multi-language support
    Logger = false,
}

⚙️ 3. Setup Script Integration in scriptConfig.lua

 ["Notification"] = {
    Name = "ox_lib", -- qb-core, esx-notification, mythic_notify, ox_lib
  },
  ["Target"] = {
    Name = "ox_target", -- qb-target, ox_target
  },
  ["VehiclesDB"] = {
    Table_Name = "player_vehicles", -- ESX using owned_vehicles, QBCore & QBox using player_vehicles
    Table_Owner_Name = "citizenid",  -- ESX using owner, QBCore & QBox using player_vehicles
    Table_Plate_Name = "plate", -- ESX using plate, QBCore & QBox using plate
    Table_Vehicle_Data_Name = "mods",  -- ESX using vehicle, QBCore & QBox using mods
  },
  ["Screenshot-Basic"] = {
    Service = "fivemanage" -- lockbinx, fivemanage
  }

🌐 4. Configure Image Hosting & Discord Logs (Optional) in serverConfig.lua

WIZ_SERVER_CONFIG = {
    SERVICE = {
        FiveManage = "https://fmapi.net/api/v2/image",
        FiveManageApiKey = "XXXXXX"
    },
    DISCORD = {
        Discord_Token = "YOUR_DISCORD_BOT_TOKEN",
        Discord_Guild_ID = "YOUR_DISCORD_SERVER_ID",
        Discord_Log_Webhook = "",

        MARKET_PLACE = {
            product_actions     = "https://discord.com/api/webhooks/...",
            auction_actions     = "https://discord.com/api/webhooks/...",
            sales_and_earnings  = "https://discord.com/api/webhooks/...",
            errors_and_warnings = "https://discord.com/api/webhooks/...",
            default             = "https://discord.com/api/webhooks/..."
        },
        BLACKMARKET_PLACE = {
            product_actions     = "https://discord.com/api/webhooks/...",
            auction_actions     = "https://discord.com/api/webhooks/...",
            sales_and_earnings  = "https://discord.com/api/webhooks/...",
            errors_and_warnings = "https://discord.com/api/webhooks/...",
            default             = "https://discord.com/api/webhooks/..."
        }
    }
}

🗃️ 5. Optional : Install SQL Database (If Using mysql)

Optional because we automatically create the required SQL tables on first run if they do not already exist in your database.

🏪 Marketplace Tables

CREATE TABLE IF NOT EXISTS `zerobug_marketplace_products` (
  `id` BIGINT(20) NOT NULL,
  `title` VARCHAR(255) NOT NULL,
  `price` BIGINT(20) NOT NULL,
  `quantity` INT(11) NOT NULL,
  `item_data` TEXT NOT NULL COMMENT 'All product data (item, metadata, etc.) in JSON format',
  `description` TEXT DEFAULT NULL,
  `img` VARCHAR(255) DEFAULT NULL,
  `type` VARCHAR(50) NOT NULL COMMENT 'E.g., cars, tools, weapons',
  `seller_data` TEXT NOT NULL COMMENT 'Seller information in JSON format',
  `list_date` BIGINT(20) NOT NULL COMMENT 'UNIX timestamp',
  `advertised_until` BIGINT(20) DEFAULT NULL COMMENT 'Expiration time for featured listings (UNIX)',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE IF NOT EXISTS `zerobug_marketplace_auctions` (
  `id` BIGINT(20) NOT NULL,
  `title` VARCHAR(255) NOT NULL,
  `price` BIGINT(20) NOT NULL COMMENT 'Buy-now price, if available',
  `quantity` INT(11) NOT NULL,
  `item_data` TEXT NOT NULL COMMENT 'Product data in JSON format',
  `description` TEXT DEFAULT NULL,
  `img` VARCHAR(255) DEFAULT NULL,
  `type` VARCHAR(50) NOT NULL,
  `seller_data` TEXT NOT NULL COMMENT 'Seller information in JSON format',
  `list_date` BIGINT(20) NOT NULL COMMENT 'Start date (UNIX)',
  `current_offer` BIGINT(20) NOT NULL,
  `current_offer_player` VARCHAR(100) DEFAULT NULL COMMENT 'Identifier of the last bidder',
  `starting_price` BIGINT(20) NOT NULL,
  `end_date` BIGINT(20) NOT NULL COMMENT 'End date (UNIX)',
  `history_list` LONGTEXT NOT NULL COMMENT 'Bid history in JSON format',
  `pending_refunds` LONGTEXT NOT NULL COMMENT 'List of refund entries (auction ID, amount, timestamp) to be paid when the player logs in.',
  `complate` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Auction completed?',
  `send_item` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Item delivered?',
  `send_price` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Money delivered?',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;


CREATE TABLE IF NOT EXISTS `zerobug_marketplace_earnings` (
  `identifier` VARCHAR(100) NOT NULL,
  `earnings` BIGINT(20) NOT NULL DEFAULT 0,
  PRIMARY KEY (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

🔐 Black Market Tables

CREATE TABLE IF NOT EXISTS `zerobug_black_marketplace_products` (
  `id` BIGINT(20) NOT NULL,
  `title` VARCHAR(255) NOT NULL,
  `price` BIGINT(20) NOT NULL,
  `quantity` INT(11) NOT NULL,
  `item_data` TEXT NOT NULL COMMENT 'All product data (item, metadata, etc.) in JSON format',
  `description` TEXT DEFAULT NULL,
  `img` VARCHAR(255) DEFAULT NULL,
  `type` VARCHAR(50) NOT NULL COMMENT 'E.g., cars, tools, weapons',
  `seller_data` TEXT NOT NULL COMMENT 'Seller information in JSON format',
  `list_date` BIGINT(20) NOT NULL COMMENT 'UNIX timestamp',
  `advertised_until` BIGINT(20) DEFAULT NULL COMMENT 'Expiration time for featured listings (UNIX)',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE IF NOT EXISTS `zerobug_black_marketplace_auctions` (
  `id` BIGINT(20) NOT NULL,
  `title` VARCHAR(255) NOT NULL,
  `price` BIGINT(20) NOT NULL COMMENT 'Buy-now price, if available',
  `quantity` INT(11) NOT NULL,
  `item_data` TEXT NOT NULL COMMENT 'Product data in JSON format',
  `description` TEXT DEFAULT NULL,
  `img` VARCHAR(255) DEFAULT NULL,
  `type` VARCHAR(50) NOT NULL,
  `seller_data` TEXT NOT NULL COMMENT 'Seller information in JSON format',
  `list_date` BIGINT(20) NOT NULL COMMENT 'Start date (UNIX)',
  `current_offer` BIGINT(20) NOT NULL,
  `current_offer_player` VARCHAR(100) DEFAULT NULL COMMENT 'Identifier of the last bidder',
  `starting_price` BIGINT(20) NOT NULL,
  `end_date` BIGINT(20) NOT NULL COMMENT 'End date (UNIX)',
  `history_list` LONGTEXT NOT NULL COMMENT 'Bid history in JSON format',
  `pending_refunds` LONGTEXT NOT NULL COMMENT 'List of refund entries (auction ID, amount, timestamp) to be paid when the player logs in.',
  `complate` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Auction completed?',
  `send_item` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Item delivered?',
  `send_price` BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'Money delivered?',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;


CREATE TABLE IF NOT EXISTS `zerobug_black_marketplace_earnings` (
  `identifier` VARCHAR(100) NOT NULL,
  `earnings` BIGINT(20) NOT NULL DEFAULT 0,
  PRIMARY KEY (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;