Introduction

Overview

uz_AutoShot is a free, open-source screenshot studio for FiveM. It teleports your ped to an underground void with chroma key walls and studio lighting, goes through every drawable and texture, captures each one, and removes the background server-side to produce transparent PNGs. It covers clothing components, props, head overlays (facial hair, makeup, etc.), tattoos, vehicles with color selection, and world objects, on both the male and the female freemode ped.

A built-in wardrobe lets you browse the results, try items on your ped, and re-shoot broken thumbnails. Captures reach the server as latent events, and photos are served from the resource folder over FiveM's cfx-nui protocol, so any other script can show them with a plain <img src="...">. No HTTP server, no port forwarding.

Features

Installation

ensure screenshot-basic
ensure uz_AutoShot

Commands

The names of /shotmaker and /wardrobe can be changed with Customize.Command and Customize.MenuCommand.

Permissions

Commands support FiveM's ACE permission system. Set Customize.AceRestricted = true in Customize.lua, then add to your server.cfg:

## Per player
add_ace identifier.license:YOUR_LICENSE command.shotmaker allow
add_ace identifier.license:YOUR_LICENSE command.wardrobe allow
add_ace identifier.license:YOUR_LICENSE command.shotcar allow
add_ace identifier.license:YOUR_LICENSE command.shotprop allow

## Or use a group
add_ace group.admin command allow
add_principal identifier.license:YOUR_LICENSE group.admin

With AceRestricted = true the server also rejects capture uploads from players without command.shotmaker.

Camera Controls

To save the framing for a category, click the camera icon on its row in the preview. On a row that is not active, the first click selects the category and moves the camera there; click again to save. Saved angles last for the session and are applied automatically when the batch reaches that category. Ped angles are saved per gender; a category without a saved angle for the current gender uses the one saved for the other gender.

Male & Female Ped

The Male / Female toggle in the preview header swaps the studio ped. Photos go to shots/male/ or shots/female/ accordingly. Turn on Capture both genders in the footer to shoot the selected ped categories for the current gender first, then the other gender, in one run. Vehicles and objects are captured once.

Tattoos

The Tattoos tab in the capture preview lists one category per body zone (Customize.TattooCategories), with the number of tattoos in each for the current gender. The tab only appears when a tattoo list is available:

1. Customize.Tattoos, if you fill it in (same format as illenium-appearance's list), otherwise
2. customize/tattoos.lua of illenium-appearance, read while that resource is running.

Each tattoo is shot alone on a bare-skin ped (Customize.TattooBody: underwear, barefoot) with its zone's camera preset (tattoo_torso, tattoo_back, tattoo_head, tattoo_left_arm, ...). Frame each zone once in the preview and save the angle, as with clothing.

Torso tattoos are split into Torso (Front) and Torso (Back) using the facing stored in the game's tattoo shop data. On first use F8 prints how many back-facing tattoos were found. Addon tattoos have no shop data and default to the front camera. If a tattoo lands in the wrong group, add it to Customize.TattooFacing and re-run that category:

Customize.TattooFacing = {
    ['MP_Example_M_000'] = 'back',   -- overlay name from the list (hashMale / hashFemale)
}

The wardrobe has a Tattoos tab too. Click a thumbnail to try the tattoo on your ped, or use re-capture mode to re-shoot single tattoos.

Configuration

All settings live in Customize.lua:

Camera presets, green screen dimensions, studio lighting, the head chroma mask (Customize.HeadMask), clothing, prop, overlay and tattoo categories (Customize.TattooCategories, Customize.TattooBody, Customize.TattooFacing, Customize.Tattoos), vehicle settings, and the object list are all configurable in the same file.