Backup Scripts
by electroluxv2
Servers that save their worlds on a timer can run custom shell scripts at each save with Backup Scripts, a Fabric mod by electroluxv2.
What it does
The mod hooks itself into the built-in save system, so a script runs each time the server saves. By default the script is executed with bin/bash, and its contents can be edited in the file mods/backup-scripts/shell. Because the scripts run on the server, the mod has no effect on a player's client.
Each run passes server details to the script: the player count, whether the server is running, the average tick time as a float, and the total number of level names. The script can also handle several levels at once, using the level name of each one to find its directory. Backup Scripts requires Fabric API, and files are published for Fabric only, across 1.20.1, 1.20.4 and 1.21, under the Creative Commons Attribution 4.0 license, which is not open source. The latest file, 1.3.0, targets 1.21 and dates from 2024-07-22.
Key features
Scripts on save
Scripts execute whenever the server's built-in save system runs, so backups follow the save schedule.
Shell editing
The default script runs under bin/bash and is edited in a plain shell file inside the mod's folder.
Server status values
Player count, average tick time and whether the server is running are available to the script.
Multiple levels
The script can process several level names in one run, mapping each name to its directory.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Scheduled world copies
A server owner can copy the world folder or push it to other storage each time the server saves.
Logging server health
The script can record player count and tick time at every save to track how a server performs over time.
Who it’s for: Server owners who want to run their own shell commands alongside the save system, and who are comfortable editing a bash script.
How it compares
Tempus is server-side only and open source under the Apache License 2.0, with files for 1.21.4. Easy backups is also server-side only and uses the Apache License 2.0, but it is not open source and targets 1.21.10. Backup Scripts reaches 1.21 with a scripting approach, not a fixed backup routine.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Backup Scripts | Fabric | 1.20.1 – 1.21 | Server-side only | 2024-07-22 |
| Tempus | Fabric | 1.21.4 | Server-side only | 2025-02-01 |
| Easy backups | Fabric | 1.21.10 | Server-side only | 2025-12-28 |
Questions
Does Backup Scripts need Fabric API?
Does Backup Scripts have to be installed on player clients?
Which game versions does Backup Scripts support?
In the catalog
Backup Scripts is one of 4,058 Storage mods on ModsFinder, and one of 2,474 Storage mods for Fabric. 15,770 mods support Minecraft 1.21.
More from electroluxv2
Similar mods
What the author says
Each script is executed in server root directory (next to.jar file) with the following arguments: - 1 - player count - 2 - average tick time (float) - 3 - server running ("true" or "false") - 4 - total level names - 5+ - level name #n (server may run multiple levels at once, level name is equal to directory name)…
Official listing
- Modrinth page
- modrinth.com/mod/git-backup-mod
- Owner
- electroluxv2
- Published
- 2023-08-10
- Updated on Modrinth
- 2024-07-22
- Facts verified
- 2026-10-15