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 ltguide ltguide Apr 19, 2012 at 21:41 UTC - 0 likes

    @frol1: Go

    Save is not a backup. You need it to save often.

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

  • Avatar of frol1 frol1 Apr 19, 2012 at 19:14 UTC - 0 likes

    hmm i put it a 1439 as that woul dbe 23hours and 59 minutes. i only want it ro back up once a day.

  • Avatar of ltguide ltguide Apr 19, 2012 at 15:25 UTC - 0 likes

    @sindaruss: Go

    Strange :0

    Set debug to true in the config, "/minebackup reload" (or whole server) and then wait less than a minute. It should output what it thinks world_arena is set to.

    @frol1: Go

    Well, first of all, the world names are case-sensitive. But since you've enabled the appropriate settings under default_actions, it would still work. However, you have save set to 1439m which is probably not what you meant. It should be more like 15m or 30m.

    I think what might be happening is dropbox will trigger at 3am, but it sends the latest compressed backup. So since the delay on compress is a whole day, it could take two days for you to see anything.

    I would set compress to a time, like compress: '1:00' so it is certain to happen soon before uploading. You can test everything with "/minebackup now" which would compress, then "/minebackup upload" to trigger all the uploads.

    Turning on debug mode might help too in configuring.

    @chalarie: Go

    That doesn't sound right at all. Can I see your config?

  • Avatar of chalarie chalarie Apr 19, 2012 at 05:12 UTC - 0 likes

    I seem to be having problems with the broadcast function. Whenever I have it set to enabled, everyone is able to see the broadcast messages (of course), but when I disable it, it does not perform the backup, but still broadcasts a "All backup actions will start momentarily" and "All backup actions have been completed". This only happens when the broadcast option is set to false. Any tips on what I'm doing wrong?

  • Avatar of frol1 frol1 Apr 18, 2012 at 21:39 UTC - 0 likes

    Hi there, I seem to be having troubles with minebackup sending my files to my drop box.
    First problem is that its not sending my main world over.
    and now its only sending my plugins folder. This is my config

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

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


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