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 Name
Label
Description

trash_grabber

Trash Grabber Kit

Used during trash collection missions. Equips grabber + bin bag.

cleaning_water_gun

Cleaning Water Gun

Used during window cleaning missions. Equips spray gun.

window_cleaning_drone

Cleaning Drone

Used during drone cleaning missions.

window_squeegee

Window Squeegee

Used during window cleaning missions. Equips squeegee.

cleaning_broom

Cleaning Broom

Used 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):

qb-core/shared/items.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:


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.luaarrow-up-right match the item names exactly as you've defined them in your inventory.

Last updated