存档时光机

存档时光机

此模组作为连接强大的MineBackup桌面应用与Minecraft的桥梁。它让你无需离开游戏即可享受MineBackup带来的所有便利。只需一条命令，即可备份和恢复你的存档！

游戏机制

Forge 版本 Fabric 版本 Neoforge 版本 许可证 English README

⚠️ 重要提示：这是一个附属模组！

请注意：本模组是 MineBackup 桌面应用程序 或 FolderRewind 的配套组件，无法独立运行。你必须先下载并运行主应用程序，本模组才能正常工作。

此外，为了实现进程间通信，你需要在电脑上安装 KnotLink 服务器。https://github.com/KnotLink-Protocol/KnotLinkService/releases

✅ 支持专用服务器

MineBackup 现在支持在专用服务器上进行热恢复，而不仅仅是在单人游戏或局域网中。当你在专用服务器上运行 /mb restore 时，模组会安全地保存世界，将控制权移交给捆绑的“重启伴生程序”，并在恢复完成后通过你自己的启动脚本重启服务器。设置详情请参阅下文 专用服务器恢复。

如果你运行的是 Spigot/Paper 服务器，请改用 MineBackupPlugin，它为 Bukkit 系列提供了相同的恢复流程。

➡️ 在此处下载必需的 MineBackup 桌面应用程序

对于 Windows 用户，我们推荐使用 FolderRewind 搭配 MineRewind 插件，而不是独立的 MineBackup 桌面应用。

这是什么？

这个轻量级模组是 MineBackup 桌面应用程序（或 FolderRewind）与 Minecraft 本身之间的桥梁。它让你无需离开游戏即可管理存档、触发恢复，并随时了解备份状态。

✨ 本模组提供：

  • 丰富的游戏内命令：使用 /mb 命令系列直接从聊天栏管理世界存档——备份、恢复、浏览历史记录以及计划自动备份。
  • 交互式备份浏览器：/mb list backups current 可在聊天栏中分页浏览当前世界的备份，显示时间戳和注释（自动从标准备份文件名中解析），每个条目旁边都有一个可点击的 [恢复] 按钮。
  • 恢复安全倒计时：在实际执行恢复之前，MineBackup 会进行可配置秒数的倒计时。使用 /mb stop 取消，或使用 /mb confirm 跳过倒计时并立即恢复。
  • 完整的专用服务器支持：备份、恢复和浏览在专用服务器上的工作方式与在单人游戏中完全相同，通过捆绑的重启伴生程序进行协调（见下文）。
  • 实时备份通知：在游戏聊天中实时接收来自主应用程序的消息——无论是备份开始、成功还是失败。
  • 无缝实时备份支持：当主应用程序需要执行“实时备份”（即游戏运行时）时，本模组会在后台自动触发一次安全、完整的游戏世界保存（相当于 /save-all），确保你的备份始终包含最新的进度。
  • FolderRewind 触发的恢复：如果你使用 FolderRewind 自己的界面选择备份，它可以直接向本模组发送信号，在游戏中启动相同的热恢复流程，使两个控制界面保持同步。

🖥️ 支持版本

加载器 Minecraft 版本 映射
Fabric 1.21 – 1.21.8 Yarn
Fabric 1.21.9 – 1.21.11 Mojang（官方）
Fabric 26.1 – 26.1.2 Mojang（未混淆）
Fabric 26.2 Mojang（未混淆）
NeoForge 1.21 – 1.21.8 Parchment
NeoForge 26.1 – 26.1.2 Mojang（未混淆）
Forge 1.20 – 1.20.4 Mojang（官方）

🚀 安装指南

  1. 下载主应用程序：确保你已从上方链接下载了 MineBackup/FolderRewind 桌面应用程序，并且它能在你的系统上正常运行。
  2. 下载 MineRewind 插件：如果你使用 FolderRewind，强烈建议安装 MineRewind 插件，并创建 Minecraft Saves 类型的配置，而不是 Default。你可以从 GitHub Releases 下载此插件。
  3. 下载并安装 KnotLink 服务器：为了实现进程间通信，请在你的电脑上安装 KnotLink 服务器。你可以从 GitHub Releases 下载。
  4. 在主应用程序中启用 KnotLink 服务：在 MineBackup 中默认启用，但在 FolderRewind 中默认禁用。如果你使用 FolderRewind，请在设置中手动启用它。
  5. 下载本模组：从 Releases 页面或其他模组分发平台获取与你加载器和 Minecraft 版本匹配的 minebackup-x.x.x.jar 文件。
  6. 安装模组：对于单人游戏或局域网游戏，将下载的 .jar 文件放入 Minecraft 客户端的 mods 文件夹。对于专用服务器，将其安装在服务器的 mods 文件夹中；客户端安装是可选的。
  7. 同时运行：启动你的 Minecraft 游戏或服务器。为让模组正常工作，在游戏过程中，你必须在后台运行 MineBackup/FolderRewind 桌面应用程序。
  8. （仅限专用服务器） 确保存在启动脚本，以便恢复完成后自动重启服务器——请参阅 专用服务器恢复。

📖 命令参考

所有命令在多人游戏和专用服务器上都需要管理员/操作员权限。在单人游戏或由客户端托管的局域网世界中，只有世界所有者可以使用——无需授予 OP。大多数参数支持 Tab 补全（配置 ID、文件夹、备份文件名）。

命令 参数 描述
/mb help [命令] 显示通用帮助，或某个命令的详细帮助及示例。
/mb save （无） 在游戏中手动执行一次完整的世界保存，等同于 /save-all。
/mb backup [注释] 备份当前世界。可选注释会附加到备份中。
/mb restore [文件] 恢复当前世界。省略文件名则恢复最新的备份。
/mb confirm （无） 立即提交一个正在倒计时的恢复操作。
/mb stop （无） 取消一个正在倒计时的恢复操作。
/mb target backup <配置ID> <文件夹> [注释] 备份由桌面应用程序管理的特定非当前文件夹。
/mb target restore <配置ID> <文件夹> <文件> 恢复特定的非当前文件夹。在专用服务器上不可用——请使用 /mb restore 恢复当前世界。
/mb list configs （无） 列出所有已配置的备份配置文件及其 ID。
/mb list folders <配置ID> 列出某个配置方案下跟踪的文件夹。
/mb list backups current [页码] 在聊天栏中交互式浏览当前世界的备份，每个条目带有一个可点击的恢复按钮。
/mb list backups <配置ID> <文件夹> 列出特定非当前文件夹的备份文件。
/mb auto start <分钟> 每隔 分钟 分钟自动备份当前世界。
/mb auto stop （无） 停止当前世界的自动备份计划。

💡 用法示例

备份并恢复你当前正在游玩的存档：

  1. 备份当前世界

    • 输入 /mb backup 去打末影龙之前

      聊天栏返回：[MineBackup] 备份任务已启动... （片刻之后） [MineBackup] 备份成功！已保存为 [Full][2026-07-30_12-33-00]world [去打末影龙之前].7z

  2. 浏览并恢复该备份

    • 输入 /mb list backups current 查看分页的、可点击的最近备份列表——或直接输入 /mb restore 恢复最新的备份。
    • 如果配置了恢复倒计时，可使用 /mb confirm 立即恢复，或使用 /mb stop 取消。

通过桌面应用程序的配置管理另一个世界（当前未运行的存档）：

  1. 查找配置和文件夹
    • 输入 /mb list configs 查看你的配置方案。
    • 输入 /mb list folders <配置ID> 查看该方案下的文件夹。
  2. 备份或恢复该文件夹
    • /mb target backup <配置ID> <文件夹> [注释]
    • /mb target restore <配置ID> <文件夹> "<文件名>"（文件名含空格时请加引号；在专用服务器上不可用）

🛠️ 专用服务器恢复

备份和浏览在专用服务器上的工作方式完全相同。但是，恢复需要停止并重新启动 Minecraft 进程——MineBackup 通过捆绑的重启伴生程序自动实现这一点：

  1. 执行 /mb restore 命令时，服务器会保存所有世界并将进程控制权移交给一个小型辅助程序（伴生程序），然后安全关闭。
  2. 伴生程序等待主 JVM 退出且世界文件被释放，然后让 FolderRewind/MineBackup 执行恢复。
  3. 一旦桌面应用程序报告明确成功、失败或取消，伴生程序便会启动你配置的启动脚本（仅一次）并退出。

你需要在服务器的工作目录中准备一个启动脚本。MineBackup 会查找 start.bat、start.cmd、run.bat、run.cmd（Windows）或 start.sh、run.sh（Linux/macOS）中的一个；必须恰好存在一个，或者你可以在 config/minebackup.properties 设置文件中通过 dedicatedRestore.restartScript 指定明确的路径。由于服务器进程会重新启动，玩家在恢复期间会断开连接，并需要在新服务器实例恢复在线后手动重新连接。

如果你使用面板或包装程序在服务器退出时自动重新启动服务器，请禁用该行为（或将其指向一个 MineBackup 不管理的脚本）——即时自动重启可能会与恢复过程竞争，并在世界文件就绪之前启动服务器。设置 dedicatedRestore.mode=DISABLED 可完全关闭专用服务器恢复功能。

❓ 常见问题解答

  • 问：当我使用某个命令时，聊天栏提示"命令失败"、"无响应"或类似的错误。

    • 答： 请检查 MineBackup/FolderRewind 桌面应用程序是否在你的电脑后台运行。本模组的所有功能都依赖于与主应用程序的网络通信。

  • 问：这个模组可以单独使用吗？

    • 答： 不可以。它是一个"桥梁"，没有主应用程序就无法做任何事情。

  • 问：我在专用服务器上进行了恢复，但服务器没有自动恢复上线。

    • 答： 请检查服务器的工作目录中是否存在启动脚本（请参阅 专用服务器恢复）。如果重启脚本本身失败，请修复脚本并手动启动服务器——MineBackup 不会静默重试。

📄 许可证

本项目使用 MIT 许可证。有关详细信息，请访问主项目仓库。