Docs/Paid Scripts

sg-storage-rentals

v2.0.0

A comprehensive and feature-rich storage rental system for FiveM servers running QBCore or QBox/QBX frameworks.

QBCore / QBoxPurchase

Overview

sg-storage-rentals is a complete storage unit rental system that allows players to rent storage units, manage their belongings, and participate in auctions. The script includes a full business management system for job holders to manage the storage business, view statistics, handle auctions, and more.

Features

Storage Rental

Rent storage units for 1-14 days
Multiple storage points per unit
Deposit system with auto refunds
Real-time expiration tracking

Access Control

Share access with other players
Owner and shared access management
Door locking with manual control
Auto-lock on rental expiration

Business Management

Complete job holder management
Business account tracking
Transaction history
Dynamic pricing

Auction System

Full auction for expired units
Real-time bidding with history
Discord webhook notifications
Item hints for auctions

Inventory Support

qb-inventory & ox_inventory
Configurable weight and slots
Multiple storage points
Persistent across restarts

UI & Interaction

Modern NUI interface
ox_lib menu support
qb-target and ox_target
Visual markers and blips

Additional Features

Discord webhook logging
Real-time status updates
Comprehensive configuration
Framework auto-detection
Full compatibility layer
Debug mode for troubleshooting

Dependencies

Required

ox_libMenu system and utilities
oxmysqlDatabase functionality
QBCore or QBox/QBXframework

Inventory (Choose One)

qb-inventory
ox_inventory

Targeting (Choose One)

qb-target
ox_target

Optional

Discord webhook for logging and auction notifications

Installation

Place the resource

Place the resource in your [scripts] folder

Configure fxmanifest.lua

For QBox/QBX:

Uncomment line 21: '@qbx_core/modules/lib.lua',
Uncomment line 27: '@qbx_core/modules/playerdata.lua',

For QBCore:

Keep lines 21 and 27 commented (default)

Add to server.cfg

ensure sg-storage-rentals

Configure settings

Edit config.lua with your preferred settings

Restart server

Database tables are created automatically on first run

Configuration

Framework Detection

Auto-detects your framework, or set manually:

Config.Framework = 'auto' -- 'auto', 'qbcore', or 'qbox'

Job Management

Config.ownerJob = 'mechanic' -- Set to nil if not player owned

Rental Settings

Config.minDuration = 1       -- Minimum rental duration (days)
Config.maxDuration = 14      -- Maximum rental duration (days)
Config.maximumRentedUnits = 1 -- Max units per player
Config.price = 20000         -- Price per day
Config.deposit = 50000       -- Required deposit

Storage Configuration

Config.inventoryStashConfig = { 
    weightPerStorage = 4000000, -- Weight per storage point (grams)
    Slots = 200,                -- Slots per storage point
    inventory = 'qb-inventory', -- 'qb-inventory' or 'ox_inventory'
}

Menu System

Config.ScriptOptions.MenuInput = 'ox_lib' -- 'standalone' (NUI) or 'ox_lib'
Config.ScriptOptions.target = 'qb-target' -- 'ox_target' or 'qb-target'
Config.ScriptOptions.textui = 'ox_lib'    -- 'qb' or 'ox_lib'

Door System

Config.DoorSystem = {
    enabled = true,
    autoLock = true,              -- Auto-lock on expiration
    lockOnRent = true,            -- Lock when rented
    allowManualControl = true,    -- Manual lock/unlock
}

Auction System

Config.AuctionSystem = {
    enabled = true,
    daysAfterExpiration = 3,      -- Days before auction
    minimumBid = 1000,
    bidIncrement = 500,
    duration = 24,                -- Auction duration (hours)
}

Discord Webhooks

Config.Webhooks = {
    enabled = true,
    url = '',                     -- Your webhook URL
    botName = 'Storage Rentals',
    botAvatar = '',
}

Commands

Command	Description	Permission
`/storagerental`	Open storage menu	All players
`/storageadmin`	Admin management panel	Admin only
`/storagejob`	Business management	Job owners

MLO Requirements

This script requires a storage facility MLO. The script is pre-configured for specific MLO coordinates. If using a different MLO, you will need to adjust the coordinates in the configuration file.

Contact support on Discord for help with custom MLO configurations.

← Getting Started Need help? Join Discord →