MineBackup

模组

· 作者 Leafuke

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

0 本站下载 0 关注 更新于 3 周前

需要前置:Fabric API

最新 3.4.1 · 26.3 · Fabric

一键开服(送7天)

⚠️ 重要提示:这是一个配套模组!

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

此外,为了实现正确的进程间通信,您的计算机上必须安装 KnotLink 服务器。

✅ 支持专用服务器

MineBackup 现在支持在专用服务器上实现热还原,不仅限于单人/LAN 模式。当您在专用服务器上运行 /mb restore 时,模组会安全地保存世界数据,将控制权移交至内置的重启旁路(sidecar),并在还原完成后通过您自己的启动脚本重启服务器。有关设置详情,请参阅下方的 专用服务器还原。

如果您使用的是 Spigot/Paper 服务器,请使用 MineBackupPlugin,它为 Bukkit 系列服务器提供了相同的还原流程。

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

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


这是什么?

这个轻量级模组充当了 MineBackup 桌面应用程序(或 FolderRewind)与 Minecraft 本身之间的桥梁。它让您无需离开游戏即可管理存档、触发还原并随时了解备份状态。

✨ 本模组提供:

  • 丰富的游戏内命令:使用 /mb 命令系列直接在聊天中管理世界存档——备份、还原、浏览历史记录以及安排自动备份。
  • 交互式备份浏览器:/mb list backups current 命令可在聊天中分页显示当前世界的备份,展示时间戳和注释(从标准备份文件名中自动解析),每个条目旁边都有一个可点击的 [Restore](还原)按钮。
  • 还原安全倒计时:在实际执行还原之前,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 (未混淆)
Fabric 26.3 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 Server:为了实现进程间通信,请在你的电脑上安装 KnotLink server。你可以从 GitHub Releases 下载它。
  4. 在主应用程序中启用 KnotLink Service:在 MineBackup 中默认启用,但在 FolderRewind 中默认禁用。如果你使用 FolderRewind,请手动在设置中启用它。
  5. 下载此模组:从 Releases 页面或其他模组分发平台获取与你加载器和 Minecraft 版本匹配的 minebackup-x.x.x.jar 文件。
  6. 安装模组:对于单人游戏或局域网(LAN),将下载的 .jar 文件放入 Minecraft 客户端的 mods 文件夹中。对于专用服务器,将其安装在服务器的 mods 文件夹中;客户端安装为可选。
  7. 同时运行:启动你的 Minecraft 游戏或服务器。要使模组生效,你 必须在游玩时保持 MineBackup/FolderRewind 桌面应用程序在后台运行。
  8. (仅限专用服务器) 确保存在启动脚本,以便恢复操作后能自动重启服务器 —— 参见 专用服务器恢复。

? 命令参考

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

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

? 使用示例

备份和恢复你正在游玩的世界:

  1. 备份当前世界

    • 输入 /mb backup Before the Ender Dragon fight

      聊天返回:[MineBackup] Backup task started... (片刻之后) [MineBackup] Backup successful! Saved as [Full][2026-07-30_12-33-00]world [Before the Ender Dragon fight].7z

  2. 浏览并从该备份中恢复

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

通过桌面应用的配置管理另一个世界(当前未运行的世界):

  1. 查找配置和文件夹
    • 输入 /mb list configs 查看你的配置文件。
    • 输入 /mb list folders <config_id> 查看该配置文件下的文件夹。
  2. 备份或恢复该文件夹
    • /mb target backup <config_id> <folder> [comment]
    • /mb target restore <config_id> <folder> "<file name>" (包含空格的文件名需加引号;专用服务器上不可用)

?️ 专用服务器恢复

在专用服务器上,备份和浏览功能完全相同。然而,恢复操作需要停止并重新启动 Minecraft 进程 —— MineBackup 通过内置的 重启 sidecar(辅助进程) 自动化了这一过程:

  1. 在执行 /mb restore 时,服务器会保存所有世界并将进程控制权交给一个小型辅助程序(即 sidecar),然后安全关闭。
  2. Sidecar 等待主 JVM 退出且世界文件被释放,随后让 FolderRewind/MineBackup 执行恢复操作。
  3. 一旦桌面应用程序报告确定性的成功、失败或取消状态,sidecar 就会精确地启动一次你配置的启动脚本并退出。

你需要一个启动脚本,放在服务器的当前工作目录中。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 设置为完全关闭专用恢复功能。

❓ 常见问题解答

  • Q: 当我使用某个命令时,聊天栏显示“Command failed”、“No response”或类似的错误。

    • A: 请检查你的电脑上是否已在后台运行 MineBackup / FolderRewind 桌面应用程序。此模组的所有功能都依赖于与主应用程序的网络通信。
  • Q: 这个模组可以单独使用吗?

    • A: 不可以。它只是一个“桥接”,没有主应用程序就无法执行任何操作。
  • Q: 我在专用服务器上进行了恢复,但服务器没有自动回来。

    • A: 请检查服务器的当前工作目录中是否存在启动脚本(参见 专用服务器恢复)。如果重启脚本本身失败了,请修复脚本并手动启动服务器 —— MineBackup 不会静默重试。

? 许可证

本项目采用 MIT License 授权。详细信息请访问主项目仓库。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源