Backup Enderchest

Enderchest

Backup your Minecraft server to Google Drive. Worlds + plugins, automatically.

No lag. Works on third party hosts.

Download: Modrinth Source: Github

Supports Paper / Spigot 1.20+,1.21+ and 26.1+ (26.1.2, 26.2, future 26.x). Java 21.

What it backs up

By default:

• All your worlds (world, world_nether, world_the_end — auto-detected)
• Your plugins folder (so you never re-enter configs)

You get 1 zip on Drive like backup-2026-09-13_17-15-16.zip.

Setup in 5 minutes (do this once)

You only do this once. After that it just works.

Step 1 - Install the plugin

1. Download Enderchest-1.0.0.jar from Modrinth above
2. Put it in your server plugins/ folder
3. Restart the server once
4. You will now have a plugins/Enderchest/ folder

Step 2 - Make a Drive folder

1. Go to https://drive.google.com
2. Click + New -> Folder -> name it Minecraft-Backups
3. Open that folder and copy the ID from the address bar For Example:

   https://drive.google.com/drive/folders/1s4Qk_4PnlaLX6FLePpxzIy4WEGcDt
                                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                          this part is your folder-id
   

   You can paste the full link too — Enderchest cleans it for you.

Step 3 - Connect Google (1 click + 1 code)

Enderchest uses your own Google login, so backups count against your Drive. Nothing is shared with us.

1. Go to https://console.cloud.google.com
2. Top-left -> project dropdown -> New Project -> name Enderchest-Backup -> Create
3. Top search bar -> type Google Drive API -> click it -> Enable
4. Left menu -> APIs & Services -> OAuth consent screen -> Get Started
   • Audience: choose External (Internal is only for paid Workspace)
   • App name: Enderchest
   • Add yourself as a test user (your Gmail)
   • Save
5. Left menu -> Credentials -> + Create Credentials -> OAuth Client ID
   • Type: Desktop App -> name Enderchest -> Create
   • Download JSON -> rename the file to credentials.json
6. Upload credentials.json to your server: plugins/Enderchest/credentials.json (via FTP / File Manager)

Step 4 - Paste 2 lines in config

Open plugins/Enderchest/config.yml and set:

google-drive:
  auth-mode: "oauth"
  folder-id: "paste-your-folder-id-here"
backup:
  extra-folders: ["plugins"]

Save, then restart or run /drivebackup reload.

Step 5 - Link your account

In-game (op) or console:

/drivebackup auth

1. It prints a Google link — open it, click Allow
2. Your browser goes to http://localhost:8080/?code=4/0XXXX... (page may fail to load that's fine)
3. Copy the code=... part from the address bar
4. Run:

/drivebackup auth 4/0XXXX...

You should see OAuth success!. Done forever token is saved in plugins/Enderchest/tokens/.

Step 6 - Test

/drivebackup now

You should see:

Backup started...
Zipping 3 folders...
Zip created: 113 MB
Backup uploaded to Drive! ID:...

Check your Minecraft-Backups folder on Drive — the zip is there.

Commands

/drivebackup now          - backup right now
/drivebackup auth         - get Google login link
/drivebackup auth <code>  - finish Google login
/drivebackup status       - is it running? what was last backup?
/drivebackup reload       - reload config.yml

Aliases: /dbackup, /gdrive. Permission: drivebackup.admin (op by default).

Auto-backup runs daily by default. Change in config:

backup:
  auto-interval-minutes: 1440  # 1440 = daily, 0 = off
  keep-count: 7                # keep last 7 on Drive, delete older

Restore

1. Download the zip from Drive
2. Stop server
3. Unzip world* and plugins/ back over your server files
4. Start server

OAuth not authorized yet -> You skipped Step 5. Run /drivebackup auth, then /drivebackup auth <code>.

404 File not found: ...?usp=drive_link -> paste only the ID part.

403 Service Accounts do not have storage quota -> You are on auth-mode: service-account with a free Gmail. Google removed free quota for service accounts in 2024. Switch to auth-mode: "oauth" (Step 3-5 above). Service-account mode only works with paid Workspace Shared Drives now.

credentials.json not found -> You didn't upload Step 3 file. Must be at plugins/Enderchest/credentials.json.

have any specific issues -> Its probably already adressed update your .jar