The Unreal Editor plugin
The plugin is a native Unreal revision control provider: Check Out, Submit, Sync, Revert, history and asset badges all work from the editor. It talks to the same background daemon as the lode command.
Supported: Unreal Engine 5.6, 5.7 and 5.8 on Windows and Linux.
Install
Most teams commit the plugin into the project, under Plugins/LodeBaseSourceControl/, so everyone gets it on sync. Otherwise, download the plugin package for your engine version and unzip it into your project's Plugins folder (create the folder if it doesn't exist). The project has to be inside a LodeBase workspace.
Connect
- Open the project.
- Revision Control (bottom right of the editor) → Connect to Revision Control.
- Choose LodeBase, then Accept Settings.
Asset icons now show who has what checked out, what you've changed and what's out of date.
Working in the editor
| You want to | In the editor |
|---|---|
| Lock an asset before editing | Right-click → Check Out (or accept the prompt when you start editing) |
| Submit your work | Revision Control → Submit Content |
| Get everyone else's work | Revision Control → Sync Content |
| Undo changes to an asset | Right-click → Revert |
| See an asset's history | Right-click → History |
What sync won't do
Sync never overwrites anything you have open with unsaved changes: those files are skipped and listed. It also never replaces the level you have open (and its external actors); open another map and sync again. Everything else is reloaded in place.
The tray
lode-tray shows green (all good), amber (offline or signed out) or red (daemon not running), how far behind each workspace is, and your locks, with Sync now, Open folder and Sign in. It tells you when someone submits or breaks one of your locks.