🚗dealer setup

Overview

This guide explains how to set up a new car dealership from scratch.

1

Add Dealer to Config

Open shared/config.lua and add a new dealer entry:

Config.dealers = {
    ['Your Dealer Name'] = {
        -- Configuration goes here
    },
}

2

Configure Dealer Zone

The dealer zone is the area where DUI showroom becomes active.

dealerZone = {
    enable = true,
    coords = vec3(0.0, 0.0, 0.0),     -- Center of the zone
    size = vec3(30.0, 40.0, 11.5),     -- Width, Length, Height
    rotation = 0.0,                      -- Rotation in degrees
    debug = true,                        -- Set true to visualize
},

Use debug = true to see the zone boundaries in-game while configuring.

3

Configure Map Blip

blip = {
    enable = true,
    sprite = 227,           -- Blip icon (see GTA V blip list)
    color = 5,              -- Blip color
    scale = 0.8,            -- Size on map
    shortRange = true,      -- Only show when nearby
    name = "Your Dealer"    -- Name on map
},

Common blip sprites for dealerships:

• 227 - Car dealership

• 225 - Garage

• 326 - Premium deluxe motorsport

4

Configure NUI Catalog (Optional)

The NUI catalog opens via target interaction and displays vehicles with 3D preview.

createNUI = {
    target = {
        coords = vec3(0.0, 0.0, 0.0),       -- Where player interacts
        size = vec3(1.0, 1.0, 1.0),
        rotation = vec3(0.0, 0.0, 0.0),
        debug = true,
        distance = 2.5,
    },
    camera = {
        coords = vec3(0.0, 0.0, 0.0),       -- Camera position
        rotation = vec3(-30.0, 0.0, 180.0), -- Pitch, Roll, Yaw
        fov = 90.0
    },
    vehicle = {
        coords = vec3(0.0, 0.0, 0.0),       -- Vehicle spawn position
        heading = 0.0,
        RandomTuning = true,
        TestDrive = {
            -- Test drive config
        },
        buyResult = {
            coords = vec3(0.0, 0.0, 0.0),   -- Where purchased car spawns
            heading = 0.0,
        },
    }
},

5

Configure Test Drive

TestDrive = {
    enable = true,
    coords = vec3(0.0, 0.0, 0.0),       -- Test drive start position
    heading = 160.0,
    duration = 120,                       -- Seconds
    cost = 500,                           -- Price to test drive
    costPerNotReturnVehicle = 1000,       -- Penalty per 10 seconds
    returnvehZone = {
        coords = vec3(0.0, 0.0, 0.0),   -- Return zone center
        size = vec3(5.0, 5.0, 5.0),
        rotation = 0.0,
        debug = true,
    }
},

6

Configure DUI Showroom

Option A: Replace Existing Texture

Use this when replacing textures on existing props (like dealership screens).

showRoom = {
    enable = true,
    dui = {
        type = "replace",
        replace = {
            prop = "int_luxshowroom_screens_banners",
            texture = "luxshowroomscreen2"
        },
        resolution = {
            width = 2440,
            height = 1440
        },
        interactions = {
            {
                target = {
                    coords = vec3(0.0, 0.0, 0.0),
                    size = vec3(1.0, 1.0, 1.0),
                    rotation = vec3(0.0, 0.0, 0.0),
                    debug = true,
                    distance = 2.5,
                },
                camera = {
                    coords = vec3(0.0, 0.0, 0.0),
                    rotation = vec3(0.0, 0.0, 0.0),
                    fov = 20.0
                }
            },
        }
    },
    carSpawn = {
        removeVehTime = 50,
        carOptions = {
            coords = vec3(0.0, 0.0, 0.0),
            heading = 120.0,
            canTuning = true,
            randomTuning = true,
        }
    }
}

Option B: Spawn TV Prop

Use this to spawn a TV prop with DUI texture.

showRoom = {
    enable = true,
    dui = {
        type = "prop",
        resolution = {
            width = 2440,
            height = 1440
        },
        objects = {
            {
                prop = "prop_tv_flat_03b",
                coords = vec3(0.0, 0.0, 0.0),
                rotation = vec3(-20.0, 0.0, 120.0),
                replace = {
                    prop = "prop_tv_flat_03b",
                    texture = "script_rt_tvscreen"
                }
            },
        },
        interactions = {
            -- Same as above
        },
    },
    carSpawn = {
        -- Same as above
    }
}

7

Create Vehicle Data

Create a JSON file in data/dealers/ with the dealer name (lowercase, underscores for spaces):

Example: your_dealer_name.json

{
    "categories": [
        {
            "name": "Sports",
            "vehicles": [
                {
                    "name": "Elegy RH8",
                    "spawnName": "elegy2",
                    "price": 95000,
                    "stock": 5,
                    "productionYear": 2020,
                    "maxSpeed": 210,
                    "speed": 8,
                    "acceleration": 8,
                    "handling": 8,
                    "braking": 7
                }
            ]
        }
    ]
}

8

Configure Other Place Showroom (Optional)

Teleport players to a separate location for the showroom:

carSpawn = {
    otherPlace = {
        exitInteraction = {
            coords = vec3(-1072.8, -62.5, -99.0),
            size = vec3(1.0, 1.0, 1.0),
            rotation = vec3(0.0, 0.0, 0.0),
            debug = false,
            distance = 2.5,
        },
        spawnCoords = vec3(-1072.8, -62.5, -99.0),
    },
    carOptions = {
        coords = vec3(-1071.9, -74.5, -99.0),
        heading = 120.0,
        canTuning = true,
        randomTuning = true,
    }
}

9

Finding Coordinates

Use these commands in-game to find coordinates:

/coords - Get current position
/heading - Get current heading

Or use external tools like:

• vMenu

• Lambda Menu

• CodeWalker

10

Testing Your Setup

• Set all debug options to true

• Restart the resource: ensure sl-cardealer

• Walk around and verify:

  • Zone boundaries are correct

  • Target interactions appear

  • Camera angles look good

  • Vehicles spawn in correct positions

• Test the full flow:

  • Enter dealer zone

  • Interact with catalog

  • Select vehicle

  • Start test drive

  • Return vehicle

• Set debug to false when done