Screenshotting Clothes

How to generate thumbnails for addon (streamed) clothing.

Addon Clothing Screenshots

Vanilla GTA clothing already has thumbnails served from the OTHERPLANET CDN, so you only need to capture addon / streamed items. The menu works without any images - missing items just show a numbered placeholder.

The thumbnail generator spawns a ped in a hidden sky studio, applies one item at a time against a green backdrop, takes a screenshot, then chroma-keys it into a transparent PNG.

Requirements

• screenshot-basic must be started (set in server.cfg before op-clothing).

• Config.Thumbnails.Enabled = true.

• You must pass the admin permission gate (or run it on a player you control).

• Your addon clothing must be streamed and working in-game first.

Run the capture on a test / dev server with no other players around. The ped is teleported to a sky studio for each shot, so do it on a character you don't mind moving.

Step 1 - Quick test first

Validate framing and the green-screen key on a few items before a full run:

/op_clothing_thumbs_test male 3
/op_clothing_thumbs_test female 3

This captures only the first 3 drawables per category. Open the clothing menu and check the tiles look correct.

Step 2 - Full capture

Run a complete batch per gender:

/op_clothing_thumbs male
/op_clothing_thumbs female

With Config.Thumbnails.SkipCdnCapture = true (default) the batch skips every item already on the CDN and only shoots what's missing - i.e. your addon items. This keeps the run short even on a full wardrobe.

Step 3 - Targeted captures (optional)

Command	What it captures
/op_clothing_thumbs_hair [male|female] [count]	Hairstyles only (head visible)
/op_clothing_thumbs_wrist [male|female]	Watches + bracelets only
/op_clothing_thumbs_test [male|female] [count]	First N drawables per category

You can also re-shoot a single item from the in-game admin menu (/clothingadmin → item → re-capture) when one thumbnail needs a redo.

Step 4 - Build the hash map

Addon clothing shifts the raw drawable indices whenever packs are added or removed. The hash map keeps existing thumbnails resolving to the right item:

/op_clothing_thumbs_map male
/op_clothing_thumbs_map female

With Config.Thumbnails.AutoHashMapAfterBatch = true (default) this runs automatically after every full batch, so you usually don't need to call it by hand.

Step 5 - Serve the new images

Captured PNGs are written to web/thumbnails inside the Config.Thumbnails.StoreResource (default op-clothing). To serve the fresh nui:// URLs:

restart op-clothing

If you moved the store to a separate assets resource, that resource is remounted automatically and no restart of op-clothing is needed.

Where files go

Setting	Default	Meaning
Config.Thumbnails.StoreResource	op-clothing	Resource the PNGs live in
Config.Thumbnails.StorePath	web/thumbnails	Folder inside that resource
Config.Thumbnails.LocalBaseUrl	nui://op-clothing/web/thumbnails/%s.png	URL template for captured items
Config.Thumbnails.BaseUrl	CDN	URL template for vanilla items

Troubleshooting

• "screenshot-basic is not started" - add it to server.cfg above op-clothing.

• Green edges on items - lower Config.Thumbnails.KeyHard (more aggressive key).

• Wrong framing for a slot - tweak Config.Thumbnails.CameraSlots['component:X'] (fov, distance, zPos).

• Thumbnails don't update - restart op-clothing (or reopen the menu) so the new nui:// files are mounted.

• Access denied - check your permissions.