Installation

2 min readUpdated 2 weeks ago

Overview

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

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
1ensure ox_lib
2ensure ml_bridge
3ensure screencapture
4ensure ml_autocapture
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
1add_ace group.admin ml_autocapture.use allow
shared/config.lua
1Config.Command = 'autocapture'
2Config.EnableCommand = true
3Config.AceRestricted = true
4Config.AcePermission = 'ml_autocapture.use'

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

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

The export does not check permissions. Check access in the calling resource.

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

The studio sets this client preference before clothing captures and warns when it is not active:

cfg
1seta allowEmptyHeadDrawable true

If hats, glasses or earrings still show the mannequin head, run it in F8 on the capture client and reconnect.

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.
  • 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.
  • Files land in ml_autocapture/shots/: ox_inventory was not running. Start it before ML Autocapture, or pick the self-contained output root.
Autocapture Installation, FiveM Docs | Micio Mods