# Configuration

> Configuration reference for ML Autocapture

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

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