TechFreqs Backup Mod a 7 Days to Die Client Only World Save and Backup Tool

V2.1 (V2.2) BETA

• Many More fixes and improvements
• Better Logic handling
• Added Operating System Detection Yay! Detects if its on Windows or Linux
• Adds Linux Support as its IN BETA! Yay!
• Updated Readme, Modinfo
• Added GeneratedWorlds Config entry for the config json
• Same features as for previous revisions!
• Many issues TBA Read Description carefully
• Adds skipping of Pregen Worlds that are not needed unless you backup manually!

Lets dive into the changes:
THE ONLY difference in this one is that, NOW, their Linux support!
Meaning Linux users can now backup their save files! To AN Extent.

HOWEVER in the config json
NOW with a GeneratedWorlds config entry,
in its early stages, This will work fine for windows and its default path usually located at.
“C:\Users\YOUR USER NAME OF YOUR COMPUTER\AppData\Roaming\7DaystoDie\GeneratedWorlds” BUT IN THIS CASE the file setting is set to default,

YOU MAY use that as an absolute path or with double slashes for that to work yay windows users profit!

AS FOR LINUX USERS WE HAVE SOME TROUBLE only some!
it MAY NOT always work as everyone has their own favorite flavor of distribution of linux.
IN MY testing I’ve used Bazzite on my LENOVO S7 15ACH6 Gaming Laptop with an rtx 3060 6gb and ryzen 7 5800h cpu, bonkers of equipment.
THE ONLY flaw that ive had encountered as far as this goes. Are TWO issues, HOWEVER if set to default. it will use an outdated folder location that im troubleshooting as we speak. Hence.

ISSUES #1
IT MAY not always backup the, profiles sd_cf file
thats usually located in the
“/.local/share/7DaysToDie/Saves/” folder IT MAY differ on your version of Linux where its actually located.
thats where the sdcs_profiles.sdf and profiles sd cs file and serveradmin.xml are located if needed for server rights and half of your profile details for your CLIENT.

ISSUES #2
and of course the Generated Worlds for your world save in itself. HOWEVER everything else seems to be functional again windows profit BUT FOR LINUX,
that generated world folder isn’t called generated worlds its just this folder location called Worlds within the game folder, which also may differ on your distribution or installation but this folder here .
“/.local/share/Steam/steamapps/common/7 Days to Die/Data/Worlds”
is where it would be stored and SHOULD be backed up, so simply copy that folder and or that specific file to the archive, if need be, making this SEMI automatic until i can provide a FIX.

in this case… one more thing

ISSUES #2A not really a bug but an enhancement and not BUG 3 lol
AS FOR WINDOWS, due to this NEW implementation of the GeneratedWorld Entry for the config json, it brings another issue, IF you backup manually or automatic for your world, it will backup the COMPLETE Generated Worlds Folder instead of just the one THATS actually needed for the map your playing on, GO FIGURE.

either way its still good way to have those generated worlds backed up especially for your other worlds in the archive, if the off chance you may need it even though its for a different world save, its a win in my book BUT that can increase the file size to at least 1gb or higher. depending on your worlds, Please make sure you have space and clean backups regularly and make sure to set your configuration settings appropriately.

DID i mention again that theirs operating system detection woo! As it semis works if left to default in the config json, and automatically adjusts as needed which is dope!
but if you prefer your custom windows backup locations you may do so as you please

NEW CONFIG JSON ENTRIES
DEFAULT
{
“BackupInterval”: “15m”,
“MaxBackupCount”: 8,
“EnableTooltipNotifications”: true,
“EnableDebugLogging”: true,
“SaveSourcePath”: “default”,
“ConfigPath”: “default”,
“GeneratedWorldsPath”: “default”,
“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
}

BUT RECOMMENDED TO SET A CUSTOM LOCATION EVEN IF ITS A DEFAULT LOCATION FOR BEST RESULTS
WINDOWS, leave as is or provide your absolute or double slash paths for, SaveSourcePath, GeneratedWorldsPath, and Backup Location ONLY.

AS FOR LINUX , IN MY CASE it was set to this from default and manually changed to these locations, it doesn’t auto detect them for you.
So change the following below to what your location could be. the saves, Worlds and Backups folders as needed. Yes it can be custom too but im not sure if it will work with double forward slashs but as far as i know with single slashes it does work.

NEW CONFIG JSON CUSTOM ENTRIES
CUSTOM
{
“SaveSourcePath”: “/var/home/bazzite/.var/app/com.valvesoftware.Steam/.local/share/7DaysToDie/Saves/”,
“GeneratedWorldsPath”: “/var/home/bazzite/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/7 Days To Die/Data/Worlds/”,
“BackupLocation”: “/var/home/bazzite/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/7 Days To Die/Mods/TechFreqsBackupMod/Backups/”,
}

BEFORE that it was,
“GeneratedWorlds directory not found: /home/bazzite/.local/Share/Steam/steamapps/common/7 Days to Die/Data/Worlds, it will be created if needed during backup.”

so you may see tht in logs, but do not be alarmed , as its semi manual automatic is still good for the majority and a fix is on the way for windows BUT mainly for linuxs so Stay Tuned! AGAIN this isn’t not server sided JUST FOR CLIENT. I hope to provide a windows server backup version in the future in the backup server mod , separate from this one.

Also again that log will says it will be created but It wont be created its a false positive, nothing will actually happen for Linux. as strange as it is. and it doesn’t load the default or custom location for generated worlds which i plan to fix.
I haven’t tested just creating the folder with the similar name and copying the world files into that locations thats its trying to attempt to backup since its clearly not getting the actual worlds folder location BUT you can be my best and try but thats really not necessary for you to do.

Anything helps feel free to bring alog the bug reports! Thanks again for reading!

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.

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 Initial Backup Prompt:
When entering a new world, the mod prompts you to make an initial backup.
Respond with /bmyes or /bmno (or bm yes/bm no in console).
If you say yes, a manual backup is scheduled with all warning/imminent tooltips and completion message.
If you say no, the prompt is skipped for this world

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 — 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 — 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