VRChat Avatar Ripping & Repair Guide

This guide covers how to extract a .vrca avatar file, import it into Unity, repair broken scripts and shaders using FACS Utilities, and upload the finished avatar to VRChat.

Resources

Requirements

Part 1 – Extracting the VRCA

Extract with AssetRipper

  1. Download AssetRipper and extract it to a folder.
  2. Open a terminal in that folder.
  3. Place your .vrca file inside the folder (or know its full path).
  4. Run:
AssetRipper.exe youravatar.vrca -o OutputFolderName
  1. Navigate to:
OutputFolderName/ExportedProject/Assets
  1. Rename the following folders:
Shader  -> .Shader
Scripts -> .Scripts
If you skip this step, Unity will throw compile errors.
  1. If an Editor folder exists inside Assets, delete it.

Part 2 – Importing into Unity

  1. Open Unity Hub or Creator Companion.
  2. Create a new project using the latest VRChat Avatar SDK.
  3. Import FACS Utilities.
  4. Import your extracted avatar folder (OutputFolderName).

Part 3 – Repairing the Avatar

All tools are located under FACS Utils → Repair Project.

Step 1 – Fix Scripts

Step 2 – Fix Animations

Step 3 – Easy Shader Reassign

Step 4 – Remove Missing Scripts

If missing scripts appear, you may need additional packages (for example VRCFury or other dependencies). Import the required packages and re-run Fix Scripts, then click Run Fix.

Step 5 – Detach Blueprint ID (Optional)

Optional – Testing with Gesture Manager

  1. Import Gesture Manager.
  2. Navigate to Tools → Gesture Manager Emulator.
  3. Click Play.
  4. Use the radial menu in the Inspector to test animations.
If the radial menu does not appear, select GestureManager in the Hierarchy.

Final Step – Upload to VRChat

  1. Open VRChat SDK → Show Control Panel.
  2. Sign in.
  3. Open the Builder tab.
  4. Enter avatar name and thumbnail.
  5. Resolve any warnings.
  6. Click Build & Publish.