Last reviewed 18 May 2026
Applies to
VRChat avatar creation Avatar expression workflow Unity avatar project setup
Difficulty Beginner

Setting up your Avatar Project | VRC Avatar for Dummies

Open this avatar tutorial on YouTube

Creator: DedZedOffishal

Set up the avatar project before importing models, adding expressions, or debugging upload problems. This page adds the written setup checks, VRChat-specific caveats, and next-step links around the video so it works as part of the avatar creation collection.

The important habit is simple: prove the project is healthy before you add the avatar. A clean Creator Companion project is much easier to troubleshoot than a project that already has broken shaders, missing SDK menus, old packages, and several imported avatars mixed together.

Recommended Setup

Work on one avatar feature at a time in a clean project, then test in VRChat before expanding it.

  1. Create or open the avatar project through VRChat Creator Companion.
  2. Confirm the supported Unity version and Avatar SDK packages are installed.
  3. Import dependencies in a controlled order, then test before adding extra avatar systems.
VRChat note

VRChat avatar projects are easiest to troubleshoot when Creator Companion manages the SDK packages. Avoid starting avatar work inside an old world project, a manually assembled SDK folder, or a project with both world and avatar SDK assumptions mixed together.

What This Tutorial Helps With

Set up the avatar project before importing models, adding expressions, or debugging upload problems. It is part of the VRC Avatars for Dummies playlist and works best when you follow along inside Unity instead of only watching passively.

You'll Learn

  • Where project setup fits in the larger upload workflow.
  • What to confirm before importing a model or expression system.
  • Why a clean VCC project makes later troubleshooting easier.

Before You Start

  • VCC installed and signed in.
  • Supported Unity version available.
  • A dedicated local project folder outside cloud sync.
  • Enough disk space for imports and Unity cache files.

Before importing the avatar itself, confirm:

  • the project type is Avatar
  • the VRChat SDK menu appears in Unity
  • the Console has no red compile errors
  • the project opens from Creator Companion
  • the Unity version matches VRChat's currently supported editor version
  • you know which shaders or packages the avatar requires

Recommended Import Order

Importing everything at once makes troubleshooting harder. A safer beginner order is:

Step Import or check Why
1 Create the Avatar project in Creator Companion starts with the right SDK package setup
2 Open Unity and confirm SDK menus proves the project loaded correctly
3 Import required shaders or tools avoids pink materials and missing dependencies
4 Import the avatar package or model keeps avatar errors separate from setup errors
5 Check the Avatar Descriptor confirms the SDK can recognize the avatar
6 Test upload/build validation catches missing requirements before adding extras
7 Add expressions, PhysBones, contacts, or toggles keeps advanced systems easier to debug

For paid or downloaded avatars, always read the creator's install notes. Many avatar packages expect a specific shader, package, or import order.

Good Fit

Use this first if you are new to avatar work or if an existing project has become messy enough that troubleshooting is harder than starting clean.

Starting fresh is often faster when:

  • SDK menus are missing
  • old SDK files were imported manually
  • the project was originally a world project
  • multiple avatars and shader packs are mixed together
  • every import creates new Console errors
  • you cannot tell which package caused the problem

VRChat Concept Check

VRChat Creator Companion is the expected project manager for current SDK projects, and VPM keeps SDK packages and dependencies tracked. Start here before changing avatar-specific systems.

Avatar projects and world projects are different templates. They both use Unity and the VRChat SDK ecosystem, but your first avatar project should be created as an avatar project from the start.

Clean Project Checklist

Area Healthy sign
Creator Companion Project appears in VCC and opens from there
Unity version Matches the current VRChat-supported editor version
SDK VRChat SDK menu appears after Unity finishes loading
Console No red compile errors before avatar import
Packages Avatar SDK is installed and managed by VCC
Folder location Project is in a stable local folder, not inside a fragile sync/import loop
Import plan Dependencies, avatar, then optional systems

Common Problems

The project opens with missing SDK menus.

Reopen it from Creator Companion and confirm the Avatar SDK package is installed before changing Unity files. If the project was created manually, it may be faster to create a fresh avatar project in VCC.

Imports immediately create Console errors.

Pause and fix package or shader issues before importing more assets. Stacking imports on a broken project makes the cause harder to find.

The avatar package has pink materials.

Check the avatar creator's required shader or render setup. Import missing shader dependencies before changing every material manually.

The project was accidentally made as a world project.

Create a fresh Avatar project in Creator Companion. Mixing project types can produce confusing SDK panels, missing builder options, and package assumptions.

I want to import several avatars into one project.

For beginners, keep one avatar per project until you understand the dependencies. Shared shader packages are fine, but multiple complex avatars can make errors harder to trace.

After You Finish

  • Save the Unity scene and project assets.
  • Test the result in VRChat, not only in the Unity editor.
  • Check the avatar performance rank if the change adds materials, dynamics, contacts, or extra systems.
  • Keep a backup before repeating the same pattern across the whole avatar.
  • Record which shaders and packages the avatar depends on.
  • Keep a clean backup before adding expression menus, toggles, or PhysBone changes.

Related Resources

Related Docs

Final Advice

Do not rush the setup step. A clean avatar project gives you a stable place to import the model, fix materials, configure the Avatar Descriptor, test performance, and upload without guessing which old package caused the latest error.

Topics: Setting up your Avatar Project, VRChat avatars, avatar workflow