# Configuration

> Configuration reference for ML MasterVideo

Category: SCENE EDITOR · Source: https://miciomods.it/docs/ml-mastervideo-configuration · Last updated: 2026-07-05

## Overview

- `shared/config.lua`: General settings, performance, camera controls, keybinds
- `server/config_server.lua`: Discord webhooks, admin permissions

Asset lists (ped models, vehicle models, props, weapons, scenarios, emotes) are included as data files and loaded automatically.

## General

**shared/config.lua**

```lua
Config.Locale = 'en'
Config.Debug = false
Config.Interaction = nil
Config.DatabaseMode = 'auto'
Config.Theme = 'default'
Config.OpenKey = 'F6'
Config.OpenCommand = 'sceneeditor'
Config.RequirePermissions = false
Config.AcePermission = 'ml_mastervideo.access'
Config.AdminPermissions = { 'command', 'admin', 'god', 'superadmin' }
```

- `Locale`: Language code for translations
- `Debug`: Console output for troubleshooting
- `Interaction`: Interaction prompt mode. `nil` = auto-select via ml_bridge, `'textui'` = force TextUI
- `DatabaseMode`: Persistence backend. `'auto'` detects oxmysql automatically
- `Theme`: UI theme. Options: `'default'`, `'cyberpunk'`, `'wasteland'`, `'noir'`, `'fantasy'`
- `OpenKey`: Keybind to open the scene editor (rebindable in FiveM settings)
- `OpenCommand`: Chat command to open the editor
- `RequirePermissions`: When `true`, only players with `AcePermission` can access the editor
- `AdminPermissions`: Framework permission groups treated as admin for restricted actions
- `AcePermission`: ACE node required when `RequirePermissions = true`

## Performance

**shared/config.lua**

```lua
Config.Performance = {
    RecordingInterval = 50,
    PedRecordingInterval = 0,
    MaxEntitiesPerScene = 50,
    MaxScenesPerPlayer = 100,
    EntityRenderDistance = 150.0,
    CleanupOnStop = true,
}
```

- `RecordingInterval`: Milliseconds between recorded frames (50 = 20 FPS capture)
- `PedRecordingInterval`: Milliseconds between recorded ped frames. `0` captures every game frame for maximum smoothness
- `MaxEntitiesPerScene`: Maximum entities (peds, vehicles, props) per scene
- `MaxScenesPerPlayer`: Maximum saved scenes per player
- `EntityRenderDistance`: Distance at which scene entities are visible
- `CleanupOnStop`: Auto-delete all scene entities on resource stop

## Camera Controls

**shared/config.lua**

```lua
Config.Camera = {
    HideAllUIKey = 'H',
    ToggleOverlayKey = 'TAB',
    BaseSpeed = 0.3,
    SlowSpeedMultiplier = 0.1,
    FastSpeedMultiplier = 5.0,
    StickDeadzone = 0.2,
    StickSensitivity = 0.25,
    RotationSensitivity = 1.5,
    SmoothingFactor = 0.15,
}
```

- `HideAllUIKey`: Toggle all UI off for clean screenshots/recording
- `ToggleOverlayKey`: Toggle the editor overlay only
- `BaseSpeed`: Normal camera movement speed
- `SlowSpeedMultiplier`: Precision mode speed (hold LT)
- `FastSpeedMultiplier`: Turbo mode speed (hold RT)
- `StickDeadzone`: Gamepad: ignore stick movements below this threshold (0.0 - 1.0)
- `StickSensitivity`: Gamepad: how fast the sticks affect movement
- `RotationSensitivity`: Gamepad: how fast the right stick rotates the camera
- `SmoothingFactor`: Camera movement interpolation (lower = smoother)

## Drive Styles

Pre-configured AI driving behaviors for vehicle path recording:

**shared/config.lua**

```lua
Config.DriveStyles = {
    { id = 'normal',        label = 'Normal',        flags = 786603 },
    { id = 'rushed',        label = 'Rushed',        flags = 262156 },
    { id = 'careful',       label = 'Careful',       flags = 786468 },
    { id = 'ignore_lights', label = 'Ignore Lights', flags = 2883621 },
    { id = 'aggressive',    label = 'Aggressive',    flags = 6 },
}
```

## Discord Webhooks

**server/config_server.lua**

```lua
ServerConfig.DiscordWebhook = ''
ServerConfig.AdminWebhook = ''
ServerConfig.AdminPermissions = { 'command', 'admin', 'god' }
ServerConfig.RateLimitCooldown = 1000
```

- `DiscordWebhook`: Player scene actions (create, delete, play)
- `AdminWebhook`: Admin actions
- `AdminPermissions`: Permission groups allowed to run admin webhook actions
- `RateLimitCooldown`: Minimum milliseconds between server actions per player

Set to `false` to disable.