# Configuration

> Configuration reference for ML Bridge

Category: BRIDGE · Source: https://miciomods.it/docs/ml-bridge-configuration · Last updated: 2026-07-28

## 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

**config.lua**

```lua
Config.Framework   = 'auto'
Config.Inventory   = 'auto'
Config.Target      = 'auto'
Config.Notify      = 'auto'
Config.Dispatch    = 'auto'
Config.ProgressBar = 'auto'
Config.Fuel        = 'ml_fuel'
Config.Input       = 'auto'
Config.Menu        = 'auto'
Config.HelpText    = 'auto'
Config.VehicleKeys = 'ml_vehiclekeys'
Config.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

**config.lua**

```lua
Config.Debug = false
```

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

## Admin Permissions

**config_server.lua**

```lua
Config.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

**config_server.lua**

```lua
Config.LogProvider       = 'discord'
Config.FiveManageToken   = ''
Config.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.

> **TIP:** Disable a Log
>
> In any ML script's webhook config, set a webhook to `false` to disable that log entirely.

## Inventory Image Path

**config.lua**

```lua
Config.InventoryImagePath = nil
Config.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

**config.lua**

```lua
Config.Waypoints = {
    syncToWayPoint = true,

    mapWaypoint = {
        type = 'checkpoint',
        label = 'WAYPOINT',
        color = '#f500fc',
        size = 1.0,
        drawDistance = 1000.0,
    },

    defaults = {
        drawDistance = 500.0,
        fadeDistance = 400.0,
        size = 1.0,
        minHeight = 0.5,
        maxHeight = 50.0,
        groundZOffset = -2.0,
        color = '#f5a623',
        label = 'CHECKPOINT',
        displayDistance = true,
    },

    dui = {
        width = 512,
        height = 1024,
    },

    rendering = {
        updateInterval = 100,
        distanceUpdateInterval = 100,
        perspectiveDivisor = 20.0,
        checkpointBaseMultiplier = 4.0,
        checkpointMinScale = 0.1,
        checkpointAspectRatio = 2.0,
        smallMinScale = 1.0,
        smallAspectRatio = 2.0,
    },

    server = {
        cleanupInterval = 60000,
    },
}
```

- `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.