Inventory
Overview
QBCore, Qbox, ESX, OX
TSS Inventory
TSS Inventory is a free, open-source FiveM inventory with multi-slot items, movable windows and a clean, customisable interface.
TSS Bridge connects the inventory to your framework and interaction system.
Features
Inventory windows
- Grid-based storage with different item sizes.
- Drag, rotate, stack and split items.
- Placement previews and valid-slot highlights.
- Movable and minimisable windows.
- Eight screen-edge docking positions.
- Tabbed inventories sharing the same docking position.
- Saved window positions per character.
- Automatic inventory repacking.
Storage
- Player inventories and extra equipment slots.
- Backpacks, wallets and nested containers.
- Shared and personal stashes.
- Vehicle trunks and gloveboxes.
- Temporary world drops.
- Randomised loot containers.
- Drag items directly onto container icons.
Trading
- Configurable shops and products.
- Buying and selling with separate prices.
- Cash and bank payments.
- Drag-to-buy and drag-to-sell.
- Give items to nearby players through the context menu or on-screen player circles.
Equipment and crafting
- Optional weapon equipping, holstering and reloading.
- Weapon ammunition and durability.
- Equipped-weapon display.
- Interactive 3D weapon attachment editing.
- Weapon finishes and tints.
- Optional clothing items and equipment slots.
- Crafting by dragging two ingredients together.
Item details
- Item and inventory metadata.
- Custom labels for individual items and inventories.
- Optional rarity colours.
- Metadata progress bars.
- Default metadata in item definitions.
- Optional cash items synchronised with the player's cash balance.
Throwing
- Separate Take to hand context-menu action.
- Press E to use a held item.
- Hold R and release to throw.
- A vertical power bar rises and falls while charging.
- Release near a peak for the longest throw.
- Thrown items become collectible world drops.
- Weapons use their own models.
Normal Use, double-clicking and item keybinds still use items immediately.
Controls
| Control | Action |
|---|---|
TAB or /inv | Open or close inventory. |
| Drag an item | Move it. |
| R while dragging | Rotate it. |
| Right-click | Show available actions. |
| Double-click | Use an item or open its container. |
| Shift + left-click | Quick-move a stack to the last touched inventory. |
| Ctrl + left-click | Quick-move half a stack. |
| Hold D while dragging a window | Show docking positions. |
| R with an equipped weapon | Reload. |
| ESC during crafting | Cancel crafting. |
| E with an item taken to hand | Use it. |
| Hold and release R with an item taken to hand | Charge and throw it. |
TAB also opens the glovebox while seated in a vehicle, or an unlocked trunk when standing near its rear.
Personal settings
Open /inventorysettings to:
- Toggle the weapon display.
- Toggle item notifications and change their duration.
- Move the weapon display and item notifications.
- Choose Small, Medium or Large UI size.
- Adjust or mute inventory sounds.
- Enable drop confirmation.
- Remember open carried containers.
- Reset window positions.
Choose Save to keep changes or Cancel to discard them.
Admin commands
Admin commands use the server's command permissions.
/giveitemor/additem/removeitem/createinventory/openinventory/resizeinventory/setinventorymetadata/setitemmetadata/inspectinventory
Example:
/giveitem 1 backpack 1
/giveitem 1 radio 1
/giveitem 1 stolen_wallet 1
Give an item with metadata:
/giveitem 1 backpack 1 {"label":"Jack's Backpack","rarity":"rare"}
Replace 1 with the player's server ID.
Saving
Player inventories, regular containers and character settings save automatically.
World drops and loot contents remain in server memory only and disappear when the resource or server restarts.