MineBackup - Automatically save and backup your server!


  • Numerous backup actions: Save (default); Copy and/or Compress. The copy action creates a copy of files in backup folder while the compress action creates a zip of files in backup folder. You do not need to enable both for compress to work.
  • Numerous upload actions: Dropbox; FTP. These actions will upload the latest compressed version, so you will need to be using compression.
  • Maintenance action: Cleanup. With this action enabled, old backups will only be deleted as scheduled (otherwise they will be deleted after a copy/compress action).
  • Each action has a configurable interval. You can even set a specific time that an action should trigger (only once per day). Every action supports either method.
  • You can either enable actions globally (default for all worlds) or enable/disable actions for specific worlds. Specific worlds can even have different time intervals for each action!
  • Global or per world configurable amount of backups to be kept on disc. So a world that is rarely used can be compressed every few hours and set to have less copies retained.
  • Global or per world configurable broadcast of backup status.
  • Setting to enable an immediate backup on server restart/reload with configurable delay. With this disabled (default), scheduled actions will occur at their proper time, but if the server was stopped during that time, then it will run as soon as possible.
  • Backup actions are staggered to try to prevent low-powered servers from getting overloaded. Instead of checking every world at one time and in order, a queue is checked once a minute to see if it needs to do a backup action.
  • If no one has used the world since the last backup ("not dirty") then its actions are skipped.
  • Able to backup plugins/other directories with a list of excluded paths (like dynmap's /tiles) and file types.
  • Customizable messages. Everything sent to players is able to be translated or changed. Including broadcast groups.
  • Configuration migration with a backup copy of the original configuration.


Does your server have a single-core processor or a low amount of memory (512mb and several plugins)?
Do NOT enable compression! Only enable copy.

Does your server operate over a typical home internet connection?
Do NOT enable dropbox or ftp!

Failure to understand this will almost certainly result in all of your players being disconnected.


[v0.5+] Due to changes to the old backup deletion code, the plugin will not automatically delete any v0.4 backups. You will need to manually delete them at an appropriate time.

[v5.9.2+] If you still have the old map format (world height 128) files in your world folders, it's going to yell at you on server startup. Once you have a backup of the world, delete level.dat_mcr and the *.mcr files in the region folder. They aren't needed after the conversion and double the size/time of the backup.

[v5.9.3+] Enable 'debug' in config.yml for a detailed list of the settings that are being used as each world/plugins is loaded. (Exact times are seconds from midnight, but stored as a negative number.)

Setup & Usage

Only save is enabled by default. You need to enable either 'copy' or 'compress'.

Commands and Permissions

Configuration | Scenarios (with Example Configurations)




MineBackup.jar (for auto-updaters)



Default Config (created first start)

Default Strings (created first start)

Dropbox Linker (Google App Engine)


ThisIsAreku for the original MineBackup. This plugin has now been completely re-imagined and rewritten. The only thing untouched and unchanged is the name itself.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of sindaruss sindaruss Apr 18, 2012 at 14:55 UTC - 0 likes

    Hi there! thanks for doing this plugin! but i am having a little problem that i can't understand: i've configured all the world the same way, and one of them doesn't copy when i use /backup all:


    i think this picture summarize it quite well...

    thanks for reading and answering ;)

    Last edited Apr 18, 2012 by sindaruss
  • Avatar of ltguide ltguide Apr 18, 2012 at 04:57 UTC - 0 likes

    @gnorbsl: Go

    directories.destination needs to be something other than '.' You've got it trying to copying a folder into itself so it just loops.

    @Jyizzle: Go

    It should be a folder 'minebackup' in the same level as the plugins folder. Make sure you've turned on either copy or compress for all/some worlds since it will just save by default.

    Plugins: GiveTo (/give enhancement) | MineBackup | ClearInventory | EntityInfo

  • Avatar of Jyizzle Jyizzle Apr 17, 2012 at 20:28 UTC - 0 likes


    Hey i cant find the folder where the backups would be located. I did not tinker with the config file that modifies that help!

  • Avatar of gnorbsl gnorbsl Apr 17, 2012 at 18:27 UTC - 0 likes

    @ltguide: Go

    It does the same with . But now in the world folder...

    here is my config:



  • Avatar of ltguide ltguide Apr 16, 2012 at 21:43 UTC - 0 likes

    @Fuzzwolf: Go

    I'll see what I can do. Had a problem similar to this with saving inventories where playername and NPC name matched.

    @awesomebilly: Go

    Your paste disappeared. By default, if the server restarts it will keep track of the proper time to backup.

  • Avatar of ltguide ltguide Apr 16, 2012 at 21:38 UTC - 0 likes

    @gnorbsl: Go

    I think you have directories.worlds set incorrectly. If your worlds are at the same level as the craftbukkit.jar, set it to '.'

    @McDodge34: Go

    I just looked into this and I think I can implement this pretty easily.

  • Avatar of McDodge34 McDodge34 Apr 16, 2012 at 01:39 UTC - 0 likes

    I really like this plugin, makes it a breeze to have a backup ready, but since my server is in the Netherlands right now the time indicated and the date on each backup isn't accurate for me, I always have to correct the date and time manually, is there any ways to make a correction in the Minebackup utility to set the correct date and time according to the choice of region. I asked them if they could correct the time on my server but its not possible for them to do this, I would probably have the same problem if the new server I choose is in California or anywhere that isn't GMT-5.

  • Avatar of gnorbsl gnorbsl Apr 15, 2012 at 20:32 UTC - 0 likes

    I have the following Problem:

    2012-04-15 22:29:15 [SEVERE] [MineBackup] # copy: ./minebackup/world_the_end -> ./minebackup/world_the_end/2012-04-15_22-28-53 2012-04-15 22:29:15 [SEVERE] [MineBackup] java.io.FileNotFoundException: ./minebackup/world_the_end/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/2012-04-15_22-28-53/15042012-141100/DIM1/region/r.0.-1.mca (File name too long) 2012-04-15 22:29:15 [SEVERE] [MineBackup] java.io.FileOutputStream.open(Native Method) 2012-04-15 22:29:15 [SEVERE] [MineBackup] java.io.FileOutputStream.<init>(Unknown Source) 2012-04-15 22:29:15 [SEVERE] [MineBackup] java.io.FileOutputStream.<init>(Unknown Source) 2012-04-15 22:29:15 [SEVERE] [MineBackup] ltguide.base.utils.DirUtils.copyFile(DirUtils.java:42) 2012-04-15 22:29:15 [SEVERE] [MineBackup] ltguide.base.utils.DirUtils.copyDir(DirUtils.java:36) 2012-04-15 22:29:15 [SEVERE] [MineBackup] ltguide.base.utils.DirUtils.copyDir(DirUtils.java:35) 2012-04-15 22:29:15 [SEVERE] [MineBackup] ltguide.base.utils.DirUtils.copyDir(DirUtils.java:35)

  • Avatar of MissPicket MissPicket Apr 13, 2012 at 05:57 UTC - 0 likes

    <<reply 647416="">>

    Great, thanks ltguide! It would be very useful. There's a bunch of root files that are important - mine were wiped by a disk space error the other day and it was a nightmare! (Whitelist and banned lists, urgh...)

  • Avatar of awesomebilly awesomebilly Apr 13, 2012 at 03:53 UTC - 0 likes

    Thank you very much for your hard work!

    I have posted my config to pastebin located here http://pastebin.com/hbTqJk1c

    What I'm trying to Achieve:

    Have my server save every 10-15 minutes. Backup my server every 3:45 minutes My server restarts every 4 hours. (simplerestart plugin)

    Once my server restarts I would like to have it at the same time and point where it was before it restarted.

    additional note: I have compress off to try to reduce server backup lag. Every time my server backs up it lags really bad and the users get disconnected.

    Last edited Apr 13, 2012 by awesomebilly


Date created
Oct 26, 2011
Last update
Aug 07, 2012
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files