世界备份

世界备份

在游戏更新或模组更改可能改动世界之前备份你的世界,可按计划、在关闭时以及按需备份。下次启动时从窗口恢复,若改变主意可撤销。小型、去重的备份。MIT。

实用

World Backup

更新前先备份

在游戏可能损坏你的世界之前为其创建备份。 World Backup 会在新游戏版本或变更的模组列表首次打开某个世界之前、按计划、每次正常关闭时,以及你按下按钮时,为每个世界创建快照。使用 /worldbackup 打开窗口,选择一个快照,按下 Restore,它会在下一次启动时应用。被替换的世界会先被备份,因此每次恢复都可以撤销。

安装后即可使用:它第一次看到某个世界时,就会为其创建备份。

功能

  • 在更新和模组变更之前。 游戏更新可能升级世界,使旧版本无法打开它;而缺少某个模组时打开世界,可能无法恢复原样。World Backup 会在世界加载前创建 pre-update 或 mod-change 快照,因此你始终拥有世界原本的样子。
  • 按计划备份,不浪费。 默认每 60 分钟一次,没有变化时跳过,且仅在有人游玩时进行(最后一名玩家离开时再额外一次)。每次正常关闭时也会备份。
  • 里程碑。 为某个时刻命名(“城堡之前”),它就会被固定:永远不会被自动删除。
  • 带撤销的恢复。 恢复会在下一次启动时、世界加载前进行。被替换的世界会先保存并检查为 pre-restore 快照。中断的恢复会在下一次启动时完成;失败的恢复会将世界还原为原样并说明原因。
  • 小型备份。 文件按 64 KB 块、按内容存储,且只存一次。变化很少的世界的快照几乎不占空间,因此频繁创建快照成本很低。
  • 空间由你控制。 整台电脑共用一个备份文件夹,并设有一个空间上限(默认 10 GB)。较旧的快照会逐渐稀疏为每天一个,然后每周一个。/worldbackup budget 会告诉你设置是否合适,以及大致能保留多久的历史。
  • 不小心删除了世界? 它的快照仍保留在备份文件夹中。导出功能可将任意快照写为普通世界文件夹。
  • 一个窗口。 左侧是你的世界(此服务器的、此电脑上的其他世界、已删除的),右侧是所选世界的快照,每个按钮旁边都写有对应的命令。
  • 有日志。 每个快照、恢复和命令都会记录到备份文件夹中的 actions.log。
  • 不干扰 Hytale 自带的备份。 它从不更改其设置或文件;窗口会显示它们占用了多少空间。

单人游戏与服务器

  • 专用服务器: 服务器上的每个世界都受到保护。
  • 单人游戏: Hytale 按世界启用模组,因此 World Backup 保护你启用了它的世界,且仅在这些世界打开时。窗口会说明这一点。
  • World Backup 无法将游戏本身回滚到旧版本。在服务器上,你可以放回旧服务器 jar 并恢复 pre-update 快照。在单人游戏中,启动器只保留最新版本,因此该快照是一份安全副本,可保留到修复更新发布。

安装

  1. 将 WorldBackup-1.0.0.jar 放入服务器的 mods 文件夹(单人游戏:%APPDATA%\Hytale\UserData\Mods\,然后在世界的模组列表中启用它)。
  2. 无需其他操作。推荐使用 Mod Settings Manager,以获得设置页面。
  3. 打开世界。输入 /worldbackup。

在 Windows 上,备份会保存到 %LOCALAPPDATA%\WorldBackup\。其他驱动器更安全:在设置中设置 Backup folder。

命令与权限

命令 作用
/worldbackup 或 /wbak 打开窗口
/worldbackup list [world] 快照,最新的在前
/worldbackup worlds 备份文件夹中的每个世界
/worldbackup budget [world] 空间设置是否合适
/worldbackup now [label] 保存世界,然后备份
/worldbackup milestone <label> 类似 now,但会固定
/worldbackup verify <id> 检查快照的文件
/worldbackup pin <id>、unpin <id> 保护快照不被删除,或停止保护
/worldbackup restore <id> 在下一次启动时恢复;restore cancel 可撤销
/worldbackup prune 立即应用保留设置
/worldbackup export <id> 将快照写为普通文件夹

权限: 任何人都可以列出和检查预算。worldbackup.create 允许 now、milestone 和 verify。worldbackup.admin 允许 restore、pin、unpin、prune 和 export。操作员和单人游戏世界的所有者都拥有这两项权限。 服务器只能恢复和固定自己的世界;同一备份文件夹中的其他世界可以列出、验证和导出。

设置

设置位于 mods/Hledjolf_WorldBackup/config.json,或在安装了 Mod Settings Manager 时的设置页面中;除备份文件夹外,每项更改都无需重启即可生效。

  • 磁盘空间: 所有备份的空间上限、驱动器上保留的可用空间,以及何时发出警告。
  • 频率: 计划快照的开或关、间隔分钟数、无变化时跳过、仅在玩家在线时进行,以及速度限制,以免大型快照造成卡顿。
  • 保留数量: 近期快照(24 个),然后每天一个(7 天),然后每周一个(4 周),以及关闭时的快照(2 个)。
  • 里程碑: 更新和模组变更前的快照,以及保留其中多少个(3 个)。
  • 世界、位置、通知: 不备份的世界、备份文件夹、是否包含玩家数据,以及向操作员发送聊天通知。

在有多个世界的服务器上,每个世界在 Mod Settings Manager 中都有自己的部分。你未在其中设置的值会跟随服务器的设置。

命令行

同一个 jar 可在游戏外运行,用于服务器已停止时:java -jar WorldBackup-1.0.0.jar help。它可以列出世界和快照、检查预算、验证和导出快照,以及恢复到已停止的服务器。它会拒绝仍在运行的服务器。

兼容性

  • Hytale 服务器 0.7.4。
  • 专用服务器和单人游戏。
  • 无依赖。它添加一个窗口;不替换任何原版资源。
  • 共享同一备份文件夹的服务器和存档通过锁文件轮流访问。在同一时刻运行两个服务器共用一个备份文件夹的测试不如一次一个充分。

许可证

MIT,版权所有 (c) 2026 Hledjolf。