# \ud83d\udee1\ufe0f Ancient-Backup<\/p>\n
**The most advanced backup solution for Minecraft servers**<\/p>\n
\n
\n<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\ude80 **High-Performance Compression**
\n– **ZSTD Compression**: 3-5x faster than traditional ZIP with better compression ratios
\n– **Adjustable Levels**: Balance between speed and file size (0-9)
\n– **Streaming Mode**: Compress and upload simultaneously with zero local disk usage<\/p>\n
### \ud83d\udce4 **Multiple Upload Destinations**
\n– **SFTP** – Secure FTP with SSH encryption (recommended)
\n– **FTPS** – FTP over TLS\/SSL
\n– **OneDrive\/SharePoint** – Microsoft Graph API integration
\n– **Google Drive** – Direct cloud upload support<\/p>\n
### \ud83d\udd04 **Smart Upload Management**
\n– **Parallel Uploads**: Upload to multiple destinations simultaneously
\n– **Resume Support**: Automatically resume interrupted uploads (SFTP\/FTPS)
\n– **Adaptive Throttling**: Reduces backup speed if server TPS drops to prevent lag
\n– **Upload Retry**: Manual `\/abackup uploadlast` command to retry failed uploads<\/p>\n
### \ud83d\udcca **Real-Time Progress Tracking**
\n– **Live Console Output**: See compression and upload progress every 5 seconds
\n– **Discord Webhooks**: Beautiful embeds with progress bars and statistics
\n– **Speed Monitoring**: Real-time MB\/s tracking for uploads and compression<\/p>\n
### \ud83c\udfaf **Advanced Features**
\n– **File Exclusions**: Skip large folders like dynmap tiles or BlueMap renders using glob patterns
\n– **Automatic Retention**: Keep only the last N backups on remote servers
\n– **Flexible Scheduling**: Run backups every X minutes or at specific times daily
\n– **World Save Safety**: Automatically disables auto-save during backups to prevent corruption
\n– **Memory Management**: Automatic RAM cleanup after backups complete
\n– **Staff Notifications**: In-game notifications for players with permission<\/p>\n
### \ud83d\udd12 **Security & Reliability**
\n– **Strict Host Key Checking**: Verify SFTP server fingerprints to prevent MITM attacks
\n– **SSH Key Authentication**: Use private keys instead of passwords
\n– **TLS\/SSL Support**: Encrypted connections for FTPS
\n– **Cancellable Backups**: Stop backups mid-process with `\/abackup cancel`<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Server Software**: Paper\/Spigot\/Bukkit 1.20.6+
\n– **Java**: 21 or higher
\n– **Permissions**: `ancientbackup.admin` for commands, `ancientbackup.notify` for notifications<\/p>\n
—<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### Installation<\/p>\n
1. Download the latest version from Modrinth
\n2. Place the JAR file in your `plugins\/` folder
\n3. Restart your server
\n4. Configure `plugins\/Ancient-Backup\/config.yml`<\/p>\n
### Basic Configuration<\/p>\n
“`yaml
\nbackup:
\n use-zstd: true # Enable ZSTD compression (recommended)
\n zip-level: 1 # 1 = fast, 9 = smallest file<\/p>\n
schedule:
\n enabled: true # Enable automatic backups
\n every-minutes: 360 # Backup every 6 hours<\/p>\n
upload:
\n sftp:
\n enabled: true
\n host: “your-server.com”
\n port: 22
\n username: “backup-user”
\n password: “your-password”
\n remote-folder: “\/backups\/minecraft”
\n“`<\/p>\n
### First Backup<\/p>\n
Run your first backup with:
\n“`
\n\/abackup start
\n“`<\/p>\n
Check status with:
\n“`
\n\/abackup status
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udce6 Commands<\/p>\n
| Command | Permission | Description |
\n|———|———–|————-|
\n| `\/abackup start` | `ancientbackup.admin` | Start a new backup |
\n| `\/abackup cancel` | `ancientbackup.admin` | Cancel the running backup |
\n| `\/abackup status` | `ancientbackup.admin` | Check backup progress |
\n| `\/abackup uploadlast` | `ancientbackup.admin` | Retry uploading the last backup |
\n| `\/abackup reload` | `ancientbackup.admin` | Reload configuration |<\/p>\n
—<\/p>\n
## \ud83c\udfa8 Discord Integration<\/p>\n
Get beautiful real-time updates in Discord:<\/p>\n
“`yaml
\ndiscord:
\n enabled: true
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/…”
\n notifications:
\n on-backup-start: true
\n on-zip-complete: true
\n on-upload-start: true
\n on-upload-complete: true
\n on-backup-complete: true
\n“`<\/p>\n
**Features:**
\n– \ud83d\udcca Color-coded embeds for different phases
\n– \ud83d\udcc8 Visual progress bars
\n– \u26a1 Real-time speed and ETA
\n– \ud83c\udfaf Step-by-step progress tracking (1\/5, 2\/5, etc.)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Advanced Configuration<\/p>\n
### File Exclusions<\/p>\n
Exclude large folders to reduce backup size:<\/p>\n
“`yaml
\nbackup:
\n exclude:
\n – “logs\/*.gz”
\n – “logs\/*.log.*”
\n – “plugins\/dynmap\/web\/tiles\/**”
\n – “plugins\/BlueMap\/web\/**”
\n – “**\/cache\/**”
\n“`<\/p>\n
### Streaming Mode<\/p>\n
Compress and upload simultaneously (no local file):<\/p>\n
“`yaml
\nupload:
\n streaming-compression: true # Requires SFTP or FTPS
\n“`<\/p>\n
**Benefits:**
\n– \u26a1 Faster overall backup time
\n– \ud83d\udcbe No local disk space usage
\n– \ud83d\udd04 Real-time progress updates<\/p>\n
**Limitations:**
\n– \u26a0\ufe0f Retention policies not supported in streaming mode
\n– \ud83d\udccd Requires SFTP or FTPS destination<\/p>\n
### Performance Tuning<\/p>\n
Optimize for your server:<\/p>\n
“`yaml
\nperformance:
\n max-memory-mb: 512 # Maximum RAM usage
\n max-buffer-kb: 8192 # Buffer size for compression
\n gc-after-zip: true # Free memory after compression
\n cleanup-after-backup: true # Full memory cleanup
\n tps-threshold: 18.0 # Slow down if TPS drops below this
\n“`<\/p>\n
### Retention Policies<\/p>\n
Automatically delete old backups:<\/p>\n
“`yaml
\nretention:
\n enabled: true
\n keep-last: 7 # Keep only the last 7 backups
\n filename-prefix: “backup-” # Filter files by prefix
\n filename-suffix: “.tar.zst” # Filter files by extension
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd10 SSH Key Authentication<\/p>\n
For enhanced security, use SSH keys instead of passwords:<\/p>\n
1. Generate an SSH key:
\n “`bash
\n ssh-keygen -t ed25519 -f ~\/.ssh\/minecraft_backup
\n “`<\/p>\n
2. Add the public key to your server:
\n “`bash
\n ssh-copy-id -i ~\/.ssh\/minecraft_backup.pub user@your-server.com
\n “`<\/p>\n
3. Configure Ancient-Backup:
\n “`yaml
\n sftp:
\n private-key-path: “plugins\/Ancient-Backup\/minecraft_backup”
\n password: “” # Leave empty when using key auth
\n “`<\/p>\n
—<\/p>\n
## \ud83d\udcca Performance<\/p>\n
### Benchmark Results<\/p>\n
Tested on a 10GB Minecraft server with Paper 1.21.10:<\/p>\n
| Method | Time | CPU Usage | Disk I\/O |
\n|——–|——|———–|———-|
\n| **ZSTD Level 1** | 2m 15s | Low | Minimal |
\n| **ZIP Level 1** | 6m 30s | Medium | Medium |
\n| **ZIP Level 9** | 12m 45s | High | High |<\/p>\n
**Streaming Mode:** Reduces total backup time by 30-40% compared to traditional mode.<\/p>\n
—<\/p>\n
## \ud83d\udc1b Troubleshooting<\/p>\n
### No progress output?
\n– Ensure you’re using the latest version
\n– Check that your upload destination is properly configured
\n– Look for error messages in the console<\/p>\n
### Upload fails?
\n– Use `\/abackup uploadlast` to retry
\n– Check network connectivity and credentials
\n– Enable debug logging in config.yml<\/p>\n
### Server lags during backup?
\n– Lower `performance.max-buffer-kb` to reduce memory usage
\n– Reduce `backup.zip-level` to use less CPU
\n– Set `performance.tps-threshold` higher to trigger throttling sooner<\/p>\n
### Discord notifications not working?
\n– Verify webhook URL is correct
\n– Test webhook manually using curl or online tools
\n– Check that `discord.enabled: true`<\/p>\n
—<\/p>\n
## \ud83e\udd1d Support<\/p>\n
– **Issues**: GitHub Issues
\n– **Discord**: Join our Discord Server
\n– **Documentation**: Wiki<\/p>\n
—<\/p>\n
## \ud83d\udcdd License<\/p>\n
This plugin is released under the MIT License. See [LICENSE](LICENSE) for details.<\/p>\n
—<\/p>\n
## \u2b50 Support the Project<\/p>\n
If you find Ancient-Backup useful, please consider:
\n– \u2b50 Starring the project on GitHub
\n– \ud83d\udce2 Sharing it with other server owners
\n– \ud83d\udcac Leaving a review on Modrinth
\n– \u2615 Supporting development<\/p>\n
—<\/p>\n
**Made with \u2764\ufe0f for the Minecraft community**<\/p>\n","protected":false},"excerpt":{"rendered":"
A all-in-one backup system for your minecraft server!<\/p>\n","protected":false},"featured_media":14117,"template":"","meta":{"_minecraft_slug":"ancient-backup","_minecraft_project_id":"IvgTLMRU","_minecraft_author":"mysticalcraft-ancientvipers","_minecraft_license":"MIT","_minecraft_downloads":107,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ancient-backup.zip","_minecraft_size_bytes":74849598,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:37:12.953183Z","_minecraft_date_created":"2025-12-14T00:28:11.617705Z","_minecraft_date_modified":"2026-01-04T10:59:30.303463Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ancient-backup","_minecraft_icon_attachment_id":14117,"_minecraft_imported_at":"2026-05-31T17:48:31+00:00","_minecraft_import_hash":"4d968b08901b29ee21eeb42f3ad65632","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,90,127,128,129,91,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-14116","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n