#backup #game-server #save #back #game #directory #path

app game-save-backuper

The tool to back up save data of some game server

6 releases

0.1.5 Mar 23, 2022
0.1.4 Feb 22, 2022

#1162 in Game dev

Apache-2.0 OR MIT

52KB
1K SLoC

game save backuper

a12 maintenance: Slowly

The tool to back up save data of some game server.

This project is in development, not released yet. the following installation steps may not work.

Currently, this is mainly intended for Minecraft but can be used for other games.

Request to support other game is welcome! Please read this section.

How to use

  1. get docker image from github packages

    docker pull ghcr.io/anatawa12/game-save-backuper
    
  2. create config file. See Config format.

    Note that you must not set backup_dir and save_dir.

  3. docker run \
      -v '/path/to/your/save/dir:/save' \
      -v '/path/to/your/backups/dir:/backups' \
      ghcr.io/anatawa12/game-save-backuper 
    

    to start daemon.

Config format

# choose preset. currently, minecraft are supported. optional.
preset: minecraft
# the path to directory to be backed up.
# This should not be specified if you're using docker
save_dir: /path
# the path to backups directory.
# This should not be specified if you're using docker
backup_dir: /path

# you can back up multiple interval.
backups:
  # name of backup directory
  - name: 5min
    # interval of backup.
    # you can choose from:
    #   5, 10, 15, 20, 30 minutely
    #   1, 2, 4, 6, 12 hourly (every 0 minute)
    #   daily (every 0:00 UTC)
    #   weekly (every monday 0:00 UTC)
    #   1, 2, 3, 4, 6 monthly (every 1st 0:00 UTC)
    #   yearly (every Jan 1st 0:00 UTC)
    interval: 5 minutely
    # the count of backups will be saved.
    # if more than this number of backups are found,
    # the oldest backup will be removed
    max_backups: 12

Adding game support

I think it make this better to support other games. I don't have enough time to find which game is good to support and to find game information. That's why it's welcome to send me a request to support other game. To request, please open a new issue! If possible, please let me know the following information to make it easy to support new game.

  • whether the game supports rcon to
    • stop and resume auto save if the game have auto save
    • force save world
  • the default rcon port number if it supports rcon.
  • the command to be sent over rcon to
    • stop and resume auto save if the game have auto save
    • force save world

Dependencies

~8–20MB
~279K SLoC