Kartik Scripts

Smart Vehicle Image Resolution

Garages V2 features an automatic multi-tier image resolution pipeline to render accurate vehicle preview thumbnails in the garage NUI.

๐ŸŒŸ Resolution Pipeline

When displaying a vehicle card or details modal, the UI resolves thumbnails using a 3-tier fallthrough logic:

  1. FiveM Docs WebP API: Automatically fetches standard GTA V base-game vehicle renders from https://docs.fivem.net/vehicles/<model>.webp.
  2. Local Custom Image Directory: If the vehicle is a custom or addon car, it checks for a local image placed in web/images/<model>.png.
  3. Configuration Overrides: Check explicit URL overrides defined in shared/vehicle_images.lua.

๐Ÿ“ Adding Custom Addon Car Images

To add custom images for your server's addon vehicles:

  1. Take a screenshot of the vehicle on a transparent background or white backdrop.
  2. Save the image as a .png file.
  3. Rename the file to the exact lowercased spawn model name (e.g., web/images/gtr.png for spawn model gtr).
  4. Rebuild the web asset bundle or restart the resource.

On this page