Advanced NPC Storage & Locker System for FiveM (ox_inventory)
dev5_storages is a fully-featured, performance-optimized locker and storage system built specifically for FiveM roleplay servers using ox_inventory.
Allow players to buy or rent personal storage lockers through an immersive NPC interaction system โ complete with automatic rent handling, debt locking, and optional police inspection functionality.
โจ Core Features
๐น Multiple Locker Sizes
Players can choose between:
-
Small Locker
-
Medium Locker
-
Large Locker
Each size has configurable:
-
Slot amount
-
Weight limit
-
Buy price
-
Rent price
Everything is fully adjustable in config.lua.
๐ณ Buy or Rent System
Players can:
-
Purchase lockers permanently
-
Rent lockers for a defined time interval (e.g., 24h)
The system automatically:
-
Deducts rent from cash or bank
-
Tracks unpaid rent
-
Locks access when payments are overdue
๐ Debt & Lock Mechanism
If a player fails to pay rent:
-
The locker becomes locked
-
Items remain stored safely
-
Access is blocked until the debt is paid
No item loss. No automatic deletion.
๐ฎ Police Inspection System
Optional police integration:
-
Police officers (configurable job + grade) can inspect lockers
-
Inspection requires the owner to be physically nearby
-
Clean, dedicated police UI panel
-
Does NOT interfere with personal locker ownership
Fully roleplay-friendly implementation.
๐ Dynamic Location System
-
Add unlimited locker locations
-
Place NPCs anywhere on the map
-
Configure multiple storage hubs
-
Each location supports all locker sizes independently
๐ Full Localization Support
Built-in locale system:
-
German & English included
-
Easily expandable
-
No hardcoded UI strings
All text is configurable via locales/.
โ๏ธ Technical Highlights
-
Built for ox_inventory
-
Uses ox_lib
-
Optimized database structure
-
Unique stash IDs per player + locker size
-
No overlapping inventories
-
Clean NUI design
-
Fully configurable
Dependencies:
-
ox_lib
-
ox_inventory
-
oxmysql
๐ฅ๏ธ UI Features
-
Modern glass-style interface
-
Dynamic button states (Buy / Rent / Open / Dissolve)
-
Status display (Bought / Rented / Locked)
-
Confirmation dialogs
-
Debt payment modal
-
Police inspection panel
๐ฏ Perfect For
-
Serious RP servers
-
Economy-driven gameplay
-
Police-focused RP
-
Realistic storage management
๐ฆ Installation
- Add the resource to your server
- Ensure ox_inventory & ox_lib are installed
- Configure locations and prices in
config.lua - Restart server
Done.
๐ก๏ธ Stability & Development
This script is actively maintained and designed for:
-
Performance
-
Clean architecture
-
Expandability
-
Long-term server use
๐ Protected with FiveM Escrow โ This script is secured using the FiveM Escrow system to ensure integrity and prevent unauthorized modifications.