[Tutorial] QBCore - How to add items correctly

[Yorzen]

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)

1. Open /resources/[qb]/qb-core/shared/items.lua (MAKE BACKUP BEFORE EDITING!)
2. 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.
3. Drag & Drop the filename.png into /resources/[qb]/qb-inventory/html/images folder.
   FILENAME SHOULD BE IDENTICAL TO THE NAME IN THE CODE!
4. Add thirst and hunger values for drinks and food go to /resources/[qb]/qb-smallresources/config.lua MAKE BACKUP BEFORE EDITING!
5. Go to /resources/[qb]/qb-smallresources/server/consumables.lua and copy and edit this example code:

QBCore.Functions.CreateUseableItem("sandwich", 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)

6. Rename “sandwich” to your desired item name If consumable and save changes.

Optional - Add an item to shop / gas station / hardwarestore etc…:

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

        [14] = {
            name = "clipper420",
            price = 10,
            amount = 420,
            info = {},
            type = "item",
            slot = 14,
        },

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

Visit our server Harmony RP|18+|Discord|Global / Cfx.re (click to join)
Discord: 𝓗𝓪𝓻𝓶𝓸𝓷𝔂 𝓡𝓟 | 18+🌎
Peace,
Yorzen

[proportions]

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

[Yorzen]

Thank you sir

[AstroGurl]

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

[Apina0]

Thanks, really helpful!

[_Sandell]

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]

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]

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]

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