DBN Inventory – Advanced Inventory System for FiveM

DBN Inventory is a comprehensive, feature-rich inventory system designed for FiveM servers. Built with modern architecture and extensive customization options, it provides everything you need for a complete inventory management experience.

Ideal for server owners, developers, and administrators who need a robust, configurable, and framework-compatible inventory solution with advanced features.

Preview: YouTube

Discord: Join here

Tebex: Tebex

🎯 Included Systems

Core Systems Included — Complete inventory solution!

| Item Management | Weapon System | Weapon Customization | Crafting System |

|-------------------|------------------|-------------------------|-------------------|

| Backpack System | Vehicle Trunks | Storage System | Status System |

| Injury System | Temperature System | License System | Ammo System |

| Admin Tools | Search & Filters | Multi-language | Database Integration |

🛠️ Key Features

Modern User Interface

• Sleek and intuitive UI with smooth animations and responsive design.

• Drag-and-drop functionality for seamless item management.

• Real-time inventory updates and synchronization.

Advanced Weapon System

• Complete weapon management with serial numbers and custom labels.

• Weapon Progression System - Track experience, levels, and unlocks by weapon category.

• Weapon Customization - Attach components, apply skins/tints, and personalize weapons.

• Component System - Unlock and equip weapon attachments through progression.

• League System - Global progression with league rankings and achievements.

• Automatic ammo management with reload system.

• Weapon metadata with durability and quality tracking.

Weapon Customization & Progression (3D System)

• 3D Weapon Customization Interface - Full 3D weapon preview with interactive rotation and component visualization.

• Category-based Progression - Separate progression for Pistols, Rifles, SMGs, Shotguns, Snipers, Melee, Heavy Weapons, and Throwables.

• Level-based Unlocking - Unlock weapon components, skins, and attachments based on experience and level progression.

• Experience System - Track shots, hits, NPC kills, and player kills per weapon category to gain experience.

• Component Unlocking - Unlock weapon components through gameplay, progression, and experience levels.

• Visual Customization - Real-time 3D preview with drag-to-rotate functionality for perfect customization.

• Customization Inventory - Dedicated inventory for weapon components and attachments.

• Progression Rewards - Unlock new components, skins, and customization options as you level up.

• League System - Global progression with league rankings and achievements.

Comprehensive Crafting System

• Crafting Stations - Configure workbenches, tables, and specialized crafting locations.

• Craft Book - In-game recipe book with categorized recipes.

• Recipe System - Complex recipes with multiple ingredients and success chances.

• Difficulty Levels - Easy, Medium, and Hard crafting with varying success rates.

• Job Requirements - Restrict crafting to specific jobs or job grades.

• Progress Tracking - Visual progress bars during crafting.

• Metadata Support - Crafted items can include custom metadata.

Backpack System

• Multiple Backpack Types - Small, Medium, Large, Military, Premium, Duffel, Explorer, and Medical backpacks.

• Expandable Storage - Each backpack type offers different slot and weight capacities.

• Visual Models - 3D backpack props that appear on player’s back.

• Transfer System - Smooth item transfer between main inventory and backpack.

• Drop & Pickup - Backpacks can be dropped and picked up with preserved contents.

• Despawn System - Configurable despawn times for dropped backpacks.

Vehicle Trunk System

• Vehicle Class Configuration - Different trunk capacities based on vehicle class.

• Target Integration - Optional target system integration for trunk access.

• Weight & Slot Limits - Configurable storage limits per vehicle class.

• Weapon Storage - Optional weapon storage in vehicle trunks.

• Persistent Storage - Trunk contents persist across server restarts.

Storage System

• Multiple Storage Types - Default, House, Business, Gang, Container, and Bank storages.

• Permission System - Job-based and identifier-based access control.

• Shared & Private - Configure storages as shared or player-specific.

• Blacklist System - Restrict specific items from storage types.

• Whitelist System - Allow only specific items in storages.

• Custom Limits - Per-storage slot and weight configurations.

Status & Metabolism System (Built-in - No Native Systems Required)

• Integrated Status System - Complete hunger, thirst, and stamina system built-in. No need for native FiveM status systems!

• Hunger System - Realistic hunger mechanics with movement-based consumption and activity multipliers.

• Thirst System - Thirst management with activity multipliers and environmental factors.

• Stamina System - Fatigue system affecting movement and performance with realistic depletion rates.

• Sleep System - Advanced sleep system with recovery mechanics:

• Custom Home Locations - Players can set their own home/sleep location (with configurable cost).

• Sleep Locations - Pre-configured sleep locations for players without homes.

• Teleportation - Automatic teleportation to bed when exhaustion is critical.

• Recovery System - Stamina and status recovery while sleeping.

• Movement Blocking - Optional movement restriction during sleep for realism.

• Status Effects - Low status warnings and damage effects with configurable thresholds.

• Auto-save - Automatic status saving at configurable intervals.

Injury System

• Multiple Injury Types - Light, Heavy, Bleeding, Infection, Poisoning, Dizziness, Broken Bones, Cold, Heat, Overfed, Starving, Thirst, Sickness, Intoxication, and Exhaustion.

• Severity Levels - Light, Moderate, Severe, and Critical injury severities.

• Visual Indicators - UI display of active injuries and status.

• Auto-detection - Automatic injury detection based on player health and status.

• Treatment System - Integration with medical items and treatments.

Temperature System

• Requires Zone Weather System - This system requires our Zone Weather System to function properly.

• Body Temperature - Realistic body temperature simulation.

• Environmental Effects - Temperature changes based on weather and location from Zone Weather System.

• Activity Heat - Movement and activity affect body temperature.

• Adaptation System - Body adapts to environmental conditions.

• Temperature Effects - Hypothermia and heatstroke with damage mechanics.

• Visual Effects - Screen effects for extreme temperatures.

• Warning System - Temperature warnings before critical states.

License System

• Auto-license Generation - Automatic license creation for new characters.

• Multiple License Types - ID Card, Driver License, Weapon License, Lawyer Pass, and more.

• Metadata Integration - Licenses include character information (name, DOB, sex, height, etc.).

• Configurable Licenses - Enable/disable specific licenses and set spawn conditions.

• Visual Display - License display system with formatted information.

Advanced Ammo System

• Ammo Types - Support for all weapon categories (Pistol, SMG, Shotgun, Rifle, Sniper, Heavy, Thrown, etc.).

• Ammo Labels - Localized ammo type names.

• Ammo Limits - Maximum ammo per type configurations.

• Auto-reload - Optional automatic reload on empty.

• Manual Reload - Double-click ammo to reload weapons.

• Hotbar Reload - Reload directly from inventory hotbar.

Search & Filter System

• Real-time Search - Instant item search as you type.

• Auto-focus - Optional automatic search bar focus.

• Category Filters - Filter items by category.

• Advanced Filters - Filter by item type, quality, and metadata.

Database Integration

• Persistent Storage - All inventory data stored in MySQL database.

• Database Updater - Automatic database schema updates.

• Cache System - Optimized caching for performance.

• Backup System - Built-in backup and recovery tools.

Admin Tools (Real-time Item Creator & Management)

• Real-time Item Creator - Complete in-game item creation system with instant updates:

• Live Item Creation - Create, edit, and delete items in real-time without server restart.

• Visual Item Editor - Intuitive interface with live preview of item properties.

• Image Management - Upload custom images, use existing images, or set image URLs.

• Metadata Editor - Configure item metadata, consumable effects, animations, and properties.

• Category Management - Assign categories and subcategories with real-time updates.

• Item Testing - Test items immediately after creation.

• Database Sync - Automatic database synchronization when creating/editing items.

• Real-time Item Management - Manage all items, their properties, and configurations in real-time.

• User Inventory Management - View and manage player inventories directly from admin panel.

• Item Distribution - Give items to players instantly through the admin interface.

• Admin Commands - Give/remove items, clear inventory, check inventory, and more.

• Permission System - Group, job, and permission-based admin access.

• Logging System - Configurable logging for admin actions.

Multi-language Support

• Localization System - Complete translation system for all UI elements.

• Multiple Languages - Support for English, Spanish, Italian, and more.

• Easy Translation - Simple language file structure for adding new languages.

• Dynamic Translations - Runtime translation updates.

Framework Compatibility

• Auto-detection - Automatically detects and integrates with ESX, QB-Core, and QBox.

• Standalone Mode - Works without frameworks if needed.

• Framework Sync - Synchronizes items with framework item databases.

• External Item Import - Import items from external resources.

Customization Options

• Item Metadata - Extensive metadata system for items (durability, quality, spoilage, expiration, crafting info).

• Custom Items - Create custom items with unique properties.

• Item Effects - Configure item usage effects and behaviors.

• Item Groups - Organize items into groups for better management.

• Clothing System - Integrated clothing and metabolism system.

Security Features

• Permission System - Flexible permission system for storages and custom inventories.

• Blacklist/Whitelist - Item and weapon restrictions.

• Validation System - Server-side validation for all inventory operations.

• Anti-exploit - Built-in protection against common exploits.

Additional Features

• Pickup System - World item pickups with despawn timers.

• Throw System - Throw items with charge-based distance.

• Give Item System - Player-to-player item transfer.

• Notification System - Customizable notification system.

• Sound Effects - Optional sound effects for inventory actions.

• Death System - Configurable item/weapon/money handling on death.

• Respawn System - Customizable respawn item restoration.

⚙️ Technical Specifications

• ox_lib for UI helpers and utilities

• oxmysql for database integration

• Lua 5.4 support

• NUI Framework for modern web-based UI

• Modular Architecture - Clean separation of client, server, and shared code

• Service-based Design - Organized service layer for maintainability

• Event-driven - Efficient event system for communication

• Config-driven - Extensive configuration files for customization

• Export System - Comprehensive export API for integration

🧩 Use Cases

• Server Owners → Complete inventory solution with all features included.

• Developers → Extensive export API for custom integrations.

• Admins → Powerful admin tools for item and inventory management.

• Players → Intuitive interface with advanced features like weapon customization and crafting.

• RP Servers → Realistic systems like status, injuries, and temperature for immersive gameplay.

• Custom Servers → Highly configurable system adaptable to any server type.

📦 Requirements

• ESX Legacy (es_extended) or QB-Core (qb-core) or QBox (qbox_core)

• oxmysql - MySQL database integration

• ox_lib - UI and utility library

• FiveM Server - Latest recommended build

• MySQL Database - For persistent storage

• Zone Weather System (Optional) - Required only if you want to use the Temperature System

Note: This inventory system includes its own built-in status system (hunger, thirst, stamina). You do NOT need native FiveM status systems - everything is handled internally!

Temperature System Note: The Temperature System feature requires our Zone Weather System to function properly. If you don’t have it, you can disable the temperature system in the config.

🚀 Installation

1. Ensure all dependencies are installed (oxmysql, ox_lib).

2. Place the resource inside resources/ directory.

3. Add ensure dbn_inventory to your server.cfg.

4. Configure config/config.lua and other config files as needed.

5. Run database updater if required (automatic on first start).

6. Restart the server.

🛡️ Support & Updates

• Regular updates and improvements.

• Fully editable configs and locales.

• Comprehensive export API documentation.

• Debug tools and logging included.

• Active development and community support.

SUPER CUSTOMIZABLE UI

REAL-TIME ITEM CREATOR

WEAPON 3D CUSTOMIZATION

TOGGLE HOTBAR

MINI MODE

Summary

DBN Inventory is a complete, professional-grade inventory system that brings modern inventory management to your FiveM server. With features like weapon progression and customization, advanced crafting, backpack system, status and injury mechanics, temperature system, and extensive storage options, it provides everything needed for a comprehensive inventory experience.

Built for ESX/QB-Core/QBox, powered by MySQL persistence, and designed with modular architecture for easy customization and integration.