Unreal Engine Setup

Diversion ships a native Unreal Engine source control provider plugin for UE5. It integrates lock status overlays in the content browser, automatic lock-before-edit prompts, and sync status in the editor toolbar.

Requirements

  • Unreal Engine 5.0 – 5.4
  • Diversion CLI 0.7.0 or later (must be in PATH)
  • Active Diversion workspace with synced depot

Install the Plugin

# From your UE5 project root
diversion ue-plugin install --project MyGame.uproject

This copies Plugins/Diversion/ into your project and adds it to .uproject. Alternatively, download the plugin ZIP from the early access dashboard and copy it manually.

Enable in UE5 Editor

  1. Open your project in UE5
  2. Go to Edit → Plugins → search "Diversion"
  3. Enable the plugin and restart the editor
  4. Go to Source Control → Connect to Source Control
  5. Select Diversion from the provider dropdown
  6. Enter your workspace name and click Accept Settings

Lock Behavior in UE5

Once connected, the content browser shows lock status overlays: a gold lock icon for files you hold, a red lock for files locked by teammates. Opening a locked file for edit triggers a confirmation prompt — the plugin acquires the lock via CLI automatically.

# Equivalent CLI operation
diversion lock Content/Maps/City_Hub.umap --type exclusive

Toolbar Sync

The Diversion toolbar button in UE5 (next to the source control indicator) runs diversion sync and refreshes the content browser. Build farm hooks fire after the sync completes.