Skip to main content

Setup OSS (Deprecated)

warning

This setup guide is deprecated. It documents the older VRseBuilder Starter Project and OSS-oriented workflow. A new setup guide for installing the VRseBuilder SDK in a fresh Unity 6 URP project will replace the main setup page after review.

Set up the VRseBuilder Starter Project, connect VRse MCP, and create a first experience in Unity.

Video Walkthrough​

Before You Begin​

Use a Windows workstation with a stable internet connection, GitHub access, GitHub Desktop, Unity Hub, and Unity Editor 6000.3.19f1.

VR Development Workstation​

ComponentMinimumRecommended
Operating systemWindows 10, 64-bitWindows 11, 64-bit
ProcessorIntel Core i5 12th generation or AMD Ryzen 5 5600Intel Core i7 12th generation or AMD Ryzen 7 7000 series, or better
Memory16 GB RAM32 GB RAM
Graphics cardNVIDIA RTX 3060 or AMD Radeon RX 6700 XTNVIDIA RTX 4070 or AMD Radeon RX 7800 XT, or better
Storage100 GB free SSD space100 GB free NVMe SSD space
Headset and connectionMeta Quest 2 or newer with a compatible USB 3 cable or stable Wi-Fi connectionMeta Quest 3 or Quest Pro with a dedicated Wi-Fi 6/6E router or a high-quality USB 3 cable

These are VRseBuilder targets for PC VR development and Quest testing, not Meta's official compatibility list. The baseline reflects the setup walkthrough's RTX 3060 guidance; use the recommended tier when regular headset testing is part of your workflow. Confirm GPU and connection compatibility against Meta Quest Link requirements before purchasing hardware or scheduling headset testing.

warning

Package installation and imports modify the Unity project. Keep the project under version control, confirm the repository and Git credential context before installing packages, and do not interrupt Unity while it is registering packages, compiling, reloading the domain, or importing assets.

Clone and Open the Starter Project​

  1. Open VRseBuilder-Starter-Project on GitHub.
  2. Select Code then Open with GitHub Desktop.
  3. Wait for cloning to finish and GitHub Desktop to show No local changes.
  4. In Unity Hub, select Add then Add project from disk.
  5. Choose the cloned VRseBuilder-Starter-Project folder and open it with Unity Editor 6000.3.19f1.
  6. Wait for Unity to resolve packages, compile scripts, and open the Editor. Close optional first-launch windows, such as Meta Avatars sample asset configuration, when they are not needed.

Install VRse MCP​

  1. The VRseBuilder SDK Setup Wizard opens when Unity finishes loading. Select New / Load Project to open the VRseBuilder Project Hub.
  2. Open Settings then Packages.
  3. Find VRse MCP and select Install.
  4. Review the confirmation: Unity Package Manager uses your existing Git credentials. Select Install only when the repository and credentials are correct.
  5. Wait for the package process to complete. The package shows Installed and a Manage button when ready.
  6. Select Manage and verify that the VRseBuilder Unity MCP window shows Server Running on port 7890.
info

If you close or miss the Setup Wizard, select VRseBuilder > SDK Setup Wizard from Unity's menu bar. To open the Project Hub directly, select VRseBuilder > Project Hub.

Configure an External AI Agent​

In the VRseBuilder Unity MCP window, open AI Agent Configuration and choose your agent:

  • OpenCode
  • Claude Code
  • Claude Desktop
  • Codex
  • Cursor
  • GitHub Copilot
  • Visual Studio Code
  • Other

Confirm the agent and MCP configuration show as connected, then select the required skills and choose Install Selected Skills. Restart the selected agent so it loads the updated MCP configuration and skills.

Optional: Install Multiplayer​

Install the Photon SDK Bundle only when the experience requires multiplayer or voice. In Project Hub > Settings > Packages, select Install for Photon SDK Bundle and complete Photon sign-in and license acceptance if authorized.

The Project Hub lists these required versions. If you use manual package imports, use this order:

  1. Fusion 2.0.13
  2. Voice 2.8.5
  3. Fusion Physics 2.0.6

Accept Unity's script-updating consent when prompted and wait for compilation after each import.

For multiplayer configuration after installation, see Multiplayer.

Create Your First Experience​

VRseBuilder organizes content as Project > Module > Experience > Scene.

  1. In Project Hub > Projects, select + New Project, name it, and select Create.
  2. Under the project, select + Create Module, name it, and select Create.
  3. Add an experience, give it a name, choose Training or Evaluation, then select Create.
  4. Select Create Scene for the new experience.
  5. Wait for the scene to load. Confirm that the Hierarchy contains the generated story objects and that the Scene view displays the VR interface.

Try MCP​

Open your configured AI agent and enter a request such as:

create a grabbable cube for me

Inspect and test every generated Unity change before using it in a training or production build.

Next Steps​

unity

Unity SDK Overview

Learn what the Unity SDK provides and how its systems fit together.

cube

VRse Blocks

Add pre-configured interactables and UI blocks to your scene.