Configuration

Overview

• config.lua: Auto-detection overrides, debug, waypoint settings, inventory image path
• config_server.lua: Admin permissions, log provider, FiveManage token

All settings live in two files. Most values should remain 'auto'.

System Detection

1Config.Framework   = 'auto'
2Config.Inventory   = 'auto'
3Config.Target      = 'auto'
4Config.Notify      = 'auto'
5Config.Dispatch    = 'auto'
6Config.ProgressBar = 'auto'
7Config.Fuel        = 'ml_fuel'
8Config.Input       = 'auto'
9Config.Menu        = 'auto'
10Config.HelpText    = 'auto'
11Config.VehicleKeys = 'ml_vehiclekeys'
12Config.Clothing    = 'auto'

• Each value can be set to 'auto' (recommended) or forced to a specific provider name
• 'auto' probes which resource is started and picks the first match
• Override only when you have multiple systems installed and want to force a specific one

General

1Config.Debug = false

• Debug: Prints detection results and internal logs. Keep off in production.

Admin Permissions

1Config.AdminPermissions = { 'admin', 'god', 'superadmin' }

• AdminPermissions: ACE permission groups that Bridge.HasPermission() checks against. Add or remove groups to match your server's permission structure.

Logging

1Config.LogProvider       = 'discord'
2Config.FiveManageToken   = ''
3Config.FiveManageDataset = 'default'

• LogProvider: Which provider(s) to send logs to:

- 'discord': Discord webhooks only

- 'ox_lib': ox_lib logger only

- 'fivemanage': FiveManage only

- 'both': Discord + FiveManage

- 'all': Discord + ox_lib + FiveManage

• FiveManageToken: API token for FiveManage (can also be set via convar fivemanage:key)
• FiveManageDataset: FiveManage dataset name

Logs are batched and sent every 60 seconds. Discord batches max 10 embeds, FiveManage batches max 25 entries.

Inventory Image Path

1Config.InventoryImagePath = nil
2Config.InventoryImageExt  = '.webp'

• InventoryImagePath: Override the image path for item icons. nil = auto-detect based on inventory system
• InventoryImageExt: Override the image file extension. Default '.webp', falls back to '.png' on some inventories

Auto-detected paths per inventory system: nui://ox_inventory/web/images/, nui://qb-inventory/html/images/, etc.

Waypoints

1Config.Waypoints = {
2    syncToWayPoint = true,
3
4    mapWaypoint = {
5        type = 'checkpoint',
6        label = 'WAYPOINT',
7        color = '#f500fc',
8        size = 1.0,
9        drawDistance = 1000.0,
10    },
11
12    defaults = {
13        drawDistance = 500.0,
14        fadeDistance = 400.0,
15        size = 1.0,
16        minHeight = 0.5,
17        maxHeight = 50.0,
18        groundZOffset = -2.0,
19        color = '#f5a623',
20        label = 'CHECKPOINT',
21        displayDistance = true,
22    },
23
24    dui = {
25        width = 512,
26        height = 1024,
27    },
28
29    rendering = {
30        updateInterval = 100,
31        distanceUpdateInterval = 100,
32        perspectiveDivisor = 20.0,
33        checkpointBaseMultiplier = 4.0,
34        checkpointMinScale = 0.1,
35        checkpointAspectRatio = 2.0,
36        smallMinScale = 1.0,
37        smallAspectRatio = 2.0,
38    },
39
40    server = {
41        cleanupInterval = 60000,
42    },
43}

• syncToWayPoint: Automatically create a 3D waypoint marker when the player sets a GTA map waypoint
• mapWaypoint: Visual style for the auto-synced map waypoint
• defaults: Default values for any waypoint created without specifying these fields
• dui: DUI texture resolution. Higher values = sharper text, more VRAM
• rendering: Performance tuning for the render loop. updateInterval controls how often visibility checks run (ms)
• server.cleanupInterval: How often the server prunes waypoints for disconnected players (ms)

For full Waypoints documentation, see the dedicated Waypoints page.