# Installation

> Setup guide for ML Autocapture

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

## Overview

ML Autocapture creates clothing, prop, vehicle and outfit images inside FiveM. It can produce transparent inventory icons, cinematic batches, free-camera photos and layered vehicle configurator assets.

## Quick Start

1. Download the resource from CFX Portal.
2. Extract it as `ml_autocapture` without renaming the folder.
3. Install `screencapture`, `ox_lib` and `ml_bridge`.
4. Add the resources in this order:

**server.cfg**

```cfg
ensure ox_lib
ensure ml_bridge
ensure screencapture
ensure ml_autocapture
```

> **WARNING:** Resource name
>
> The folder must remain named `ml_autocapture`. A different resource name locks the script.

## Access

The default command is available to framework administrators and players allowed by the optional ACE permission.

**server.cfg**

```cfg
add_ace group.admin ml_autocapture.use allow
```

**shared/config.lua**

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

Run `/autocapture` in chat or open the studio from another server resource:

```lua
exports['ml_autocapture']:OpenStudio(source)
```

## Output folders

- Clothing with root `ox` writes to `ox_inventory/web/images/clothing/`.
- Props with root `ox` write to `ox_inventory/web/images/`.
- Self-contained output writes below `ml_autocapture/images/`.
- Vehicle configurator layers write below `ml_autocapture/images/configurator/`.

> **INFO:** Prop filenames
>
> Each prop entry has an item name and a model name. The item name becomes the PNG filename. A model named `nc_windowway_metal` mapped to item `model_windowway_metal` produces `model_windowway_metal.png`.

## Headless clothing props

On the administrator client used for capture, run this once in the F8 console:

```cfg
seta allowEmptyHeadDrawable true
```

Restart ML Autocapture after changing it. Without this client preference, hats, glasses and earrings may include the mannequin head.

## Verify

1. Start all required resources.
2. Confirm the version banner prints without dependency errors.
3. Open `/autocapture` as an administrator.
4. Capture one prop with `Only missing` disabled.
5. Confirm the PNG is written to the selected output root and has transparency.

**Troubleshooting**

- `screenshot-basic is not started` — Start `screencapture` before ML Autocapture and verify its manifest provides `screenshot-basic`.
- The game appears behind the subject — Keep `Config.Capture.settleFrames` at its default or raise it on a slow client.
- A prop is skipped — Disable `Only missing`, verify the model resource is started and check that the item/model pair exists in `Config.Props.list`.
- The output is written locally — Start `ox_inventory` before ML Autocapture or select the self-contained output root.