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 ✅ **Async Processing** - Zero server lag during backups ✅ **Automatic Scheduling** - Interval and time-based backups ✅ **Smart Retention** - Auto-cleanup based on count, age, or disk space ✅ **ZIP Compression** - Configurable levels (0-9) for optimal size ✅ **TPS Monitoring** - Pauses during low performance ✅ **Progress Tracking** - Real-time backup progress updates ✅ **Backup Verification** - MD5 checksum validation ✅ **Discord Webhooks** - Real-time notifications ✅ **Easy Restoration** - One-command backup recovery ✅ **Metadata Tracking** - JSON metadata for each backup ## Perfect For - **Production Servers** - Reliable backups with zero downtime - **Development Servers** - Frequent backups for testing - **Large Worlds** - Handles multi-gigabyte worlds efficiently - **Modded 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: - **Backup Location** - Store backups locally or on external drives - **World Selection** - Backup all worlds or choose specific ones - **Include Directories** - Add plugin folders, configs, etc. - **Exclude Patterns** - Skip temporary files and caches - **Performance Tuning** - Adjust threads, chunk size, and TPS threshold - **Notification Settings** - Customize player and console messages - **Discord Integration** - Configure webhook notifications ## Performance AutoBackup is optimized for servers of all sizes: - **Small Servers** (< 1GB): ~30-60 seconds per backup - **Medium 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 - **Minecraft Version**: 1.21 or higher - **Server Software**: Paper (not compatible with Spigot/Bukkit) - **Java Version**: 21 or higher - **Disk Space**: At least 2x your world size recommended ## Suppo