📦 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

ensure 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

CREATE 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

---

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

• Required for older versions • Adds item storage support

---

⚙️ Basic Settings

Config.Language = "en"

• Controls language system

---

🌐 Locale System

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

• Multi-language support • Fully customizable UI texts

---

🏪 Stash System

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

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

---

job = false

• false → personal stash • table → job restricted stash

---

job = {
  ["valgunsmith"] = 0
}

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

---

👤 NPC & Object System

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

• Optional NPC for stash interaction • Can be disabled

---

object = "p_ammoboxlancaster02x"

• Object-based stash interaction • Alternative to NPC

---

🗺️ Blip System

Blip = true
BlipSprite = -426139257

• Shows stash on map • Fully customizable

---

📦 Slot & Upgrade System

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

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

---

💰 Money Storage System

MoneyDeposit = true

• Allows storing money in stash • Supports deposit & withdraw

---

⚖️ Item Limit System

limit = 500

• Total stash capacity • Prevents overflow

---

Config.StashItemLimit = false

• Optional per-item limits • Can restrict specific items

---

🔒 Whitelist / Blacklist System

UseBlackList = false
whitelistItems = false
whitelistWeapons = false

• Control allowed items • Supports whitelist and blacklist logic

---

limitedItems = {}
limitedWeapons = {}

• Define allowed items/weapons • Works with whitelist system

---

🔫 Weapon System

acceptWeapons = true

• Allows storing weapons • Supports metadata

---

🧠 Stack & Limit Control

ignoreItemStackLimit = true

• Allows stacking beyond default limits • Useful for bulk storage

---

👮 Admin Commands

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

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

---

removestashjob

• Removes job stash • Requires admin permission

---

🔄 External Usage

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

• Open stash via script • Fully dynamic system

---

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

• Custom stash creation • Used for houses / props

---

🔔 Notification System

Notify({
  text = "Message"
})

• Supports VORP / RSG / REDEMRP • Handles all notifications

---

🌐 Server Config

SV_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