Skip to main content Link Search Menu Expand Document (external link)

Using FastBack

FastBack adds a custom /backup command that is used for all backup operations. To get detailed help about using it, just type.

/backup help

This page explains how to do most common tasks.

Enabling Backups on a world

To enable backups on your world, just run

/backup enable
Enabled automatic local backups on world shutdown.

Note: Backups currently only run during world shutdown; you can’t do a backup while the world is running. This limitation will be removed in a future release.

Listing available backup snapshots

Every time FastBack runs, it creates a snapshot of your world. Snapshots are identified by the time they were created.

To see all snapshots in your backup of the current world, run

/backup list

Available snapshots:
2022-10-07_10-11-12
2022-10-02_23-43-01
2022-09-24_11-32-59
2022-05-08_08-56-33

Restoring a backup snapshot

You can restore your world from any snapshot in the backup by running

/backup restore 2022-10-02_10-11-12
Restoring 2022-10-02_10-11-12 to
/home/pcal/minecraft/saves/MyWorld-2022-10-02_10-11-12

This will create a copy of your world as it was when that snapshot was made. Note that a restored snapshot is created as a new world in your saves directory; the files in the current world are never touched by restore.

To look at the restored snapshot, quit the current world and open the restored snapshot world.

Configuring remote backups to a git server

If you care about your world, you really should keep a backup of it on a different computer. FastBack makes that easy.

If you have a git server already running (GitHub, for example), all you need to do is

  • create a repository on the server to store your world’s backups
  • get the URL to the repository (e.g., ssh://192.168.0.99/mygitserver/myworld)

Then, with your world running in Minecraft, type

/backup set-remote ssh://192.168.0.99/mygitserver/myworld

Configuring remote backups without a git server

If you don’t have a git server, no problem. You can also do remote backups to any network drive on your computer. Just type something like

/backup create-file-remote /path/to/network/volume/minecraft-backups/myworld

You can configure this to be any valid path on your file system. But it makes the most sense to do your backups to another machine on your network.

Note that you can only have one remote configured at a time.