- License
- License: CC BY-NC-SA 4.0
- Compatible Game Versions
- 2.0
The TechFreqs Backup Server Mod,
A Server 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 console log messages for backed up creations & autosaving notifications for server world saves, and important files..
It is designed to help you recover from world corruption, mod testing mishaps, or accidental loss.
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...
Compatibility:
- Latest version of 7D2D V2.4 (Linux only version V1.0 is V2.1 of 7D2D and up!)
- NON EAC - Anti-Cheat Must Be Off
- Windows (Used Windows 11, Steam 7 Days to Die Dedicated Server), Linux (LGSM), vinaar)
- Harmony mod (required for server-side DLL mods—place in your Mods folder) SHould be already downloaded by default from Steam if not scan and check ur mods folder for the 0_TFPHarmony folder
Latest Changelog:
V1.1
- Supporting latest verions of 7D2D V2.4
- Added Windows Support! via Steam 7 Days to Die Dedicated Server
- Added detailed progress messages (e.g., "Copying files to temp directory...", "Continuing to next process...", "Please wait a few minutes for ZIP creation...").
- Added elapsed time to completion message (e.g., "completed in X minutes").
- Improved skipped files handling: Announces "Skipped files found! See details below:" with list, and suggests enabling long path support on Windows if relevant.
- Minor fixes for backup stability and logging.
- Updated ReadMe not just for the mod but the backup process when zip creation is complete for linux and windows server setup with clear instructions.
NOW LETS DIG INTO THE MOD DETAILS!
Windows Support in TechFreqs Backup Server Mod:
This mod now fully supports Windows dedicated servers, making it easy to back up your 7 Days to Die data without manual hassle. It auto-detects default paths like %AppData%\Roaming\7DaysToDie for local files (Saves, GeneratedWorlds, serveradmin.xml) and your dedicated server root (e.g., C:\SteamLibrary\steamapps\common\7 Days to Die Dedicated Server) for Mods and serverconfig.xml. Use custom absolute paths in config.json for flexibility (e.g., "C:\CustomBackups" for BackupLocation).
Key Windows Features:
Platform-aware defaults: Automatically sets SavesPath to %AppData%\Roaming\7DaysToDie\Saves if not specified.
Long path handling: Skips files exceeding 260 characters and suggests enabling Win32 long paths in registry for full support.
Backup focus: Copies entire Saves/GeneratedWorlds (or only current save if configured), Mods (excluding itself), and key XML files to ZIP.
Restore: Unzip and copy manually '7DaysToDie' to %AppData%\Roaming\7DaysToDie and 'serverfiles' to your dedicated server root as necessary.
Key Purpose and Benefits:
Protects Your Progress: Automatically backs up saves, worlds, mods, and configs at set intervals (e.g., every 30 minutes) or manually on demand.
Cross-Platform: Works on Windows (e.g., dedicated server installs) and Linux (e.g., LGSM setups), with auto-detection of default paths.
User-Friendly: In-game/chat announcements for backups (countdown, start, completion), detailed logs, skipped file summaries, and elapsed time (e.g., "completed in 9.5 minutes").
Customizable: Edit config.json for paths (e.g., Saves, Mods, GeneratedWorlds), intervals, max backups, and options like backing up only the current save.
Safe and Efficient: Checks disk space before starting, keeps only the latest N backups, skips its own folder to avoid loops, and handles errors gracefully (e.g., suggests fixing long paths on Windows).
Admin Control: Commands restricted to admins (permission level 0 in serveradmin.xml). Supports console, web dashboard, and in-game chat.
Restore-Friendly: Each ZIP includes a readme.txt with step-by-step restore instructions for Windows/Linux, using generic examples.
How It Works and Whats Backed Up (Configurable via config.json):
Auto-Backup: Runs on a timer (configurable, e.g., "30m" for 30 minutes). Announces in chat/console before starting (1 min, 10s, 5s warnings).
Manual Backup: Trigger with "bms backup" (console) or "/manualbackup" (chat) — includes countdown.
What Gets Backed Up (Configurable):
Local data: Saves (full folder or current save only if "BackupOnlyCurrentSave": is added to the config json and set to true), GeneratedWorlds, serveradmin.xml. sdcs_profiles.sdf, profiles.sdf
Server data: Mods ((excluding the backup mod itself), serverconfig.xml, Data/Worlds (current world only or full folder), Data/Config, platform.cfg, sdtdserver.xml, lgsm/config-lgsm, logs.
Linux-specific: lgsm/config-lgsm and log folders (skipped on Windows if empty).
Other: readme.txt with manual restore instructions.
Error Handling: Skips locked/missing/long-path files, logs details (e.g., "Skipped files found! See details below:"), and suggests fixes like enabling Windows long path support.
Output: ZIP files stored in BackupLocation (e.g., per world/save), with world_settings.json tracking per-world status.
Backups are ZIP files stored in said BackupLocation, organized by world/save (e.g., Backups/[World]/[Save]/Backup_[timestamp].zip).
Note: Skipped items (e.g., locked files or long paths) are logged with details and suggestions (like enabling Windows long path support).
Check out my client-side backup mod for single-player saves:
Back to BackupServerMod Details:
BUGS:
WINDOWS BUGS:
If backups skip files due to paths exceeding 260 characters (common on Windows), enable long path support
(search 'Enable Win32 long paths' in registry or Group Policy) and restart your system to avoid this.
LINUX ONLY BUGS:
May not copy serveradmin.xml if path is incorrect—set "ServerAdminXmlPath" to "/home/sdtdserver/.local/share/7DaysToDie/Saves/serveradmin.xml"
(adjust for your container/volume setup). Based on LGSM—Google for Vinaar if needed.
General: If backups take long (e.g., large Saves/Mods), it's normal—progress is announced. Test with small intervals or "BackupOnlyCurrentSave": true to speed up.
Report bugs on Discord with logs for quick fixes! and or on nexus mods!
EXTRA Notes:
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 Features:
- Full cross-platform (Windows and Linux). Uses RuntimeInformation for OS detection, auto-sets defaults (e.g., %AppData%\Roaming\7DaysToDie on Windows, ~/.local/share/7DaysToDie on Linux). Skips Linux-specific paths (e.g., LgsmPath) on Windows if empty. Supports absolute/custom paths for both OSes.
- Expanded config.json with more fields (e.g., GeneratedWorldsPath, ModsPath, ServerConfigXmlPath, BackupOnlyCurrentSave). Auto-detects defaults if not set (e.g., ServerfilesPath to server root). Empty strings skip backups for that item. Added ResolvePath for environment variables and relative/absolute handling.
- Selective backups based on config (skips empty paths). Options like "BackupOnlyCurrentSave" to back up only active save (not all old ones). Backs up specific items (Saves, GeneratedWorlds, Mods excluding self, XML files). Handles errors (locks, long paths, missing files) by skipping and continuing partial backups.
BUT currently set to backup the complete Save folder so that entry or option is not included in the config json. You may add that yourself to test as an added option but not necessary.
- Comprehensive try-catch in copy/ZIP functions. Skips locked/missing/long-path items, logs them, and continues. Pre-checks path length, suggests Windows long path fix if relevant. ZIP always attempted (even with skips), temp dir left on failure for recovery.
- Detailed progress (e.g., "Copying to temp directory...", "Continuing to next process...", "Zipping — please wait..."). Skipped files summary with list and suggestions. Elapsed time in completion message (e.g., "completed in 9.5 minutes"). More informative announcements in chat/console.
- Same commands, plus world_settings.json for per-world auto-backup tracking. Added "BackupOnlyCurrentSave" config for focused backups. Improved reload to apply changes dynamically.
- Expanded readme with OS-specific restore instructions, generic examples, long path tips, and full feature list WHEN the Backup Zip has completed.
- Better temp dir management (shorter names to avoid path limits, no delete on failure). Timer for elapsed time. Cross-platform checks (e.g., skip LGSM on Windows).
- Automatic and Manual Backups
Schedule automatic backups at any interval (e.g. every 2 minutes, 15 minutes, etc).
Trigger manual backups with a countdown and chat/server notifications.
- Smart Folder Selection
Backs up the entire 7DaysToDie folder (including Twitch, RfsCache, titlestorage, etc using the same Linux configuration from previous build).
In the Saves folder, only backs up the current world/save (not all worlds/saves, Linux only) Windows backs up complete saves folder.
Backs up only the current world in Data/Worlds and Data/Config (not all worlds ,Linux only).
Backs up all Mods except itself on the dedicated server folder (Linux and Windows).
Backs up key config files (Linux: platform.cfg, sdtdserver.xml, serverconfig.xml)(Windows: profiles sdf, serverconfig.xml, serveradmin.xml).
Backs up lgsm/config-lgsm and log folders (Linux Only) Includes serveradmin.xml and sdcs_profiles.sdf in the backup.
Admin-Only Control
Only users with permission_level="0" in serveradmin.xml can run backup commands (in-game, web dashboard, or console).
World-Specific Settings
Maintains a world_settings.json for each world/save, tracking auto-backup status and last backup time.
Respects per-world auto/manual backup settings.
Real-Time Announcements
Announces upcoming backups in chat and console (1 minute, 10 seconds, 5 seconds, and start).
Announces backup completion and next scheduled backup time.
Configurable and Dynamic
All paths and settings are configurable in config.json.
Supports dynamic config reload via command (bms reload or /reloadbmsconfig).
Safe and Efficient
Only keeps the latest N backups (configurable).
Checks for minimum free disk space before backup.
Skips backing up its own mod folder to avoid recursive backups.
No Client Mod Needed
This is a server-only mod. No client installation required.
AS FOR Console Commands (for admins)
New Commands:
Console/Web Dashboard Commands
Type these in the F1 console or web dashboard:
bms backup
Start a manual backup (with countdown and announcements).
bms enableauto
Enable auto-backup (uses the interval from config or setinterval).
bms disableauto
Disable auto-backup.
bms config
Show the current config as JSON.
bms reloadconfig
Reload config and world settings.
bms reload
Alias for reloadconfig.
bms setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. bms setinterval 2m for 2 minutes, bms setinterval 600s for 10 minutes).
bms status
Show time until next auto-backup.
AS FOR In-Game Chat Commands (for admins)
Type these in the in-game chat (must be a server admin):
/manualbackup
Start a manual backup (with countdown and announcements).
/enableautobackup
Enable auto-backup.
/disableautobackup
Disable auto-backup.
/backupstatus
Show time until next auto-backup.
/reloadbmsconfig
Reload config and world settings.
/setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. /setinterval 2m).
Config Settings Explained:
BackupInterval: How often to auto-backup (e.g. "2m" for every 2 minutes, "30m" for 30 minutes).
MaxBackupCount: How many backups to keep before deleting the oldest.
EnableAutoBackup: true for automatic backups, false for manual only.
SilentLogging: If true, only logs to console, not chat.
DeleteOldBackupsImmediately: If true, deletes oldest backups when over the limit.
MinFreeSpaceMB: Minimum free space (in MB) required to run a backup.
BackupLocation: Where to store Your backup ZIPs (relative or absolute path, either defaulted to a custom backup location or in the mod folder).
SavesPath: Path to your 7DTD Saves folder.
LgsmPath: Path to your LGSM config folder. (LINUX ONLY Leave empty if using windows)
LogPath: Path to your log folder. (LINUX ONLY Leave empty if using windows)
ServerfilesPath: Path to your serverfiles folder. (LINUX ONLY Leave empty if using windows)
SuccessSound: Sound to play on backup success (not used in server mod, but kept for compatibility).
ServerAdminXmlPath: Path to your serveradmin.xml file.
GeneratedWorldsPath: Path to your Saves, world files that are needed to load the specific world
ModsPath: Path to your Mods, for the dedicated server that will be backed up
ServerConfigXmlPath: Path to your serverconfig.xml file thats needed to boot the server with your custom settings.
Although their is the new modspath and generated worlds path and serverconfig path, i am unable to confirm if thats needed for Linux?
HOWEVER, If using the windows configuration please leave the lgsmpath and log path and serverfile path empty as such.
BUT if using it for Linux
To Skip Any of the Extra paths like the GeneratedWOrlds Patha nd Mods Path and servercopnfig xmlpath,
: Set to "" (empty string) — the mod ignores it and backs up other stuff.
Defaults: If you remove the line entirely (or set to null), like ServerConfigXmlPath: null, or if that lines removed.
the mod tries to auto-guess based on ServerfilesPath (if set) for a default location but you can set a custom location to that directory for linux.
TechFreqs Default Settings: SSD, for main 7 days to die game files, BUT Dedicated Server is on HDD and Backed up to HDD.
{
"BackupInterval": "30m",
"MaxBackupCount": 8,
"EnableAutoBackup": true,
"SilentLogging": false,
"DeleteOldBackupsImmediately": true,
"MinFreeSpaceMB": 2048,
"BackupLocation": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/Mods/TechFreqsBackupServerMod/Backups",
"SavesPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/Saves",
"LgsmPath": "",
"LogPath": "",
"ServerfilesPath": "",
"SuccessSound": "ui_success",
"ServerAdminXmlPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/Saves/serveradmin.xml",
"GeneratedWorldsPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/GeneratedWorlds",
"ModsPath": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/Mods",
"ServerConfigXmlPath": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/serverconfig.xml"
}
And thats the end of the readme so far! Enjoy your backups! Happy gaming! Report any bugs as necessary!!
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 SERVER 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 A SERVER SIDE ONLY
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.
Latest BUT PREVIOUS Changelogs:
V1.0 (LINUX ONLY)
- 7 Days to Die 2.1 support and up!
BUGS:
If backups skip files due to paths exceeding 260 characters (common on Windows), enable long path support (search 'Enable Win32 long paths' in registry or Group Policy) and restart your system to avoid this.
MOD doesn't copy this ONE file , serveradmin.xml (from 7DaysToDie root)
"ServerAdminXmlPath": "/home/sdtdserver/.local/share/7DaysToDie/serveradmin.xml"
usually located in the /7DaysToDie/Saves root folder for server made mods, thats used to identify admin rights for the server itself... under the
admin tools category...
IF IT DOES LET YOU please make sure the path is set like this /home/sdtdserver/.local/share/7DaysToDie/Saves/serveradmin.xml
for the linux server as its based on the container path not the actual volume path.
AGAIN THIS IS BASED ON THE LINUX GSM 7DtD server from vinaar googles your friend!
FOR EXAMPLE FOR WEB DASHBOARD SETUP IF NEEDED in the serveradmin xml
<adminTools>
<!-- Name in any entries is optional for display purposes only -->
<users>
<!-- <user platform="Steam" userid="STEAMID" name="STEAMNAME" permission_level="0" /> -->
<!-- <group steamID="STEAMID" name="Steam Universe" permission_level_default="1000" permission_level_mod="0" /> -->
<user platform="Steam" userid="STEAMIDAGAIN" name="STEAMNAME" permission_level="0" />
<group steamID="0" name="Staff" permission_level_default="0" permission_level_mod="0" />
</users>
as well as the web dashboard
<webmodules />
<webusers>
<user name="TechFreq" pass="PASSWORD" platform="Steam" userid="STEAMID" crossplatform="EOS" crossuserid="CROSSUSERID" />
</webusers>
the STEAM ID and CROSS USER ID are identifiers for your account if you dont know it join a random server, checkout ur ingame F1 logs, grab that from the text file and then copy paste that into those entries and then bam! your set for getting your dashboard ready and admin rights for your own server.
but again im using Linux as my server, ive included a windows example config json that may work in your favour it does support abosolute paths, custom folder directories aswell as double slashes for that sort of thing BUT UNTESTED as i dont have a windows server.
Mod Structure:
Mod DLL important mod for server backups
ReadMe Txt important documentation
License Txt important documentation
Backups folder will be created for backing up server world saves
world_settings json used to track auto-backup status and last backup time for each individual serverworld/save per server mod, one worldsettings json per server setup.
Config json if it isn't already created, used to run the mods programming
New Commands:
-------------------------
Console/Web Dashboard Commands
Type these in the F1 console or web dashboard:
bms backup
Start a manual backup (with countdown and announcements).
bms enableauto
Enable auto-backup (uses the interval from config or setinterval).
bms disableauto
Disable auto-backup.
bms config
Show the current config as JSON.
bms reloadconfig
Reload config and world settings.
bms reload
Alias for reloadconfig.
bms setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. bms setinterval 2m for 2 minutes, bms setinterval 600s for 10 minutes).
bms status
Show time until next auto-backup.
In-Game Chat Commands (for admins)
Type these in the in-game chat (must be a server admin):
/manualbackup
Start a manual backup (with countdown and announcements).
/enableautobackup
Enable auto-backup.
/disableautobackup
Disable auto-backup.
/backupstatus
Show time until next auto-backup.
/reloadbmsconfig
Reload config and world settings.
/setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. /setinterval 2m).
Command Explanations Summary
backup/manualbackup: Triggers a backup with a countdown and chat/server notifications.
enableauto/disableauto: Turns auto-backup on or off for the current world/save.
config: Shows the current config.json as JSON in the console.
reload/reloadconfig/reloadbmsconfig: Reloads config.json and world_settings.json, and applies any changes.
setinterval: Changes the backup interval (e.g. 15m for 15 minutes, 600s for 10 minutes). Takes effect immediately.
status/backupstatus: Shows how long until the next auto-backup (in minutes).
What’s Backed Up
The current world/save only (not all saves/worlds)
The entire 7DaysToDie folder (except all saves, only current world/save)
serverfiles/Data/Worlds/[CurrentWorld]
serverfiles/Data/Config
serverfiles/Mods (except the backup mod itself)
serverfiles/platform.cfg, sdtdserver.xml, serverconfig.xml
lgsm/config-lgsm
log
sdcs_profiles.sdf (from 7DaysToDie/Saves)
A readme.txt with restore instructions
How To Restore:
Thanks for using TechFreqsBackupServerMod!
To restore FROM THE CREATED ZIP ARCHIVE:
1. Stop your server.
2. Unzip this archive.
3. Copy the contents to your server's root folders, overwriting as needed:
- '7DaysToDie' to your 7DaysToDie folder (includes Saves, Twitch, RfsCache, titlestorage, etc)
- 'lgsm_config' to lgsm/config-lgsm
- 'logs' to log/
- 'serverfiles' contents to serverfiles/
4. Start your server.
If you have issues, visit: https://beacons.ai/techfreq or Discord: https://discord.gg/SQCnGjNUhw
DEFAULT CONFIG:
{
"BackupInterval": "2m",
"MaxBackupCount": 8,
"EnableAutoBackup": true,
"SilentLogging": false,
"DeleteOldBackupsImmediately": true,
"MinFreeSpaceMB": 2048,
"BackupLocation": "Backups",
"SavesPath": "/home/sdtdserver/.local/share/7DaysToDie/Saves",
"LgsmPath": "/home/sdtdserver/lgsm/config-lgsm",
"LogPath": "/home/sdtdserver/log",
"ServerfilesPath": "/home/sdtdserver/serverfiles",
"SuccessSound": "ui_success",
"ServerAdminXmlPath": "/home/sdtdserver/.local/share/7DaysToDie/serveradmin.xml"
}
Config Settings Explained
BackupInterval: How often to auto-backup (e.g. "2m" for every 2 minutes, "30m" for 30 minutes).
MaxBackupCount: How many backups to keep before deleting the oldest.
EnableAutoBackup: true for automatic backups, false for manual only.
SilentLogging: If true, only logs to console, not chat.
DeleteOldBackupsImmediately: If true, deletes oldest backups when over the limit.
MinFreeSpaceMB: Minimum free space (in MB) required to run a backup.
BackupLocation: Where to store backup ZIPs (relative or absolute path).
SavesPath: Path to your 7DTD Saves folder.
LgsmPath: Path to your LGSM config folder.
LogPath: Path to your log folder.
ServerfilesPath: Path to your serverfiles folder.
SuccessSound: Sound to play on backup success (not used in server mod, but kept for compatibility).
ServerAdminXmlPath: Path to your serveradmin.xml file.
**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 Features:
Automatic and Manual Backups
Schedule automatic backups at any interval (e.g. every 2 minutes, 15 minutes, etc).
Trigger manual backups with a countdown and chat/server notifications.
Smart Folder Selection
Backs up the entire 7DaysToDie folder (including Twitch, RfsCache, titlestorage, etc).
In the Saves folder, only backs up the current world/save (not all worlds/saves).
Backs up only the current world in Data/Worlds and Data/Config (not all worlds).
Backs up all Mods except itself.
Backs up key config files (platform.cfg, sdtdserver.xml, serverconfig.xml).
Backs up lgsm/config-lgsm and log folders.
Includes serveradmin.xml and sdcs_profiles.sdf in the backup.
Admin-Only Control
Only users with permission_level="0" in serveradmin.xml can run backup commands (in-game, web dashboard, or console).
World-Specific Settings
Maintains a world_settings.json for each world/save, tracking auto-backup status and last backup time.
Respects per-world auto/manual backup settings.
Real-Time Announcements
Announces upcoming backups in chat and console (1 minute, 10 seconds, 5 seconds, and start).
Announces backup completion and next scheduled backup time.
Configurable and Dynamic
All paths and settings are configurable in config.json.
Supports dynamic config reload via command (bms reload or /reloadbmsconfig).
Safe and Efficient
Only keeps the latest N backups (configurable).
Checks for minimum free disk space before backup.
Skips backing up its own mod folder to avoid recursive backups.
No Client Mod Needed
This is a server-only mod. No client installation required.
Thank You Debug Log
Logs a thank you message and support link on server start.
A Server 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 console log messages for backed up creations & autosaving notifications for server world saves, and important files..
It is designed to help you recover from world corruption, mod testing mishaps, or accidental loss.
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...
Compatibility:
- Latest version of 7D2D V2.4 (Linux only version V1.0 is V2.1 of 7D2D and up!)
- NON EAC - Anti-Cheat Must Be Off
- Windows (Used Windows 11, Steam 7 Days to Die Dedicated Server), Linux (LGSM), vinaar)
- Harmony mod (required for server-side DLL mods—place in your Mods folder) SHould be already downloaded by default from Steam if not scan and check ur mods folder for the 0_TFPHarmony folder
Latest Changelog:
V1.1
- Supporting latest verions of 7D2D V2.4
- Added Windows Support! via Steam 7 Days to Die Dedicated Server
- Added detailed progress messages (e.g., "Copying files to temp directory...", "Continuing to next process...", "Please wait a few minutes for ZIP creation...").
- Added elapsed time to completion message (e.g., "completed in X minutes").
- Improved skipped files handling: Announces "Skipped files found! See details below:" with list, and suggests enabling long path support on Windows if relevant.
- Minor fixes for backup stability and logging.
- Updated ReadMe not just for the mod but the backup process when zip creation is complete for linux and windows server setup with clear instructions.
NOW LETS DIG INTO THE MOD DETAILS!
Windows Support in TechFreqs Backup Server Mod:
This mod now fully supports Windows dedicated servers, making it easy to back up your 7 Days to Die data without manual hassle. It auto-detects default paths like %AppData%\Roaming\7DaysToDie for local files (Saves, GeneratedWorlds, serveradmin.xml) and your dedicated server root (e.g., C:\SteamLibrary\steamapps\common\7 Days to Die Dedicated Server) for Mods and serverconfig.xml. Use custom absolute paths in config.json for flexibility (e.g., "C:\CustomBackups" for BackupLocation).
Key Windows Features:
Platform-aware defaults: Automatically sets SavesPath to %AppData%\Roaming\7DaysToDie\Saves if not specified.
Long path handling: Skips files exceeding 260 characters and suggests enabling Win32 long paths in registry for full support.
Backup focus: Copies entire Saves/GeneratedWorlds (or only current save if configured), Mods (excluding itself), and key XML files to ZIP.
Restore: Unzip and copy manually '7DaysToDie' to %AppData%\Roaming\7DaysToDie and 'serverfiles' to your dedicated server root as necessary.
Key Purpose and Benefits:
Protects Your Progress: Automatically backs up saves, worlds, mods, and configs at set intervals (e.g., every 30 minutes) or manually on demand.
Cross-Platform: Works on Windows (e.g., dedicated server installs) and Linux (e.g., LGSM setups), with auto-detection of default paths.
User-Friendly: In-game/chat announcements for backups (countdown, start, completion), detailed logs, skipped file summaries, and elapsed time (e.g., "completed in 9.5 minutes").
Customizable: Edit config.json for paths (e.g., Saves, Mods, GeneratedWorlds), intervals, max backups, and options like backing up only the current save.
Safe and Efficient: Checks disk space before starting, keeps only the latest N backups, skips its own folder to avoid loops, and handles errors gracefully (e.g., suggests fixing long paths on Windows).
Admin Control: Commands restricted to admins (permission level 0 in serveradmin.xml). Supports console, web dashboard, and in-game chat.
Restore-Friendly: Each ZIP includes a readme.txt with step-by-step restore instructions for Windows/Linux, using generic examples.
How It Works and Whats Backed Up (Configurable via config.json):
Auto-Backup: Runs on a timer (configurable, e.g., "30m" for 30 minutes). Announces in chat/console before starting (1 min, 10s, 5s warnings).
Manual Backup: Trigger with "bms backup" (console) or "/manualbackup" (chat) — includes countdown.
What Gets Backed Up (Configurable):
Local data: Saves (full folder or current save only if "BackupOnlyCurrentSave": is added to the config json and set to true), GeneratedWorlds, serveradmin.xml. sdcs_profiles.sdf, profiles.sdf
Server data: Mods ((excluding the backup mod itself), serverconfig.xml, Data/Worlds (current world only or full folder), Data/Config, platform.cfg, sdtdserver.xml, lgsm/config-lgsm, logs.
Linux-specific: lgsm/config-lgsm and log folders (skipped on Windows if empty).
Other: readme.txt with manual restore instructions.
Error Handling: Skips locked/missing/long-path files, logs details (e.g., "Skipped files found! See details below:"), and suggests fixes like enabling Windows long path support.
Output: ZIP files stored in BackupLocation (e.g., per world/save), with world_settings.json tracking per-world status.
Backups are ZIP files stored in said BackupLocation, organized by world/save (e.g., Backups/[World]/[Save]/Backup_[timestamp].zip).
Note: Skipped items (e.g., locked files or long paths) are logged with details and suggestions (like enabling Windows long path support).
Check out my client-side backup mod for single-player saves:
Back to BackupServerMod Details:
BUGS:
WINDOWS BUGS:
If backups skip files due to paths exceeding 260 characters (common on Windows), enable long path support
(search 'Enable Win32 long paths' in registry or Group Policy) and restart your system to avoid this.
LINUX ONLY BUGS:
May not copy serveradmin.xml if path is incorrect—set "ServerAdminXmlPath" to "/home/sdtdserver/.local/share/7DaysToDie/Saves/serveradmin.xml"
(adjust for your container/volume setup). Based on LGSM—Google for Vinaar if needed.
General: If backups take long (e.g., large Saves/Mods), it's normal—progress is announced. Test with small intervals or "BackupOnlyCurrentSave": true to speed up.
Report bugs on Discord with logs for quick fixes! and or on nexus mods!
EXTRA Notes:
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 Features:
- Full cross-platform (Windows and Linux). Uses RuntimeInformation for OS detection, auto-sets defaults (e.g., %AppData%\Roaming\7DaysToDie on Windows, ~/.local/share/7DaysToDie on Linux). Skips Linux-specific paths (e.g., LgsmPath) on Windows if empty. Supports absolute/custom paths for both OSes.
- Expanded config.json with more fields (e.g., GeneratedWorldsPath, ModsPath, ServerConfigXmlPath, BackupOnlyCurrentSave). Auto-detects defaults if not set (e.g., ServerfilesPath to server root). Empty strings skip backups for that item. Added ResolvePath for environment variables and relative/absolute handling.
- Selective backups based on config (skips empty paths). Options like "BackupOnlyCurrentSave" to back up only active save (not all old ones). Backs up specific items (Saves, GeneratedWorlds, Mods excluding self, XML files). Handles errors (locks, long paths, missing files) by skipping and continuing partial backups.
BUT currently set to backup the complete Save folder so that entry or option is not included in the config json. You may add that yourself to test as an added option but not necessary.
- Comprehensive try-catch in copy/ZIP functions. Skips locked/missing/long-path items, logs them, and continues. Pre-checks path length, suggests Windows long path fix if relevant. ZIP always attempted (even with skips), temp dir left on failure for recovery.
- Detailed progress (e.g., "Copying to temp directory...", "Continuing to next process...", "Zipping — please wait..."). Skipped files summary with list and suggestions. Elapsed time in completion message (e.g., "completed in 9.5 minutes"). More informative announcements in chat/console.
- Same commands, plus world_settings.json for per-world auto-backup tracking. Added "BackupOnlyCurrentSave" config for focused backups. Improved reload to apply changes dynamically.
- Expanded readme with OS-specific restore instructions, generic examples, long path tips, and full feature list WHEN the Backup Zip has completed.
- Better temp dir management (shorter names to avoid path limits, no delete on failure). Timer for elapsed time. Cross-platform checks (e.g., skip LGSM on Windows).
- Automatic and Manual Backups
Schedule automatic backups at any interval (e.g. every 2 minutes, 15 minutes, etc).
Trigger manual backups with a countdown and chat/server notifications.
- Smart Folder Selection
Backs up the entire 7DaysToDie folder (including Twitch, RfsCache, titlestorage, etc using the same Linux configuration from previous build).
In the Saves folder, only backs up the current world/save (not all worlds/saves, Linux only) Windows backs up complete saves folder.
Backs up only the current world in Data/Worlds and Data/Config (not all worlds ,Linux only).
Backs up all Mods except itself on the dedicated server folder (Linux and Windows).
Backs up key config files (Linux: platform.cfg, sdtdserver.xml, serverconfig.xml)(Windows: profiles sdf, serverconfig.xml, serveradmin.xml).
Backs up lgsm/config-lgsm and log folders (Linux Only) Includes serveradmin.xml and sdcs_profiles.sdf in the backup.
Admin-Only Control
Only users with permission_level="0" in serveradmin.xml can run backup commands (in-game, web dashboard, or console).
World-Specific Settings
Maintains a world_settings.json for each world/save, tracking auto-backup status and last backup time.
Respects per-world auto/manual backup settings.
Real-Time Announcements
Announces upcoming backups in chat and console (1 minute, 10 seconds, 5 seconds, and start).
Announces backup completion and next scheduled backup time.
Configurable and Dynamic
All paths and settings are configurable in config.json.
Supports dynamic config reload via command (bms reload or /reloadbmsconfig).
Safe and Efficient
Only keeps the latest N backups (configurable).
Checks for minimum free disk space before backup.
Skips backing up its own mod folder to avoid recursive backups.
No Client Mod Needed
This is a server-only mod. No client installation required.
AS FOR Console Commands (for admins)
New Commands:
Console/Web Dashboard Commands
Type these in the F1 console or web dashboard:
bms backup
Start a manual backup (with countdown and announcements).
bms enableauto
Enable auto-backup (uses the interval from config or setinterval).
bms disableauto
Disable auto-backup.
bms config
Show the current config as JSON.
bms reloadconfig
Reload config and world settings.
bms reload
Alias for reloadconfig.
bms setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. bms setinterval 2m for 2 minutes, bms setinterval 600s for 10 minutes).
bms status
Show time until next auto-backup.
AS FOR In-Game Chat Commands (for admins)
Type these in the in-game chat (must be a server admin):
/manualbackup
Start a manual backup (with countdown and announcements).
/enableautobackup
Enable auto-backup.
/disableautobackup
Disable auto-backup.
/backupstatus
Show time until next auto-backup.
/reloadbmsconfig
Reload config and world settings.
/setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. /setinterval 2m).
Config Settings Explained:
BackupInterval: How often to auto-backup (e.g. "2m" for every 2 minutes, "30m" for 30 minutes).
MaxBackupCount: How many backups to keep before deleting the oldest.
EnableAutoBackup: true for automatic backups, false for manual only.
SilentLogging: If true, only logs to console, not chat.
DeleteOldBackupsImmediately: If true, deletes oldest backups when over the limit.
MinFreeSpaceMB: Minimum free space (in MB) required to run a backup.
BackupLocation: Where to store Your backup ZIPs (relative or absolute path, either defaulted to a custom backup location or in the mod folder).
SavesPath: Path to your 7DTD Saves folder.
LgsmPath: Path to your LGSM config folder. (LINUX ONLY Leave empty if using windows)
LogPath: Path to your log folder. (LINUX ONLY Leave empty if using windows)
ServerfilesPath: Path to your serverfiles folder. (LINUX ONLY Leave empty if using windows)
SuccessSound: Sound to play on backup success (not used in server mod, but kept for compatibility).
ServerAdminXmlPath: Path to your serveradmin.xml file.
GeneratedWorldsPath: Path to your Saves, world files that are needed to load the specific world
ModsPath: Path to your Mods, for the dedicated server that will be backed up
ServerConfigXmlPath: Path to your serverconfig.xml file thats needed to boot the server with your custom settings.
Although their is the new modspath and generated worlds path and serverconfig path, i am unable to confirm if thats needed for Linux?
HOWEVER, If using the windows configuration please leave the lgsmpath and log path and serverfile path empty as such.
BUT if using it for Linux
To Skip Any of the Extra paths like the GeneratedWOrlds Patha nd Mods Path and servercopnfig xmlpath,
: Set to "" (empty string) — the mod ignores it and backs up other stuff.
Defaults: If you remove the line entirely (or set to null), like ServerConfigXmlPath: null, or if that lines removed.
the mod tries to auto-guess based on ServerfilesPath (if set) for a default location but you can set a custom location to that directory for linux.
TechFreqs Default Settings: SSD, for main 7 days to die game files, BUT Dedicated Server is on HDD and Backed up to HDD.
{
"BackupInterval": "30m",
"MaxBackupCount": 8,
"EnableAutoBackup": true,
"SilentLogging": false,
"DeleteOldBackupsImmediately": true,
"MinFreeSpaceMB": 2048,
"BackupLocation": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/Mods/TechFreqsBackupServerMod/Backups",
"SavesPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/Saves",
"LgsmPath": "",
"LogPath": "",
"ServerfilesPath": "",
"SuccessSound": "ui_success",
"ServerAdminXmlPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/Saves/serveradmin.xml",
"GeneratedWorldsPath": "C:/Users/ROGPC/AppData/Roaming/7DaystoDie/GeneratedWorlds",
"ModsPath": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/Mods",
"ServerConfigXmlPath": "F:/@ON GAME DRIVE/@IN GAME DRIVE/RetailGames/SteamLibrary/steamapps/common/7 Days to Die Dedicated Server/serverconfig.xml"
}
And thats the end of the readme so far! Enjoy your backups! Happy gaming! Report any bugs as necessary!!
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 SERVER 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 A SERVER SIDE ONLY
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.
Latest BUT PREVIOUS Changelogs:
V1.0 (LINUX ONLY)
- 7 Days to Die 2.1 support and up!
BUGS:
If backups skip files due to paths exceeding 260 characters (common on Windows), enable long path support (search 'Enable Win32 long paths' in registry or Group Policy) and restart your system to avoid this.
MOD doesn't copy this ONE file , serveradmin.xml (from 7DaysToDie root)
"ServerAdminXmlPath": "/home/sdtdserver/.local/share/7DaysToDie/serveradmin.xml"
usually located in the /7DaysToDie/Saves root folder for server made mods, thats used to identify admin rights for the server itself... under the
admin tools category...
IF IT DOES LET YOU please make sure the path is set like this /home/sdtdserver/.local/share/7DaysToDie/Saves/serveradmin.xml
for the linux server as its based on the container path not the actual volume path.
AGAIN THIS IS BASED ON THE LINUX GSM 7DtD server from vinaar googles your friend!
FOR EXAMPLE FOR WEB DASHBOARD SETUP IF NEEDED in the serveradmin xml
<adminTools>
<!-- Name in any entries is optional for display purposes only -->
<users>
<!-- <user platform="Steam" userid="STEAMID" name="STEAMNAME" permission_level="0" /> -->
<!-- <group steamID="STEAMID" name="Steam Universe" permission_level_default="1000" permission_level_mod="0" /> -->
<user platform="Steam" userid="STEAMIDAGAIN" name="STEAMNAME" permission_level="0" />
<group steamID="0" name="Staff" permission_level_default="0" permission_level_mod="0" />
</users>
as well as the web dashboard
<webmodules />
<webusers>
<user name="TechFreq" pass="PASSWORD" platform="Steam" userid="STEAMID" crossplatform="EOS" crossuserid="CROSSUSERID" />
</webusers>
the STEAM ID and CROSS USER ID are identifiers for your account if you dont know it join a random server, checkout ur ingame F1 logs, grab that from the text file and then copy paste that into those entries and then bam! your set for getting your dashboard ready and admin rights for your own server.
but again im using Linux as my server, ive included a windows example config json that may work in your favour it does support abosolute paths, custom folder directories aswell as double slashes for that sort of thing BUT UNTESTED as i dont have a windows server.
Mod Structure:
Mod DLL important mod for server backups
ReadMe Txt important documentation
License Txt important documentation
Backups folder will be created for backing up server world saves
world_settings json used to track auto-backup status and last backup time for each individual serverworld/save per server mod, one worldsettings json per server setup.
Config json if it isn't already created, used to run the mods programming
New Commands:
-------------------------
Console/Web Dashboard Commands
Type these in the F1 console or web dashboard:
bms backup
Start a manual backup (with countdown and announcements).
bms enableauto
Enable auto-backup (uses the interval from config or setinterval).
bms disableauto
Disable auto-backup.
bms config
Show the current config as JSON.
bms reloadconfig
Reload config and world settings.
bms reload
Alias for reloadconfig.
bms setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. bms setinterval 2m for 2 minutes, bms setinterval 600s for 10 minutes).
bms status
Show time until next auto-backup.
In-Game Chat Commands (for admins)
Type these in the in-game chat (must be a server admin):
/manualbackup
Start a manual backup (with countdown and announcements).
/enableautobackup
Enable auto-backup.
/disableautobackup
Disable auto-backup.
/backupstatus
Show time until next auto-backup.
/reloadbmsconfig
Reload config and world settings.
/setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. /setinterval 2m).
Command Explanations Summary
backup/manualbackup: Triggers a backup with a countdown and chat/server notifications.
enableauto/disableauto: Turns auto-backup on or off for the current world/save.
config: Shows the current config.json as JSON in the console.
reload/reloadconfig/reloadbmsconfig: Reloads config.json and world_settings.json, and applies any changes.
setinterval: Changes the backup interval (e.g. 15m for 15 minutes, 600s for 10 minutes). Takes effect immediately.
status/backupstatus: Shows how long until the next auto-backup (in minutes).
What’s Backed Up
The current world/save only (not all saves/worlds)
The entire 7DaysToDie folder (except all saves, only current world/save)
serverfiles/Data/Worlds/[CurrentWorld]
serverfiles/Data/Config
serverfiles/Mods (except the backup mod itself)
serverfiles/platform.cfg, sdtdserver.xml, serverconfig.xml
lgsm/config-lgsm
log
sdcs_profiles.sdf (from 7DaysToDie/Saves)
A readme.txt with restore instructions
How To Restore:
Thanks for using TechFreqsBackupServerMod!
To restore FROM THE CREATED ZIP ARCHIVE:
1. Stop your server.
2. Unzip this archive.
3. Copy the contents to your server's root folders, overwriting as needed:
- '7DaysToDie' to your 7DaysToDie folder (includes Saves, Twitch, RfsCache, titlestorage, etc)
- 'lgsm_config' to lgsm/config-lgsm
- 'logs' to log/
- 'serverfiles' contents to serverfiles/
4. Start your server.
If you have issues, visit: https://beacons.ai/techfreq or Discord: https://discord.gg/SQCnGjNUhw
DEFAULT CONFIG:
{
"BackupInterval": "2m",
"MaxBackupCount": 8,
"EnableAutoBackup": true,
"SilentLogging": false,
"DeleteOldBackupsImmediately": true,
"MinFreeSpaceMB": 2048,
"BackupLocation": "Backups",
"SavesPath": "/home/sdtdserver/.local/share/7DaysToDie/Saves",
"LgsmPath": "/home/sdtdserver/lgsm/config-lgsm",
"LogPath": "/home/sdtdserver/log",
"ServerfilesPath": "/home/sdtdserver/serverfiles",
"SuccessSound": "ui_success",
"ServerAdminXmlPath": "/home/sdtdserver/.local/share/7DaysToDie/serveradmin.xml"
}
Config Settings Explained
BackupInterval: How often to auto-backup (e.g. "2m" for every 2 minutes, "30m" for 30 minutes).
MaxBackupCount: How many backups to keep before deleting the oldest.
EnableAutoBackup: true for automatic backups, false for manual only.
SilentLogging: If true, only logs to console, not chat.
DeleteOldBackupsImmediately: If true, deletes oldest backups when over the limit.
MinFreeSpaceMB: Minimum free space (in MB) required to run a backup.
BackupLocation: Where to store backup ZIPs (relative or absolute path).
SavesPath: Path to your 7DTD Saves folder.
LgsmPath: Path to your LGSM config folder.
LogPath: Path to your log folder.
ServerfilesPath: Path to your serverfiles folder.
SuccessSound: Sound to play on backup success (not used in server mod, but kept for compatibility).
ServerAdminXmlPath: Path to your serveradmin.xml file.
**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 Features:
Automatic and Manual Backups
Schedule automatic backups at any interval (e.g. every 2 minutes, 15 minutes, etc).
Trigger manual backups with a countdown and chat/server notifications.
Smart Folder Selection
Backs up the entire 7DaysToDie folder (including Twitch, RfsCache, titlestorage, etc).
In the Saves folder, only backs up the current world/save (not all worlds/saves).
Backs up only the current world in Data/Worlds and Data/Config (not all worlds).
Backs up all Mods except itself.
Backs up key config files (platform.cfg, sdtdserver.xml, serverconfig.xml).
Backs up lgsm/config-lgsm and log folders.
Includes serveradmin.xml and sdcs_profiles.sdf in the backup.
Admin-Only Control
Only users with permission_level="0" in serveradmin.xml can run backup commands (in-game, web dashboard, or console).
World-Specific Settings
Maintains a world_settings.json for each world/save, tracking auto-backup status and last backup time.
Respects per-world auto/manual backup settings.
Real-Time Announcements
Announces upcoming backups in chat and console (1 minute, 10 seconds, 5 seconds, and start).
Announces backup completion and next scheduled backup time.
Configurable and Dynamic
All paths and settings are configurable in config.json.
Supports dynamic config reload via command (bms reload or /reloadbmsconfig).
Safe and Efficient
Only keeps the latest N backups (configurable).
Checks for minimum free disk space before backup.
Skips backing up its own mod folder to avoid recursive backups.
No Client Mod Needed
This is a server-only mod. No client installation required.
Thank You Debug Log
Logs a thank you message and support link on server start.
- Install / Usage Instructions
- AS FOR Console Commands (for admins)
New Commands:
Console/Web Dashboard Commands
Type these in the F1 console or web dashboard:
bms backup
Start a manual backup (with countdown and announcements).
bms enableauto
Enable auto-backup (uses the interval from config or setinterval).
bms disableauto
Disable auto-backup.
bms config
Show the current config as JSON.
bms reloadconfig
Reload config and world settings.
bms reload
Alias for reloadconfig.
bms setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. bms setinterval 2m for 2 minutes, bms setinterval 600s for 10 minutes).
bms status
Show time until next auto-backup.
AS FOR In-Game Chat Commands (for admins)
Type these in the in-game chat (must be a server admin):
/manualbackup
Start a manual backup (with countdown and announcements).
/enableautobackup
Enable auto-backup.
/disableautobackup
Disable auto-backup.
/backupstatus
Show time until next auto-backup.
/reloadbmsconfig
Reload config and world settings.
/setinterval 15m
Set backup interval to 15 minutes (or any value, e.g. /setinterval 2m).