LAC Texture Compressor

Texture Compressor analyzes avatar textures and compresses them based on their complexity. Complex textures (detailed patterns, text) receive less compression, while simple textures (solid colors, gradients) receive more compression.

Usage

Presets

Built-in Custom Presets

In addition to the main presets above, intermediate presets are available via the Custom Preset dropdown:

These presets provide finer control when the main presets don't quite match your needs.

Texture Filters

Control which texture types are processed:

Skip Uncompressed Textures on Unknown Properties

Available as a sub-option under Other Textures (enabled by default).

Some shaders use texture slots to store non-visual data — SPS bake data, masks, lookup tables — where individual pixel values matter. Compressing these textures can corrupt the data even when the visible result looks fine.

When this option is enabled, uncompressed textures assigned to unrecognized shader properties are skipped. Already-compressed textures (DXT/BC/ASTC) on the same properties are still processed, since their data is already lossy. Properties known by Unity Standard / URP / HDRP, lilToon, Poiyomi, and UTS2 are always treated as visual textures regardless of this setting.

Exclusions

The Exclusions section combines two ways to opt textures out of compression: by texture asset, and by asset path prefix.

Excluded Textures

Add specific Texture2D assets to skip them entirely. Useful when you want to keep a single texture untouched without converting it to a frozen entry.

1. Expand the Exclusions section in the inspector
2. Under Textures, click + Add Texture
3. Drag a texture asset into the field, or pick one from the object picker

Excluded textures are matched by GUID, so renames and moves are tracked automatically.

Path Exclusions

Skip every texture whose asset path starts with a given prefix. Useful for:

• Excluding temporary assets generated by other tools
• Preserving textures from specific packages that shouldn't be modified

The list is empty by default. Click + Add Path... to either enter a custom prefix or pick a known preset:

Any texture whose asset path begins with a listed prefix is skipped.

Preview

Click Preview Compression Results in the Inspector to see compression analysis before building.

Search and Filter

The Frozen Textures and Preview sections each have their own search box, so you can filter the two lists independently:

• Standard search: Type any part of the texture name or asset path to filter the list (case-insensitive). The Preview search additionally matches the texture category (Main / Normal / Emission / Other). The Frozen search falls back to matching the texture GUID when the asset path can't be resolved.
• Fuzzy search: Toggle Fuzzy to allow up to 1 character of edit distance — insertion, deletion, or substitution.

While searching, the section header shows the filtered count (e.g., Frozen Textures (3/10) or Preview (3/10 shown)) and the search box itself shows Showing 3 of 10.

Summary

The preview shows total memory statistics for the avatar's textures:

Texture List

Entries are grouped under three section headers:

• Textures to Compress — entries that will be analyzed and compressed
• Frozen Textures (Manual Override) — entries with user-set Divisor / Format / Skip
• Skipped Textures — entries that won't be processed (see Skipped Textures)

For each texture, the preview displays:

• Texture thumbnail - Click to highlight the texture in the Project window
• Texture type label below the thumbnail (Main, Normal, Emission, Other)
• Texture name to the right of the thumbnail
• Complexity (0–100%) with a green-to-red progress bar
• Size - {original}x{original} → {recommended}x{recommended} (÷N), or {original}x{original} (unchanged) when no resize is applied.
• Format - Expected compression format (e.g., BC7, DXT5, ASTC_4x4) with format details (bpp, etc.)
• Freeze button - Click to freeze the texture with manual override settings (see Frozen Textures)

A Close Preview button at the bottom of the section dismisses the preview.

Complexity Score Interpretation

Skipped Textures

Textures that won't be processed are shown separately with skip reasons:

• Too small: Texture is smaller than the minimum size threshold
• Filtered by type: Texture type is disabled in filters
• User frozen (skipped): Texture is frozen with "Skip compression" enabled
• Runtime generated: Texture has no asset path (dynamically created during build)
• Excluded texture: Texture is in the Excluded Textures list
• Excluded by path: Texture's asset path matches a path exclusion pattern
• Uncompressed on unknown property: Texture is uncompressed and assigned to an unrecognized shader property. See Skip Uncompressed Textures on Unknown Properties.

Frozen Textures

Frozen textures allow you to manually override compression settings for specific textures. This is useful when:

• Automatic compression is too aggressive for an important texture
• You want to preserve a specific texture at full quality
• You need to use a specific compression format for certain textures

Freezing a Texture

1. Click Preview Compression Results to analyze your textures
2. Find the texture you want to freeze in the list
3. Click the Freeze button next to the texture

The texture will be moved to the "Frozen Textures" section with manual controls.

Frozen Texture Settings

For each frozen texture, you can configure:

Available Formats

Unfreezing a Texture

To remove manual override and return to automatic compression:

1. Find the texture in the Frozen Textures section
2. Click the Unfreeze button

The texture will return to normal automatic processing.

Custom Presets

Custom Presets allow you to save compression settings as reusable ScriptableObject assets. This is useful for:

• Sharing settings across multiple avatars
• Creating platform-specific configurations (e.g., "PC/High Detail", "Quest/Optimized")
• Maintaining consistent compression settings across projects

Creating a Custom Preset

Using a Custom Preset

1. Set the component to Custom mode
2. Click the Custom Preset button
3. Select a preset from the hierarchical menu

Use-Only Mode vs Edit Mode

When you select a preset from the Custom Preset button, the component enters Use-Only Mode:

In Use-Only Mode:

• A settings summary shows the current configuration at a glance
• The preset's Description is displayed if set
• Click Edit to switch to Edit Mode for modifications

Preset Editing Restrictions

Some presets cannot be edited directly:

When attempting to edit a restricted preset:

1. A confirmation dialog appears
2. You can choose to Unlink and continue editing (settings are copied locally)
3. Or Cancel to keep the preset linked

Managing Preset Settings

These actions are available as icon buttons next to the preset field:

A sync indicator shows whether local settings match the preset:

• Modified: Local settings differ from the preset
• Synced: Settings match the linked preset

Preset Configuration

When editing a Custom Preset asset in the Inspector:

Advanced Settings

Editor Preferences

Project-wide settings live under Edit > Preferences > Avatar Compressor. These apply to every avatar in the project.

Analysis Backend

Texture complexity analysis can run on either the GPU (compute shaders) or the CPU. The GPU backend is faster on large avatars but requires supportsComputeShaders and supportsAsyncGPUReadback. CPU and GPU produce matching scores within numerical tolerance.

If GPU initialization fails at runtime, Avatar Compressor logs a warning and transparently falls back to CPU for that build — there is no need to switch the preference manually.

Compatibility