\n# What is this?
\nThis mod hooks itself to built in save system and executes scripts:<\/p>\n
**Each script is executed in server root directory (next to .jar file) with the following arguments:**
\n– `1` – player count
\n– `2` – average tick time (float)
\n– `3` – server running (“true” or “false”)
\n– `4` – total level names
\n– `5+` – level name #n (server may run multiple levels at once, level name is equal to directory name)<\/p>\n
Each script is by default executed in `\/bin\/bash`, but you may provide your shell by editing `mods\/backup-scripts\/shell` file.<\/p>\n
## Init script:
\n**This script is executed only if contains changes since last execution**
\nTo manually force execution without changes delete `.last-init-run` file from `mods\/backup-scripts` directory.
\n“`bash
\n# Do not use Shebang here, change default shell by editing `shell` file
\necho “Script PWD: $(pwd)”
\necho “Arguments passed: $#”
\necho “Player count: ${1}”
\necho “AVG Tick time: ${2}”
\necho “Server running: ${3}”
\necho “Total levels: ${4}”
\necho “Level names: ‘${*:5:$4}'”<\/p>\n
echo “Creating git repository”
\ngit init<\/p>\n
levelNames=${*:5:$4}
\nfor levelName in “${levelNames[@]}” # Preventing word splitting, because minecraft level names may contain spaces
\ndo
\n echo “Adding ‘$levelName’ to repository”
\n git add “$levelName”
\ndone<\/p>\n
echo “Creating initial commit”<\/p>\n
git commit -m “Automatic backup – $(date)”
\necho “Initialization done!”
\n“`
\nExample output:
\n“`
\n[15:52:21] [Server thread\/INFO] (Minecraft) Done (15.286s)! For help, type “help”
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Script PWD: \/Users\/mateusz.budzisz\/git\/fabric\/git-backup-fabric-mod\/run
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Arguments passed: 4
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Player count: 0
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): TPS: 0.0
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Total levels: 1
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Level names: ‘world’
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Creating git repository
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Initialized empty Git repository in \/Users\/mateusz.budzisz\/git\/fabric\/git-backup-fabric-mod\/run\/.git\/
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Adding ‘world’ to repository
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Creating initial commit
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): [main (root-commit) a142833] Automatic backup – Sun Aug 13 15:52:21 CEST 2023
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): 11 files changed, 1 insertion(+)
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/entities\/r.-1.-1.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/entities\/r.-1.0.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/entities\/r.0.-1.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/entities\/r.0.0.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/level.dat
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/poi\/r.0.0.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/region\/r.-1.-1.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/region\/r.-1.0.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/region\/r.0.-1.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/region\/r.0.0.mca
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): create mode 100644 world\/session.lock
\n[15:52:21] [Server thread\/INFO] (BackupScripts) (init.sh): Initialization done!
\n“`
\n## OnSave script
\n**This script is executed at every auto save (Minecraft performs auto save every 5 minutes, use `save-on` to enable), you may use `save-all` to force save.**
\nDefault script contents:
\n“`bash
\n# Do not use Shebang here, change default shell by editing `shell` file
\necho “Script PWD: $(pwd)”
\necho “Arguments passed: $#”
\necho “Player count: ${1}”
\necho “AVG Tick time: ${2}”
\necho “Server running: ${3}”
\necho “Total levels: ${4}”
\necho “Level names: ‘${*:5:$4}'”<\/p>\n
if [ “$1” -le 0 ] && [ “$3” = “true” ] ; then
\n echo “Skipping backup as no one is online”
\n exit 1
\nfi<\/p>\n
# AVG tick time is float, hence this wierd comparison
\nif (( $(echo “$2 > 50” |bc -l) )) && [ “$3” = “true” ] ; then
\n echo “Skipping backup as avg tick time is too high ($2)”
\n exit 2
\nfi<\/p>\n
levelNames=${*:5:$4}
\nfor levelName in “${levelNames[@]}” # Preventing word splitting, because minecraft level names may contain spaces
\ndo
\n echo “Adding ‘$levelName’ to commit”
\n git add “$levelName”
\ndone<\/p>\n
echo “Creating commit”
\ngit commit -m “Automatic backup – $(date)”
\ngit push
\necho “Backup done!”
\n“`
\nExample output:
\n“`
\n[15:43:50] [Server thread\/INFO] (BackupScripts) Running scripts off main thread
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Script PWD: \/Users\/mateusz.budzisz\/git\/fabric\/git-backup-fabric-mod\/run
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Arguments passed: 4
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Player count: 1
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): AVG tick time: 0.1340647
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Total levels: 1
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Level names: ‘world with space in name’
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Adding ‘world with space in name’ to commit
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Creating commit
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): [main 7cd92d5] Automatic backup – Sun Aug 13 15:43:50 CEST 2023
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): 9 files changed, 0 insertions(+), 0 deletions(-)
\n[15:43:50] [Thread-13\/INFO] (BackupScripts) (on-save.sh): Backup done!
\n[15:43:50] [Server thread\/INFO] (BackupScripts) Shutdown of off main thread
\n“`<\/p>\n
## Default scripts use GIT
\nWhich is fine for small worlds (e.g.: up to few gigabytes), but it is recommended to setup more reliable solution as https:\/\/github.com\/bup\/bup or https:\/\/github.com\/WayneD\/rsync<\/p>\n","protected":false},"excerpt":{"rendered":"
Execute your scripts at builtin save system events.<\/p>\n","protected":false},"featured_media":75811,"template":"","meta":{"_minecraft_slug":"git-backup-mod","_minecraft_project_id":"qKTboxdx","_minecraft_author":"electroluxv2","_minecraft_license":"CC-BY-4.0","_minecraft_downloads":786,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"git-backup-mod.zip","_minecraft_size_bytes":5191453,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-15T21:24:39.715223Z","_minecraft_date_created":"2023-08-14T07:42:44.599416Z","_minecraft_date_modified":"2024-07-22T22:00:32.444787Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/git-backup-mod","_minecraft_icon_attachment_id":75811,"_minecraft_imported_at":"2026-06-04T09:21:00+00:00","_minecraft_import_hash":"5b6591c9a5fe6e5f491fd640f13ebf91","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,91,123,92],"mod_loader":[99],"minecraft_version":[36,94,62],"class_list":["post-75810","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-20-4","minecraft_version-1-21"],"yoast_head":"\n