Last reviewed 31 Jul 2026
Applies to
First VRChat world VRChat Creator Companion VRChat Worlds SDK
Difficulty Beginner

Create Your First VRChat World in Unity

A VRChat world is a Unity scene prepared with the VRChat Worlds SDK. This guide takes you from a new Creator Companion project to a local test in VRChat.

First Local Test

Create a World project in Creator Companion, confirm the scene has a VRC Scene Descriptor, position its spawn, and run the SDK's local test.

  1. Create a World project in Creator Companion.
  2. Build a floor and place the VRCWorld spawn above it.
  3. Resolve required SDK validation messages, then select Build & Test Your World.
VRChat project required

Do not add a standalone XR Origin or XR Interaction Toolkit rig. VRChat supplies the player, camera, tracking, input, and networking when the world runs.

What You Need

  • VRChat Creator Companion
  • Unity Hub and the Unity version selected by Creator Companion
  • a VRChat account
  • VRChat installed for local testing

Creator Companion checks for Unity Hub and a compatible Unity installation. Its World template includes the VRChat Base and Worlds SDK packages and ClientSim.

1. Create a World Project

Open Creator Companion, then:

  1. Select Projects.
  2. Select New.
  3. Choose the World template.
  4. Enter a project name and choose its parent folder.
  5. Select Create Project.
  6. Wait for Unity to finish importing the project and its packages.

Open the project from Creator Companion after the import completes.

2. Confirm the Scene Descriptor

Every VRChat world scene requires a VRC Scene Descriptor.

Projects created from the World template normally include a VRCWorld GameObject with the descriptor already attached. Select it in the Hierarchy and confirm the component appears in the Inspector.

If the scene does not contain one:

  1. Open VRChat SDK > Show Control Panel.
  2. Sign in on the Authentication tab.
  3. Open the Builder tab.
  4. Select Add a VRCSceneDescriptor.

The SDK adds a VRCWorld GameObject containing the required descriptor and supporting components.

3. Add a Floor and Boundaries

Create geometry that makes the first test safe and easy to inspect:

  1. Add a Plane or Cube for the floor.
  2. Confirm the floor has a Collider.
  3. Add walls or barriers around any open edges.
  4. Place a light so the test area is visible.
  5. Save the scene.

Keep the spawn clear of walls, ceilings, furniture, and other colliders.

4. Position the Spawn

The world needs at least one spawn point. By default, players spawn at the location of the VRCWorld GameObject.

Move VRCWorld to the intended arrival point:

  • place it above the floor rather than inside it;
  • rotate it toward the first area players should see;
  • leave clear space around it.

For additional spawns, create empty GameObjects and add their transforms to the descriptor's Spawns list. The descriptor also provides Spawn Order, Spawn Radius, and Spawn Orientation controls.

Scene Descriptor Settings

Setting What it controls
Spawns The transforms players may use when joining the world.
Spawn Radius A disc around each spawn where players may appear. A value of zero uses the exact spawn position.
Spawn Order How the descriptor chooses between multiple spawns.
Spawn Orientation How the player or room-scale space aligns with the selected spawn.
Respawn Height -Y The height below which players respawn and pickups are respawned or destroyed.
Reference Camera Camera settings applied to players in the instance.

5. Check the SDK Builder

Open VRChat SDK > Show Control Panel, sign in, and select Builder.

Read the validation messages before building. The SDK checks for problems such as:

  • a missing VRC Scene Descriptor;
  • missing VRChat layers or collision settings;
  • problems with Audio Sources, textures, or Udon scripts.

Some messages include an automatic fix. Other messages are advisory, so read the description before changing the scene.

6. Test the World Locally

In the Builder tab, use the Build Type menu and select Build & Test Your World. The SDK builds the scene and launches the local world in VRChat.

During the test, confirm:

  • you arrive at the intended spawn and face the correct direction;
  • the floor and boundaries prevent falling;
  • the scene is visible from the spawn;
  • the Unity Console does not contain build errors.

The Builder also offers Build & Reload Your World, Test Your Last Build, and Reload Your Last Build for repeated local tests.

Local Testing and Upload Access

VRChat currently requires a trust rank of New User or higher to upload a world. Visitor accounts can still build and test worlds locally.

When the world is ready to upload, the SDK Builder asks for public-facing information such as its name, description, capacity, content warnings, tags, and thumbnail. Use Build & Publish Your World Online only after resolving required validation errors and completing a local test.

Add a VRChat Interaction

Use VRChat world components and Udon for world interactions. Do not import a generic standalone VR player rig.

The Worlds SDK includes components for common features such as:

  • VRC_Pickup for pickup objects;
  • VRC_ObjectSync for synchronizing an object's transform;
  • VRC_MirrorReflection for mirrors;
  • VRC_Station for seats and stations;
  • VRC_UIShape for interaction with Unity UI.

Check the official scene-components and allowlisted-components pages before relying on a Unity component or runtime asset in an uploaded world.

Troubleshooting

The VRChat SDK menu is missing.

Confirm that the project was created from the Creator Companion World template. VRChat's first-world guide also recommends trying Assets > Reimport All when the SDK is installed but its menu does not appear.

The SDK says the scene has no descriptor.

Open VRChat SDK > Show Control Panel > Builder and select Add a VRCSceneDescriptor. Then position the generated VRCWorld GameObject at the intended spawn.

I spawn inside the floor or a wall.

Move the VRCWorld GameObject or assigned spawn transform into clear space above the floor. Rotate it toward the arrival area, save the scene, and run Build & Test again.

The world will not build.

Read the SDK Builder validation messages and the first relevant red error in the Unity Console. Resolve compile errors before starting another build.

I cannot upload the world yet.

You can continue using local build options while your account is below New User rank. Uploading becomes available when the VRChat account meets the current requirement.

Official References

Continue Learning