AutoBackupV2

AutoBackup is a powerful, intelligent backup plugin for Minecraft 1.21.11 that automatically safeguards your server with smart incremental backups to save space and time.

Key Features

• Smart Incremental Backups: Only backs up files that have changed since the last save
• Zero-Lag Performance: Runs entirely asynchronously to prevent server stalling
• Corruption-Safe: Utilizes native world.save() to ensure data consistency
• Automatic Cleanup: Automatically manages disk space by deleting old backups
• Complete Coverage: Backs up worlds, plugins, and configurations
• Native Compression: Uses efficient Java ZIP compression to minimize file size

Functionality

Standard backup solutions often copy the entire server directory every time, wasting massive amounts of disk space and frequently causing lag spikes during large file operations.

AutoBackup solves this by using smart tracking. After the initial full backup, the plugin tracks the modification time of every file. Subsequent backups only include the specific files or chunks that have changed. This dramatically reduces backup size (often by 90% or more) and allows the process to complete in seconds rather than minutes.

Safety & Performance

The plugin is designed with a "corruption-risk: near zero" philosophy. Before any backup begins, it triggers a world.save(), forcing the server to flush all pending chunk writes and data to the disk. The backup process itself is strictly read-only—it streams files directly to a ZIP without ever writing to your active game data.

Configuration

The plugin works out of the box, but is highly customizable via plugins/AutoBackup/config.yml.

• Schedule: Set the backup interval in minutes (Default: 60).
• Retention: Define the maximum number of backups to keep before deleting the oldest ones (Default: 10).
• Scope: Choose specific worlds to backup or exclude specific file patterns (like heavy log files).
• Mode: Toggle between incremental (smart) or full backups.

Commands & Permissions

• /autobackup now — Force a full backup immediately (autobackup.create)
• /autobackup list — List all stored backups (autobackup.list)
• /autobackup info — View current configuration (autobackup.use)
• /autobackup reload — Reload the plugin configuration (autobackup.reload)

Installation

AutoBackup is a server-side plugin designed for Paper 1.21.11 (compatible with all 1.21.x versions). Simply drop the JAR into your plugins folder and restart your server. A backups folder will be created automatically in your server root.

Restoring

Backups are stored as standard ZIP files in the backups/ folder. To restore, simply stop your server, extract the contents of the desired backup ZIP, and overwrite your current server files. It is highly recommended to test restores on a local environment first.

🛠 Support & Bug Reports

Found a bug or need help setting up the plugin?
Report issues directly on Discord.