🌟 What is VeloBackup?

VeloBackup is a lightweight backup plugin built exclusively for Velocity Minecraft proxy servers. It securely saves your proxy configuration and plugins directly to your own Google Drive, with zero complex setup.

Link your account once with a short code, pick an interval, and your proxy protects itself around the clock.

✨ Features

• ☁️ Direct Cloud Uploads: Automatically compresses and sends backup zip files straight to a dedicated velobackup folder on your Google Drive.
• 🧹 Smart Storage Cleanup: Automatically deletes older backups so your Google Drive never runs out of space.
• 🔗 Simple Device Linking: Headless-friendly quick code verification. No public IP or web server needed.
• ⚡ Instant Manual Control: Trigger a backup whenever you want, from the console or in-game chat.
• ⏱️ Automated Scheduling: Set custom backup intervals so your server protects itself automatically.
• 🔒 Your Data Stays Yours: Fully self-hosted. Files go straight to your own Drive, and login tokens are stored locally on your server.

📋 Requirements

📦 Installation

1. Download the velobackup-1.0.0.jar plugin file.
2. Drop it into your Velocity plugins folder.
3. Start or restart your Velocity proxy to generate the default configuration files.

🔑 Linking Your Google Drive

1. Run /link-drive in your server console or in-game chat.
2. Find your unique User Code and Verification URL in the console output.
3. Open the link in any browser, enter your code, and sign in with your Google account.

Note: Because this is a private plugin, Google may show an unverified app warning page. Click Advanced, then Go to VeloBackup (unsafe) to finish linking.

🎮 Commands

⚙️ Configuration

After the first start, open plugins/velobackup/ and edit the config:

• Backup Interval: How often the server automatically creates and uploads backups in the background.
• Retention Limit: How many past backups to keep on Google Drive before older ones are automatically purged.

🔧 Troubleshooting & Tips

• Re-linking: Changed Google accounts or revoked access? Run /link-drive again to generate a new token.
• Console logs: Watch your Velocity console output to verify a successful upload or diagnose a path issue.

🔒 Privacy

• VeloBackup does not send your data to any developer-owned server or third party.
• Your OAuth refresh token is stored only on your own server, in the plugin's data folder.
• The plugin only accesses files and folders it created itself on your Google Drive. It cannot view or modify your other files.
• The project is open source, so you can audit exactly how requests and credentials are handled.

⚠️ Disclaimer

VeloBackup is provided "as is" under the MIT License. Server owners are responsible for securing their own server, Google account and backup folder. The authors are not responsible for leaked, lost or corrupted files, or for issues caused by modified or unofficial builds.

🔗 Links

• 💻 Source code & full README: https://github.com/HectorAX6/VeloBackup
• 🐛 Report a bug / request a feature: https://github.com/HectorAX6/VeloBackup/issues