Use Diversion without leaving the Unreal Engine editor
Get the plugin
Diversion
in the Fab Marketplace,
then click on the Add to My Library
button to add the plugin to your account.Download
button and click on the Epic Games Launcher
link to go to your engine assets library.Install the plugin
Install to Engine
.Install
.Alternative: Build plugin from source
Activate the plugin
Edit
> Plugins
. Search for Diversion
and click on the checkbox to activate the plugin. If you’re prompted to restart the editor, please do.Enable revision control
Revision Control -> Connect to Revision Control
on the bottom-right.Choose provider
Diversion
from the provider drop-down list.Make sure you're logged in to Diversion
Set up Diversion Revision Control
I want to create a new repo
Initialize project with Diversion
and the plugin will do the rest. If it looks like nothing happened, make sure you’re logged in and try re-selecting Diversion from the provider drop-down list.
The plugin will recognize the root of the repository and your Diversion installation.Accept Settings
and you’re good to go!I’m connecting to an existing repo
Accept Settings
and you’re good to go!Content Browser
, right-click and choose Blueprint Class
.
In the window that appears, choose Character
and name it MyCharacter
.
You’ll notice that the new file might not be what you’re used to - it now has a yellow question mark on it. This is because Unreal Engine just created the file in-memory, and hasn’t saved it to the disk yet, so Diversion doesn’t know about it.
Save
button on the top-left. Alternatively, you can press Ctrl + S
while the file is selected in the Content Browser to save the file.
The question mark will now be gone, and instead we have a green plus sign. This means that the file is now being tracked by Diversion, and it recognizes that this is a newly added file.
Revision Control
button on the bottom-right, and then click on Submit Content
.
MyCharacter
with a green plus sign next to it. You will also see your .uproject
file, since Diversion recognizes this as a new file as well.
In the text box labeled Changelist Description
, write a brief description of the changes you’re committing. In this case, you could write Added MyCharacter
.
Submit
button, and the green plus on MyCharacter
will disappear, meaning that Diversion has committed the file.
View Repo
. It should have the same name as your project’s folder.
You’ll see the commit you just made, with the description you wrote, and the file you added. You can get a better look by clicking on the History
button and selecting your commit.
MyCharacter
blueprint, click on the Add Component
button on the top-left, and then search for Cube
and add it. Now we can see our character.
Event Graph
, add a Print String
node and connect it to the Event Begin Play
node. Now our character has some basic functionality.
Content Browser
and you’ll see that MyCharacter
now has a red checkmark next to it. This means that Diversion recognizes that the file has changed.
Revision Control
button on the bottom-right, and then click on Submit Content
.
You’ll see the MyCharacter
file with a red checkmark next to it.
Event Graph
in the list on the left.
Clicking it will show you the changes you’ve made to the blueprint, and you you should see the Print String
node you added.
Adding placeholder mesh and basic functionality to MyCharacter
.
Click on the Submit
button and the red checkmark will disappear, meaning that Diversion has committed the file.