Customization

Vehicle Colors

BIT-Dealership includes a predefined color system with 24 colors. Colors are defined in RGB format.

[!CAUTION] DON'T CHANGE the color definitions unless you know what you're doing!

Colors = {
    ['gray'] = '133, 134, 148',
    ['brown'] = '140, 82, 37',
    ['olive'] = '143, 147, 34',
    ['dark green'] = '21, 92, 45',
    ['purple'] = '98, 18, 118',
    ['chrome'] = '88, 112, 161',
    ['metallic lime'] = '152, 210, 35',
    ['matte lime green'] = '102, 184, 31',
    ['util red'] = '156, 16, 22',
    ['black'] = '13, 17, 22',
    ['metallic vermillion pink'] = '223, 88, 145',
    ['metallic saxony blue'] = '48, 76, 126',
    ['metallic dark silver'] = '69, 75, 79',
    ['worn dark red'] = '55, 28, 37',
    ['util green'] = '29, 90, 63',
    ['metallic racing green'] = '18, 46, 43',
    ['metallic orange'] = '247, 134, 22',
    ['metallic surf blue'] = '118, 175, 190',
    ['hot pink'] = '242, 31, 153',
    ['metallic lava red'] = '188, 25, 23',
    ['metallic sunrise orange'] = '212, 74, 23',
    ['salmon pink'] = '253, 214, 205',
    ['metallic white'] = '255, 255, 246',
    ['worn taxi yellow'] = '241, 204, 64'
}

Available Colors

Standard Colors

Gray: Light metallic gray
Brown: Dark brown
Olive: Olive green
Black: Deep black
Metallic White: Pearl white

Green Tones

Dark Green: Forest green
Util Green: Utility green
Metallic Racing Green: British racing green
Metallic Lime: Bright lime
Matte Lime Green: Flat lime

Blue Tones

Metallic Saxony Blue: Deep blue
Metallic Surf Blue: Light ocean blue

Red & Orange Tones

Util Red: Bright red
Worn Dark Red: Burgundy
Metallic Lava Red: Vibrant red
Metallic Orange: Bright orange
Metallic Sunrise Orange: Sunset orange

Pink & Purple Tones

Purple: Deep purple
Metallic Vermillion Pink: Bright pink
Hot Pink: Neon pink
Salmon Pink: Light pink

Special Finishes

Chrome: Mirror chrome
Metallic Dark Silver: Gunmetal
Worn Taxi Yellow: Classic taxi yellow

Adding Custom Colors

To add a new color:

Add the color to the Colors table:

['my custom color'] = 'R, G, B'

Use RGB values (0-255 for each channel)

Example:

['electric blue'] = '0, 150, 255'

UI Customization

Marker Color

Change the marker color at the dealership entrance:

Marker = {
    -- RGB COLOR:
    r = 245,  -- Red channel (0-255)
    g = 14,   -- Green channel (0-255)
    b = 70    -- Blue channel (0-255)
}

Blip Color & Icon

Customize the map blip:

Blip = {
    title = "Dealership",
    color = 49,   -- Blip color ID
    sprite = 225, -- Blip icon ID
    scale = 0.9   -- Blip size
}

Common blip sprites:

225: Car dealership icon
50: Garage icon
227: Car rental icon
380: Luxury car icon

Common blip colors:

0: White
1: Red
2: Green
3: Blue
49: Dark cyan

Alert Text

Customize the entry text:

Config.enterText = "Press ~r~E~s~ to access the dealership"

Text formatting:

~r~: Red color
~g~: Green color
~b~: Blue color
~y~: Yellow color
~p~: Purple color
~w~: White color
~s~: Reset to default

Example:

Config.enterText = "Press ~g~E~w~ to browse ~y~vehicles"

Camera Settings

Adjust the showroom camera:

CamCoords = {
    x = 227.94,
    y = -995.61,
    z = -98.5,
    rotx = 360.00,  -- X rotation
    roty = 0.00,    -- Y rotation
    rotz = 0.00,    -- Z rotation
    fov = 60.00     -- Field of view
}

FOV: Lower values = zoomed in, higher values = zoomed out
Rotations: Adjust camera angle (0-360 degrees)

Vehicle Statistics Multiplier

If vehicle stats (speed bars) appear incorrect:

Config.maxspeedBarMultiplier = 3

Increase if bars are too low
Decrease if bars exceed maximum

Discord Logging

Enable Discord webhooks for purchase notifications:

Config.DiscordWebhookLink = "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

When a player purchases a vehicle, you'll receive:

Player name and identifier
Vehicle model and name
Purchase price
Payment method (cash/bank)
Timestamp

Multi-Store Setup

To create multiple dealership locations:

Config.prefix = "bit-dealership-2"

Duplicate the resource folder
Rename it (e.g., bit-dealership-luxury)
Change the prefix in config.lua
Update coordinates for the new location
Customize vehicle inventory per store
Add to server.cfg