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 -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: | Country | Language | Name | Code | |---------|----------|------|------| | 🇷🇺 | Russian | Русский | `ru_ru` | | 🇺🇸 | English | English | `en_us` | | 🇩🇪 | German | Deutsch | `de_de` | | 🇪🇸 | Spanish | Español | `es_es` | | 🇵🇱 | Polish | Polski | `pl_pl` | | 🇺🇦 | Ukrainian | Українська | `uk_ua` | | 🇧🇾 | Belarusian | Беларуская | `be_by` | | 🇫🇷 | French | Français | `fr_fr` | | 🇧🇬 | Bulgarian | Български | `bg_bg` | | 🇨🇿 | Czech | Čeština | `cs_cz` | | 🇯🇵 | Japanese | 日本語 | `ja_jp` | | 🇰🇿 | Kazakh | Қазақша | `kk_kz` | | 🇮🇳 | Hindi | हिन्दी | `hi_in` | | 🇨🇳 | Chinese (Simplified) | 简体中文 | `zh_cn` | --- ## Commands All commands use the `/backup` prefix: | Command | Description | |---------|-------------| | `start` | Create a backup immediately | | `restore ` | Restore a world from a backup archive | | `restore -r` | Restore and overwrite if folder exists | | `delete last` | Delete the most recent backup | | `delete all` | Delete all backups | | `delete all ` | Delete backups on a specific drive | | `delete confirm` | Confirm a pending deletion | | `list` | List all backups grouped by drive with sizes | | `info ` | Show detailed info about a backup | | `reset` | Interrupt the current backup process | | `path game` | Switch storage to the game directory | | `path set ` | Set a custom backup path | | `path show` | Display the current storage mode and path | --- ## 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-.jar` into the `mods` folder. --- Developed by **ar1emq** – a member of **THEMIDNIGHTCORE**