Advanced Vehicle Customization & Preset System

EX-EXTRASMENU is a fully optimized, feature-rich vehicle customization menu built for ESX, QBCore & QBox servers. Designed for performance, flexibility, and clean integration.

✨ Core Features

🎨 Full Vehicle Customization

• Liveries
• Primary & Secondary Colors
• Window Tints
• Neon Lights (multi-color)
• Custom License Plates
• Wheels & Rims (All categories + wheel color + tire smoke)
• Engine, Brakes, Transmission
• Turbo, Exhaust, Suspension (height adjust)
• Armor
• Toggle 20+ Extras
• Individual Door Control
• Full Repair & Vehicle Wash

💾 Advanced Preset System

• Save / Load / Delete / Rename
• Favorites (★ indicator)
• Descriptions (500 char limit)
• Preview Mode (confirm/cancel)
• Undo Last Change
• Vehicle-specific filtering
• MySQL persistence (oxmysql)
• Timestamp tracking

🔐 Access Control

• Job-based restrictions
• Service vehicle filtering
• Vehicle whitelist
• Configurable world markers + map blips
• Optional /vehicleextras command
• Keybind support (F10 or custom)

🎮 Framework & UI Support

• Auto-detect: ESX / QBCore / QBox
• OX Lib integration
• Custom notification support
• Multiple Text UI systems
• Configurable progress bars
• Movement lock during actions

⚙️ Configuration & Security

• 30+ vehicle colors
• Cooldown system
• Feature toggles
• Localization ready (50+ keys)
• Input sanitization
• SQL injection protection
• Player-isolated database storage

🗄️ Database

• oxmysql backend
• Auto table creation
• InnoDB + UTF8MB4
• Unique preset constraints
• ESX & QBCore compatible identifiers

🔧 Dependencies

• oxmysql
• ESX / QBCore / QBox

📝 Config

Config = {}

--[[

    ================================================
    VEHICLE EXTRAS MENU CONFIGURATION
    ================================================
    Thank you for using this resource!
    Please read the comments carefully for each section.
    ================================================

--]]

--[[

    FRAMEWORK SETTINGS
    The script will try to auto-detect your framework, but you can force it here if needed.

--]]

Config.Framework = "Auto-Detect" -- Options: "Auto-Detect", "ESX", "QBCore"

--[[

    DEBUG & NOTIFICATIONS
    Controls how messages are displayed to players.

--]]

Config.EnableDeveloperMode = false -- [!! SECURITY WARNING !!] Set to `true` ONLY for testing. Allows extra debug prints and could reveal sensitive information.

Config.DefaultFrameworkNotification = "Auto-Detect" -- Options: "Auto-Detect", "QBCore", "ESX", false

Config.CustomNotification = false -- Options: false, "Quasar", "OkOk", "Brutal", "OX", "CD", "custom"

--[[

    ACCESS CONTROL
    Define which players can use the menu and how they access it.
    
--]]

Config.AllowedJobs = {
    "police",
    "sheriff",
    "ambulance"
}

Config.Command = {
    EnableCommand = false,
    CommandName = "vehicleextras",
}

Config.KeyBinds = {
    EnableKeybind = false,
    DefaultKeybind = "F10",
}

--[[

    VEHICLE RESTRICTIONS

--]]

Config.AllowOnlyServiceVehicles = true

Config.WhitelistedVehicles = {
    "police",
    "police2",
    "police3",
    "ambulance",
    "firetruk",
    "fbi",
    "fbi2",
    "adder"
}

--[[

    MENU LOCATIONS (MARKERS)

--]]

Config.Markers = {
    MarkerPositions = {
        vector3(407.97, -997.02, 29.85),
        vector3(-605.05, -902.80, 25.92),
    },
    MarkerType = 27,
    MarkerColor = { r = 0, g = 0, b = 255, a = 100 },
    MarkerScale = { x = 1.5, y = 1.5, z = 1.0 },
    MarkerDrawDistance = 10.0,
}

--[[

    BLIP SETTINGS

--]]

Config.Blips = {
    EnableBlips = true,
    BlipName = "Vehicle Extra Menu",
    BlipSprite = 566,
    BlipColor = 5,
    BlipScale = 0.7,
}

--[[

    MENU FEATURE TOGGLES

--]]

Config.Menus = {
    EnableColorMenu = true,
    EnablePresets = true,
    EnableLicensePlate = true,
    EnableRepairVehicle = true,
    EnableWashVehicle = true,
    EnableWindowTints = true,
    EnableNeons = true,
    EnableWheels = true,
    EnableSuspension = true,
    EnableDoorControl = true,
    EnablePerformance = true,
    EnableArmor = true,
}

--[[

    COOLDOWNS & LIMITS

--]]

Config.MaxNumOfExtras = 20

Config.Liveries = {
    LiveriesCooldownEnabled = false,
    LiveriesCooldownTime = 5000,
}

Config.Extras = {
    ExtrasCooldownEnabled = false,
    ExtrasCooldownTime = 3000,
}

Config.Suspension = {
    SuspensionCooldownEnabled = false,
    SuspensionCooldownTime = 5000,
}

--[[

    LOGGING & WEBHOOKS

--]]

Config.DiscordWebhook = ""

Config.AdminCommands = {
    EnableClearPresets = true,
    EnableDeletePreset = true,
    EnableListPresets = true,
    EnableExportPresets = true,
    EnableAuditLogs = true,
    EnableTestWebhook = true,
    EnableTestIdentifier = true
}

--[[

    USER INTERFACE (UI)

--]]

Config.DrawTextUI = {
    Enabled = true,
    OX_TextUi = true,
    QBCore_TextUI = false,
    ESX_TextUi = false,
    CD_TextUi = false,
    Custom_TextUi = false,

    Position = "right",
    OX_Position = "left-center",

    ESX_TextUi_Type = "success",
}

--[[

    PROGRESS BAR

--]]

Config.Progressbar = {
    Time = 5000,

    disableMovement = true,
    disableCarMovement = true,
    disableMouse = false,
    disableCombat = true,

    OX_ProgressCircle = false,
    OX_ProgressBar = true,
    ESX_Progress = false,
    QBCore_Progress = false,
}