🏪 FX-STORE

Advanced and fully configurable store system for RedM with buy/sell mechanics, daily limits, stock system, job restrictions, and multi-framework support.

---

📦 Installation

ensure 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

Config.Language = "en"

• Controls language system

---

Config.Log = true

• Enables webhook logging for buy/sell

---

Config.OpenStoreKey = 0x2CD5343E

• Default key to open store (ENTER)

---

Config.NuiDevToolsSecurity = true

• Prevents NUI exploit (price/item manipulation)

---

Config.DropPlayerNuiCheater = false

• If true → kicks cheaters

---

🌐 Locale System

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

• Multi-language support • Dynamic text replacement system

---

🛒 Store System

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

• Defines store locations • Supports multiple positions per store

---

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

• UI title & image

---

👤 PED System

ped = true
model = "cs_nils"
pedSpawnDistance = 30

• Store NPC system • Distance-based spawn

---

🎭 Ped Animation / Scenario

pedScenario = "WORLD_HUMAN_SMOKE_NERVOUS_STRESSED"

• Ped idle behavior

---

anim = {
  animDict = '',
  animName = ''
}

• Alternative to scenario

---

🗺️ Blip System

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

• Map blip system • Fully customizable

---

⏰ Open / Close System

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

• Store working hours • If false → always open

---

🔐 Job Restriction

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

• Restricts store access • false → open for everyone

---

📏 Interaction System

distance = 2.0

• Interaction range

---

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

• Prompt-based interaction system

---

💰 Buy System

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

• Players can purchase items • Supports gold/cash

---

moneytype = "gold"

• Optional currency type

---

💸 Sell System

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

• Players can sell items

---

📊 Daily Limit System

sellStock = 50

• Limits how many items can be sold per day

---

buyStock = 5

• Limits how many items can be bought

---

🗂️ sellStock.json System

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

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

---

⏱️ Stock Refresh System

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

• Daily reset system

---

Config.SellStockUseUTC = false

• true → UTC time • false → server time

---

Config.AdminRefreshSellStockCommand = "refreshsellstock"

• Admin command to reset stock

---

🔔 Notification System

Notify({
  text = "Message"
})

• Supports VORP / RSG / REDEMRP • Unified notify system

---

🧠 Security System

Config.DisableShowingItemQuantities = false

• Optimisation setting

---

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

---

🌐 Server Config

SV_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