Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for ferrohd

Cloud Backup Solution

Report ObsidianVault?

โšก ObsidianVault - Automated Cloud Backups

Minecraft Server Storage

๐Ÿ›ก๏ธ Never Lose Your Minecraft World Again!

ObsidianVault is the ultimate backup solution for Minecraft servers. Automatically backup your worlds, plugins, and configurations to secure cloud storage with scheduled backups, instant restores, and enterprise-grade security.

โœจ Key Features

  • ๐Ÿš€ Automated Scheduled Backups - Set it and forget it with cron-based scheduling
  • โ˜๏ธ Secure Cloud Storage - Your backups are stored safely in the cloud with encryption
  • ๐ŸŒ World & Plugin Backups - Backup entire worlds or individual plugins
  • โšก Instant Commands - Create, download, and restore backups with simple commands
  • ๐Ÿ“Š Backup History - Track all your backup versions with detailed history
  • ๐Ÿ”’ Enterprise Security - Client ID/Secret authentication with secure transmission
  • ๐Ÿ’พ 5GB Free Storage - Generous free tier with affordable upgrade options
  • ๐Ÿ”„ Easy Restoration - One-click restore from any backup point
  • ๐Ÿ“ฑ Web Dashboard - Manage your backups from any device
  • โš™๏ธ Flexible Configuration - Customize backup schedules and world selection

๐Ÿš€ Quick Start Guide

1. Installation

  1. Download ObsidianVault.jar
  2. Place it in your server's plugins folder
  3. Restart your server or use /reload confirm
  4. The plugin will generate plugins/ObsidianVault/config.yml

2. Get Your Credentials

  1. Create Account - Visit obsidianvault.io/auth and sign up (5GB free storage)
  2. Access Dashboard - Log into your dashboard
  3. Generate Credentials - Click "Credentials" โ†’ "Generate New Credentials"
  4. Copy Values - Save your Client ID and Client Secret immediately

3. Configure the Plugin

Edit plugins/ObsidianVault/config.yml:

# ObsidianVault Configuration
auth:
  client-id: your-client-id-here      # From your dashboard
  client-secret: your-client-secret-here  # From your dashboard

backup:
  # Daily backups at midnight (cron format)
  cron: "0 0 * * *"
  # Worlds to backup automatically
  worlds:
    - world
    - world_nether
    - world_the_end

After configuration, reload with /reload confirm and start backing up!


๐ŸŽฎ Commands

All commands start with /backup:

Command Description Permission
/backup list List all available backups obsidianvault.backup
/backup create world <name> Create a world backup obsidianvault.backup
/backup create plugin <name> Create a plugin backup obsidianvault.backup
/backup history <type> <name> View backup history obsidianvault.backup
/backup download <type> <name> Get download link obsidianvault.backup
/backup delete <type> <name> Delete a backup obsidianvault.admin
/backup status Check backup operations obsidianvault.backup

Command Examples

# Create a backup of the main world
/backup create world world

# Create a backup of WorldEdit plugin
/backup create plugin WorldEdit

# View all backups for a world
/backup history world survival

# Download the latest backup
/backup download world survival

# Check current operations
/backup status

โฐ Automatic Scheduling

Configure automatic backups using cron expressions:

Schedule Cron Expression Description
Daily at midnight 0 0 * * * Once per day
Every 6 hours 0 */6 * * * 4 times per day
Every 30 minutes */30 * * * * 48 times per day
Weekly (Sunday) 0 0 * * 0 Once per week
Weekdays at 2 AM 0 2 * * 1-5 Monday-Friday

Cron Format: minute hour day-of-month month day-of-week


๐Ÿ”ง Advanced Configuration

Click to expand full configuration options
# ObsidianVault Configuration File

# Authentication settings
auth:
  client-id: your-client-id-here
  client-secret: your-client-secret-here

# Backup configuration
backup:
  # Cron expression for scheduling
  cron: "0 0 * * *"
  
  # List of worlds to include in automated backups
  worlds:
    - world
    - world_nether
    - world_the_end
    - survival
    - creative
  
  # Enable debug logging
  debug: false
  
# Advanced options
storage:
  # Enable compression (recommended)
  compress: true
  
  # Maximum backup retention (days)
  retention-days: 30
  
  # Copy worlds before upload (for large worlds)
  copy-before-upload: true

# Performance settings
performance:
  # Maximum concurrent uploads
  max-uploads: 2
  
  # Upload timeout (seconds)
  timeout: 300
  
  # Chunk size for uploads (MB)
  chunk-size: 50

๐Ÿ” Permissions

Permission Description Default
obsidianvault.backup Access to backup commands op
obsidianvault.admin Administrative commands op
obsidianvault.reload Reload configuration op

๐Ÿ†˜ Troubleshooting

Authentication Failed

Symptoms: "Authentication failed" or "Invalid credentials" errors

Solutions:

  • Verify client-id and client-secret are correct (copy-paste from dashboard)
  • Check for extra spaces or special characters in config.yml
  • Ensure your ObsidianVault account is active
  • Regenerate credentials if needed
  • Test credentials by logging into the web dashboard
Upload Failures

Symptoms: Backups fail to upload or timeout

Solutions:

  • Check server internet connection and DNS resolution
  • Verify you haven't exceeded storage quota (check dashboard)
  • Ensure firewall allows HTTPS connections on port 443
  • Check available disk space on server (need 2x world size temporarily)
  • Increase timeout value in config for large worlds
  • Enable compression to reduce upload size
Large World Issues

Symptoms: OutOfMemory errors or very slow backups

Solutions:

  • Enable copy-before-upload: true in config
  • Increase server memory allocation (-Xmx parameter)
  • Schedule backups during low-activity periods
  • Reduce chunk-size for slower connections
  • Consider backing up worlds individually
  • Enable compression to reduce memory usage

Debug Mode

Enable detailed logging by setting debug: true in config.yml for troubleshooting.


๐Ÿ’Ž Why Choose ObsidianVault?

  • ๐Ÿ”„ Automated & Reliable - Set your schedule and never worry about manual backups
  • โ˜๏ธ Cloud-First Design - Your data is safe even if your server hardware fails
  • ๐Ÿš€ Performance Optimized - Minimal impact on server performance during backups
  • ๐Ÿ’ฐ Cost-Effective - 5GB free storage with affordable premium plans
  • ๐Ÿ›ก๏ธ Enterprise Security - Your backups are encrypted and secure
  • ๐Ÿ“ฑ Easy Management - Web dashboard for backup management from anywhere

๐Ÿ“ž Support & Resources


๐Ÿ”’ Protect Your Server Today!

Join thousands of server administrators who trust ObsidianVault to protect their precious Minecraft worlds. Download now and never lose your server data again!

ObsidianVault is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.

Information

CategoryAdmin Tools
Published onJune 13, 2025
LicenseUnspecified
Downloads3
Stars1
Watchers0
Addon

Pinned Versions

ObsidianVault

Members

Avatar for ferrohd

ferrohd

Owner