hate-zinventory

An advanced, inspired grid 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 personal inventory, equipped 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.

Features

• Modern Inventory Grid
  • Configurable grid inventory with slot and weight limits.
  • Drag-and-drop transfers with timed and conflict-aware concurrent processing.
  • Stack merging, splitting, and amount selection.
  • Server-side validation for item amounts, permissions, ownership, and distance.
• Quick Slots
  • Quick slots remain visible while the inventory is closed.
  • Use items directly through configurable quick slots.
  • Assign and clear quick slots directly from the inventory.
  • Configurable item change popups with image, label, and amount.
• Weapon System
  • Standalone weapon handling with draw and holster animations.
  • Per-weapon instances with unique serial numbers.
  • Individual ammunition, durability, break-at-zero behavior, and attachments.
  • Weapons are equipped through quick slots instead of the default GTA weapon wheel.
• Magazine-Based Ammunition
  • Support compatible magazines and loose ammunition.
  • Load and unload magazines with configurable animations.
  • Automatically resolve the best compatible magazine from the player's inventory.
  • Backpack-aware ammunition and magazine resolution.
• Backpack System
  • Owned backpacks with a dedicated equipment slot.
  • Independent inventory pages for equipped backpacks.
  • Configurable backpack slot and weight limits.
  • Persistent backpack contents.
  • Synchronize backpack-held weapon ammunition with the inventory.
• Ground Drop System
  • Drop items directly into the world.
  • Configure drop lifetime, interaction distance, markers, and object visuals.
  • Server-side pickup validation prevents invalid or out-of-range interactions.
• Vehicle Storage
  • Vehicle trunk and glovebox storage.
  • Validate vehicle distance, doors, locks, and ownership before access.
  • Persistent vehicle storage between sessions.
• World Containers
  • Personal, job, and shared storage containers.
  • Optional marker and object visuals.
  • Configurable access and storage behavior.
• Consumables
  • Configurable consumable item effects.
  • Item-use notifications.
  • Configurable removal behavior after use.
• Back-Item System
  • Display supported weapons and melee weapons on the player's back.
  • Support visible weapon attachments on back items.
• External Contexts
  • Open temporary, read-only inventory contexts through OpenExternalContext.
  • Includes integration with Hate Looting.
  • Allows external resources to display loot directly inside the inventory UI.

Included

• Modern inspired drag-and-drop inventory UI
• Configurable grid, slot, and weight system
• Quick-slot bar with item popup notifications
• Backpack system with persistent contents
• Weapon, ammunition, magazine, durability, and attachment systems
• Ground drops and pickup system
• Vehicle trunk and glovebox storage
• Personal, job, and shared containers
• Consumable item system
• Basic back-item display system
• External read-only inventory contexts
• Server-side validation for inventory operations
• Standalone SQL persistence
• English and Turkish localization

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

Persistence

Player items are stored exclusively in the hate_zinventory_items SQL table. Quick-slot preferences, vehicle storage, backpacks, and personal, job, and shared containers are persisted using server resource KVP data. Ground drops remain available until the resource restarts or their configured lifetime expires.

Controls

• TAB: Open or close the inventory
• ESC: Close the inventory
• 1-7: Use a quick slot
• Hover: Show item details
• Right-click an item: Use, give, or split
• Drag matching stacks: Merge stacks
• Drag to the right pane: Drop or store an item
• Drag to the inventory: Pick up or retrieve an item
• Drag to a quick slot: Assign the item
• Right-click a quick slot: Clear the slot
• Right-side tabs: Switch between ground, vehicles, and configured containers
• R while dragging: Rotate the item
• R while holding a configured weapon: Reload with the best compatible magazine
• Hold E: Progress a configured consumable or magazine-loading action
• Backspace: Cancel an active consumable action

Soon

• Player Loot
• Clothing as Item support
• Combine item system
• Loot Drop After Death