FX-STORE

#📦 Installation

bashensure fx-store

• Place script into your resources folder
• Add ensure fx-store to your server.cfg
• Restart your server
• Script uses NUI system and config-based stores

---

#⚙️ Basic Settings

luaConfig.Language = "en"

• Controls language system

---

luaConfig.Log = true

• Enables webhook logging for buy/sell

---

luaConfig.OpenStoreKey = 0x2CD5343E

• Default key to open store (ENTER)

---

luaConfig.NuiDevToolsSecurity = true

• Prevents NUI exploit (price/item manipulation)

---

luaConfig.DropPlayerNuiCheater = false

• If true → kicks cheaters

---

#🌐 Locale System

luaConfig.Locale = {
  ["en"] = {}
}

• Multi-language support
• Dynamic text replacement system

---

#🛒 Store System

luaConfig.Stores = {
  {
    model = "cs_nils",
    coords = {
      vector4(...)
    }
  }
}

• Defines store locations
• Supports multiple positions per store

---

luapromptitle = "Fishing Store"
image = "/ui/img/balikci.png"

• UI title & image

---

#👤 PED System

luaped = true
model = "cs_nils"
pedSpawnDistance = 30

• Store NPC system
• Distance-based spawn

---

#🎭 Ped Animation / Scenario

luapedScenario = "WORLD_HUMAN_SMOKE_NERVOUS_STRESSED"

• Ped idle behavior

---

luaanim = {
  animDict = '',
  animName = ''
}

• Alternative to scenario

---

#🗺️ Blip System

luaBlip = {
  showBlip = true,
  BlipSprite = -1575595762
}

• Map blip system
• Fully customizable

---

#⏰ Open / Close System

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

• Store working hours
• If false → always open

---

#🔐 Job Restriction

luarequiredJobs = {
  ["doctor"] = "0"
}

• Restricts store access
• false → open for everyone

---

#📏 Interaction System

luadistance = 2.0

• Interaction range

---

luaConfig.Prompts = {
  ["store"] = {}
}

• Prompt-based interaction system

---

#💰 Buy System

luaBuyItems = {
  {
    itemName = "water",
    price = 0.25
  }
}

• Players can purchase items
• Supports gold/cash

---

luamoneytype = "gold"

• Optional currency type

---

#💸 Sell System

luaSellItems = {
  {
    itemName = "fish",
    price = 0.25
  }
}

• Players can sell items

---

#📊 Daily Limit System

luasellStock = 50

• Limits how many items can be sold per day

---

luabuyStock = 5

• Limits how many items can be bought

---

#🗂️ sellStock.json System

json{
  "buy": {},
  "sell": []
}

• Stores player daily limits
• Uses charid tracking
• Auto updates

---

#⏱️ Stock Refresh System

luaConfig.SellStockRefreshTimes = {
  ["06:00"] = true,
  ["14:00"] = true
}

• Daily reset system

---

luaConfig.SellStockUseUTC = false

• true → UTC time
• false → server time

---

luaConfig.AdminRefreshSellStockCommand = "refreshsellstock"

• Admin command to reset stock

---

#🔔 Notification System

luaNotify({
  text = "Message"
})

• Supports VORP / RSG / REDEMRP
• Unified notify system

---

#🧠 Security System

luaConfig.DisableShowingItemQuantities = false

• Optimisation setting

---

• NUI anti-cheat system active
• Server validates all prices
• Prevents client manipulation

---

#🌐 Server Config

luaSV_Config.Webhook = {
  url = ""
}

• Discord logging system
• Logs buy & sell actions

---

#🎯 Advanced Features

• Multi-store support
• Buy & Sell system
• Daily stock limit system
• Job-based stores
• Time-based store opening
• Blip & UI system
• Anti-cheat protection
• Framework independent

---

#⚠️ Important Notes

• Item names must match inventory
• Prices must be numeric
• sellStock requires refresh system
• Jobs must match framework
• JSON file must exist

---

#🚨 Common Issues

• Store not opening → wrong coords
• Cannot buy → no money
• Cannot sell → daily limit reached
• Items not showing → config error
• Stock not resetting → wrong time config

---

#🏁 Summary

FX-STORE provides:

• Advanced store system
• Buy / Sell mechanics
• Daily stock limits
• Job restrictions
• Full security system
• Multi-framework support

---

© Fixitfy Development