Create a VRChat Unity Project with Creator Companion

VRChat Creator Companion creates new world and avatar projects with the VRChat SDK and supported Unity setup. Use its Create New Project workflow, choose the correct project type, and confirm the new project opens without package or compilation errors before importing anything else.

Create the project in Creator Companion

Choose World or Avatar, name the project, select its location, and open it in Unity.

  1. Open Creator Companion and click Create New Project.
  2. Select World or Avatar, then set the name and location.
  3. Create and open the project, then verify Unity, the SDK, build target, and Console.
Supported Unity version

VRChat currently lists Unity 2022.3.22f1 as its supported Editor version. Check VRChat’s Current Unity Version page before creating or upgrading a project; a newer Unity release is not automatically compatible with uploaded VRChat content.

Before You Create the Project

Prepare:

  • a Windows computer
  • VRChat Creator Companion
  • a Unity account and activated Unity license
  • a VRChat account
  • enough local storage for the project and imported assets
  • the correct project type: World or Avatar

Creator Companion can help install Unity Hub and the VRChat-supported Unity Editor when they are missing.

If Android, Quest, or iOS publishing is planned, install the required build-support modules for the VRChat-supported Unity Editor. VRChat’s Current Unity Version page provides module guidance.

Choose World or Avatar

Project type Select it when you are creating Includes
World An environment, game, social space, or Udon experience VRChat Worlds SDK and world project packages
Avatar A character uploaded as a VRChat avatar VRChat Avatars SDK and avatar project packages

Do not use one project for both an unrelated world and a collection of avatars. VRChat advises against placing many different worlds or avatars into a single project because future migrations become harder.

Create the Project

Follow the current VRChat Creator documentation:

  1. Open VRChat Creator Companion.
  2. Click Create New Project.
  3. Choose World or Avatar.
  4. Enter a project name.
  5. Choose a project location.
  6. Click Create Project.
  7. When the project page appears, click Open Project.

Creator Companion also lists created projects under Projects. If an existing VCC project is missing, use the dropdown next to Create New Project, choose Add Existing Project, and select its project folder.

Name and Locate the Project

Use a name tied to the actual content, such as:

  • HarbourGalleryWorld
  • RobotAvatar
  • MuseumPrototype

Avoid ambiguous names such as NewProject or Test2.

Choose a location with enough free space. VRChat notes that Unity projects can become large. Keep separate projects in separate folders, and do not place one Unity project inside another.

The selected folder becomes the project root. A Unity project root contains folders such as:

Assets/
Packages/
ProjectSettings/

Select that root folder—not Assets—when adding an existing project to Creator Companion or Unity Hub.

Confirm the Unity Version

After Unity opens:

  1. Read the Editor version in the title bar or Unity Hub.
  2. Compare it with VRChat’s Current Unity Version page.
  3. Close the project if the version is wrong.
  4. Correct the Editor association through Creator Companion before importing or saving upgraded assets.

Do not open a VRChat project in the newest Unity version offered by Unity Hub merely because an update is available.

Confirm the Initial Build Target

VRChat’s Getting Started guide asks creators to confirm that the Unity title bar ends with:

PC, Mac & Linux Standalone <DX11>

If it does not:

  1. Open File > Build Settings.
  2. Select PC, Mac & Linux Standalone.
  3. Click Switch Platform.
  4. Wait for Unity to finish reimporting.

Switch to Android later when preparing and testing the Android version. Platform switching can trigger asset reimports, so let the process finish before editing or closing the project.

Verify the VRChat SDK

Open:

VRChat SDK > Show Control Panel

Check:

  • the Control Panel opens
  • the Authentication tab is available
  • the Builder tab is available for the selected project type
  • the Console has no red compilation errors
  • Unity has finished importing packages

Sign in with the VRChat account used for publishing. VRChat requires a VRChat account—not a Steam, Meta, or Viveport platform account—for uploads.

Do not begin importing asset packages while the new project is still resolving or compiling its initial packages.

Use the Correct Render Setup

VRChat’s current setup documentation tells creators who use Unity Hub directly to create a standard 3D project and not use HDRP or URP, because VRChat does not use those pipelines.

Creator Companion’s World and Avatar project templates provide the intended starting point. Do not replace their render setup with a Unity Hub URP, HDRP, VR, or AR template.

If a tutorial tells you to convert a new VRChat project to another render pipeline, verify that workflow against current VRChat Creator documentation before proceeding.

Save a Known Working State

Before adding third-party packages:

  1. Wait for Unity’s import and compilation indicators to finish.
  2. Open the Console and resolve unexpected red errors.
  3. Save the active scene if you changed it.
  4. Close Unity.
  5. Reopen the project through Creator Companion.
  6. Confirm the SDK Control Panel and Console still work.
  7. Create a backup or version-control checkpoint.

This gives you a reproducible point to return to if a later import introduces errors.

Organize Your Own Assets

Keep creator-owned content in clear folders under Assets, for example:

Assets/
  Project/
    Scenes/
    Materials/
    Textures/
    Models/
    Prefabs/
    Audio/

Do not reorganize files inside installed package folders to match this example. Package-managed content belongs under Packages and should be managed through Creator Companion or the relevant package manager.

Use a project-specific root such as Assets/Project to separate your work from imported third-party assets.

Add Packages Through Creator Companion

Close Unity before changing VCC-managed packages.

  1. Open the project in Creator Companion.
  2. Click Manage Project.
  3. Review the installed packages and available updates.
  4. Add only packages required by the project.
  5. Reopen Unity and wait for compilation.
  6. Check the first relevant Console error if the import fails.

Confirm that a package supports the project’s Unity and SDK versions before installation. A Unity Asset Store package or old tutorial is not proof of current VRChat compatibility.

General Unity Projects

Use Unity Hub directly when the project is not intended for VRChat.

For a general Unity project:

  1. Open Unity Hub.
  2. Choose New project.
  3. Select the required Editor version and template.
  4. Set the project name and location.
  5. Create the project.

Template and render-pipeline choices depend on that project’s target. Do not copy VRChat-specific restrictions into an unrelated Unity application, and do not copy a general Unity template into a VRChat project.

First-Open Checklist

Check Expected result
Project type World or Avatar matches the intended content
Unity version Matches VRChat’s Current Unity Version page
Build target Standalone for the initial PC setup
SDK menu VRChat SDK Control Panel opens
Packages Initial import and compilation finish
Console No unexplained red compilation errors
Project root Contains Assets, Packages, and ProjectSettings
Recovery point Backup or version-control checkpoint exists

Do not treat the project as ready for asset imports until these checks pass.

Troubleshooting

Creator Companion cannot find the installed Unity Editor.

Check VRChat’s Current Unity Version page, then use Creator Companion’s Unity Editor settings to refresh or select the installed Editor path. Do not associate the project with an unsupported Unity release.

The World or Avatar project option is missing.

Update Creator Companion and let it refresh its package and template information. If the options remain unavailable, use VRChat’s SDK troubleshooting and support guidance rather than creating a substitute URP or HDRP project in Unity Hub.

The VRChat SDK menu is missing after the project opens.

Wait for package import and compilation, then inspect the first red Console error. Close Unity and confirm the project’s VRChat packages in Creator Companion before reinstalling or deleting anything.

The new project opens with red Console errors.

Let Unity finish importing, then read the first relevant error. Confirm the Unity version and VCC package state. VRChat asks creators to contact Support when a brand-new empty project still reports errors.

The project opens on Android instead of Standalone.

Open File > Build Settings, select PC, Mac & Linux Standalone, and click Switch Platform. Wait for the reimport to finish before continuing the initial PC setup.

The project is not listed in Creator Companion.

Use the dropdown beside Create New Project, select Add Existing Project, and choose the project root containing Assets, Packages, and ProjectSettings.

Continue Learning

Official References

Next Step

Create one empty World or Avatar project, reopen it through Creator Companion, and confirm the Unity version, Standalone target, SDK Control Panel, and clean Console before importing assets.

Related Navigation