F.A.Q

2 min readUpdated Today

Setup

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

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.

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

server.cfg
1add_ace group.admin ml_autocapture.use allow

Transparent captures

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.

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
1Config.Capture.settleFrames = 15

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

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

shared/config.lua
1{ item = 'model_windowway_metal', model = 'nc_windowway_metal' }

The resulting file is model_windowway_metal.png.

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

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

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

cfg
1seta allowEmptyHeadDrawable true

Only the client used for capture needs this setting.

They are disabled by default:

shared/config.lua
1Config.IncludeDecals = true

Output

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.

Yes. Use the server exports:

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

Updates

  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.