2020-06-06 19:41:42 +00:00
|
|
|
# Albatross
|
|
|
|
Back up what you care about in your Minecraft worlds.
|
|
|
|
|
2020-06-07 19:21:26 +00:00
|
|
|
Albatross backs up player files and region files within a certain configurable radius. It can also send Discord
|
|
|
|
webhooks. Backups are compressed and stored as `tar.gz` archives.
|
|
|
|
|
2020-10-24 18:41:11 +00:00
|
|
|
## Help
|
|
|
|
```
|
2021-02-04 00:46:33 +00:00
|
|
|
albatross 0.4.0
|
2020-10-24 18:41:11 +00:00
|
|
|
Backup your Minecraft Server!
|
|
|
|
|
|
|
|
USAGE:
|
|
|
|
albatross --config-path <config-path> <SUBCOMMAND>
|
|
|
|
|
|
|
|
FLAGS:
|
|
|
|
-h, --help Prints help information
|
|
|
|
-V, --version Prints version information
|
|
|
|
|
|
|
|
OPTIONS:
|
|
|
|
-c, --config-path <config-path> Path to the Albatross config [env: ALBATROSS_CONFIG=]
|
|
|
|
|
|
|
|
SUBCOMMANDS:
|
2020-11-04 03:54:15 +00:00
|
|
|
backup Backup a server
|
|
|
|
export Export a backup as a single player world
|
|
|
|
help Prints this message or the help of the given subcommand(s)
|
|
|
|
restore Restore certain chunks from a backup
|
2020-11-06 02:35:34 +00:00
|
|
|
|
|
|
|
Process finished with exit code 1
|
|
|
|
|
2020-11-04 03:54:15 +00:00
|
|
|
```
|
2020-10-24 18:41:11 +00:00
|
|
|
|
2020-11-04 03:54:15 +00:00
|
|
|
## Examples
|
|
|
|
Running a backup:
|
2020-10-24 18:41:11 +00:00
|
|
|
|
2020-11-04 03:54:15 +00:00
|
|
|
`albatorss -c test.toml backup`
|
|
|
|
|
|
|
|
Exporting a backup to a single player world:
|
|
|
|
|
|
|
|
`albatorss -c test.toml export backups/04-11-20_01.51.27_backup.tar.gz sp.tar.gz`
|
|
|
|
|
2020-11-06 02:35:34 +00:00
|
|
|
Restoring a single chunk (from -2,-2 to 2,2):
|
|
|
|
|
2020-11-06 20:05:44 +00:00
|
|
|
`albatorss -c test.toml restore world backups/04-11-20_01.51.27_backup.tar.gz sp.tar.gz (0,0)`
|
2020-11-06 02:35:34 +00:00
|
|
|
|
2020-11-04 03:54:15 +00:00
|
|
|
Restoring a range of chunks (from -2,-2 to 2,2):
|
|
|
|
|
2020-11-06 20:05:44 +00:00
|
|
|
`albatorss -c test.toml restore world backups/04-11-20_01.51.27_backup.tar.gz sp.tar.gz (-2,-2) -u (2,2)`
|
2020-10-24 18:41:11 +00:00
|
|
|
|
2020-06-06 19:41:42 +00:00
|
|
|
## Config
|
|
|
|
```toml
|
|
|
|
[backup]
|
|
|
|
# Minecraft sever directory
|
|
|
|
minecraft_dir = "/home/mc/server"
|
|
|
|
# Directory to place backups
|
|
|
|
output_dir = "/home/mc/backups"
|
|
|
|
# Number of backups to keep
|
|
|
|
backups_to_keep = 10
|
2020-06-07 19:21:26 +00:00
|
|
|
# Discord Webhook
|
|
|
|
discord_webhook = "https://discordapp.com/api/webhooks/"
|
2020-06-06 19:41:42 +00:00
|
|
|
|
2020-06-07 19:21:26 +00:00
|
|
|
# World config options
|
2020-06-06 19:41:42 +00:00
|
|
|
[[world_config]]
|
|
|
|
# world name
|
|
|
|
world_name = "world"
|
|
|
|
# world save radius (in blocks)
|
|
|
|
save_radius = 8000
|
|
|
|
```
|