Making inventory images for FiveM weapons

#The naming rule

The file must be named exactly after the item, with a .png extension. On ox_inventory weapon items use the uppercase name, so WEAPON_MYGUN needs WEAPON_MYGUN.png — the same as the stock images it ships with. On QBCore items are lowercase, so the image is weapon_mygun.png (or whatever the item’s image field says). Not weapon_mygun.jpg, not weapon-mygun.png. Inventories look for an exact match and show a placeholder when they do not find one, and Linux hosts also treat capitalisation as part of the name.

#Where each inventory reads from

• ox_inventory - ox_inventory/web/images/
• qb-inventory - qb-inventory/html/images/ (some forks differ; match wherever the existing weapon images live)
• Older ESX inventories - usually an html/img folder inside the inventory resource

#What makes an icon look right

• 512x512 with a transparent background. Larger is wasted; smaller looks soft on high-resolution displays.
• The weapon at a slight angle rather than dead side-on, so it reads as a three-dimensional object in a small square.
• Consistent framing across your whole set - roughly the same margin on every icon. A grid where every gun is a different size looks unfinished.
• Neutral, even lighting. Heavy shadows read as smudges once the image is scaled down to a slot.
• No background box, no drop shadow baked in, no watermark.

#Producing them

By hand, that means loading the model in a viewer, framing it, rendering with a transparent background and cropping consistently for every weapon in the pack - slow, and hard to keep uniform across a large set.

Every resource exported from our library ships with its icons already rendered: a transparent 512x512 image per weapon, framed identically across the whole pack, named exactly as the item, with the matching inventory entries generated alongside. Copying them into web/images/ is the entire job. If you would rather not draw them, 18,574 inventory icons rendered from the game’s own models are free to take, and an icon maker squares up your own.