AR1 Backup v11.0.0

A large-scale update focused on improving save reliability, protecting against data loss, and completely reworking the user interface to make interaction better.

Safety and Data Integrity

• Data protection during world overwrite (Rewrite): if a failure occurs while extracting the archive, the old world will not be permanently deleted. The mod will move it to a backup directory and restore it to its original state if an error occurs.
• Protection against malicious archives: protection against Zip-bomb attacks (RAM and disk space exhaustion) and Zip-slip (writing files outside the target directory) has been implemented.
• Race conditions eliminated: hangs and parallel launches of multiple backup processes during rapid UI interaction or command use are now prevented.
• Password database protection: if the passwords.json file is corrupted, it will be moved to quarantine, preventing irreversible loss of password history. The password is written to the database before the archiving process begins.
• PC change identification: when transferring the build to another computer, the mod will detect the user account change and initiate a telemetry settings reset, allowing the new owner to provide consent.
• Correct autosave behavior: the mod will not force-enable world autosave if it was disabled by the user before the operation began. The settings state is restored to its original position.

Archiving and Snapshot Verification

• World snapshot verification: the default mode is Rebuild (RETRY). This prevents item duplication and desynchronization if the world changes during archiving. Backup creation may take longer, but data integrity is guaranteed.
• Fixed false verification positives: files modified after they have already been read are no longer detected as mismatches.
• Active process protection: an archive currently being written is marked with the corresponding status. Its deletion, restoration, or addition to favorites is blocked until the operation completes. The Delete All function skips active files.
• Fixed name collision: if two archives are created in the same second, a suffix (_1, _2) is added to the name, preventing overwriting of an existing file.
• Removed the "Compression threads" setting: the parameter was not used in the code. Chunk files (.mca) are saved without recompression because they are already compressed by the game.

Interface and Usability (GUI)

• Smart recommendations: an interactive tips panel has been added to the lower-left corner of the screen. The mod analyzes the state and suggests solutions (enabling auto-backup, deleting corrupted archives, changing a dangerous save path, or insufficient space). Recommendations are switched using navigation buttons with smooth animation.
• GUI settings screen: a separate scrollable menu. It allows you to manage outline animations, search field visibility, background blur, and compact list mode.
• Compact list mode: reduces tile height and icon size, allowing more archives to be displayed on screen.
• Latest backup indication: the newest archive is highlighted with a lighter background and the corresponding status. An actively creating archive is not counted when determining the latest one.
• Colored timestamps: the deletion, restoration, and mass deletion windows display the exact archive creation time with color formatting similar to the list tiles.
• Streamer mode: the feature hides chat notifications and progress bars while recording the screen.
• Long name handling: world names scroll smoothly without overlapping status elements (such as protection or deletion badges).
• Version display: the current mod version is displayed in the upper-right corner of the screen.
• Localization: the interface has been fully translated into 14 languages. All text data has been moved to language files.

Progress and HUD

• Accurate progress calculation: fixed progress calculation for large files in the HUD. Previously, progress was based on file count, which caused incorrect display when processing one large file (the bar filled instantly). Now calculation is based on bytes actually read.
• HUD color statuses: during backup creation, the widget grid has a rainbow coloring; during restoration, it is yellow. On successful completion — green; on error — red.
• Restore cancellation: a cancel button (X in the corner of the window) has been added, appearing 10 seconds after the process starts.
• Instant backup interruption: the /backup reset command interrupts the process in milliseconds. The widget displays the cancellation status, and the partial archive is immediately deleted.
• Correct text wrapping: in restore windows, long world names wrap to a new line and do not go beyond the window.

Config Changes

• backupLimit: 5–100, default 30.
• backupRetentionDays: 0–60, default 30.
• restoreWorldSuffix: default false.
• saveBackupsInWorldFolders: default true.
• snapshotCheckMode: default RETRY.
• New "Appearance" category: added after "Advanced".
• Settings order: toggles, sliders, enums, and buttons.
• New fields: guiCompactList, guiAnimationsEnabled, guiShowLegend, guiShowSearch, guiTitleFooter, guiShowBadges, guiBackgroundBlur.
• Service field: uniqueInstallation (encrypted account identifier for PC change detection).

Other Fixes and Optimizations

• Safe directory deletion: during recursive deletion, the mod does not keep all paths in RAM, preventing out-of-memory (OOM) errors when processing large worlds.
• Directory scanning: fixed a game crash when attempting to read Windows system folders (for example, C:\Windows\CSC).
• Log stability: fixed loss of trailing arguments during message formatting. WARN and ERROR level entries are always output to the console.
• Number formatting: all values use Locale.ROOT, ensuring correct display (with a dot instead of a comma) regardless of the system locale.
• Thread error handling: background task and scheduler launches are protected from unhandled exceptions.
• Symlink ignoring: when collecting files and calculating directory size, symlinks are not traversed.
• List sorting: archives are sorted by the date from the filename, not by the last modified date.
• Safe reset: the /backup reset command does not delete the file if the archiving thread is still running.
• Code optimization: overall stability has been improved.

Important Notes

• The mod is developed and tested primarily for Windows. Operation on Linux and macOS may not be fully verified.
• The mod may work on mobile launchers (such as Pojav, Zalith, or FoldCraft), but there are no guarantees of flawless operation in some usage scenarios.