# F.A.Q

> Frequently asked questions for ML Autocapture

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

## Setup

**Which screenshot resource is required?**

Install `screencapture` and start it before ML Autocapture. It provides the backward-compatible `screenshot-basic` exports used by the script.

**Why does the resource report that screenshot-basic is not started?**

The compatibility provider is not active. Verify that the resource folder is named `screencapture`, its manifest contains `provide 'screenshot-basic'`, and it starts before `ml_autocapture`.

**Why can a non-admin not open the studio?**

Access is restricted by default. Grant framework administrator permission or the optional ACE:

**server.cfg**

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

## Transparent captures

**Why is the background black?**

Use PNG output with transparency enabled. Restart ML Autocapture after updating it so the current client and backend code are loaded. JPG cannot preserve an alpha channel.

**Why does the normal game view appear behind the subject?**

The capture was requested before the scripted camera completed enough rendered frames. Keep the default value or raise it on a slow capture client:

**shared/config.lua**

```lua
Config.Capture.settleFrames = 15
```

**Why does only the first image have transparency?**

Use the current resource files and restart both `screencapture` and `ml_autocapture`. Prop captures always use the configured prop transparency value for the complete batch.

## Props and filenames

**Why is nc_windowway_metal missing from the output folder?**

It is saved under the item name, not the model name:

**shared/config.lua**

```lua
{ item = 'model_windowway_metal', model = 'nc_windowway_metal' }
```

The resulting file is `model_windowway_metal.png`.

**Why was an existing prop not photographed again?**

Disable `Only missing`. When enabled, any existing image with the item key is skipped even if it was created by an older run.

**Why is a prop counted as skipped?**

The entry has no valid item/model pair, an existing image was found while `Only missing` was enabled, or the model was not valid in the client CD image. Start the resource that streams the model before beginning the batch.

## Clothing

**Why is a head visible behind hats or glasses?**

Enable the client preference on the administrator machine and restart ML Autocapture:

```cfg
seta allowEmptyHeadDrawable true
```

Only the client used for capture needs this setting.

**Why are decals not included?**

They are disabled by default:

**shared/config.lua**

```lua
Config.IncludeDecals = true
```

## Output

**Where are generated images stored?**

The `ox` root writes to `ox_inventory/web/images/`. The `self` root writes to `ml_autocapture/images/`. Clothing and props default to `ox`; vehicles, outfits, cinematic sets and configurator output default to `self`.

**Can another resource read generated images?**

Yes. Use the server exports:

```lua
local image = exports['ml_autocapture']:getImage('adder')
local images = exports['ml_autocapture']:getImages({ 'adder', 'sultan' })
```

## Updates

**How do I update the script?**

1. Back up `shared/config.lua`, `locales/`, `data/` and generated `images/`.
2. Replace the resource files with the current CFX Portal download.
3. Restore only intentional configuration changes.
4. Restart `screencapture` and `ml_autocapture`.
5. Run one transparent prop test with `Only missing` disabled.

No database migration is required.