COLLECTIONS & CALIBRATION#

When Is Calibration Needed?#

Calibration Commands#

Full Calibration#

Scans all clothing collections (base, DLC, and addons) in one operation.

When to use:

• First-time setup with addon clothes
• After major changes to multiple clothing packs
• When you're unsure what needs updating

Requirements:

• Must be run by an admin player in-game
• Cannot be run from server console

Selective Calibration#

Scans a specific rarity tier or individual addon collection.

Parameters:

Examples:

# Scan only base game clothes
/clothescallibrate base

# Scan only DLC clothes
/clothescallibrate dlc

# Scan all addon clothes
/clothescallibrate addon

# Scan specific addon pack
/clothescallibrate addon mypack
/clothescallibrate addon eup_clothing

Validate Collections#

Checks all collection data files for errors and integrity issues.

What it checks:

• Missing collection files
• Corrupted JSON data
• Mismatched item counts
• Invalid component references

When to use:

• After calibration to verify success
• When items aren't appearing in menus
• After server crashes during calibration

Reprice All Items#

Regenerates prices for all clothing items based on your pricing configuration.

Behavior:

• Recalculates prices using pricing rules
• Preserves items with manual priceOverride flag
• Updates collection JSON files

Collection Data Structure#

Calibration creates JSON files in the collections/ folder:

Collection File Format#

Each component has a JSON file containing item data:

collections/addons/mypack/male/torso.json
Copy
{
  "items": [
    {
      "localIndex": 0,
      "textureCount": 3,
      "hash": "mypack_torso_0",
      "priceOverride": false,
      "label": null
    },
    {
      "localIndex": 1,
      "textureCount": 1,
      "hash": "mypack_torso_1",
      "priceOverride": false,
      "label": null
    }
  ],
  "collection": "mypack",
  "componentId": 11,
  "gender": "male",
  "component": "torso",
  "lastUpdated": "2025-01-15T10:30:00Z",
  "version": 1,
  "pricing": {
    "basePrice": 150,
    "currency": "$",
    "multiplier": 1
  },
  "rarity": "addon"
}

Field Descriptions#

Components Scanned#

The calibration system scans these clothing components:

Clothing Components (PED Components)#

Prop Components (PED Props)#

Calibration Workflow#

Initial Setup (First Time)#

/clothescallibrateall

/clothesvalidate

/clothesstudio

Adding New Addon Pack#

/clothescallibrate addon newpackname

/clothesvalidate

/shootclothes addon newpackname

Removing Addon Pack#

Troubleshooting#

Calibration Fails to Start#

Problem: Command does nothing or returns error

Solutions:

1. Ensure you're running as admin in-game (not console)
2. Check ACE permissions are set correctly
3. Verify onex-creation is started without errors

Items Not Appearing After Calibration#

Problem: New addon items don't show in menus

Solutions:

1. Run /clothesvalidate to check for errors
2. Verify addon pack is properly installed (stream folder)
3. Check collection JSON files were created
4. Ensure game build supports the addon (sv_enforceGameBuild)

Calibration Takes Too Long#

Problem: Full calibration runs for extended time

Solutions:

• Use selective calibration instead: /clothescallibrate addon packname
• Calibrate during low-population periods
• Check for very large addon packs causing delays

Collection Data Corrupted#

Problem: Validation shows errors

Solutions:

1. Delete the corrupted collection folder
2. Re-run calibration for that specific addon
3. If persistent, check server logs for disk errors

Best Practices#

1. Backup before major changes - Copy collections/ folder before large operations

2. Use selective calibration - Only calibrate what changed, not everything

3. Validate after calibration - Always run /clothesvalidate to confirm success

4. Document your addons - Keep a list of installed addon pack names for reference

5. Test in staging - Calibrate on a test server before production if possible

Next Steps#