Configuration

General

1Config.Language = 'en'
2Config.Command = 'autocapture'
3Config.EnableCommand = true
4Config.AceRestricted = true
5Config.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

1Config.RoutingBucket = 970
2Config.StudioCoords = vector3(0.0, 0.0, -150.0)
3Config.StudioHeading = 180.0
4Config.StudioAutoRelocate = true
5Config.StudioClearRadius = 25.0
6Config.StudioAltCoords = {
7    vector3(0.0, 0.0, -500.0),
8    vector3(1600.0, 3100.0, -500.0),
9    vector3(2500.0, -350.0, -500.0),
10}
11Config.ChromaKeyColor = 'magenta'
12Config.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

1Config.Capture = {
2    applyWait = 400,
3    settleFrames = 15,
4    settleWait = 0,
5    streamWait = 3000,
6    propWait = 300,
7    batchSize = 10,
8    batchPause = 250,
9    gcEvery = 60,
10    fast = false,
11    captureScale = 3,
12    uploadTimeout = 20000,
13    uploadWait = 1500,
14}

• 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

1Config.OutputRoots = {
2    clothing = 'ox',
3    prop = 'ox',
4    vehicle = 'self',
5    outfit = 'self',
6    cinematic = 'self',
7    configurator = 'self',
8}

• ox — Writes below ox_inventory/web/images/.
• self — Writes below ml_autocapture/images/.

The panel can override these defaults for a single run.

Clothing

1Config.Clothing = {
2    size = 256,
3    format = 'png',
4    quality = 92,
5    transparent = true,
6}
7Config.CaptureAllTextures = true
8Config.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

1Config.Props = {
2    enabled = true,
3    autoCamera = true,
4    size = 256,
5    format = 'png',
6    quality = 92,
7    transparent = true,
8    outputKey = 'inventory',
9    pitch = -18.0,
10    yaw = 35.0,
11    margin = 1.35,
12    list = {
13        { item = 'model_windowway_metal', model = 'nc_windowway_metal' },
14    },
15}

• 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

1Config.Vehicles = {
2    enabled = true,
3    autoCamera = true,
4    size = 512,
5    format = 'png',
6    quality = 92,
7    transparent = true,
8    outputKey = 'vehicles',
9    source = 'config',
10    yaw = 35.0,
11    pitch = -8.0,
12    margin = 1.25,
13    primaryColor = nil,
14    secondaryColor = nil,
15    plateText = nil,
16    background = { mode = 'none', color = '#181a21', color2 = '#0b0d12', pad = 0 },
17    list = {},
18}

• 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

1Config.Cinematic = {
2    enabled = true,
3    outputKey = 'showcase',
4    width = 1920,
5    height = 1080,
6    format = 'png',
7    quality = 95,
8    watermark = false,
9    bucket = 972,
10    streamWait = 1500,
11    settleWait = 500,
12    clearNearby = true,
13    clearRadius = 90.0,
14}
15Config.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

1Config.Outfit = {
2    enabled = true,
3    outputKey = 'showcase',
4    size = 1024,
5    format = 'png',
6    quality = 92,
7    transparent = true,
8    scene = '',
9    fov = 35.0,
10    yaw = 22.0,
11    pitch = -3.0,
12    margin = 1.75,
13    base = {},
14    poses = {},
15    outfits = {},
16}

• 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

1Config.Configurator = {
2    outputKey = 'configurator',
3    width = 0,
4    height = 0,
5    autoCrop = true,
6    cropPadding = 24,
7    maxWidth = 0,
8    threshold = 28,
9    warmupWait = 1000,
10    applyWait = 120,
11    settleWait = 60,
12    batchPause = 0,
13    hero = { yaw = 35.0, pitch = -8.0, fov = 40.0, margin = 1.25 },
14    paint = { primary = nil, secondary = nil, livery = -1, noPearl = true },
15    slots = {},
16    list = {},
17}

• 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

1Config.Photo = {
2    enabled = true,
3    outputKey = 'photo',
4    width = 1920,
5    height = 1080,
6    format = 'png',
7    quality = 95,
8    privateBucket = true,
9    bucketId = 971,
10    clearNearby = false,
11    clearRadius = 60.0,
12    subjectDefault = 'vehicle',
13}

• 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

1Config.Studio = {
2    overrideTime = true,
3    hour = 12,
4    minute = 0,
5    overrideWeather = true,
6    weather = 'EXTRASUNNY',
7    lightColor = { r = 255, g = 255, b = 255 },
8    lightBoost = 1.0,
9}
10Config.UITheme = {
11    preset = nil,
12    colors = { primary = nil, accent = nil, background = nil, surface = nil, text = nil },
13}

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