Yueyue Quick Backup

By Yisibite, 1.1.8+mc26.3, for local singleplayer worlds on Minecraft 26.3 Fabric. Open the pause menu to create, name, replace or delete restore points, browse backups and restore the latest or a selected snapshot.

Backups and management

Incremental mode hashes files and reuses unchanged file content. Every snapshot has a complete manifest and does not depend on a chain of earlier restore points; changed region files are stored as whole files. Full mode stores an independent copy. The first incremental backup captures the complete saved world.

World saving is flushed before capture. Backups cover the saved world directory, all dimensions and saved player data, including world-stored mod data. Supported Carpet fake-player state is additionally captured and restored, including inventories, equipment, ender chest, profile, effects, supported action state/progress, cooldowns and riding state. Without Carpet, ordinary world backups still work.

Name backups at creation or rename them later (1–64 characters). Replace a selected backup using the name currently entered; switching replacement mode or target, or resizing the window, preserves that entered name. The confirmation shows both the old target and the new name. Single and batch deletion require confirmation; selections can span pages. Deletion removes the selected records and unreferenced incremental objects, preserving objects still shared by remaining backups. Renaming does not rename the world directory.

Restoration and protection

Restore and Quick-load previous backup both show a confirmation with the native checkbox 创建读档前保护副本 (“Create a pre-restore protective backup”). It starts checked each time a new confirmation opens. Click to toggle; resizing/rebuilding the screen preserves the current choice, while cancelling and reopening starts checked again.

When checked, restoration first captures an incremental protective backup of the current world. Unchecking skips only that extra catalogued snapshot. Content verification, mutual exclusion/file locks, the temporary transaction rollback directory and interrupted-restore recovery still run. The backup is validated and materialized before the world directory is exchanged; the old directory is retained until restoration, fake-player restoration and synchronized saving finish. Uncertain interrupted transactions preserve recovery material and report the problem.

Quick-load selects the current world's latest complete backup, including pre-restore protective snapshots. With protection enabled, repeated quick-load can therefore switch back to the state captured before the preceding restore.

Backups are stored in the instance's quick-backups, separately from saves; there is no automatic expiration. Local singleplayer only: LAN-published worlds and remote servers are unsupported. Saving/copying large worlds can pause simulation. Keep independent full backups of important worlds; supported checks and tested recovery paths do not guarantee every hardware or software failure.

中文介绍与完整操作说明

月月备份mod 1.1.8+mc26.3用于未开放局域网的本地单人世界。进入世界后按 Esc → 备份管理还原点，也可使用 快速读档上一个备份。不依赖月月区块编辑器、现代科技或投影扩展。

1. 建立备份：默认增量，首份仍保存完整世界。输入 1～64 字符名称，选择增量或全量后创建；备份前会同步保存世界，并在同一服务端任务中捕获状态、刷新和复制文件。增量按文件内容 SHA256 去重，每份有完整文件清单，不依赖之前的备份组成恢复链；变化的 region 文件整文件保存。全量独立复制整份世界，不依赖增量对象库。
2. 范围与耗时：包括全部维度、区块 / 实体 / POI、计划刻、世界数据、规则、模组保存在世界中的数据与已保存玩家 NBT；不复制 session.lock。兼容 Carpet 时额外保存支持的假人背包、末影箱、状态、皮肤资料、动作及进度、冷却与骑乘等信息，读档时恢复。没有 Carpet 仍能做普通备份。保存和复制期间会暂停模拟，界面显示进度，大世界和首次备份可能耗时较长。
3. 命名与替换：可重命名已有备份；替换使用名称输入框里当前的新名称，切换替换模式、目标或调整窗口大小不会将它覆盖。确认框同时列出旧目标名与新名称；确认替换会改写该还原点内容，其他备份仍可独立恢复。重命名不会改存档目录名或创建时间。
4. 删除：支持单个、跨页多选和全选批量删除，均先显示确认框。取消不改备份或选择；确认后只删除选中记录，并清理不再被引用的增量对象，不删除其他备份仍在使用的共享内容。删除备份不修改正在玩的世界。
5. 选择读档保护：点某行 恢复，或点 快速读档上一个备份，先看确认框。文字下方的原版复选框 创建读档前保护副本每次新打开都默认勾选，左键一次取消、再一次勾选；缩放或控件重建保留当前选择，取消后重开恢复默认勾选。
6. 确认恢复：勾选时先建立一份增量保护备份，再关闭当前世界、校验并还原备份、重新打开世界。取消勾选只跳过这份额外留在列表中的保护备份，内容校验、互斥和文件锁、还原事务临时回滚目录、中断恢复仍然执行。损坏内容会拒绝替换；旧目录在恢复完成前保留，状态不明时保留恢复材料并提示，不会因为取消勾选就关闭事务保护。
7. 快速读档：取当前世界最新完整记录，也包括自动保护备份。勾选保护时，连续使用可能切回上次读档前的状态；需要固定还原点时，请在列表明确选择。

备份位于实例 quick-backups，与 saves 分开保存，不自动按时间清理。仅本地单人且未开放局域网可用，客户端不能给远程服务器做完整备份。重要世界建议另存独立全量备份；已测试的校验与进程中断恢复不等于覆盖所有软硬件故障或真实断电。

Requirements / 运行要求

Minecraft 26.3, Java 25, Fabric Loader 0.19.5+ and Fabric API. Fabric Carpet is optional for supported fake-player state. Client-side local singleplayer only. Complete corresponding source and build instructions are attached separately; install the runnable JAR, not the source attachment.

中文：Fabric API 是必需前置，Fabric Carpet 是假人状态联动的可选前置。生产模组不要求安装测试驱动或其它月月模组。源码包内编译依赖准备按随附说明执行。

Credits and references / 致谢、参考与许可

Original implementation by Yisibite, with AI assistance; original code is MIT. Interoperates with Fabric Carpet by gnembon and contributors (MIT), a separate optional mod. Minecraft saving/NBT are game APIs. The backup implementation is maintained in this project; these references describe API/state interoperability.

• Fabric Carpet: Optional API/state interoperability (MIT).
• Minecraft: Game API/world formats; not relicensed.

Upstream APIs and names retain their original rights; see REFERENCES.md and THIRD_PARTY_NOTICES.md in the source archive. 中文：原创实现为 Yisibite 制作，使用 AI 辅助；Carpet 和 Minecraft 等上游代码、接口、名称与世界格式各自保留原有权利，不因本项目 MIT 标识而重新授权。