Backup Mod Client Side 2.0 for (V2.2)

The TechFreqs Backup Mod , A single-player / Client Only mod that automates and manages backups of 7 Days to Die save file data, ensuring players can preserve their progress with configurable options and clear tooltip messages for backed up creations & autosaving notifications for world saves.

Latest Changelog:
V2.0 (V2.2) (BETA)
- Many fixes and improvements!
- Separate Changelog txt for old versions
- LICENSE txt for terms
- Updated for V2.2 of 7D2D
- Updated Logic for Backup Interval, New commands, New tooltip delays, Detailed logs and tooltips
- Updated ReadMe for easier instruction for the modern user
See Description for new features and usage below.

KNOWN ISSUES FOR V2.0 (V2.2 (BETA):
- Issue where, on new worlds the prompt for an initial backup doesn't last long on screen,
however mechanics for backups work in console or in game chat commands, just type bm yes in console or bm no if youd prefer no backups or manualbackups,
shown by manual backup, but showing an automatic backup completed message when it should say manualbackup.
- So, some tooltips context , DELAYED, actions starts faster than the tooltip, context may be slow but still functional.
- May see the same Manual tooltip twice, even though it was triggered once still functional, says automatic backup complete typos ya know.
- Automatic backups, same tooltip delayed but functional.



StoryTime:
Great for modders or vanilla users who would like a backup of their save files, if in the event the worst case scenarios occurs or crashes.
As for my situation i hadnt found a backup mod of some sort other than resorting to manual backup methods.
And even after researching forums for a way to restore my playerxml as i tried to load into a save and found it had been corrupted, and their was hardly
anything reliable for previous version when i encountered this in A21 and A20 and early days of A19.
and i would receive a null reference error in red in logs..., as it turns out my players xml was corrupted due for that new save due to a nasty mod.
So, upon restoring a backup, from an old save even though it was only a few days old when i had made a manual backup anyways, i dont always remember to do that in mind with my ADHD brain, and life getting in the way of things.
and even after manual restoring, i was able to jump right back into my game with only a few adjustments and reusing my points for other skills in the skill tree which was no biggie but that sparked an idea..
so thus this mod was born and figured everyone should at least look into that kind of thing too. despite crashes, lag, and or some natural causes.
But despite that...



New Key Features V2.0 but for V2.2:
Configurable Delays for All Backups:
Manual Backup Warning Delay: Set how many seconds before a manual backup starts after the command is issued.
Manual Backup Imminent Delay: Set how many seconds before the manual backup action, after the warning.
Auto Backup Warning Delay: Set how many seconds before an auto-backup starts, the warning tooltip appears.
Auto Backup Imminent Delay: Set how many seconds before the auto-backup action, after the warning.


Per-World Auto-Backup Enable/Disable:
Auto-backups can be enabled or disabled per world/save.
World settings are stored in world_settings.json and updated automatically.

Improved Tooltip System:
All tooltips are prefixed with [TechFreqsBackupMod].
Tooltips are split for readability and never run off the screen.
Tooltips show backup type (Manual/Auto), world/save, backup file name and path, save folder, max backups, and next auto-backup time.
Tooltips for backup actions are shown before the action, with correct timing, and after completion.

All Commands Work in Both Chat and Console:
All backup, config, and enable/disable commands are available in both in-game chat and F1 console.

Robust Error Handling:
All errors and important actions are logged if debug logging is enabled.
All directories are verified and created as needed.
Backups are pruned to max count per world/save.
Backups are zipped and include a readme.


New/Improved Commands:
In-Game Chat:
/manualbm — Schedule a manual backup (with warning and imminent tooltips, then backup).
/enableautobm — Enable auto-backups for the current world/save.
/disableautobm — Disable auto-backups for the current world/save.
/configbm — Show current config and settings in a tooltip.
/setintervalbm <value> — Set the backup interval (e.g. /setintervalbm 10m or /setintervalbm 600s).
/reloadconfigbm — Reload config from file.
/bmyes — Respond to initial backup prompt: schedule an initial backup for this world.
/bmno — Respond to initial backup prompt: skip initial backup for this world.

F1 Console:
bm manual — Schedule a manual backup (same as /manualbm).
bm enableauto — Enable auto-backups for this world.
bm disableauto — Disable auto-backups for this world.
bm config — Show current config and settings.
bm setinterval <value> — Set the backup interval.
bm reloadconfig — Reload config from file.
bm yes — Respond to initial backup prompt: schedule an initial backup for this world.
bm no — Respond to initial backup prompt: skip initial backup for this world.


New Default Config Options JSON
{
"BackupInterval": "15m",
"MaxBackupCount": 8,
"EnableTooltipNotifications": true,
"EnableDebugLogging": false,
"SaveSourcePath": "%AppData%\\7DaysToDie\\Saves",
"BackupLocation": "Backups",
"DeleteOldBackupsImmediately": true,
"EnableAutoBackup": true,
"EnableTooltipSounds": true,
"MinFreeSpaceMB": 1024,
"AlertSound": "ui_menu_click",
"SuccessSound": "coins_grab",
"TooltipDurationSeconds": 45,
"ManualBackupWarningDelaySeconds": 30,
"ManualBackupImminentDelaySeconds": 10,
"AutoBackupWarningDelaySeconds": 30,
"AutoBackupImminentDelaySeconds": 10
}

How the New Delays Work:
Manual Backup:
/manualbm or bm manual shows a warning tooltip for ManualBackupWarningDelaySeconds,
then an imminent tooltip for ManualBackupImminentDelaySeconds,
then performs the backup and shows a completion tooltip.

Auto Backup:
At (interval - AutoBackupWarningDelaySeconds), shows a warning tooltip.
At (interval - AutoBackupImminentDelaySeconds), shows an imminent tooltip.
At interval, performs the backup and shows a completion tooltip.


Initial Backup Prompt (Per World)
When entering a new world, if HasPromptedInitialBackup is false, the mod prompts you to create an initial backup.
Respond with /bmyes or /bmno (or bm yes/bm no in console).
If yes, a manual backup is scheduled with all warning/imminent tooltips and completion message.
If no, the prompt is skipped for this world.

Per-World Settings
Each world/save has its own settings in world_settings.json:
AutoBackupEnabled: true | false
HasPromptedInitialBackup: true | false
ExistingBackup: true | false
These are updated automatically as the user interacts with the mod.


How to Restore from a Backup: (WINDOWS TUTORIAL) OTHER Operating Systems Coming soon!
Unzip the backup archive (with WinRAR, 7-Zip, or similar).
Copy the Saves folder to:
C:\Users``` YOUR USERNAME]\AppData\Roaming\7DaysToDie
(Optional) Copy the GeneratedWorlds folder to:
C:\Users``` YOUR USERNAME]\AppData\Roaming\7DaysToDie\GeneratedWorlds
(Optional) Copy serveradmin.xml, sdcs_profiles.sdf, profiles.sdf from Saves to:
C:\Users```YOUR USERNAME]\AppData\Roaming\7DaysToDie\Saves
(Optional, Initial Only) Copy Config to:
C:\Program Files (x86)\Steam\steamapps\common\7 Days To Die\Data\Config


Note:
Always restore backups while the game is NOT running.
Keep multiple backups in different locations (3-2-1 rule: 3 copies, 2 different media, 1 offsite/cloud).


Overall Key Features:
Automatic Backups:
Runs every X minutes (configurable, default 15m) in single-player mode, with warning and imminent tooltips before backup.
Manual Backups:
Triggered via /manualbm or bm manual in chat/console.
Shows warning, then imminent tooltip, then performs backup.
Backup Contents:
Saves the specific save folder (Saves/<world>/<save>),
Generated world (GeneratedWorlds/<world>),
Root files from Saves (serveradmin.xml, sdcs_profiles.sdf, profiles.sdf),
Includes the Config folder for initial/manual backups,
Includes a readme.txt with restore instructions in every backup zip.
Backup Management:
Limits to max backups per save (configurable, default 8), deleting oldest if exceeded.
Checks for minimum free disk space (default 1 GB).
Technical Details:
Uses Harmony to patch EntityPlayerLocal.Update for backup logic and GameManager.ChatMessageServer for manual commands.
Relies on a MonoBehaviour singleton for coroutine-based delays and tooltip persistence.
Configurable via config.json.
User Experience:
Simple, tooltip-driven interface for single-player backups with clear start and completion messages.
Robust error handling for disk space and missing files, ensuring backups proceed even if optional files are absent.



Disclaimer:
By using this mod, you acknowledge that TechFreq is not responsible for any issues, crashes, or conflicts caused by its use.
Use at your own risk. Please backup your game files before installing any type of mod.
Thanks for downloading and enjoy!


Installation:
Make sure harmony mod exist in the mod directory as it's required.
Download the mod files, Extract Mod files.
Please backup your world, save, and or game files.
Place them in your Mods directory of your 7 Days to Die Game.
EAC must be disabled, although i hope in the future that can be changed, as for now DLLS are not EAC supported however XML has no issue, unfortunately this is a dll modification.
THIS IS CLIENT SIDE ONLY but maybe perhaps this is also, server side and client side compatibility?
No further setup needed. Enjoy!



CREDITS:
Thanks to TechFreq & A.I, ChatGPT or Microsoft CoPilot A.I or Grok AI from Twitter or X, for helping me create the modlet, aswell as with very little modding knowledge for the game and learning as i go i couldn't do this without it and overall brainstorming and or the modding community.
I’d very much appreciate it and or any feedback for the mod(s) aswell



Support Notice:
For those who’d like to support 'TechFreqs' work, This mod may or may not be crossposted. Downloading via 7daystodiemods website through ModsFire (ad-powered, which earns per download) and helps me a ton if posted on there or other example mod sites HOWEVER!
(although its 10 cents per download) There is also a direct mirror for using NexusMods website instead which also features direct links BUT those aren't earned per click or per downloads and run off Donation Points through a different system. The best way to support TechFreq other than downloading mods, sharing the mod with friends, leaving feedback and endorsing the mod in general is all that i ask for, but if you want to go the extra mile although not necessary you may use Donation Links through paypal or ko-fi pages which again helps me a bunch!
However, Donations aren't expected, every little bit of support helps along the way & fuels more mods, music, and bug fixes in the future,so thanks again for reading and being awesome in general and checking out the mod post.


Social Media:
If you appreciate 'TechFreqs' work and want to show support, use this donation link, although not necessary. Kofi Page: https://ko-fi.com/techfreq
I appreciate it in general for just checking out the mod posts, sharing and enjoying any of the mods in itself. Thank you again! and Happy gaming!

Love this mod? Got feedback or ideas or need to troubleshoot?
Join the TechFreq Pretty Rad Squad Discord Server! https://discord.com/invite/SQCnGjNUhw
Chill with us on Discord for game chat, memes, and even more mod updates!

As for TechFreqs music, it's royalty-free music to use in your projects or for casual listening!
Source music files are available feel free to ask away, available in the discord! or for more content! TechFreqs Socials: https://beacons.ai/techfreq
Checkout the behind-the-scenes vibes today! Thank you again for checking out the mod post.


License: CC BY-NC-SA 4.0
This mod is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. You can use it for personal play in *7 Days to Die*. Modifications or sharing require crediting TechFreq, linking to the mod page, and using the same license for derivatives. Contact me at beacons.ai/techfreq for permission for any modifications or changes.
See LICENSE.txt or http://creativecommons.org/licenses/by-nc-sa/4.0/ for full terms.
Note: Monetized videos/blogs showcasing this mod are allowed along as with credit to TechFreq.