AR1 Backup

AR1 Backup is a simple and reliable Fabric mod for manual or automatic backup of your Minecraft worlds. Forget about sudden crashes, corrupted chunks, or failed experiments — the mod takes care of your data integrity.

Key Features

• Automatic Backups – configurable interval from 1 to 120 minutes.
• Manual Creation – via /backup start command or the F7 hotkey (rebindable in controls).
• Flexible Storage – default game folder or any custom absolute/relative path.
• Smart Cleanup – by backup count limit (5–30) and retention time (1–30 days).
• Free Space Check – prevents backups when disk space falls below a configurable threshold (1–10 GB).
• World Restore – /backup restore command with automatic archive structure detection. Restore rewrite flag -r – /backup restore <filename> -r automatically overwrites an existing world folder during restore. Without -r, the command will show an error if the folder already exists.
• Multi-threaded Compression – adjustable compression level (0–9) and thread count (1–8).
• Progress Bars – animated indicators displayed in ActionBar or Subtitle.
• Password-protected Archives – create encrypted ZIP backups with AES‑256.
  Passwords are stored outside the game folder and automatically matched to archives during restoration.
• Developer Tools – optional detailed logging, per‑file technical information, and export of logs to a user‑specified file.
• Automatic Recovery – corrupted or unreadable config files are regenerated with default values without crashing the game.
• Full Command Set – complete management via commands.
• Graphical Interface – integrated with ModMenu and Cloth Config.
• Info Panel – in the settings screen, shows CPU model, cores, OS, Java version, free disk space, and backup statistics.
• Localization – fully translated into 14 languages (see below).
• More reliable backups (compared to competitors) — guarantees the complete preservation of all world data (including player inventories, statistics, and achievements) prior to archiving.

Password Protection

When the ZIP with password archive method is selected, backups are encrypted with AES‑256.
The password is not stored in the game folder or configuration file.

Where passwords are stored:

• Default location: Documents\AR1 Backup PASSWORDS\passwords.json
• Fallback location: C:\AR1 Backup PASSWORDS\passwords.json

The file contains:

• the currently active password,
• full history of previously used passwords,
• mapping between each archive and the password used to create it.

Important warning: If the password file is deleted and you do not remember the password, encrypted backups cannot be restored. If you accidentally delete the folder, check the Recycle Bin first. If it is not there, use file recovery software (e.g., Recuva). Always keep a safe copy of your passwords in a secure place.

Localization

The mod is fully translated into 14 languages:

Commands

All commands use the /backup prefix:

Configuration

All settings are available through the graphical interface (ModMenu) or manually in config/ar1-backup.toml:

• Enable/disable auto‑backup
• Backup interval (1–120 minutes)
• Backup limit (5–30 files)
• Retention days (0–30, 0 = disabled)
• ZIP compression level (0–9)
• Backup thread priority (1–10)
• Compression threads (1–8)
• Wrap in world folder (on/off)
• Storage mode (game folder / custom path)
• Show backup progress (on/off)
• Progress display type (ActionBar / Subtitle)
• Confirm deletion (on/off)
• Free space check threshold (1–10 GB)
• Archive method (ZIP / ZIP with password)
• Password (only for password method)
• Developer settings: detailed logging, per‑file technical info, save debug log, custom log path

Installation

1. Install Fabric Loader.
2. Place dependencies in the mods folder:
   • Fabric API
   • Cloth Config API
   • ModMenu (recommended)
3. Copy the ar1-backup-<version>.jar into the mods folder.

Developed by ar1emq – a member of THEMIDNIGHTCORE