Skip to main content
Version: 3.0.0

Upgrade WEAVR

To upgrade WEAVR Creator to a newer version, import the new package from the Package Manager exactly as when you first installed WEAVR.

Migrating to WEAVR 3.0.0 (Unity 6.3)​

WEAVR 3.0.0 requires Unity 6.3 (or newer) and URP. When moving an existing project onto this release, migrate Unity first, then WEAVR — don't import the new package while the project is still on the old Unity version.

Follow this order:

  1. Back up the project — commit or copy the project (and, ideally, close Unity) before you start, so you can roll back if anything goes wrong.
  2. Convert the project to Unity 6.3 — open the existing project with Unity 6.3 and let the editor upgrade it (it reimports assets and updates the packages it manages). Let this finish and resolve any Unity-side errors before touching WEAVR.
  3. Remove the old WEAVR package — once the project runs on Unity 6.3, remove the previous WEAVR package from the Package Manager.
  4. Add the new WEAVR package — import WEAVR 3.0.0 the same way you would on a fresh install (see Import WEAVR).
warning

Do the steps in this order. Removing the old package before the project is on Unity 6.3, or importing WEAVR 3.0.0 while still on the old Unity version, can leave the project with unresolved references or compilation errors.

tip

After the upgrade, if a scene's materials look wrong (for example pink shaders), convert them to URP with WEAVR > Utilities > Add Material Switcher (see Material Switcher).