Koja Scripts
FREE

Custom Vehicle Images

By default the tablet UI fetches vehicle images from https://docs.fivem.net/vehicles/.webp — that covers every stock GTA V vehicle, but not modded cars on your server.

Custom Vehicle Images

By default the tablet UI fetches vehicle images from https://docs.fivem.net/vehicles/<respname>.webp — that covers every stock GTA V vehicle, but not modded cars on your server.

This page shows how to ship your own images for custom vehicles.

How it works

  1. You put an image file at web/build/images/vehicles/<respname>.webp.
  2. You register the respname in Config.CustomVehicleImages.
  3. The UI loads listed respnames from your local resource and falls back to docs.fivem.net for everything else.

Steps

  1. Get the vehicle image

    Recommended specs:
    • Format: .webp (PNG works but is larger)
    • Size: 512 × 256
    • Background: transparent
    • Crop: vehicle centered, side or 3⁄4 view

  2. Drop it in the right folder

    Save it as <respname>.webp in: 
    koja-carmarket/web/build/images/vehicles/
    The filename must match the spawn model exactly, in lowercase: 
    web/build/images/vehicles/mymodcar1.webp   ✅
web/build/images/vehicles/MyModCar1.webp   ❌ (case mismatch)
web/build/images/vehicles/mymodcar1.png    ❌ (wrong format unless you set up otherwise)

  3. Register it in the config

    shared/config.lua
    Config.CustomVehicleImages = {
    'mymodcar1',
    'mymodcar2',
    'supercarx',
}
    Names are normalized to lowercase server-side, but it's good practice to write them lowercase here too.

  4. Restart and test

    restart koja-carmarket. Open the tablet — your custom vehicle should now show with the local image instead of a missing-image placeholder.

Troubleshooting

SymptomLikely cause
Image shows for stock cars but not moddedRespname missing from Config.CustomVehicleImages
Modded car shows placeholder iconFile not in web/build/images/vehicles/ or name mismatch (case-sensitive)
Everything broken after rebuildDid you forget to restart koja-carmarket after building?

Bulk-registering many vehicles

If you have a vehicle pack with dozens of cars, just list them all:

Config.CustomVehicleImages = {
    'audi_r8', 'bmw_m4', 'mercedes_amg',
    'ferrari_488', 'lambo_huracan', 'porsche_911',
    -- ...
}

No artificial cap — the lookup is an O(1) Set on the frontend.

  • Parking — Players can buy individual market slots within zones, pay weekly rent, and park their listed vehicles there.
  • Overview — All tunable settings live in shared/config.lua.
  • Exchange — The exchange is the player-or-server-owned tier above zones.
  • Test Drive — Buyers can take a listed vehicle for a spin before committing to a purchase.
  • Configuration — back to the section overview