ResourcesInventory SystemsLJ Inventory

LJ Inventory

LJ Inventory delivers a polished drag-and-drop UI with category filters, smooth animations, and optimizations for high-population servers.

Overview

Developed as a community upgrade for QBCore, LJ Inventory replaces the stock qb-inventory interface with a modern layout that resembles mobile inventory systems. It supports keyboard and controller navigation, includes crafting and shop interfaces, and exposes exports for custom integrations.

Feature Highlights

  • Category tabs for weapons, food, medical, materials, and miscellaneous items
  • Built-in crafting stations with progress bars and recipe previews
  • Performance-focused NUI implementation that avoids unnecessary rerenders
  • Improved search and sorting tools within stashes and vehicle storage
  • Configurable hotbar with quickslot icons and custom keybind hints

Requirements

  • QBCore framework (latest stable build)
  • oxmysql for database communication
  • qb-core/shared/items.lua access to register new metadata fields if needed
  • qb-target (optional) for crafting or stash interactions

Installation Steps

  1. Download the LJ Inventory package and place it inside resources/[qb]/lj-inventory.

  2. Remove or disable qb-inventory to prevent duplicate exports or UI elements.

  3. Add the resource to server.cfg:

    ensure qb-core
ensure lj-inventory

  4. Import the included SQL migrations if the package adds new tables for stash persistence or crafting.

  5. Copy any provided images into lj-inventory/html/images and run ensure lj-inventory to rebuild the UI cache.

  6. Update scripts that reference qb-inventory exports to the equivalents documented by LJ Inventory (most exports remain the same for compatibility).

Configuration Overview

  • config.lua defines weight limits, slot counts, and default hotbar size.
  • config.crafting.lua (if included) lists recipe requirements and job restrictions.
  • UI variables (colours, fonts, layout sizes) can be edited in html/css/app.css.
  • Toggle advanced features such as quick-drop areas, grid view, or mobile layout in the configuration files.

Migration Tips

  • Back up shared/items.lua and any custom stash scripts before switching.
  • Review the changelog for known conflicts with resources like qb-shops or qb-traphouse and follow mitigation steps.
  • Provide staff with a cheat sheet showing new shortcuts and hotkeys.
  • Encourage players to clear FiveM cache if the UI assets appear outdated after updates.

Troubleshooting

IssueResolution
Items disappear when droppedConfirm drop handling is enabled in config.lua and that the cleanup script is running.
Crafting recipes not visibleEnsure the job requirements and item names match your shared/items.lua entries.
UI elements misalignedClear the NUI cache (lj-inventory/html) and refresh the resource. Check for conflicting CSS from other scripts.
Weight not updatingVerify that server events are calling the LJ Inventory weight calculation exports.

Additional Resources

  • Documentation or README included with the download
  • Community video showcases highlighting UI themes and color schemes
  • Advanced Inventory Systems guide for tips on evaluating other alternatives
Advanced InventoryQB Inventory V2