[UPDATED] QBCore - How to add items correctly by Yorzen

Yorzen · 2022-05-31T00:26:30.050Z

Hey there,
Yorzen here with a quick & easy tutorial for adding items into your server. [QBCore framework]

Things you will need:

100x100px .png file of your desired item.
Access to the FTP Server. (can be used locally)
Patience and a functioning brain
Copy & Paste skills (It’s NOT a joke, while dealing with huge files such as items.lua be careful)

Now carefully follow these instructions…

1. Open /resources/[qb]/qb-core/shared/items.lua (MAKE BACKUP BEFORE EDITING!)

items.lua: (Example Line of Code)

coffee = { name = 'coffee', label = 'Coffee', weight = 200, type = 'item', image = 'coffee.png', unique = false, useable = true, shouldClose = true, description = 'Buy me a cup of Caffeine.' },

Then,

1. Add the correct line of code of a similar item (copy & paste similar line of code) edit the item details such as weight, description and so on… then save changes.
1. Drag & Drop the filename.png into /resources/[qb]/qb-inventory/html/images folder.
  FILENAME SHOULD BE IDENTICAL TO THE NAME IN THE CODE!
1. Add thirst and hunger values for drinks and food go to /resources/[qb]/qb-smallresources/config.lua MAKE BACKUP BEFORE EDITING!
1. Go to /resources/[qb]/qb-smallresources/server/consumables.lua and copy and edit this

example code:

QBCore.Functions.CreateUseableItem("coffee", function(source, item)
    local Player = QBCore.Functions.GetPlayer(source)
	if Player.Functions.RemoveItem(item.name, 1, item.slot) then
        TriggerClientEvent("consumables:client:Eat", source, item.name)
    end
end)

1. Rename “coffee” to your desired item name If consumable and save changes.

Optional - Add an item to a Shop / Gas Station / Hardware Store etc…:

1. Make sure the item is properly added to the server both in items.lua file & images folder.
1. Go to /resources/[qb]/qb-shops/config.lua and edit as shown below (example):
  (MAKE BACKUP BEFORE EDITING!)

        [69] = {             -- Represent the slot of the item in store, replace 69 with whatever you want..
            name = "coffee", -- This is Important, use **only** the same name across all scripts...
            price = 10,      -- The price of the item, is here change it to how much you want.
            amount = 420,    -- How MANY items are in stock of the store...
            info = {},       -- Description of the item
            type = "item",   -- guess what, It's an item type item... yea.. go figure what jbib is.. :D
            slot = 69,       -- Use actual number that makes sense, this is just an example
        },

Important notes: The Item Number [ ] in config.lua must be incremented by +1 *Last item on the list copy and paste and change both [x] and slot = x increase by +1 (Example: [14] turns to [15])
Important: .png file resolution must be 100 x 100px
Important: Edit values of Weight, Price, Description etc…

Verify and save all config files and restart the server to see the changes.

If you’re still struggling let me know down in the comments I’ll do my best to simplify it a little more.

P.S I’ve tried to look for a tutorial and didn’t find any of this topic thought it could help some of you out there good luck!

And if I helped you, I’m glad

proportions · 2022-06-16T15:21:11.673Z

Nice tuto, it will become handy for beginner developers on qbcore.

Yorzen · 2022-06-19T08:47:14.259Z

Thank you sir

AstroGurl · 2023-01-01T15:54:08.990Z

How would i add a table to my database for my items

Apina0 · 2023-02-12T00:26:31.370Z

Thanks, really helpful!

_Sandell · 2023-02-27T00:13:38.760Z

Has there been an update at some point within the framework coding since you posted this?

Context: I had a server previously, running an older version of Qbus and everything worked perfectly after following these steps given by yourself <3

I have since updated Qbus to it’s latest framework, and now additional items I have added don’t seem to work.

I have added all the images to qb-inventory/html/images
Images added

I have added all the items to qb-core/shared/items.lua
Items added to qb-core

However, the problem I find, is when I add the items to qb-smallresources/config.lua (like I did before)
Seen here
The game then decides that I can’t use the items

So… I checked out the qb-smallresources/server/consumables.lua and noticed a change in the way the script is presented to how I did it previously.
Consumables differences shown here

I tested out using a copy of the consumables.lua from my old server into my new server and then the characters were able to consume a product, emote eating a burger or drinking a bottle, but it would not replenish any hunger or thirst. It also started flagging up that ‘progressbar’ couldn’t detect the events required.

So now I have reverted back to the default qb-smallresources and will have to wait on some eye opening answer for my problem until I attempt it again.

RayanCin89228 · 2024-02-02T12:26:27.637Z

hello, I have some issues.

I created blackmoney as item, and when I tried the item (doing a robbery) my inventory just shows 100 (not the real amount that i robbed)

I edited the max amount on qb-inventory but it’s always showing just 100.

I don’t know if its an error of the item created or what, but with the cash its working perfectly.

Comic_Gaming · 2024-02-25T16:21:34.530Z

New Format is Made On latest Nowadays looking like this aswell gonna throw up a tutorial for all thats been changed in the lastest ones later on aswell

Config.Products = {
[‘normal’] = {
{name = ‘tosti’, price = 20, amount = 100, info = {}, type = ‘item’},
{name = ‘water_bottle’, price = 20, amount = 100, info = {}, type = ‘item’},
{name = ‘kurkakola’, price = 20, amount = 100, info = {}, type = ‘item’},
{name = ‘twerks_candy’, price = 20, amount = 100, info = {}, type = ‘item’},
{name = ‘snikkel_candy’, price = 20, amount = 100, info = {}, type = ‘item’},
{name = ‘sandwich’, price = 20, amount = 100, info = {}, type = ‘item’},
},

Yorzen · 2024-03-05T20:20:21.640Z

Thanks for letting me know, I will update it to the new version of QB-Core Items.lua

Chaine_floscke · 2024-06-05T09:43:52.536Z

hello voici mon problem j’ai refait tout les étape mais ca change rien [ script:qb-inventory] AddItem: Invalid item

eldediamante · 2024-06-25T15:28:22.713Z

Thanks men

XHIBIT · 2024-07-26T00:14:51.322Z

Any update to this ?

Yorzen · 2024-11-16T06:29:26.245Z

Updated the tutorial to the latest version of QBCore