# 🚪 QS STORAGE LOCKERS (QBCore + QS Inventory)

A **standalone storage locker system** designed for FiveM servers using QBCore and QS Inventory.

Create interactive, persistent lockers anywhere in the world with full ownership, PIN security, and seamless stash integration.

---

## ✨ Overview

QS Storage Lockers allows server owners to add **fully functional, player-owned storage systems** into their server.

Players can purchase lockers, secure them with a PIN, and access their personal stash at any time.

Built with performance and flexibility in mind, this system is lightweight, configurable, and easy to integrate.

---

## 🔑 Key Features

### 🔐 Secure Locker System

* PIN-protected lockers

* Enter PIN to access stash

* Change PIN (owner-only configurable)

### 💰 Buy & Sell Functionality

* Purchase unowned lockers

* Sell lockers back for configurable refund %

* Ownership system fully database-driven

### 📦 QS Inventory Integration

* Uses QS stash system

* Configurable **slots & max weight**

* Fully persistent storage

### 🛠️ Staff Management Tools

* Create lockers in-game via UI

* Delete lockers by ID

* Permission system:

* QB permissions

* ACE permissions

* Job & grade whitelist

### 🌍 World Interaction

* Press **E** to interact

* Configurable markers & distances

* Clean and immersive interaction system

### 💾 Persistent Data

* Stored in MySQL database

* Survives restarts

* Reliable and optimized

---

## ⚙️ Configuration Options

* Locker price & refund percentage

* Weight & slot limits

* Commands & permissions

* Owner-only actions (sell / PIN change)

* Marker visibility & interaction range

---

## 📥 Installation

1. Drag & drop resource

2. Import SQL file

3. Configure settings

4. Restart server

---

## 🎯 Use Cases

* Player housing storage

* Gang / faction lockers

* Business storage systems

* Custom interiors & MLOs

---

## 🚀 Why Choose This?

* Clean UI & user experience

* Lightweight & optimized

* Fully standalone

* Built specifically for QBCore + QS Inventory

* Easy to configure & expand

---

## 📩 Support

For help, setup, or questions — contact via Discord.

---

🔥 Upgrade your server’s storage system with a **modern, secure, and fully immersive locker solution**.