Installation

Requirements

Required Dependencies

• ox_lib - Required for UI, callbacks, and utilities
• oxmysql - Required for database operations
• Framework - One of: QB-Core, QBX-Core, or ESX

Optional Dependencies

The resource will auto-detect and use these if available:

• ox_target or qb-target - For NPC interaction
• ox_inventory or qb-inventory or esx_inventory - For item management

Installation Steps

Step 1: Download the Resource

Download legends_platechanger from your Keymaster grants or the store.

Step 2: Extract to Resources

Place the legends_platechanger folder into your server's resources directory.

resources/
└── legends_platechanger/
    ├── fxmanifest.lua
    ├── config/
    │   └── config.lua
    ├── client/
    │   ├── client.lua
    │   └── npc.lua
    ├── server/
    │   └── server.lua
    ├── shared/
    │   ├── lang.lua
    │   └── utils.lua
    ├── locales/
    │   └── en.json
    └── images/
        └── licenseplate.png

Step 3: Add to Server Config

Add the following line to your server.cfg. Make sure dependencies start first:

ensure ox_lib
ensure oxmysql
ensure qb-core   # or qbx_core or es_extended

ensure legends_platechanger

Step 4: Add the Item to Your Inventory

You must add the license plate item to your inventory system.

For ox_inventory

Add to ox_inventory/data/items.lua:

['licenseplate'] = {
    label = 'License Plate',
    stack = false,
    weight = 1000,
    close = true,
    description = "Change the vehicle's license plate",
    client = {
        image = 'licenseplate.png',
    }
},

For qb-inventory

Add to qb-inventory/shared/items.lua:

['licenseplate'] = {
    name = 'licenseplate',
    label = 'License Plate',
    weight = 1000,
    type = 'item',
    image = 'licenseplate.png',
    unique = true,
    useable = true,
    shouldClose = true,
    description = 'Change the vehicle\'s license plate'
},

For ESX Inventory

Add to your items table:

['licenseplate'] = {
    label = 'License Plate',
    weight = 1000,
    stack = false,
    close = true,
    description = "Change the vehicle's license plate"
},

Or use SQL for classic ESX inventory:

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`, `description`)
VALUES ('licenseplate', 'License Plate', 1, 0, 1, 'Change the vehicle\'s license plate');

Step 5: Add the Item Image

Copy the licenseplate.png from the images/ folder to your inventory's web/images folder:

• ox_inventory: ox_inventory/web/images/
• qb-inventory: qb-inventory/html/images/
• esx_inventory: Your inventory's image folder

Step 6: Configure (Optional)

Customize settings in config/config.lua. See the Configuration page for all options.

Step 7: Restart Server

Restart your server or use the refresh and ensure legends_platechanger commands.

Verification

After installation:

1. Check server console for "Framework detected" messages
2. The NPC should spawn at the configured location (if enabled)
3. Use the license plate item near a vehicle you own
4. Enter a new plate (3-8 characters)

Need help? Join our Discord (opens in a new tab) and open a support ticket!