Skip to content
⌘ K

Items

Items#

Inventory Item Configuration

Update your inventory configuration by adding the following items required for the various cleaning missions (Window Cleaning, General Cleaning, Street Cleaning, etc).

Required Items Overview#

Item NameLabelDescription
trash_grabberTrash Grabber KitUsed during trash collection missions. Equips grabber + bin bag.
cleaning_water_gunCleaning Water GunUsed during window cleaning missions. Equips spray gun.
window_cleaning_droneCleaning DroneUsed during drone cleaning missions.
window_squeegeeWindow SqueegeeUsed during window cleaning missions. Equips squeegee.
cleaning_broomCleaning BroomUsed during street cleaning missions. Equips broom.

QBCore / ESX Setup#

Add the following items to your shared items configuration file (e.g., qb-core/shared/items.lua or your framework's equivalent):

text
qb-core/shared/items.lua
lua
trash_grabber             = { name = 'trash_grabber',             label = 'Trash Grabber Kit',     weight = 500,  type = 'item', image = 'trash_grabber.png',         unique = false, useable = true, shouldClose = true, description = 'Equipment for trash collection missions' },
cleaning_water_gun        = { name = 'cleaning_water_gun',        label = 'Cleaning Water Gun',    weight = 1000, type = 'item', image = 'cleaning_water_gun.png',    unique = false, useable = true, shouldClose = true, description = 'Water gun for window cleaning missions' },
window_cleaning_drone     = { name = 'window_cleaning_drone',     label = 'Cleaning Drone',        weight = 2000, type = 'item', image = 'window_cleaning_drone.png', unique = false, useable = true, shouldClose = true, description = 'Drone for cleaning missions' },
window_squeegee           = { name = 'window_squeegee',           label = 'Window Squeegee',       weight = 500,  type = 'item', image = 'window_squeegee.png',       unique = false, useable = true, shouldClose = true, description = 'Squeegee for window cleaning missions' },
cleaning_broom            = { name = 'cleaning_broom',            label = 'Cleaning Broom',        weight = 1000, type = 'item', image = 'cleaning_broom.png',        unique = false, useable = true, shouldClose = true, description = 'Broom for street cleaning' },

Note: Don't forget to extract the images from the script's images/ directory and place them into your inventory resources (e.g., qb-inventory/html/images/).

QBox & OX Inventory Setup#

If you are using ox_inventory, add these items to your ox_inventory/data/items.lua:

text
ox_inventory/data/items.lua
lua
['trash_grabber'] = {
    label = 'Trash Grabber Kit',
    weight = 500,
    stack = true,
    close = true,
    description = 'Equipment for trash collection missions',
},

['cleaning_water_gun'] = {
    label = 'Cleaning Water Gun',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Water gun for window cleaning missions',
},

['window_cleaning_drone'] = {
    label = 'Cleaning Drone',
    weight = 2000,
    stack = true,
    close = true,
    description = 'Drone for cleaning missions',
},

['window_squeegee'] = {
    label = 'Window Squeegee',
    weight = 500,
    stack = true,
    close = true,
    description = 'Squeegee for window cleaning missions',
},

['cleaning_broom'] = {
    label = 'Cleaning Broom',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Broom for street cleaning',
},

Item Behavior Details#

  • Trash Grabber Kit (trash_grabber)
    • ✅ Used during mission → Equips grabber tool + bin bag in hands.
    • ❌ Used outside mission → "You are not on a mission!" warning.
    • 🗑️ Mission ends → Automatically removed from inventory (if the script expects temporary equipment).
  • Cleaning Water Gun (cleaning_water_gun)
    • ✅ Used during mission → Activates water gun.
  • Cleaning Broom (cleaning_broom)
    • ✅ Used during mission → Equips/Unequips broom prop.

[!NOTE] Ensure that item strings in your shared/config.lua match the item names exactly as you've defined them in your inventory.