FiveM QBCore Item Definition Builder

Generate properly formatted QBShared.Items definitions for qb-core/shared/items.lua. Configure all item flags, add multiple items, and copy ready-to-paste Lua in one click.

Quick-Add Presets

Clicking a preset adds it as a new item below.

Item Name * (Lua table key)

snake_case, e.g. police_badge

Label *

Display name shown in inventory

Weight (grams, 0–10000)

Description (optional)

Image filename

Leave blank to use default: item.png. Place images in qb-core/html/images/.

Unique each instance is unique Useable has a use action Should Close close inventory on use Stackable items can stack Combinable can combine with items Decay item degrades over time

Output — items.lua

Paste inside the QBShared.Items table in qb-core/shared/items.lua

-- Paste these entries inside QBShared.Items = { ... } in qb-core/shared/items.lua
-- Generated by DustBowl.Games QBCore Item Builder — https://dustbowl.games/tools/fivem-qbcore-item

['unnamed'] = {
    name = 'unnamed',
    label = 'unnamed',
    weight = 200,
    type = 'item',
    image = 'item.png',
    unique = false,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = '',
},

Server-side UseItem Boilerplate for useable items

-- Place this in a server-side script in your resource
-- (e.g. server/main.lua). Runs once when the resource starts.

local QBCore = exports['qb-core']:GetCoreObject()

-- No useable items defined yet.

Place this in a server-side script in your resource. Register each useable item once on resource start. Replace the -- your logic here comment with your item's actual server logic.

About QBCore items & where to paste

Open qb-core/shared/items.lua and find the QBShared.Items table (it starts with QBShared.Items = {). Paste your new definitions before the closing }.

unique — when true, each item instance carries its own metadata. Use for documents, IDs, anything with per-instance data.

useable — when true, the item appears in the "Use" context menu. You must still register the use callback with QBCore.Functions.CreateUseableItem in a server script.

shouldClose — closes the QB inventory UI when the item is used. Recommended for most interactive items.

combinable — set to a table describing the combination recipe, or nil to disable. This builder outputs nil as a placeholder.

decay — set to a number (seconds) for the item to degrade, or false to disable. This builder outputs false as a placeholder.

Item images go in qb-inventory/html/images/ (or qb-core/html/images/ depending on your QB version). The filename must match the image field exactly.

Reference: QBCore docs — Shared Items

Private FiveM hosting

Run your own FiveM server.

Rent a private FiveM server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.

Rent a FiveM server Real hardware · Full control panel · 98% SLA

Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.