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 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.

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

  • 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 '.'

    @Dodge34: Go

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

  • Avatar of Dodge34 Dodge34 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
  • Avatar of Fuzzwolf Fuzzwolf Apr 12, 2012 at 21:22 UTC - 0 likes

    I have had a problem with my NPCs made via the Citizens plugin despawning at what first seemed like random intervals. Unless a user is in a chunk where they are located, the NPCs will despawn upon having a save and/or backup by this plugin. I can confirm that without running this plugin, NPCs will not disappear.

    I'd very much like to use this, but I also need my NPCs.

    Last edited Apr 12, 2012 by Fuzzwolf
  • Avatar of ltguide ltguide Apr 12, 2012 at 16:05 UTC - 0 likes

    @awesomebilly: Go

    Let me see your config and I'll change it to match the times you've said. MineBackup does not "load" backup worlds. When the server crashes you lose any changes since the last save, so if your server is unstable, you probably need your main world saved much more often like every 10 minutes.

    @MissPicket: Go

    Yeah, I'll add something for them in the next version.


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