# Configuration

> Configuration reference for ML Autocapture

Category: AUTOCAPTURE · Source: https://miciomods.it/docs/ml-autocapture-configuration · Last updated: 2026-09-26

## General

**shared/config.lua**

```lua
Config.Language = 'en'
Config.Command = 'autocapture'
Config.EnableCommand = true
Config.AceRestricted = true
Config.AcePermission = 'ml_autocapture.use'
```

- `Language`: UI and notification locale. Additional locale files are stored in `locales/`.
- `Command`: Chat command registered by the full edition.
- `EnableCommand`: Enables the chat command and admin-panel exports.
- `AceRestricted`: Requires framework administrator permission or the configured ACE.
- `AcePermission`: Additional ACE permission. Set it to an empty string to accept framework administrators only.

## Studio location

**shared/config.lua**

```lua
Config.RoutingBucket = 970
Config.StudioCoords = vector3(0.0, 0.0, -150.0)
Config.StudioHeading = 180.0
Config.StudioAutoRelocate = true
Config.StudioClearRadius = 25.0
Config.StudioAltCoords = {
    vector3(0.0, 0.0, -500.0),
    vector3(1600.0, 3100.0, -500.0),
    vector3(2500.0, -350.0, -500.0),
}
Config.ChromaKeyColor = 'magenta'
Config.BackendPort = 3960
```

- `RoutingBucket`: Private bucket used by studio captures.
- `StudioCoords` and `StudioHeading`: Primary hidden studio position and heading.
- `StudioAutoRelocate`: Tests the primary location and selects the first clear alternative.
- `StudioClearRadius`: Radius checked for map objects around a studio location.
- `StudioAltCoords`: Alternative hidden studio positions.
- `ChromaKeyColor`: Accepts `magenta` or `green`.
- `BackendPort`: Loopback port used by the bundled image processor.

## Capture timing

**shared/config.lua**

```lua
Config.Capture = {
    applyWait = 400,
    settleFrames = 15,
    settleWait = 0,
    streamWait = 3000,
    propWait = 300,
    batchSize = 10,
    batchPause = 250,
    gcEvery = 60,
    fast = false,
    captureScale = 3,
    uploadTimeout = 20000,
    uploadWait = 1500,
}
```

- `applyWait`: Safety delay after applying an item.
- `settleFrames`: Rendered frames waited after mounting the camera. Raising it prevents the normal game view from appearing on slow clients.
- `settleWait`: Delay after each completed shot.
- `streamWait`: Maximum asset streaming wait.
- `propWait`: Additional wait for ped props.
- `batchSize` and `batchPause`: Periodic pause controls.
- `gcEvery`: Garbage-collection interval in shots. Zero disables it.
- `fast`: Removes optional timing margins but keeps `settleFrames`.
- `captureScale`: Maximum source scale relative to the requested output. Zero captures at game resolution.
- `uploadTimeout`: Maximum wait for the backend write confirmation.
- `uploadWait`: Fallback delay after repeated missing confirmations.

## Output routing

**shared/config.lua**

```lua
Config.OutputRoots = {
    clothing = 'ox',
    prop = 'ox',
    vehicle = 'self',
    outfit = 'self',
    cinematic = 'self',
    configurator = 'self',
}
```

- `ox`: Writes below `ox_inventory/web/images/`.
- `self`: Writes below `ml_autocapture/images/`.

The panel can override these defaults for a single run.

## Clothing

**shared/config.lua**

```lua
Config.Clothing = {
    size = 256,
    format = 'png',
    quality = 92,
    transparent = true,
}
Config.CaptureAllTextures = true
Config.IncludeDecals = false
```

- `size`: Square output size.
- `format`: `png` or `jpg`.
- `quality`: JPEG quality from 40 to 100.
- `transparent`: Removes the chroma background.
- `CaptureAllTextures`: Captures every texture of each drawable.
- `IncludeDecals`: Includes clothing component 10.

`Config.CameraPresets` stores the framing for each clothing group. Each entry supports `fov`, `zPos`, `rotation`, `dist`, `defaultAngleH`, `defaultCamZ` and `defaultRoll`. `Config.Slots` maps inventory labels to component or prop IDs and their camera preset.

## Props

**shared/config.lua**

```lua
Config.Props = {
    enabled = true,
    autoCamera = true,
    size = 256,
    format = 'png',
    quality = 92,
    transparent = true,
    outputKey = 'inventory',
    pitch = -18.0,
    yaw = 35.0,
    margin = 1.35,
    list = {
        { item = 'model_windowway_metal', model = 'nc_windowway_metal' },
    },
}
```

- `enabled`: Enables the Props tab.
- `autoCamera`: Frames each model from its dimensions.
- `size`, `format`, `quality` and `transparent`: Prop output settings.
- `outputKey`: Output subfolder mapping.
- `pitch`, `yaw` and `margin`: Automatic framing defaults.
- `list`: Item/model mappings. `item` becomes the filename; `model` is spawned for the capture.

## Vehicles

**shared/config.lua**

```lua
Config.Vehicles = {
    enabled = true,
    autoCamera = true,
    size = 512,
    format = 'png',
    quality = 92,
    transparent = true,
    outputKey = 'vehicles',
    source = 'config',
    yaw = 35.0,
    pitch = -8.0,
    margin = 1.25,
    primaryColor = nil,
    secondaryColor = nil,
    plateText = nil,
    background = { mode = 'none', color = '#181a21', color2 = '#0b0d12', pad = 0 },
    list = {},
}
```

- `source`: Uses the configured list by default. The panel can switch to all spawnable models or a custom list.
- `primaryColor`, `secondaryColor` and `plateText`: Optional appearance overrides.
- `background.mode`: `none`, solid colour or gradient as selected in the panel.
- `background.color`, `color2` and `pad`: Background colours and transparent padding.

## Cinematic presets

**shared/config.lua**

```lua
Config.Cinematic = {
    enabled = true,
    outputKey = 'showcase',
    width = 1920,
    height = 1080,
    format = 'png',
    quality = 95,
    watermark = false,
    bucket = 972,
    streamWait = 1500,
    settleWait = 500,
    clearNearby = true,
    clearRadius = 90.0,
}
Config.Naming = { fallback = '{model}_{set}_{shot}' }
```

- `width`, `height`, `format` and `quality`: Default cinematic output.
- `watermark`: Applies `images/watermark.png`.
- `bucket`: Private bucket used for on-location batches.
- `streamWait` and `settleWait`: World and subject settling delays.
- `clearNearby` and `clearRadius`: Hide ambient traffic and pedestrians around the shot.
- `Naming.fallback`: Default filename pattern. Available placeholders are `{model}`, `{set}`, `{shot}`, `{scene}` and `{index}`.

`Config.Scenes` stores locations, environment, lights, depth of field and default framing. `Config.Shots` stores relative camera angles. `Config.Compositions` stores vehicle and ped slots. `Config.Sets` binds a scene, composition, shots and output recipe. These presets can also be created and deleted from the in-game studio.

## Outfit

**shared/config.lua**

```lua
Config.Outfit = {
    enabled = true,
    outputKey = 'showcase',
    size = 1024,
    format = 'png',
    quality = 92,
    transparent = true,
    scene = '',
    fov = 35.0,
    yaw = 22.0,
    pitch = -3.0,
    margin = 1.75,
    base = {},
    poses = {},
    outfits = {},
}
```

- `scene`: Empty uses the transparent studio; a scene key uses that location.
- `base`: Clothing applied before the showcased item.
- `poses`: Animation, scenario or neutral pose definitions.
- `outfits`: Optional named complete outfits.

## Configurator

**shared/config.lua**

```lua
Config.Configurator = {
    outputKey = 'configurator',
    width = 0,
    height = 0,
    autoCrop = true,
    cropPadding = 24,
    maxWidth = 0,
    threshold = 28,
    warmupWait = 1000,
    applyWait = 120,
    settleWait = 60,
    batchPause = 0,
    hero = { yaw = 35.0, pitch = -8.0, fov = 40.0, margin = 1.25 },
    paint = { primary = nil, secondary = nil, livery = -1, noPearl = true },
    slots = {},
    list = {},
}
```

- `width` and `height`: Zero keeps game resolution.
- `autoCrop`, `cropPadding` and `maxWidth`: Shared crop controls for every layer.
- `threshold`: Difference sensitivity used to isolate vehicle parts.
- `warmupWait`, `applyWait`, `settleWait` and `batchPause`: Configurator timing.
- `hero`: Locked camera shared by every layer of a vehicle.
- `paint`: Optional paint, livery and pearl treatment.
- `slots`: Vehicle mod types exposed as configurable layers.
- `list`: Default vehicle list.

## Photo mode

**shared/config.lua**

```lua
Config.Photo = {
    enabled = true,
    outputKey = 'photo',
    width = 1920,
    height = 1080,
    format = 'png',
    quality = 95,
    privateBucket = true,
    bucketId = 971,
    clearNearby = false,
    clearRadius = 60.0,
    subjectDefault = 'vehicle',
}
```

- `privateBucket` and `bucketId`: Isolate the administrator while composing.
- `clearNearby` and `clearRadius`: Default ambient cleanup.
- `subjectDefault`: `vehicle` or `ped`.

`Config.Photo.camera` controls FOV limits, flight speed and mouse sensitivity. `dof`, `watermark`, `lights`, `grading`, `postfx`, `weathers` and `framing` provide the initial editor presets.

## Studio environment and UI

**shared/config.lua**

```lua
Config.Studio = {
    overrideTime = true,
    hour = 12,
    minute = 0,
    overrideWeather = true,
    weather = 'EXTRASUNNY',
    lightColor = { r = 255, g = 255, b = 255 },
    lightBoost = 1.0,
}
Config.UITheme = {
    preset = nil,
    colors = { primary = nil, accent = nil, background = nil, surface = nil, text = nil },
}
```

- `Studio` fixes time, weather and light colour during transparent captures.
- `UITheme.preset` accepts a resource preset or `nil` to inherit the global Micio UI preset.
- Each `UITheme.colors` field accepts a CSS hex colour or `nil` to inherit it.