hate-zinventory

An advanced,  Zomboid-inspired inventory resource for FiveM. It is designed to work with ESX Legacy, QB-Core, and Qbox while keeping player-item storage in its own validated SQL layer. The NUI provides a modern grid workflow for inventory, backpacks, ground drops, vehicles, and configured containers.

Beta Testing

QB-Core has been tested locally. ESX Legacy and Qbox support are included, but this release is still in beta. Feedback from servers using ESX or Qbox is especially welcome. Please include your framework version, related inventory resources, console errors, and the exact steps needed to reproduce an issue.

Installation and framework-specific migration notes are available in the documentation guides for ESX Legacy, QB-Core, and Qbox.

Features

• Modern Inventory Grid
  • Configurable inventory slot count and maximum weight capacity.
  • Drag-and-drop transfers with stack merging, splitting, and amount selection.
  • FIFO transfer queue with configurable transfer duration and animations.
  • Server-side validation for amounts, permissions, ownership, and distance.
• Backpack System
  • Support multiple owned backpacks per player.
  • Create custom backpack types with unique slot and weight limits.
  • Access backpacks as separate inventory pages.
  • Preserve backpack contents when backpacks are dropped, stored, or retrieved.
• Quick Slots and Weapons
  • Configurable quick slots remain visible while the inventory is closed.
  • Per-weapon instances with unique serials, ammunition, and durability.
  • Magazine-based ammunition with compatible magazines, loose ammo, loading, and unloading.
  • Weapon attachments with validated attach and detach actions.
  • Configurable draw, holster, reload, and magazine-loading animations.
• Ground Drop System
  • Drop items into the world and collect nearby drops.
  • Display drops as markers, 3D objects, or both.
  • Configure interaction distance, visibility, and exact drop lifetime.
• Storage and Containers
  • Vehicle trunk and glovebox storage with lock, door, distance, and access validation.
  • Personal, job, and shared world containers with optional marker/object visuals.
  • External read-only contexts through OpenExternalContext, including Hate Looting integration.
• Item Notifications and Consumables
  • Configurable notifications when items are received or used.
  • Consumable effects with configurable use animations and removal behavior.
• Basic Back-Item System
  • Display supported weapons and melee items on the player's back.
  • Support visible weapon attachments on back items.

Included

• Modern drag-and-drop inventory UI
• Configurable weight and slot system
• Quick-slot bar and item popup notifications
• Backpack and basic back-item systems
• Weapon, ammunition, magazine, durability, and attachment handling
• Ground drops, pickup, give, and transfer actions
• Vehicle trunk and glovebox storage
• Configured personal, job, and shared containers
• Standalone SQL persistence with resource KVP persistence for secondary storage

Compatibility

• ESX Legacy support, including standard items, legacy loadout weapons, and connected xPlayer inventory methods
• QB-Core support, including slots, info metadata, usable items, and the custom player-function bridge
• Qbox support through its qb-core compatibility bridge, including player data, item definitions, and usable items
• Automatic framework detection, with optional explicit ESX, QB, or QBOX configuration
• oxmysql support
• Hate Looting integration through OpenExternalContext
• English and Turkish locales