AutoBackup documentation page
Note:By default AutoBackup is disabled!
AutoBackup backups your worlds folders, by default backups are located at the folder {your server folder}/backups/.
backups of worlds are stored in the folder {backupfolder}/worlds , using WorldEdit snapshot folder structure
backups of plugins are stored in the folder {backupfolder}/plugins
Command
/asw backup (performs a backup manually)
Permission: autosaveworld.backup
Config values: (config.yml)
backup: enabled: false #enable or disable autobackup interval: 21600 #interval in seconds between autobackups savebefore: true #forces save before doing backup broadcast: true #broadcast message before and after the backup rateLimit: -1 #limits the read rate (kb/s, -1 for unlimited) localfs: enabled: true #enable backup to local filesystem worlds: #list of worlds to backup, '*' - backup all worlds - '*' MaxNumberOfWorldsBackups: 30 #maximum number of worlds backups, after reaching this limit, plugin will delete the oldest one and then create a new. pluginsfolder: false #backups plugins folder MaxNumberOfPluginsBackups: 30 #maximum number of plugins backups, after reaching this limit, plugin will delete the oldest one and then create a new. excludefolders: [] #list of paths to folders excluded from backup destinationfolders: [] #list of destinationfolders folders to backup to zip: false #zip backuped folders. ftp: enabled: false #enable backup to ftp sftp: true #uses sftp backup hostname: 127.0.0.1 #ftp server hostname port: 21 #ftp server port login: user #ftp server username/login password: password #ftp server password path: asw #path at ftp server at which backups will be stored zip: false #zip bakuped folders worlds: #list of worlds to backup, '*' - backup all worlds - '*' pluginsfolder: false #backup plugins folder otherfolders: [] #list of other folders to backup excludefolders: [] #list of paths to folders excluded from backup maxNumberOfBackups: 2 #maximum number of backups, after reaching this limit, plugin will delete the oldest one and then create a new. script: enabled: true #enable script backup scriptpaths: [] '' #paths to the scripts to execute dropbox: enabled: false #enable backup to dropbox token: #your own app token(get one by creating your own app with full access at https://www.dropbox.com/developers/apps) path: asw #path at dropbox at which backups will be stored worlds: #list of worlds to backup, '*' - backup all worlds - '*' pluginsfolder: false #backup plugins folder otherfolders: [] #list of other folders to backup excludefolders: [] #list of paths to folders excluded from backup maxNumberOfBackups: 2 #maximum number of backups, after reaching this limit, plugin will delete the oldest one and then create a new. zip: true #zip bakuped folders
excludefolders example:
excludefolders: - 'plugins/Essentials' - 'plugins/dynmap/web/tiles' - 'plugins/A*' #wildcard, will ignore any folders which are in plugin folder and which names starts with A
destinationfolders example:
destinationfolders: - 'D:/test' - '/home/serv/test'
Thank you for this, It'll help a'lot of people!
Dont work with BukkitForge
Thanks, this is REALLY useful! Keep it updated! :D
Is it possible to backup only part of a world? I have tried using
but this doesn't actually backup anything. My entire world is almost 10 gigs which severely limits the backups I can keep and significantly increases the time it takes me to make backups and/or restore from a backup.
The ability to backup just the region data (just the overworld) would be extremely helpful.
Alternatively, it would be nice to backup the region data on one interval, and the entire world on a separate interval.
I am willing to donate specifically for this feature if that helps.
@Omniwrath
It's not possible. (But you can exclude all folders that are in the world folder using excludefolders)
P.S i don't know why you are trying to backup only regions files because there is nothing besides them in world folder(only players in overworld, but you can exclude them).
There ,ay be other world folders in mcpc+, but they are aready ignored.
@Shevdchikden
Hi Shevchikden, thank you so much for the response.
If backing up select folders is not possible, then is it possible to ignore folders with a wildcard?
I run a FTB server that utilizes MCPC+ and a lot of Mystcraft ages, but the Mystcraft ages are primarily used as temporary worlds. Creating backups of Mystcraft ages is something I would prefer to do less often because they require too much space to backup and are not used for permanent homes and such on my server.
These are in the 'world' folder and have a naming pattern like: DIM_MYST195 DIM_MYST196 DIM_MYST
# etc.
with newly assigned numbers for each world. So ignoring each of them separately is possible in theory, but it's not ideal when new worlds are being generated on a daily basis.
If I could ignore all folders that start with 'DIM_MYST*' or something, that would absolutely fulfill my desires.
@Omniwrath Do those worlds show themselfs in /gc or /elag (essentials)?
Because i already done that others worlds folders are excluded from overworld backup in mcpc+ and i was sure that it was working.
@Shevchikden
They do show up in /elag and /gc but only the ones that are currently loaded.
Elag image.
There are a lot more ages than those listed here.
@Omniwrath
Ok, i will see if i can add wildcard folders exclude.
@Shevchikden
Thanks a lot. This is a fantastic plugin. Is there a place I can donate to support you/the plugin?
@Omniwrath There is a donate button at the right top corner.
Hi there,
I've some problems with the autobackup, I can't set any external folder. Each time I set a path, the file reload itself and the config is lost. I've tried those
extfolders:
- 'D:/test'
- 'D:\test'
- D:/test
etc...
I've this error :
22:41:29 [SEVERE] Cannot load plugins\AutoSaveWorld\config.yml
22:41:29 org.bukkit.configuration.InvalidConfigurationException while scanning for the next token
22:41:29 found character '\t' that cannot start any token
22:41:29 in "<string>", line 23, column 1:
22:41:29 - 'T:/test'
22:41:29 ^
Maybe I've forgotten something important but I can't find what ..
@TheRealBix You can't use tabs in yaml config, you should use spaces.
Seriously... I think i'll go suicide me..
Thanks :)
@Omniwrath
I've added a partial wildcard resolution in test build so something like {worldfolder}/DIM_MYST* in exlude list sould ignore all folders which are in the {worldfolder} and names starts with DIM_MYST, you try it and tell me if that works.
@Shevchikden
It's fully functional. Thank you for the update. The only thing worth noting is that it doesn't auto purge the previous backups I had, even after passing the backup limit, so I had to purge those manually.
@Omniwrath
THat's strange it's fully functional for me.
Do you use external folders?
(enable debug and check console if it tryes to delete oldest backup)
(Also if you deleted some of the backups by yourself ASW will still think that they are still there, because data about backups is stored in file)
@Shevchikden
It's not a problem. I only said anything for the sake of completeness and curiosity. It is fully functional, in that it only keeps X number of backups, but it doesn't count the backups it previously made (the ones that still had Mystcraft ages) among those backups. So it was keeping X + old backups. I just had to manually delete the old backups and it is working 100% as intended.
Howdy, I'm trying to use external folders and I'm having issues as well. I'm trying to save to an external drive, and I'm using /Volumes/B2/ASW-Backups/ and every time I reload configuration it wipes that out. Any idea what is going on?
@xllluzionx
show me your config and i will tell you what is wrong , but probably you broke yaml formatting