PREVIEW IMAGES#

Overview#

Default Clothes Previews (Download)#

For base game and DLC clothing, pre-recorded preview images are available for download.

Step 1: Download Previews#

Download the pre-recorded previews package:

The download contains:

• All base game clothing previews
• All DLC clothing previews
• Organized by gender and component

Step 2: Extract to Previews Folder#

Extract the downloaded archive to your onex-creation folder:

Step 3: Verify Installation#

After extraction, your previews folder should contain:

Addon Clothes Previews (Record)#

Custom addon clothing requires recording previews using the built-in studio system.

Prerequisites#

Before recording addon previews:

1. Calibration complete - Run /clothescallibrate addon yourpack first
2. Admin permissions - Studio commands require admin access
3. In-game player - Commands must be run in-game, not console

Studio Commands#

Open Studio Interface#

/clothesstudio

Opens the interactive studio UI for manual preview generation.

Studio Features:

• Controlled environment (lighting, weather, background)
• Camera positioning
• Manual item selection
• Preview capture controls

How to use:

1. Run /clothesstudio to enter studio mode
2. Use the UI to select clothing items
3. Capture previews manually
4. Run /clothesstudio again to exit

Automated Preview Recording#

/shootclothes [rarity] [collection] [gender]

Automatically photographs all clothing items based on filters.

Parameters:

Examples:

# Shoot all addon clothes for male characters
/shootclothes addon male

# Shoot all addon clothes for female characters
/shootclothes addon female

# Shoot specific addon pack
/shootclothes addon mypack male
/shootclothes addon mypack female

# Shoot everything (takes a long time!)
/shootclothes all male
/shootclothes all female

Shoot Specific Collection#

/shootcollection [collection] [component] [gender]

Photographs a specific collection with optional component filter.

Parameters:

Examples:

# Shoot entire collection for both genders
/shootcollection mypack

# Shoot only torso items from collection
/shootcollection mypack torso

# Shoot only male items from collection
/shootcollection mypack male

# Shoot specific component and gender
/shootcollection mypack torso male

Preview File Format#

Directory Structure#

Previews are organized by rarity, collection, gender, and component:

previews/{rarity}/{collection}/{gender}/{component}/

Examples:

• previews/base/male/torso/
• previews/dlc/mpbiker/female/pants/
• previews/addons/mypack/male/shirt/

File Naming#

Preview files follow this naming convention:

{localIndex}_{textureId}.webp

Examples:

• 0_0.webp - Item 0, texture 0
• 0_1.webp - Item 0, texture 1
• 1_0.webp - Item 1, texture 0
• 15_3.webp - Item 15, texture 3

Image Format#

Recording Workflow#

For New Addon Pack#

For Missing Previews#

If some items show no preview in the UI:

Troubleshooting#

Previews Not Showing in UI#

Problem: Items appear but have no preview image

Solutions:

1. Verify preview files exist in correct location
2. Check file naming matches expected format
3. Restart server to refresh file cache
4. Ensure calibration was completed first

Studio Won't Open#

Problem: /clothesstudio command does nothing

Solutions:

1. Verify admin permissions are granted
2. Check for script errors in F8 console
3. Ensure onex-creation started without errors
4. Try restarting the resource

Shoot Command Skips Items#

Problem: Some items aren't being photographed

Solutions:

1. Run calibration to update item list
2. Check if items are in correct collection
3. Verify gender parameter is correct
4. Check server console for error messages

Preview Quality Issues#

Problem: Previews look wrong or have artifacts

Solutions:

1. Ensure proper lighting in studio
2. Wait for model to fully load before capture
3. Check studio configuration settings
4. Re-shoot affected items manually

Wrong Items in Previews#

Problem: Preview shows different item than expected

Solutions:

1. Recalibrate the collection
2. Check for conflicting addon packs
3. Verify localIndex matches between calibration and preview
4. Delete existing previews and re-shoot

Best Practices#

1. Calibrate first, shoot second - Always complete calibration before recording previews

2. Shoot by gender - Record male and female separately to avoid confusion

3. Use specific commands - Target individual addon packs rather than shooting everything

4. Verify as you go - Check UI after each shoot session to confirm success

5. Backup previews - Keep copies of preview folders for addon packs you use frequently

6. Low population - Run shoots during off-peak hours as it can impact performance

Summary#

Next Steps#