Unity Plugin

The Diversion Unity plugin brings version control directly into the Unity Editor. View file statuses, commit changes, and receive real-time conflict warnings - all without leaving your project.

​

Prerequisites

Before using the plugin, ensure you have:

• Unity 6 (6000.0.0f1) or later
• Diversion Desktop app installed, running, and signed in (Quickstart)
• Your Unity project initialized as a Diversion repository (via Desktop app or CLI)

​

Installation

Once you have access to the plugin:

​

Configuration

After installing the plugin, configure it to use Diversion as your version control provider.

​

The Diversion Window

Access the main Diversion window via Window > Diversion. This is your central hub for version control operations.

​

Header Bar

The header displays:

• Branch - The active branch name
• Status - Sync state (Synced, Syncing, or Paused)
• Refresh button - Manually refresh the connection and file status
• Settings button - Opens Version Control settings

​

Changes List

The changes section shows all modified files in your workspace:

• Select All toggle - Quickly select or deselect all files
• File count - Total number of changed files
• View in Desktop - Open Diversion Desktop to view detailed diffs
• Reset All - Discard all uncommitted changes

Each file row shows its path, status, and a checkbox for selection.

​

Commit Panel

At the bottom of the window:

• Commit Message - Enter a description of your changes
• Reset Selected - Discard changes for selected files only
• Commit - Commit the selected files with your message

​

File Status Icons

Files in both the Diversion window and the Project window show status icons:

• Green circle (+) - Added file
• Orange circle - Modified file
• Red circle (-) - Deleted file
• Yellow circle (!) - Potential conflict with another user’s changes

​

Conflict Prevention

Diversion helps prevent merge conflicts by alerting you when teammates are editing the same files.

​

Opening Files

When you double-click to open an asset that another team member is currently editing, a warning dialog appears showing:

• Who is editing the file
• Which branch they’re working on
• When they last modified it

You can choose to Open Anyway or Cancel.

​

Saving Files

When saving files with potential conflicts, you’ll see a dialog with three options:

• Save Anyway - Save all files regardless of conflicts
• Cancel - Don’t save any files
• Skip Conflicted - Save only files without conflicts

​

Disabling Warnings

If you prefer not to see conflict warnings, you can disable them in the settings:

1. Go to Edit > Project Settings > Version Control
2. Expand the Diversion section
3. Uncheck Show Conflict Warnings

​

Auto-Reload Behavior

When external changes are detected (such as switching branches, resetting files from the Desktop app, or incoming commits from teammates) the plugin automatically refreshes Unity’s Asset Database and reloads open scenes. This ensures your Unity Editor stays in sync with the latest files without manual intervention. To disable automatic scene reloading, uncheck Auto-Reload Scenes in the settings.

​

Play Mode Sync

The plugin automatically pauses sync when entering Play Mode and resumes when exiting. This prevents file changes from teammates from disrupting your testing session. When you exit Play Mode, sync resumes automatically and any changes that arrived while paused will be applied.

​

Settings

Configure the plugin via Edit > Project Settings > Version Control > Diversion.

​

Quick Actions

The settings panel also provides buttons for common actions:

• Open Diversion Window - Opens the main plugin window
• Open Diversion Desktop - Launches the Diversion Desktop app
• Refresh Connection - Manually refresh the agent connection
• Documentation - Opens this documentation

​

Troubleshooting

​

Agent Not Running

Problem: The plugin shows “Agent Not Running” status. Solution:

1. Start the Diversion Desktop app
2. Make sure you’re logged in
3. Click Refresh Connection in the plugin settings

​

Not a Workspace

Problem: The plugin shows “Not a Workspace” status. Solution:

1. Open the Diversion Desktop app
2. Create a new repository from your Unity project folder, or clone an existing repository
3. The plugin will automatically detect the workspace

​

Files Not Showing in Changes List

Problem: Modified files don’t appear in the Diversion window. Solution:

1. Make sure files are saved (Ctrl+S / Cmd+S)
2. Click the Refresh button in the Diversion window
3. Check that the files aren’t excluded by your .dvignore file

​

Scene Not Reloading After External Changes

Problem: Unity doesn’t reload scenes after teammates’ changes arrive. Solution:

1. Check that Auto-Reload Scenes is enabled in settings
2. If you have unsaved changes, Unity waits for you to save first
3. Try clicking Refresh Connection manually