Unity Setup

Diversion provides a Unity Package Manager (UPM) package that adds file lock status in the Project window, lock-before-edit prompts, and post-sync build triggers.

Requirements

Unity 2022.3 LTS or Unity 6
Diversion CLI 0.9.1 or later (must be in PATH)
Active Diversion workspace

Install via Package Manager

In the Unity Package Manager window, click + â†’ Add package by name and enter:

com.diversion.vcs

Or add directly to Packages/manifest.json:

"com.diversion.vcs": "0.9.1"

Configure the Package

After install, go to Edit â†’ Project Settings â†’ Diversion and enter your workspace name. Click Test Connection to verify CLI access.

Lock Status in Project Window

The Project window shows lock overlays: a yellow lock icon for exclusively locked assets, a grey lock for advisorily locked assets. Right-click any asset to access Diversion â†’ Lock / Release Lock / View Lock Holder.

Post-Sync Build Trigger

Configure a webhook under Project Settings â†’ Diversion â†’ Build Hooks to fire your Unity Cloud Build job after every successful sync.

# Equivalent CLI operation
diversion hooks add post-sync https://api.unity.com/build/trigger \
  --auth-header "Authorization: Bearer YOUR_TOKEN"