Cloud backup and sync mod for Minecraft single-player worlds. Store worlds on Dropbox or Yandex.Disk, restore across devices, and prevent save loss.

Features

• Automatic world backup to cloud storage on world exit
• Scheduled backups at fixed intervals
• Multi-device world synchronization with conflict detection
• Full and incremental backup modes
• Offline queue: backups queued on network failure, auto-pushed on reconnect
• World-level locking: prevents concurrent edits from multiple devices
• Backup history with configurable retention policy

Supported Loaders

• Fabric
• NeoForge

Configuration

Fabric: Open Mod Menu (if installed) and select Cloudz to access settings.

NeoForge: Open the mod browser and select Cloudz config.

Manual: Edit config/cloudz.json directly:

{
  "activeProvider": "DROPBOX",
  "backupType": "FULL",
  "autoBackupOnExit": true,
  "timedBackupEnabled": false,
  "timedBackupIntervalMinutes": 30,
  "maxBackupVersions": 1,
  "keepDailySnapshots": false,
  "deviceLabel": "My PC",
  "lockTtlMinutes": 120
}

Settings:

• activeProvider: DROPBOX or YANDEX
• backupType: FULL or INCREMENTAL
• autoBackupOnExit: Trigger backup when leaving a world
• timedBackupEnabled: Enable periodic backups
• timedBackupIntervalMinutes: Interval between backups (5-1440 min)
• maxBackupVersions: Keep only N recent backups per world (1-100)
• keepDailySnapshots: Preserve one snapshot per day regardless of retention
• deviceLabel: Human-readable device name (shown in sync UI)
• lockTtlMinutes: Expire device lock after N minutes (30-1440)

Usage

1. Install the mod
2. Launch Minecraft, open the Cloudz screen
3. Select provider (Dropbox or Yandex.Disk) and authenticate
4. Toggle features on/off as needed
5. Backups run automatically on world exit

Architecture

Push (atomic):

1. Zip world directory
2. Upload to temporary staging file
3. Verify checksum
4. Rename to final timestamped name
5. Update manifest
6. Apply retention policy

Pull (atomic):

1. Download backup to temp directory
2. Verify checksum
3. Rename current world to .bak
4. Move downloaded backup into place
5. Clean up .bak on success; restore on failure

Key dependencies:

• Minecraft 1.21.4 with Java 21+
• Architectury 15.0.3 (cross-platform modding)
• Fabric Loader 0.19.3 / NeoForge 21.4.155
• Cloth Config 17.0.144 (in-game configuration menu)

Note: No heavy external libraries. Uses Java 21 HttpClient and Gson (built-in).