- X - Changing X number means some breaking changes without backward compatibility. This means that before switching to this version you should check the
Incompatible version changes
paragraph - Y - Changing Y number means that the version contains significant changes with backward compatibility
- Z - Changing Z number means that the version contains minor changes or improvements with backward compatibility
- A - Changing A number means that the version contains bugfixes or security/stability improvements. Usually these are hotfixes
- Fully changed permission system. Check the
Permissions
section to see the changes - Fully changed command naming. Check the
Commands
section to see changes
- Install into your plugins folder
- Start the server
- Change config.yml (plugins/Backuper/config.yml)
- Restart the server
By default, backups will be stored in (plugins/Backuper/Backups)
-
If
backupTime
option in config.yml is not set to -1- Backups will occur every day at the time specified in
backupTime
, regardless ofbackupPeriod
- Backups will occur every day at the time specified in
-
If
backupTime
option in config.yml is set to -1- First localBackup will happen at the server start
- Next backups will happen after
backupPeriod
-
Auto localBackup
- (true/false) - Enables automatic backups once at a specified interval (when disabled, backups will only run on the/backuper localBackup
command) -
Backups folder
- (Path) - Full path to folder, where backups will be stored -
Add directory to localBackup
- (List of paths) - Full directory paths to folders/files that you want to be backed up. World folders will be backed up automatically, so you do not need to specify world folders there (For example you can specify "plugins", "config") -
Exclude Directory From Backup
- (List of paths) - Full directory paths to folders/files that you want to be excluded from localBackup. If you want to localBackup everything from the folder1 except some folder1/file1 you can specify folder1 inaddDirectoryToBackup
and folder1/file1 inexcludeDirectoryFromBackup
. (ThebackupsFolder
directory will be excluded automatically to prevent the loop) -
After localBackup
- (NOTHING/STOP/RESTART) - What will the server do after an automatic localBackup -
localBackup time
- (0 - 23 or -1) - Fixed localBackup time. Automatic backups will be made at this time every day. (backupPeriod
will be automatically set to 24 hours). -1 to disable localBackup time fixation -
Backup period
- (>= 1 Minutes or -1) - The period after which the server will make automatic backups (To change this value you need to setbackupTime
to -1 andautoBackup
to true) -
Skip duplicate localBackup
- (true/false) - Backup will only occur if the world has been changed since the last localBackup. If the world has not been changed, this localBackup cycle will be skipped.AfterBackup
will be executed anyway -
Max localBackup number
- (>= 1 or 0) - Maximum number of backups to be kept (0 - unlimited) -
Max localBackup weight
- (>= 1 or 0) - Maximum weight of backups that will be stored (MB) (0 - unlimited) -
Zip archive
- (true/false) - Do you want to store backups in ZIP archives? -
Alert time before restart
- (>= 1 Seconds or -1) - A notification about the server restart will be sent to all players on the serveralertTimeBeforeRestart
seconds before the restart. -1 to disable notifications -
Alert only server restart
- (true/false) - Notifications will be sent only if the server will be restarted or stopped after the localBackup -
Better logging
- (true/false) - Enable logging of additional information (used for debugging, you probably don't need it) -
Set worlds read only
- (true/false) - (True recommended) The backuper will mark all world folders as Read Only to prevent folder changing that may cause the localBackup crash. True value may cause access denied errors during the localBackup (you should just ignore that)
-
/backuper localBackup <stopRestartServer>
- Command to localBackup the server manually, argument means what the server will do after restart. ThestopRestartServer
argument can beSTOP
orRESTART
, also you can use it without an argument -
/backuper localBackup <delay> <stopRestartServer>
- Command to localBackup the server manually with a delay (delay in seconds > 0).stopRestartServer
argument is the same as in command above and it is also optional -
/backuper list
- Command to view the list of backups (click on a localBackup to open its menu) -
/backuper menu <backupName>
- Command to open the menu of the specified localBackup (can be opened by clicking on the specified localBackup in/backuper list
) -
/backuper menu <backupName> toZIP
- Command to convert the specified localBackup to a ZIP archive (can be used by clicking on the[TO ZIP]
option in/backuper menu <backupName>
) -
/backuper menu <backupName> unZIP
- Command to convert the specified localBackup from a ZIP archive to a folder (can be used by clicking on the[UNZIP]
option in/backuper menu <backupName>
) -
/backuper menu <backupName> delete
- Command to delete the specified localBackup (can be used by clicking on the[DELETE]
option in/backuper menu <backupName>
) -
/backuper config reload
- Command to reload the config file -
/backuper status
- Command to get the current progress of a task
-
backuper.localBackup
- Permission to use/backuper localBackup
command without thestopRestartServer
argument -
backuper.localBackup.stop
- Permission to use/backuper localBackup
command with the STOP argument (backuper.localBackup
permission required) -
backuper.localBackup.restart
- Permission to use/backuper localBackup
command with the RESTART argument (backuper.localBackup
permission required) -
backuper.list
- Permission to use/backuper list
and/backuper menu
commands -
backuper.list.tozip
- Permission to convert backups to a ZIP archive (backuper.list
permission required) -
backuper.list.unzip
- Permission to convert backups from a ZIP archive to a folder (backuper.list
permission required) -
backuper.list.delete
- Permission to delete backups (backuper.list
permission required) -
backuper.config.reload
- Permission to use/backuper config reload
command (backuper.config
permission required) -
backuper.status
- Permission to use/backuper status
command
- Please report any issues to GitHub
- RESTART option may not work well, so it's better to use STOP with a loop in your start script (start script auto restart ON)
- You can reset the localBackup time if it is broken and your
backupTime
is set to -1 by changinglastBackup
to 0. Then the next localBackup will happen at the server start and the next ones will happen afterbackupPeriod