Installation & Configuration

LX-PlateChanger – Installation & Configuration

LX-PlateChanger is a fully featured license plate changing system for FiveM, compatible with QBCore, QBox, and ESX.

---

1️⃣ Requirements

Before installing, ensure you have the following dependencies:

• ox_lib – Required for notifications, menus, and progress bars.

• oxmysql – Required for server-side functionality.

⚠ Note: Only one framework can be active at a time (QBCore, QBox, or ESX).

---

2️⃣ Installation

1. Download the latest version of LX-PlateChanger.

2. Extract the .zip file.

3. Place the folder in your server's resources directory:

   resources/[lx-scripts]/lx-platechanger

4. Add the resource to your server.cfg after ox_lib and oxmysql:

   ensure oxmysql
   ensure ox_lib
   ensure lx-platechanger

5. Add the licenseplate item to your inventory system (required for plate changes if Config.ItemCheckEnabled = true):

Ox Inventory (ox_inventory)

['licenseplate'] = {
    label = 'License Plate',
    stack = false,
    weight = 100,
    close = true,
    description = "Vehicle license plate",
    client = {
        image = 'licenseplate.png', -- provided with LX-PlateChanger
    }
},

QB Inventory (qb-inventory)

['licenseplate'] = {
    ['name'] = 'licenseplate',
    ['label'] = 'License Plate',
    ['weight'] = 100,
    ['type'] = 'item',
    ['image'] = 'licenseplate.png', -- provided with LX-PlateChanger
    ['unique'] = true,
    ['useable'] = true,
    ['shouldClose'] = true,
    ['combinable'] = nil,
    ['description'] = 'Vehicle license plate'
},

Note: Place the included licenseplate.png image in your inventory system’s html/images/items/ folder.

---

3️⃣ Configuration

All settings are managed in config.lua. Key sections:

Config.Core = 'qbox' -- Options: 'qbcore', 'qbox', 'esx'

-- Plate changing station
Config.Target = {
    Enabled = true,
    PedModel = 'ig_benny',
    PedCoords = vec4(-187.63, -1318.75, 31.3, 272.42),
    Type = 'ox_target', -- 'qb-target' or 'ox_target'
    Label = 'Change Plate',
    Blip = {
        Enabled = true,
        Sprite = 225,
        Color = 3,
        Scale = 0.8,
        Name = 'Plate Changing Station'
    },
    TextUI = {
        Enabled = true,
        Label = '[E] Change Plate',
        Key = 'E',
        Icon = 'fa-solid fa-car',
        Position = 'right-center',
        Distance = 6.0
    },
    ProgressBar = {
        Enabled = true,
        Duration = 5000,
        Label = 'Changing Plate...',
        Cancelable = true
    }
}

-- Jobs allowed to use plate changer
Config.Requirejob = true
Config.Jobs = { "police", "mechanic" }

-- Plate validation
Config.SamePlateCheck = true
Config.RequireOwner = false
Config.PriceEnabled = true
Config.Price = 99999

-- Commands & keybind
Config.CommandEnabled = true
Config.CommandName = "platechanger"
Config.CommandDescription = "Open Plate Changer"
Config.ItemCheckEnabled = true
Config.KeyEnabled = true
Config.CommandKey = "F6"

-- Required item for plate change
Config.ItemName = 'licenseplate'

-- Blacklist system
Config.BlacklistEnabled = true
Config.BlacklistedPlates = { "POLICE", "EMS", "LSPD", "GOV" }

-- Vehicle keys integration
CreateThread(function()
    if GetResourceState('qb-vehiclekeys') == 'started' then
        Config.VehicleKeys = 'qb-vehiclekeys'
        Config.GiveKeys = function(plate, vehicle)
            TriggerEvent("vehiclekeys:client:SetOwner", plate)
        end
    elseif GetResourceState('qbx_vehiclekeys') == 'started' then
        Config.VehicleKeys = 'qbox_vehiclekeys'
        Config.GiveKeys = function(plate, vehicle)
            TriggerEvent("qbx_vehiclekeys:client:GiveKeys", plate)
        end
    elseif GetResourceState('wasabi_carlock') == 'started' then
        Config.VehicleKeys = 'wasabi_carlock'
        Config.GiveKeys = function(plate, vehicle)
            TriggerServerEvent('wasabi_carlock:giveKeys', plate)
        end
    elseif GetResourceState('renewed-vehiclekeys') == 'started' then
        Config.VehicleKeys = 'renewed-vehiclekeys'
        Config.GiveKeys = function(plate, vehicle)
            TriggerServerEvent('renewed-vehiclekeys:server:giveKey', plate)
        end
    else
        Config.VehicleKeys = 'none'
        Config.GiveKeys = function(plate, vehicle)
            print("[lx-platechanger] ⚠️ No supported vehicle keys system detected.")
        end
    end
end)

-- Discord logging
Config.DiscordLoggingEnabled = true
Config.DiscordWebhook = 'https://discord.com/api/webhooks/Your_url'
Config.DiscordBotName = 'LX PLATE LOG'
Config.DiscordAvatarURL = 'https://example.com/avatar.png'

-- Localization
Config.Lang = {
    ["input"] = {
        title = 'Plate Changer',
        label = 'Plate',
        desc = 'min 1, max 8 characters'
    },
    ["notify"] = {
        owner = 'You do not own this vehicle!',
        nearby = 'Sit in the driver\'s seat of the car',
        job_required = "You need one of the allowed jobs to use this",
        item_required = "You need a platechanger to change plate",
        newlicenseplate = 'New license plate: ',
        sameplate = 'This plate already exists',
        blacklisted = 'This plate is not allowed.',
        notenoughmoney = 'Not enough cash or bank!'
    }
}

---

4️⃣ Framework-specific Notes

• QBCore:

  • Config.Core = 'qbcore'

  • Player money checks use Player.Functions.RemoveMoney('bank', amount)

• QBox:

  • Config.Core = 'qbox'

  • Avoid using exports; use player object functions for money and inventory

• ESX:

  • Config.Core = 'esx'

  • Money checks use xPlayer.removeMoney(amount)

---

5️⃣ Commands & Keybinds

• Open menu with command: /platechanger

• Open menu with keybind: F10 (default, configurable in config.lua)

---

---

✅ LX-PlateChanger is ready to use! Players can now change plates at the configured station with all checks, pricing, and logging enabled.