BackupGuard

AutoBackup - Professional Server Backup Solution

AutoBackup is a high-performance automatic backup system designed specifically for Paper Minecraft servers running version 1.21 and above. This plugin provides enterprise-grade backup functionality with zero server lag through intelligent async processing.

Why Choose AutoBackup?

Zero Performance Impact - All backup operations run asynchronously in separate threads, ensuring your server maintains perfect TPS even during large world backups. Players won't experience any lag or interruptions.

Intelligent Scheduling - Set up automatic backups on flexible schedules. Choose interval-based backups (every X hours) or time-based backups (specific times like 3 AM daily). The plugin includes pre-backup warnings to notify players before backups begin.

Smart Storage Management - Never worry about running out of disk space. AutoBackup automatically manages your backup storage with configurable retention policies. Set limits by backup count, age, or minimum free disk space, and old backups are automatically cleaned up.

TPS-Aware Operation - The plugin monitors your server's TPS and intelligently delays backups if performance drops below your configured threshold. This ensures backups never interfere with gameplay during peak hours or high-load situations.

Fast Compression - Backups are compressed using ZIP format with configurable compression levels (0-9). Balance between speed and file size based on your needs. Typical backups are 30-50% smaller than the original world size.

One-Click Restoration - Restoring from a backup is as simple as running a single command. The plugin handles everything automatically, including server restart, making disaster recovery quick and painless.

Discord Integration - Stay informed with Discord webhook notifications. Get alerts when backups start, complete, or encounter errors, even when you're away from the server.

Comprehensive Management - Full command suite for creating, listing, restoring, and deleting backups. View detailed backup information including size, duration, timestamp, and verification status.

Key Features

✅ Metadata Tracking - Zero server lag during backups ✅ Metadata Tracking - Interval and time-based backups ✅ Metadata Tracking - Auto-cleanup based on count, age, or disk space ✅ Metadata Tracking - Configurable levels (0-9) for optimal size ✅ Metadata Tracking - Pauses during low performance ✅ Metadata Tracking - Real-time backup progress updates ✅ Metadata Tracking - MD5 checksum validation ✅ Metadata Tracking - Real-time notifications ✅ Metadata Tracking - One-command backup recovery ✅ Metadata Tracking - JSON metadata for each backup

Perfect For

- Network Servers - Reliable backups with zero downtime - Network Servers - Frequent backups for testing - Network Servers - Handles multi-gigabyte worlds efficiently - Network Servers - Backs up plugin data and configurations - Network Servers - Configurable for different server sizes

Quick Start

1. Install the plugin in your `plugins/` folder 2. Start your server to generate the default configuration 3. Edit `plugins/AutoBackup/config.yml` to customize settings 4. Run `/backup reload` to apply changes 5. Use `/backup now` to create your first backup 6. Backups will now run automatically based on your schedule

Commands

- `/backup now` - Create an immediate backup - `/backup list` - View all available backups with details - `/backup restore <name>` - Restore from a specific backup - `/backup delete <name>` - Delete a backup manually - `/backup status` - View system status and statistics - `/backup reload` - Reload configuration without restart - `/backup cleanup` - Manually trigger retention cleanup

All commands support tab completion for easy use.

Configuration Highlights

The plugin is highly configurable to fit any server setup:

- Discord Integration - Store backups locally or on external drives - Discord Integration - Backup all worlds or choose specific ones - Discord Integration - Add plugin folders, configs, etc. - Discord Integration - Skip temporary files and caches - Discord Integration - Adjust threads, chunk size, and TPS threshold - Discord Integration - Customize player and console messages - Discord Integration - Configure webhook notifications

Performance

AutoBackup is optimized for servers of all sizes:

- Large Servers (< 1GB): ~30-60 seconds per backup - Large Servers (1-5GB): ~2-5 minutes per backup - Large Servers (5-10GB): ~5-15 minutes per backup

Memory usage is minimal thanks to chunk-based file processing, and CPU usage is configurable through compression level settings.

Requirements

- Disk Space: 1.21 or higher - Disk Space: Paper (not compatible with Spigot/Bukkit) - Disk Space: 21 or higher - Disk Space: At least 2x your world size recommended

Support & Documentation

Need help? Full documentation is included with the plugin. Check the config file for detailed comments on every setting, or use the `/backup status` command to verify your setup.

License

AutoBackup is open-source software released under the MIT License. You're free to use, modify, and distribute it for any purpose.

---

Download AutoBackup today and never worry about losing your server data again!