Configuration

Main Configuration (shared/config.lua)Copy Anchor Link

This file contains general settings for categories, brands, test drives, and core logic.

General SettingsCopy Anchor Link

• Config.DefaultGarage: The default garage where purchased vehicles are delivered.
• Config.PlateFormat: Define the format for generated license plates (e.g., NLLNNNLL).
• Config.RepoDays: Maximum days a vehicle can be seized before it is fully repossessed.
• Config.AllowSellToDealer: Enable or disable the ability for players to sell their vehicles to the dealership.
• Config.SellToDealerDepreciation: The multiplier applied to the base price when selling to the dealer (e.g., 0.6 for 60%).

Dynamic PricingCopy Anchor Link

Config.DynamicPricing = {
    enabled = true,
    demandMultiplier = 0.05,  -- +5% per pending unit
    maxMultiplier = 1.5,      -- cap at 150% of base price
    minMultiplier = 0.8       -- cap at 80% of base price
}

Test Drive SettingsCopy Anchor Link

• Config.TestDriveAmount: The cost to start a test drive.
• Config.EnableTestDriveTimer: Toggle the time limit for test drives.
• Config.TestDriveTime: Duration of the test drive in seconds.
• Config.SpeedTargets: Definition of speed goals for the test drive UI.
• Config.DistanceTargets: Definition of distance goals (e.g., Half Mile, One Mile).

Rental SettingsCopy Anchor Link

• Config.Rental.maxDays: Maximum duration for a vehicle rental.
• Config.Rental.deposit: Security deposit amount.
• Config.Rental.taxRate: Tax rate applied to the rental cost.

Showrooms (shared/config_showrooms.lua)Copy Anchor Link

This file defines the different showrooms available on your server.

Each showroom entry includes:

• label: The name displayed in the UI and on the map.
• enableBlip: Toggle the map blip.
• blip: Customize the blip ID, coordinates, color, and scale.
• zone: A polygon definition for the showroom area (used for spawning display vehicles).
• sellZones: Areas where players can initiate selling their vehicles.
• CustomerTab/ManagementTab: Coordinates and sizes for the interaction zones.
• delivery: Spawn points for purchased vehicles.

Classes & Scoring (shared/config_classes.lua)Copy Anchor Link

Defines how vehicles are ranked based on their performance stats.

• Config.Classes: Maps performance scores (0-100) to classes (S, A, B, C, D).
• Config.Parameters: The weights for different performance metrics:
  • acceleration: 35%
  • topSpeed: 30%
  • handling: 20%
  • braking: 15%

Server Settings (shared/config_server.lua)Copy Anchor Link

Contains sensitive server-side settings.

• ServerConfig.AdminWebhook: Discord webhook for administrative logging (e.g., NUI exploit detection).
• ServerConfig.DiscordBotToken: Used for Discord API integrations.
• ServerConfig.GuildID: Your server's Discord Guild ID.