For the complete documentation index, see llms.txt. This page is also available as Markdown.

Safety & Disclaimers

⚠️ READ BEFORE USING ON PRODUCTION ASSETS

SafeSave is a User Interface (UI) Wrapper. It acts as a bridge between you and Unreal Engine’s native Source Control system. It does not modify, write, or corrupt binary files directly. Because SafeSave relies on the underlying engine and your specific network configuration, please understand the following boundaries of responsibility.

1. The "Messenger" Principle

SafeSave displays the status reported by your Source Control Provider (Git, Perforce, Plastic).

  • If your Git plugin reports a file is "Synced" when it is actually outdated (due to a bad network config or detached HEAD), SafeSave will show a Green light.

  • Disclaimer: SafeSave is not responsible for data loss caused by incorrect status reporting from the underlying Source Control plugin or misconfigured repositories.

2. Merge Conflicts are Human Decisions

When the Red Light (Safe Update) is triggered, SafeSave commands Unreal to launch the Visual Merge Tool.

  • SafeSave does not decide which version of the file "wins."

  • You must manually choose whether to accept the Server's version or keep Your Local version inside the Unreal, Merge window.

  • Disclaimer: SafeSave is not liable for work lost due to incorrect merge resolutions made by the user.

3. Network Polling Latency

The Blue Light (Update Available) relies on network polling (checking the server).

  • By default, this happens every 3–5 seconds.

  • It is physically possible for a teammate to push code in the split-second between polls while you are saving.

  • Disclaimer: The Blue Light is an assistant, not a guarantee. Always communicate with your team during "Crunch Time" updates.

4. Git LFS & .gitignore

SafeSave cannot fix a broken repository.

  • If you have not set up Git LFS (Large File Storage) correctly, your pushes may fail, or your binary files may corrupt.

  • If your .gitignore is missing and you upload Intermediate or Build folders, Unreal may fail to sync.

  • Disclaimer: SafeSave cannot prevent errors caused by improper Git/LFS configuration. Please ensure your repository is set up correctly before using this tool.

5. The "Kill Switch"

If you suspect SafeSave is interfering with your workflow or causing Editor slowdowns, you can disable it instantly without affecting your project data.

  1. Go to Edit -> Plugins.

  2. Search "SafeSave".

  3. Uncheck Enabled.

  4. Restart Editor.

  • Your project Source Control will continue to function normally using Unreal's default interface.

6. No Replacement for Backups

Source Control is not a backup solution; it is a versioning solution.

  • Recommendation: Always maintain a separate, daily backup of your project files (via Zip or Cloud Storage) independent of your Source Control history.


Last updated