🛒 FX-MARKETPLACE

Advanced marketplace system for RedM with player trading, auction system, stash-based storage, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-marketplace

• Place the script inside resources/fx-marketplace • Add ensure fx-marketplace to your server.cfg • Restart your server • Make sure oxmysql is started before this script

---

⚙️ DEPENDENCIES

oxmysql (Required)

• Used for database communication • Script will not work without it • You can use tools like HeidiSQL or phpMyAdmin to manage your database

---

🗄️ SQL INSTALLATION

CREATE TABLE IF NOT EXISTS `fx_market_shopsdata` (...);
CREATE TABLE IF NOT EXISTS `fx_market_selling` (...);
CREATE TABLE IF NOT EXISTS `fx_market_payments` (...);

• Stores shop data, selling items, and payments • Required for marketplace system • Handles auctions, offers, and transactions

---

📁 STASH SYSTEM

stash.json

• Stores items in marketplace storage • Used when player inventory is full • Ensures no item loss

---

⚙️ BASIC CONFIG

Config.Language = "en"
Config.OpenMarketCommand = "market"
Config.OpenCommand = false

• Language → system language • OpenMarketCommand → command to open marketplace • OpenCommand → enable/disable command usage

---

🧠 MARKET LOCATION SYSTEM

Config.Locations = {
    {
        coords = {
            vector4(...)
        },
        ped = "cr_strawberry_males_01",
    }
}

• Defines marketplace locations • Supports NPC or object interaction • Multiple locations supported

---

openTimeSetting = {
    allowed = false,
    open = 8,
    close = 21
}

• Restricts marketplace by time • Example → open only daytime

---

Blip = {
    showBlip = true,
    BlipName = "Trading",
}

• Shows map blip • Helps players find marketplace

---

🎯 TARGET / PROMPT SYSTEM

Config.UseTarget = true

• Enables target system (ox_target etc.) • If false → uses prompt interaction • Auto-detection supported

---

💰 TAX SYSTEM

Config.Tax = {
    ["3"] = 3,
    ["7"] = 5,
}

• Defines selling tax rates • Based on listing duration • Higher duration → higher tax

---

📦 SELLING SYSTEM

Config.RequiredJobSellerPanel = false
Config.SellerJobs = {
    ["seller"] = true
}

• Restricts who can sell items • false → everyone can sell • table → job-based restriction

---

🚫 BLACKLIST SYSTEM

Config.BlacklistedItems = {
    ['weapon_revolver_lemat'] = true,
}

• Prevents selling specific items • Used for balance and protection

---

📊 WAREHOUSE LIMIT SYSTEM

Config.WareHouseLimits = {
    ["ironore"] = 100,
}

• Limits storage per item • Prevents overflow • Helps economy balance

---

🔄 AUCTION SYSTEM

auction = true
offerdata = {}

• Supports auction-based selling • Players can place offers • Highest offer wins

---

💳 PAYMENT SYSTEM

fx_market_payments

• Stores pending payments • Handles withdrawals and refunds • Prevents money loss

---

🎒 INVENTORY HANDLING

"yourInventoryIsFull"

• Items go to stash if inventory is full • Prevents item loss • Delivered on next login

---

🔔 NOTIFY SYSTEM

Notify({
  text = "Item purchased",
  type = "success"
})

• Framework-based notification system • Supports VORP / RSG / REDEMRP

---

⚙️ SERVER CONFIG

SV_Config.Webhook = {
    url = "",
}

• Used for logging system • Sends marketplace logs to Discord • Optional but recommended

---

⚠️ IMPORTANT NOTES

• oxmysql must be running • SQL tables must be installed • stash.json must not be deleted • Item names must match inventory • Blacklist should be configured

---

🚨 COMMON MISTAKES

• Items not selling → blacklist issue • Market not opening → wrong location config • Items disappearing → stash.json deleted • Auction not working → wrong config • Inventory full → items go to stash

---

🏁 SUMMARY

FX-MARKETPLACE provides:

• Full marketplace system • Auction & offer system • Stash-based storage • Tax & economy control • Multi-location trading system • Full framework compatibility

---

© Fixitfy Development