Skip to content

Limitex/avatar-compressor

Repository files navigation

Avatar Compressor

License: MIT GitHub release GitHub Downloads (latest) GitHub Downloads (total) GitHub Actions

A non-destructive avatar optimization utility for VRChat. Create lightweight avatars that more players can see.

Features

Texture Compressor

Analyzes and compresses avatar textures based on their complexity.

  • Complexity-based analysis - Textures are analyzed to determine optimal compression levels
  • Multiple analysis strategies - Fast, HighAccuracy, Perceptual, and Combined modes
  • Preset configurations - Quick setup with 5 built-in presets
  • Texture type awareness - Specialized handling for normal maps, emission maps, and more
  • Platform-specific formats - Automatic format selection for PC (DXT/BC) and Quest (ASTC)
  • High-quality compression - BC7/ASTC_4x4 for high complexity textures
  • Memory estimation - Preview estimated VRAM usage before building
  • Shared texture optimization - Shared textures are processed once and reused

Requirements

  • Unity 2022.3.22f1 (VRChat specified version)
  • VRChat SDK Avatars 3.10.0 or later
  • NDMF 1.10.0 or later

Installation

Via ALCOM (Recommended)

  1. Open ALCOM
  2. Add the repository: https://vpm.limitex.dev/
  3. Add Avatar Compressor to your project

Via VRChat Creator Companion

  1. Open VRChat Creator Companion
  2. Add the repository: https://vpm.limitex.dev/
  3. Add Avatar Compressor to your project

Manual Installation

Download the latest release from GitHub Releases and import the .zip file into your Unity project.

Usage

Add optimization components to your avatar's root GameObject, configure settings, and build your avatar. All optimizations are applied automatically at build time via NDMF.

Recommended

For best results, we recommend using this tool together with Avatar Optimizer (AAO). Avatar Optimizer provides additional optimization features such as mesh merging, bone reduction, and more. LAC runs before Avatar Optimizer in the build pipeline, ensuring optimal texture compression before other optimizations are applied.

License

MIT License

Author

Limitex

About

LAC: Avatar Compressor: Non-Destructive Avatar Compression Utilities

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta

Contributing

Stars

Watchers

Forks

Contributors