ggBackup – Ultimate Asynchronous Backup System

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Professional Backup Infrastructure for Minecraft Servers

Lightweight • Asynchronous • Production Ready

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

ggBackup is a modern backup infrastructure designed for reliable Minecraft server environments.

Instead of simple file-copy scripts, ggBackup runs backups in the background with a clean layered architecture. Your players keep playing while a backup runs.

Version 2.0 brings a completely new, easy-to-read config and full support for the new Minecraft 26.x world folders.

Developed and maintained by Glesel-Group.

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

✨ Core Features ✨

➤ Background Backup Engine
➤ Easy, Fully Explained Config (old configs are converted automatically)
➤ Profile-Based Configuration System
➤ Exact Time & Weekday Scheduling with Time Zone
➤ Automatic Backup Rotation
➤ Adjustable ZIP Compression (0–9)
➤ World, Plugin & Custom Path Support
➤ Exclude Files per Profile (for example *.log, cache)
➤ Disk Space Check Before Every Backup
➤ Automatic Retries for Failed Scheduled Backups
➤ Full 26.x World Folder Support (all dimensions, level.dat, player data)
➤ Intelligent Restore System
➤ Multi-Language Support (EN / DE)
➤ Countdown Broadcast Before Backups

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Restore System

➤ Full Server Restore
➤ Selective World Restore
➤ Plugin Restore (Data Folder)
➤ Confirmation Step Before Anything Is Overwritten
➤ Replaced Data Is Kept as .old and Put Back if a Restore Fails
➤ Main World Is Swapped In Safely When the Server Stops
➤ Metadata-Based Intelligent Recovery

Reliable restore functionality is one of the main design goals of ggBackup.
Backups are only useful if restores work reliably.

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

⚡ Performance & Stability ⚡

➤ Backups Run Off the Main Thread
➤ Backups Are Written to a Temporary File First
➤ World Autosave Is Always Switched Back On
➤ TPS-Aware Execution
➤ Smart Thread-Pool Management
➤ Zip-Slip Protection
➤ Graceful Shutdown Handling (including backup on shutdown)

Designed for long-running servers where stability matters.
Infrastructure you can trust.

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

⏱️ Backup Performance ⏱️

Backup duration depends on world size, storage speed, and server hardware.

Example production backup:
6 GB backup size
≈ 2 minutes 30 seconds runtime

Backups run in the background — the server stays responsive during the entire process.

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

System Requirements

Java 21 or newer (Minecraft 26.x servers run on Java 25)
Paper / Spigot 26.x (built against the 26.3 API)
Minimum 2 GB RAM allocated

Servers with only 1 GB RAM may experience instability during backups.
For larger servers or multiple worlds:
4 GB+ RAM recommended

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Commands

Alias: /bu or /bkup

➤ /backup start [profile] Start a manual backup
➤ /backup profiles List all backup profiles
➤ /backup list [profile] Show backups of a profile
➤ /backup status Check current backup status
➤ /backup next Time until next scheduled backup
➤ /backup restore <name> [folder|all] confirm Restore a backup
➤ /backup reload Reload plugin configuration

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Permissions

➤ ggbackup.* Full access
➤ ggbackup.use Basic usage
➤ ggbackup.start Start manual backups
➤ ggbackup.list List backups
➤ ggbackup.status View backup status
➤ ggbackup.next Show next scheduled backup
➤ ggbackup.restore Restore backups
➤ ggbackup.reload Reload configuration
➤ ggbackup.notify Receive notifications

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

⚙️ Installation ⚙️

Place ggBackup.jar into the plugins folder
Restart the server
Configure config.yml (profiles = what, schedules = when)
Done

No additional dependencies required.

Updating from 1.2.x: just replace the jar. Your old config is converted automatically and saved as config-1.2-backup.yml. Backups made by 1.2.x cannot be restored on 26.x.

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Statistics

This plugin is still new, so stats are just getting started.
Be part of ggBackup's journey and help it grow! ✨

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

★ Support & Donations ★

Join our Support Discord:

If you like this project and want to support further development,
consider leaving a donation.