Installation

2 min readUpdated Today

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
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)

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/.
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
1seta 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.
  • 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.