#📦 FX-STASH

Advanced stash system for RedM supporting personal and job-based storage with upgrade system, money storage, item limits, and full framework compatibility.

---

#📦 Installation

bashensure fx-stash

• Place the script inside your resources folder
• Add ensure fx-stash to your server.cfg
• Restart your server
• Requires fx-input system

---

#🗄️ SQL Setup

sqlCREATE TABLE IF NOT EXISTS `fx_stash` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(50) NOT NULL,
  `identifier` varchar(50) DEFAULT NULL,
  `charidentifier` varchar(50) DEFAULT NULL,
  `slot` int(11) NOT NULL,
  `money` float NOT NULL DEFAULT 0,
  `items` longtext DEFAULT '[]'
)

• Main stash storage table
• Stores items, money, and ownership
• Supports personal and job stashes

---

sqlALTER TABLE `fx_stash`
ADD COLUMN `items` longtext DEFAULT '[]'

• Required for older versions
• Adds item storage support

---

#⚙️ Basic Settings

luaConfig.Language = "en"

• Controls language system

---

#🌐 Locale System

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

• Multi-language support
• Fully customizable UI texts

---

#🏪 Stash System

luaConfig.Storage = {
  {
    name = "Valentine",
    store = vector3(...)
  }
}

• Defines stash locations
• name → unique stash ID
• store → interaction position

---

luajob = false

• false → personal stash
• table → job restricted stash

---

luajob = {
  ["valgunsmith"] = 0
}

• Job-based stash system
• Only specific jobs can access

---

#👤 NPC & Object System

luaped = 'cs_thomasdown'
pedcoord = vector4(...)

• Optional NPC for stash interaction
• Can be disabled

---

luaobject = "p_ammoboxlancaster02x"

• Object-based stash interaction
• Alternative to NPC

---

#🗺️ Blip System

luaBlip = true
BlipSprite = -426139257

• Shows stash on map
• Fully customizable

---

#📦 Slot & Upgrade System

luaminslot = 300
maxslot = 350
upgradable = true
upgradeprice = 10

• Initial stash size
• Max upgrade limit
• Cost per slot upgrade

---

#💰 Money Storage System

luaMoneyDeposit = true

• Allows storing money in stash
• Supports deposit & withdraw

---

#⚖️ Item Limit System

lualimit = 500

• Total stash capacity
• Prevents overflow

---

luaConfig.StashItemLimit = false

• Optional per-item limits
• Can restrict specific items

---

#🔒 Whitelist / Blacklist System

luaUseBlackList = false
whitelistItems = false
whitelistWeapons = false

• Control allowed items
• Supports whitelist and blacklist logic

---

lualimitedItems = {}
limitedWeapons = {}

• Define allowed items/weapons
• Works with whitelist system

---

#🔫 Weapon System

luaacceptWeapons = true

• Allows storing weapons
• Supports metadata

---

#🧠 Stack & Limit Control

luaignoreItemStackLimit = true

• Allows stacking beyond default limits
• Useful for bulk storage

---

#👮 Admin Commands

luaConfig.AdminCommands = {
  {
    command = "removestash"
  }
}

• Admin-only stash removal
• Supports personal & job stash

---

luaremovestashjob

• Removes job stash
• Requires admin permission

---

#🔄 External Usage

luaTriggerServerEvent("fx-stash:openStash", data)

• Open stash via script
• Fully dynamic system

---

luadata = {
  name = "stash_name",
  minslot = 20
}

• Custom stash creation
• Used for houses / props

---

#🔔 Notification System

luaNotify({
  text = "Message"
})

• Supports VORP / RSG / REDEMRP
• Handles all notifications

---

#🌐 Server Config

luaSV_Config.Webhook = {
  url = ""
}

• Discord webhook logging
• Tracks stash actions

---

#⚠️ Important Notes

• Stash names must be unique
• SQL must be installed
• Job names must match framework
• Slot limits must be configured
• Item limits must be defined correctly

---

#🚨 Common Issues

• Stash not opening → wrong name
• Items not saving → SQL missing
• Job stash not working → wrong job name
• Cannot deposit → blacklist active
• Cannot upgrade → max slot reached

---

#🏁 Summary

FX-STASH provides:

• Personal stash system
• Job-based stash system
• Money storage system
• Upgradeable slots
• Item limit & whitelist system
• Full framework compatibility

---

© Fixitfy Development