🏪nova_dealership

NOVA Framework vehicle dealership system. Buy, test drive, and rent vehicles at configurable dealership locations.

Features

• Buy Vehicles — Purchase vehicles with cash or bank money

• Test Drive — Try vehicles for a limited time before buying

• Rental System — Rent vehicles for a configurable number of days

• Multiple Locations — Support for multiple dealerships with different vehicle inventories

• Vehicle Categories — Organize vehicles by type (sedan, SUV, sports, etc.)

• Color Selection — Choose vehicle color at purchase

• Resale — Sell back vehicles at a percentage of purchase price

Configuration

Edit config.lua:

DealerConfig = {
    ResalePercent = 0.6,                -- 60% resale value
    TestDriveTime = 60,                 -- Test drive duration (seconds)
    TestDriveReturnDist = 50.0,         -- Max return distance
    RentalDays = 7,                     -- Default rental period
    DefaultGarage = 'legion',           -- Garage for purchased vehicles

    GeneratePlate = function()
        -- Custom plate generation logic
    end,

    Locations = {
        {
            name = 'pdm',
            label = 'Premium Deluxe Motorsport',
            shopType = 'car',
            blip = { sprite = 326, color = 3, scale = 0.7 },
            ped = { model = '...', coords = vector4(...) },  -- Configure per location
            spawn = vector4(...),
            camera = { coords = vector3(...), target = vector3(...) },
        },
        -- More locations...
    },

    VehicleModels = {
        -- UI display name → GTA spawn name
        ['Adder'] = 'adder',
        ['Sultan'] = 'sultan',
    },

    Colors = {
        { id = 0, label = 'Black' },
        { id = 1, label = 'Graphite' },
        -- More colors...
    },
}

Configuration Options

Option	Type	Description
ResalePercent	number	Percentage of original price on resale (0.0–1.0)
TestDriveTime	number	Test drive duration in seconds
TestDriveReturnDist	number	Max distance to return test drive vehicle
RentalDays	number	Default rental period in days
DefaultGarage	string	Garage ID where purchased vehicles are stored
Locations	table	Dealership locations with ped, spawn, camera
VehicleModels	table	Vehicle display name to spawn model mapping

How It Works

1. Player approaches a dealership NPC

2. NUI opens showing available vehicles with prices

3. Player can browse, test drive, or purchase

4. On purchase, vehicle is registered in nova_vehicles table and assigned to DefaultGarage

5. Test drives have a timer — vehicle is deleted when time expires or player returns

Dependencies

• nova_core — Player data, money system

• nova_garage — Vehicle registration and storage

• oxmysql — Database operations

Notes

• Purchased vehicles receive an auto-generated license plate

• Vehicle modifications and color are saved on purchase

• Test drive vehicles cannot be stored in garages

• Rental vehicles expire after the configured number of days

• The NUI displays vehicle previews with a camera system