How are output files named?

The file takes the item name, not the model name: **shared/config.lua** ```lua { item = 'chair_wood', model = 'prop_chair_01a' } ``` This produces `chair_wood.png`.

Why are decals not included?

They are disabled by default: **shared/config.lua** ```lua Config.IncludeDecals = true ```

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' }) ```

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.

F.A.Q

Q: 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.

Q: 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.

Q: How do I photograph an existing prop again?

Disable `Only missing`. When enabled, any item that already has an image is skipped.

2 min readUpdated Yesterday

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

The file takes the item name, not the model name:

shared/config.lua

1{ item = 'chair_wood', model = 'prop_chair_01a' }

This produces chair_wood.png.

Disable Only missing. When enabled, any item that already has an image is 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

The studio sets this client preference on its own and warns when it is off. If the head still shows, run it in F8 on the capture client and reconnect:

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 and cinematic sets 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

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

No database migration is required.