Install ProBuilder in Unity 2022.3
Unity distributes modern ProBuilder releases through Package Manager. Unity 2022.3 lists com.unity.probuilder version 5.2.4 as its released ProBuilder package.
Add ProBuilder from Unity Registry, wait for compilation, and create one measured shape before using it in an important scene.
- Open Window > Package Manager and select Unity Registry.
- Select ProBuilder and click Install.
- Open Tools > ProBuilder > ProBuilder Window and create a test shape.
Open the world project through VRChat Creator Companion before installing ProBuilder. VRChat's setup documentation says not to create VRChat projects with URP or HDRP, so do not change render pipelines just to install or test ProBuilder.
Confirm the Project First
Install ProBuilder into the project where it will be used. Unity packages are project dependencies, not editor-wide tools.
Before installation:
- Confirm the project is the intended Creator Companion world project.
- Save the open scene.
- Record any existing Console errors.
- Confirm the project is using its intended Unity editor version.
- Back up or commit the project when it already contains important work.
This makes it easier to distinguish a package installation problem from an error that already existed.
Install from Unity Registry
- Open Window > Package Manager.
- Choose Unity Registry from the package-source menu.
- Search for ProBuilder.
- Select the package published by Unity.
- Confirm its name is
com.unity.probuilder. - Click Install.
- Wait for package resolution and script compilation to finish.
Use the Package Manager views deliberately:
| View | Use |
|---|---|
| Unity Registry | Find packages that can be installed from Unity's registry. |
| In Project | Confirm which packages are already dependencies of this project. |
| My Assets | Manage Asset Store content; this is not the normal ProBuilder installation path. |
ProBuilder 3.0 and newer is available through Package Manager. Do not copy an old ProBuilder folder or Asset Store package into a Unity 2022.3 project.
Verify the Installation
- Open Tools > ProBuilder > ProBuilder Window.
- Activate the Shape tool.
- Choose a cube or plane.
- Enter simple measured dimensions.
- Create the shape.
- Switch between Object, Vertex, Edge, and Face modes.
- Save and reopen the scene.
The package is ready when the ProBuilder window opens, a shape can be created, and changing edit modes does not introduce Console errors.
Install by Package Name
Use this only when Unity Registry does not show ProBuilder after the package list finishes loading.
- Open Window > Package Manager.
- Open the add-package menu.
- Choose Install package by name.
- Enter:
com.unity.probuilder
- Leave the version field empty.
- Click Install.
Unity documents that leaving the version empty selects the latest compatible package. If a released version and a newer pre-release or experimental version exist, Package Manager selects the released version unless a version is explicitly entered.
Do not paste a ProBuilder 6 version into a Unity 2022.3 project. Unity's 2022.3 package listing identifies ProBuilder 5.2.4 as the released version for that editor.
Render-Pipeline Samples
Unity's ProBuilder installation guide provides optional shader support samples for URP and HDRP. These samples are relevant to non-VRChat projects using those pipelines.
For an appropriate URP or HDRP project:
- Select ProBuilder in Package Manager.
- Expand Samples in the package details.
- Import the support entry matching the active render pipeline.
- Find the imported files under
Assets/Samples/ProBuilder/<version>.
The samples provide compatible shaders for ProBuilder vertex colors and textures. Importing them does not convert the project's render pipeline or automatically replace existing materials.
For a VRChat world, keep the Creator Companion project on its supported rendering setup rather than importing a different render pipeline.
Video Companion
This Unity video demonstrates the first greyboxing workflow after installation. Interface details can differ, so use the ProBuilder 5.2 manual for version-specific controls.
Troubleshooting
ProBuilder does not appear under Unity Registry
Clear the search field, confirm the source is Unity Registry, and wait for Package Manager to finish loading. If it remains missing, use the documented package-name installation with com.unity.probuilder.
Package Manager cannot resolve com.unity.probuilder
Check the Package Manager status, the project's network access, and existing package errors. Do not try unrelated versions or package names; resolve the registry or manifest problem first.
The ProBuilder menu is missing after installation
Wait for compilation to finish, then check Tools > ProBuilder. If the menu is still missing, restart Unity and resolve Console compile errors that may be preventing editor extensions from loading.
Package Manager says ProBuilder is already installed
Select In Project, open ProBuilder's details, and confirm the installed version. Then check compilation and the Console before removing or reinstalling the package.
Vertex colors or textures are wrong in URP or HDRP
For a non-VRChat URP or HDRP project, import the matching ProBuilder shader support from the package's Samples section and apply a compatible material.
An older tutorial shows different menus
Confirm the tutorial's Unity and ProBuilder versions. For Unity 2022.3, use ProBuilder 5.2 documentation and look for the current Shape tool, Edit mode toolbar, and Tools > ProBuilder menu.
The first test shape creates Console errors
Compare the errors with the list recorded before installation. If they are new, save the project, restart Unity, and inspect the complete first error before changing package versions.
Continue Learning
- ProBuilder in Unity 2022.3
- ProBuilder Blockout Workflow for VR Worlds
- Package Manager Basics
- Install and Remove Unity Add-ons Safely
- Replace ProGrids with Unity Grid Snapping
- VRChat World Building
Official References
- Unity 2022.3 Manual: ProBuilder package
- Unity ProBuilder 5.2: Installation
- Unity 2022.3 Manual: Install a package from the registry
- Unity 2022.3 Manual: Install a package by name
- VRChat Creation: Getting Started
- VRChat Creator Companion
Next Step
Create a measured room with ProBuilder Blockout Workflow for VR Worlds.