#📦 INSTALLATION

bashensure 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

textoxmysql (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

sqlCREATE 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

jsonstash.json

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

---

#⚙️ BASIC CONFIG

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

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

---

#🧠 MARKET LOCATION SYSTEM

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

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

---

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

• Restricts marketplace by time
• Example → open only daytime

---

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

• Shows map blip
• Helps players find marketplace

---

#🎯 TARGET / PROMPT SYSTEM

luaConfig.UseTarget = true

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

---

#💰 TAX SYSTEM

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

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

---

#📦 SELLING SYSTEM

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

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

---

#🚫 BLACKLIST SYSTEM

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

• Prevents selling specific items
• Used for balance and protection

---

#📊 WAREHOUSE LIMIT SYSTEM

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

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

---

#🔄 AUCTION SYSTEM

luaauction = true
offerdata = {}

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

---

#💳 PAYMENT SYSTEM

luafx_market_payments

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

---

#🎒 INVENTORY HANDLING

lua"yourInventoryIsFull"

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

---

#🔔 NOTIFY SYSTEM

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

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

---

#⚙️ SERVER CONFIG

luaSV_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