VersionCTRL
Git-inspired version control for Cavalry scenes.
VersionCTRL brings semantic versioning and a full commit history to your .cv project files. Every meaningful save gets a version number and an optional message, so you always know exactly where you are and can return to any point in your history with a single click.
Why VersionCTRL?
Cavalry's built-in save is a single slot. VersionCTRL stacks numbered copies alongside it — each one labelled, timestamped, and described in your own words. Whether you're iterating on an animation, handing work off to a client, or just want a safety net before a big change, you get a clear, browsable record of your project's evolution with none of the terminal overhead.
Key Features
- Patch / Minor / Major saves — one-click semantic versioning with an optional commit message. The version number lives in the filename so your folder stays self-documenting.
- Full version history — a scrollable card list shows every saved version with its message, date, and elapsed time. Open any past version directly from the panel.
- Outdated version warning — if you open an older copy of your scene, VersionCTRL flags it immediately and offers to jump you straight to the latest.
- Promote older versions — restore a past version as a new Minor or Major release; original files stay on disk untouched.
- Project renaming — rename the scene and its entire version log in one step, with a redirect so older files still point to the new name.
- Patch cleanup — preview and delete intermediate patch files with smart retention rules: the highest patch per minor group is always kept.
- Referenced File mode — automatically maintains a stable, versionless copy of your scene for projects that nest this file as an asset.
- Debug logging — opt-in file-based debug log for diagnosing crashes; share it with support without needing a debugger.
Works with your existing workflow
VersionCTRL does not replace Cavalry's native save. Plain Cmd/Ctrl+S keeps working exactly as before — VersionCTRL's version buttons create additional numbered copies on demand. Your project folder stays clean, and you stay in control of when a save becomes a version entry.