Installation

Installation

1. Ensure ox_lib is installed and started.
2. Ensure oxmysql is installed, started, and connected to your database.
3. Place nexra_handling-editor in your resources folder.
4. Add the following to server.cfg:

ensure ox_lib
ensure oxmysql
ensure nexra_handling-editor

5. Add your allowed staff licenses in config.lua (see Permissions).
6. Restart the server (or start the resource).

Load order

Start ox_lib and oxmysql before nexra_handling-editor. Your framework should also be started first if you want character names and framework vehicle-name lookups.

Dependencies

Required

Auto-detected

Framework bridging is used for editor names and vehicle spawn-name lookups when available.

For other frameworks or notify systems, edit framework/custom/ or modules/notifications/custom/.

Permissions

Handling Editor uses a license allowlist in config.lua.

Config.HandlingEditor = {
    AllowedLicenses = {
        'license:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
    },
}

Add each approved staff member's FiveM license identifier:

AllowedLicenses = {
    'license:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
    'license:YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY',
}

If AllowedLicenses is empty, everyone can open the editor. For production servers, keep this list restricted to trusted staff.

Database

No manual SQL import is required. On startup, the resource creates these tables if they do not exist:

Saved uploads are broadcast to clients and applied when matching vehicles are entered or scanned.

Locales

Locale files live in locales/. Set Config.Locale in config.lua.

Included: en, de, es, fr, nl, pt-br, tr, cs

Branding

The shipped UI includes editable branding assets:

Replace the logo file with your own image, or edit theme.css to adjust the UI theme.

Editable files

These remain open for customization (escrow ignore):

• config.lua
• locales/*.json
• shared/handling_config.lua
• server/handling_editor.lua
• framework/**/*.lua
• modules/**/*.lua