Installation

How to install CustomPlates. Start this after ox_lib, oxmysql, your framework, your inventory, and Newb_Bridge.

Start this after ox_lib, oxmysql, your framework, your inventory, and Newb_Bridge. The bridge looks at what’s already running. If this script starts first, it can miss them.

Dependencies

Newb_Bridge, ox_lib, oxmysql, Server artifact and OneSync. Vehicle keys go through the bridge so the old plate key is removed and a new one is issued.

Add items and images

Paste from Item setup. Copy customizableplate.png from [INSTALL]/itemimages/ into:

InventoryImage folder
ox_inventoryox_inventory/web/images/
qb-inventory / ps-inventoryhtml/images/
one_inventoryone_inventory/web/images/

Configure

Edit configs/config.lua:

  • PlateItemName — must match the inventory item (customizableplate)
  • Settings.MinCharacters / MaxCharacters — shipped 8 / 8. Max is clamped to 8.
  • FilteredWords — rejected substrings (case-insensitive)
  • ProgressBarEnabled — true (shipped) walks to the rear, then a 5s apply progress
  • EnableOxExclusive — shipped false. true blocks giving this item to another player on ox_inventory (not rearranging it in your own inventory)

Labels: locales/en.json. Plate text must be alphanumeric. The player must be outside the vehicle, within 10.0 of a networked vehicle they own. The server re-checks at 12.0.

If jg-mechanic is started, the resource calls vehiclePlateUpdated(oldPlate, newPlate) after a successful apply.

Add to server.cfg

Swap qbx_core / ox_inventory for whatever you actually run.

ensure ox_lib
ensure oxmysql
ensure qbx_core
ensure ox_inventory
ensure Newb_Bridge
ensure MrNewbCustomPlates

Restart the server

Restart after config or item changes.

On this page