⚠️ 重要提示:这是一个配套模组!
请注意:本模组是 MineBackup 桌面应用程序 或 FolderRewind 的配套组件,无法独立运行。您必须先下载并运行主应用程序,此模组才能正常工作。
此外,为了实现正确的进程间通信,您的计算机上必须安装 KnotLink 服务器。
✅ 支持专用服务器
MineBackup 现在支持在专用服务器上实现热还原,不仅限于单人/LAN 模式。当您在专用服务器上运行 /mb restore 时,模组会安全地保存世界数据,将控制权移交至内置的重启旁路(sidecar),并在还原完成后通过您自己的启动脚本重启服务器。有关设置详情,请参阅下方的 专用服务器还原。
如果您使用的是 Spigot/Paper 服务器,请使用 MineBackupPlugin,它为 Bukkit 系列服务器提供了相同的还原流程。
对于 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 (官方) |
? 安装指南
- 下载主应用程序:确保你已从上方链接下载
MineBackup/FolderRewind 桌面应用程序,并且它能在你的系统上正常运行。
- 下载 MineRewind 插件:如果你使用 FolderRewind,强烈建议安装 MineRewind 插件并创建类型为
Minecraft Saves 的配置,而不是默认的 Default。你可以从 GitHub Releases 下载此插件。
- 下载并安装 KnotLink Server:为了实现进程间通信,请在你的电脑上安装 KnotLink server。你可以从 GitHub Releases 下载它。
- 在主应用程序中启用 KnotLink Service:在 MineBackup 中默认启用,但在 FolderRewind 中默认禁用。如果你使用 FolderRewind,请手动在设置中启用它。
- 下载此模组:从 Releases 页面或其他模组分发平台获取与你加载器和 Minecraft 版本匹配的
minebackup-x.x.x.jar 文件。
- 安装模组:对于单人游戏或局域网(LAN),将下载的
.jar 文件放入 Minecraft 客户端的 mods 文件夹中。对于专用服务器,将其安装在服务器的 mods 文件夹中;客户端安装为可选。
- 同时运行:启动你的 Minecraft 游戏或服务器。要使模组生效,你 必须在游玩时保持
MineBackup/FolderRewind 桌面应用程序在后台运行。
- (仅限专用服务器) 确保存在启动脚本,以便恢复操作后能自动重启服务器 —— 参见 专用服务器恢复。
? 命令参考
所有命令在多人游戏和专用服务器上都需要操作员(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 |
(无) |
停止当前世界的自动备份计划。 |
? 使用示例
备份和恢复你正在游玩的世界:
-
备份当前世界
- 输入
/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
-
浏览并从该备份中恢复
- 输入
/mb list backups current 查看分页且可点击的最新备份列表 —— 或直接输入 /mb restore 以恢复最新的备份。
- 如果配置了恢复倒计时,请使用
/mb confirm 立即恢复,或使用 /mb stop 取消。
通过桌面应用的配置管理另一个世界(当前未运行的世界):
- 查找配置和文件夹
- 输入
/mb list configs 查看你的配置文件。
- 输入
/mb list folders <config_id> 查看该配置文件下的文件夹。
- 备份或恢复该文件夹
/mb target backup <config_id> <folder> [comment]
/mb target restore <config_id> <folder> "<file name>" (包含空格的文件名需加引号;专用服务器上不可用)
?️ 专用服务器恢复
在专用服务器上,备份和浏览功能完全相同。然而,恢复操作需要停止并重新启动 Minecraft 进程 —— MineBackup 通过内置的 重启 sidecar(辅助进程) 自动化了这一过程:
- 在执行
/mb restore 时,服务器会保存所有世界并将进程控制权交给一个小型辅助程序(即 sidecar),然后安全关闭。
- Sidecar 等待主 JVM 退出且世界文件被释放,随后让 FolderRewind/MineBackup 执行恢复操作。
- 一旦桌面应用程序报告确定性的成功、失败或取消状态,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 设置为完全关闭专用恢复功能。
❓ 常见问题解答
? 许可证
本项目采用 MIT License 授权。详细信息请访问主项目仓库。
⚠️ Important: This is a Companion Mod!
Please note: This mod is a companion component for the MineBackup desktop application or FolderRewind and cannot function independently. You must first download and run the main application for this mod to work properly.
Additionally, for proper inter-process communication, the KnotLink server must be installed on your computer.
✅ Dedicated Servers Are Supported
MineBackup now supports hot restore on dedicated servers, not just singleplayer/LAN. When you run /mb restore on a dedicated server, the mod safely saves the world, hands off to a bundled restart sidecar, and restarts the server through your own start script once the restore finishes. See Dedicated Server Restore below for setup details.
If you run a Spigot/Paper server instead, use MineBackupPlugin, which provides the same restore flow for the Bukkit family.
For Windows users, we recommend FolderRewind with the MineRewind plugin rather than the standalone MineBackup desktop app.
What is This?
This lightweight mod is a bridge between the MineBackup desktop application (or FolderRewind) and Minecraft itself. It lets you manage saves, trigger restores, and stay informed about backup status without ever leaving your game.
✨ This Mod Provides:
- Rich In-Game Commands: Use the
/mb command series to manage world saves directly from chat — backup, restore, browse history, and schedule automatic backups.
- Interactive Backup Browser:
/mb list backups current pages through your current world's backups right in chat, showing timestamps and comments (parsed automatically from standard backup file names) with a clickable [Restore] button next to each entry.
- Restore Safety Countdown: Before a restore actually runs, MineBackup can count down a configurable number of seconds. Use
/mb stop to cancel or /mb confirm to skip ahead and restore immediately.
- Full Dedicated Server Support: Backup, restore, and browsing all work the same way on a dedicated server as they do in singleplayer, coordinated through a bundled restart sidecar (see below).
- Real-Time Backup Notifications: Receive real-time messages from the main application in your game chat — whether a backup starts, succeeds, or fails.
- Seamless Live Backup Support: When the main application needs to perform a "live backup" (i.e., while the game is running), this mod automatically triggers a safe, complete world save (equivalent to
/save-all) in the background, ensuring your backup always captures the latest progress.
- FolderRewind-Triggered Restore: If you use FolderRewind's own UI to pick a backup, it can signal this mod directly to start the same hot-restore flow in-game, so both control surfaces stay in sync.
?️ Supported Versions
| Loader |
Minecraft Versions |
Mappings |
| Fabric |
1.21 – 1.21.8 |
Yarn |
| Fabric |
1.21.9 – 1.21.11 |
Mojang (official) |
| Fabric |
26.1 – 26.1.2 |
Mojang (unobfuscated) |
| Fabric |
26.2 |
Mojang (unobfuscated) |
| Fabric |
26.3 |
Mojang (unobfuscated) |
| NeoForge |
1.21 – 1.21.8 |
Parchment |
| NeoForge |
26.1 – 26.1.2 |
Mojang (unobfuscated) |
| Forge |
1.20 – 1.20.4 |
Mojang (official) |
? Installation Guide
- Download the Main Application: Ensure you have downloaded the
MineBackup/FolderRewind desktop application from the link above and that it runs correctly on your system.
- Download MineRewind Plugin: If you use FolderRewind, it is strongly recommended to install the MineRewind plugin and create a
Minecraft Saves type configuration instead of Default. You can download this plugin from GitHub Releases.
- Download and Install KnotLink Server: For inter-process communication, install the KnotLink server on your computer. You can download it from GitHub Releases.
- Enable KnotLink Service in the Main Application: It is enabled by default in MineBackup but disabled by default in FolderRewind. If you use FolderRewind, enable it manually in settings.
- Download This Mod: Get the version-matched
minebackup-x.x.x.jar file for your loader and Minecraft version from the Releases page or another mod distribution platform.
- Install the Mod: For single-player or LAN, place the downloaded
.jar file in the Minecraft client's mods folder. For dedicated servers, install it in the server's mods folder; client installation is optional.
- Run Simultaneously: Launch your Minecraft game or server. For the mod to function, you must have the
MineBackup/FolderRewind desktop application running in the background while playing.
- (Dedicated servers only) Make sure a start script is present so restores can restart the server automatically — see Dedicated Server Restore.
? Command Reference
All commands require operator/moderator permission on multiplayer and dedicated servers. On a singleplayer or client-hosted LAN world, only the world owner may use them — no OP grant needed. Most arguments support tab-completion (config IDs, folders, backup file names).
| Command |
Parameters |
Description |
| /mb help |
[command] |
Shows general help, or detailed help and an example for one command. |
| /mb save |
(none) |
Manually performs a full world save in-game, equivalent to /save-all. |
| /mb backup |
[comment] |
Backs up the current world. An optional comment is attached to the backup. |
| /mb restore |
[file] |
Restores the current world. Omit the file name to restore the latest backup. |
| /mb confirm |
(none) |
Immediately submits a restore that is currently counting down. |
| /mb stop |
(none) |
Cancels a restore that is currently counting down. |
| /mb target backup |
<config_id> <folder> [comment] |
Backs up a specific, non-current folder managed by the desktop application. |
| /mb target restore |
<config_id> <folder> <file> |
Restores a specific, non-current folder. Unavailable on dedicated servers — use /mb restore for the current world instead. |
| /mb list configs |
(none) |
Lists all configured backup profiles and their IDs. |
| /mb list folders |
<config_id> |
Lists the folders tracked under a configuration profile. |
| /mb list backups current |
[page] |
Interactively browses the current world's backups in chat, with a clickable restore button per entry. |
| /mb list backups |
<config_id> <folder> |
Lists backup files for a specific, non-current folder. |
| /mb auto start |
<minutes> |
Schedules automatic backups of the current world every minutes minutes. |
| /mb auto stop |
(none) |
Stops the current world's automatic backup schedule. |
? Usage Example
Backing up and restoring the world you're currently playing:
-
Back up the current world
- Type
/mb backup Before the Ender Dragon fight
Chat returns: [MineBackup] Backup task started...
(After a moment)
[MineBackup] Backup successful! Saved as [Full][2026-07-30_12-33-00]world [Before the Ender Dragon fight].7z
-
Browse and restore from that backup
- Type
/mb list backups current to see a paginated, clickable list of recent backups — or type /mb restore directly to restore the latest one.
- If a restore countdown is configured, use
/mb confirm to restore right away or /mb stop to cancel.
Managing a different world (one not currently running) through the desktop app's configuration:
- Find the configuration and folder
- Type
/mb list configs to see your configuration profiles.
- Type
/mb list folders <config_id> to see the folders under that profile.
- Back up or restore that folder
/mb target backup <config_id> <folder> [comment]
/mb target restore <config_id> <folder> "<file name>" (quote file names that contain spaces; not available on dedicated servers)
?️ Dedicated Server Restore
Backups and browsing work identically on dedicated servers. Restoring, however, requires stopping and relaunching the Minecraft process — MineBackup automates this with a bundled restart sidecar:
- On
/mb restore, the server saves all worlds and hands ownership of the process to a small helper (the sidecar), then shuts down safely.
- The sidecar waits for the main JVM to exit and the world files to be released, then lets FolderRewind/MineBackup perform the restore.
- Once the desktop application reports a definite success, failure, or cancellation, the sidecar launches your configured start script exactly once and exits.
You need a start script in the server's working directory. MineBackup looks for one of start.bat, start.cmd, run.bat, run.cmd (Windows) or start.sh, run.sh (Linux/macOS); exactly one must exist, or set an explicit path with the dedicatedRestore.restartScript setting in config/minebackup.properties. Because the server process restarts, players are disconnected during the restore and need to reconnect manually once the new server instance is back online.
If you run a panel or wrapper that automatically relaunches the server the moment it exits, disable that behavior (or point it at a script MineBackup doesn't also manage) — an immediate auto-restart can race the restore and start the server before the world files are ready. Set dedicatedRestore.mode=DISABLED to turn off dedicated restore entirely.
❓ Frequently Asked Questions
-
Q: When I use a command, the chat says "Command failed", "No response", or a similar error.
- A: Please check that the
MineBackup/FolderRewind desktop application is running in the background on your computer. All features of this mod rely on network communication with the main application.
-
Q: Can this mod be used by itself?
- A: No. It is a "bridge" and cannot do anything without the main application.
-
Q: I restored on my dedicated server and the server didn't come back automatically.
- A: Check that a start script exists in the server's working directory (see Dedicated Server Restore). If the restart script itself failed, fix the script and start the server manually — MineBackup will not silently retry it.
? License
This project is licensed under the MIT License. For details, please visit the main project repository.
评论 0
登录后参与评分
还没有评论,来抢沙发吧