Chronos Backups

精美的模组图标和横幅由 Mylèna Yarah Krijnen 创作。
Chronos Backups 是一款支持多加载器、多版本的 Minecraft 备份工具。仅保存世界中最重要的部分,使备份文件更小。
功能
- 多版本、多加载器架构(Fabric、NeoForge、Forge、Bukkit、Spigot、Paper、Purpur 和 Folia)。
- 通过游戏内的
/chronos 命令进行定时和手动备份,权限级别可配置。
- 对备份进行修剪和过滤,仅包含世界中最关键的部分,使备份比传统备份小得多。
- 可配置文件复制黑名单,以从备份中排除特定文件和文件夹,预填充了常见的服务器相关文件和文件夹。
- 云同步:将完成的备份上传到您选择的云提供商,并在上传成功后选择性地删除本地副本。目前支持:
命令
| 命令 |
描述 |
/chronos backup |
立即运行手动备份。 |
/chronos cancel |
停止当前正在进行的备份。 |
/chronos speedtest <seconds> |
运行重复备份以进行基准测试(诊断用途,非正常操作使用)。 |
所需的权限级别默认为 4。
性能与基准测试
在默认设置下,Chronos 备份通常可缩减至原始世界大小的约 1–15%。如果同时过滤掉 Distant Horizons 和/或 Voxy 的数据,备份大小通常占完整磁盘占用量(世界 + LOD)的 7% 以下。
| 世界 |
大小 |
Distant Horizon 大小(渲染距离 256) |
Voxy 大小(完整世界) |
平均备份时间 |
最终大小 (%pruned, %filtered + pruned) |
| MY 100 DAYS SURVIVAL WORLD (1.19) |
189 MB |
106 MB |
85,8 MB |
1,25s |
28,0 MB (15%, 7%) |
| my survival world |
4840 MB |
888 MB |
3060 MB |
10,76s |
46,5 MB (0.96%, 0.53%) |
| My survival World (Mission) |
1290 MB |
630 MB |
708MB |
4,56s |
156 MB (12%, 6%) |
| My Survival World |
1260 MB |
501 MB |
816 MB |
6,68s |
29,3 MB (2%, 1%) |
Distant Horizons(渲染距离 256,仅限已存在的区块)。Voxy(/voxy import current,仅限已存在的区块)。
方法:Minecraft 26.2 Fabric,默认 Chronos 配置。平均时间为连续运行 120 秒期间的平均备份持续时间。CPU:AMD Ryzen 7 9800X3D。SSD:Samsung 970 EVO Plus 2TB。
云同步
Chronos 可以将完成的备份上传到远程云提供商,然后选择性地删除本地副本。
行为
- 如果远程缺少本地备份,则将其上传,包括在上传失败或重启后的追赶上传。
maxStoredBackups 还限制每个启用的提供商为每个世界保留多少个 Chronos 备份(最先移除最旧的)。低于 1 的值会在本地和远程禁用自动移除。
- 如果
shouldKeepLocalBackups 为 false,则备份将从磁盘删除(仅在成功上传后)。
当多个世界映射到相同的远程文件夹时(例如两个都名为 "world" 的服务器),Chronos 会尝试通过在 chronos-alias.txt 中分配唯一别名来解决此问题,而不是进行覆盖。这优先考虑安全性而非存储空间,因此孤立的远程数据可能会保留。在多个服务器上启用云同步时,请留意控制台输出。
提供商
目前支持:。通过 googleDriveEnabled = true 启用它,重启,然后遵循控制台中打印的授权 URL。登录一次,令牌将存储在该机器的 google-drive-tokens/ 目录下。(任何有权访问此令牌的人都可以从您的 Google Drive 上传和删除备份。他们无法访问您 Google Drive 中的任何其他文件。)如果您无法在服务器上打开浏览器(例如无头控制台),请在本地机器上完成 OAuth 流程,然后将 google-drive-tokens/ 文件夹复制到服务器。
选择 Google Drive 是因为它是流行的云提供商,并且拥有最慷慨的免费套餐,提供 15GB 存储空间。OneDrive 和 Dropbox 已在计划中。它们目前尚不可用。
局限性
Chronos 优先处理已“老化”的世界数据,尚未达到“足够老”标准的区块可以被排除在备份之外。如果你进入一个新区块并修改了方块或物品,而在该区域被纳入备份之前触发了备份任务,那么这些更改可能会在该备份中缺失(具体取决于配置)。这种情况极为罕见,且仅在恢复时可能导致丢失,绝不会导致重复。
支持的版本
以下列出了所有当前支持的版本。Chronos 承诺永远不会停止对任何版本的支持。
| Minecraft |
支持情况 |
加载器 |
备份 |
配置 |
备注 |
26.x |
✅ 支持 |
Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur 和 Folia |
✅ |
? 仅文件 |
Fabric & NeoForge: 26.1–26.3。Paper 插件:26.1.1+(26.3 通过实验性通道)。Folia:26.1.2、26.2(实验性)。Bukkit/Spigot:截至 26.2,尚不支持 26.3。 |
1.21.x |
✅ 支持 |
Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur 和 Folia |
✅ |
? 仅文件 |
Fabric/NeoForge:存在 pre-1.21.11 与 1.21.11+ 的分支差异。Paper 插件:所有 1.21.x 版本共用一个 jar。Folia:补丁子集。 |
1.20.x |
✅ 支持 |
Forge + Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur 和 Folia |
✅ |
? 仅文件 |
Forge:仅限 1.20.0–1.20.1。Fabric:1.20.x。NeoForge:1.20.2–1.20.6。Paper 插件:除 1.20.3 外所有补丁。Folia:补丁子集。 |
1.19.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot, Paper, Purpur 和 Folia |
✅ |
? 仅文件 |
Folia:仅限 1.19.4。 |
1.18.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot, Paper 和 Purpur |
✅ |
? 仅文件 |
- |
1.17.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot, Paper 和 Purpur |
✅ |
? 仅文件 |
Forge:仅限 1.17.1。 |
1.16.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Paper 插件:仅限 1.16.1+。 |
1.15.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Fabric + Forge:统一使用 1.14-1.15.x jar。 |
1.14.x |
✅ 支持 |
Fabric + Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Fabric + Forge:统一使用 1.14-1.15.x jar。Forge:仅限 1.14.2–1.14.4。 |
1.13.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.13.2。[^2] |
1.12.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:所有 1.12.x 补丁。Paper 插件:仅限 1.12.2。[^2], [^3] |
1.11.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.11.0、1.11.2。Paper 插件:仅限 1.11.2。[^2] |
1.10.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.10.0、1.10.2。Paper 插件:仅限 1.10.2。[^2] |
1.9.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.9.0、1.9.4。Paper 插件:仅限 1.9.4。[^2] |
1.8.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.8.0、1.8.8、1.8.9。Paper 插件:仅限 1.8.8。[^2] |
1.7.x |
✅ 支持 |
Forge + Bukkit, Spigot 和 Paper |
✅ |
? 仅文件 |
Forge:仅限 1.7.10。Paper 插件:仅限 1.7.10。[^1], [^2] |
1.6.x |
❌ 不支持 |
Forge |
❌ |
? 无 |
[^2] |
1.5.x |
❌ 不支持 |
Forge |
❌ |
? 无 |
[^2] |
1.4.x |
❌ 不支持 |
Forge |
❌ |
? 无 |
[^2] |
1.3.x |
❌ 不支持 |
Forge |
❌ |
? 无 |
[^2] |
| 1.2.x | ❌ 不支持 | Forge | ❌ | ? 无 | - |
| Beta & Alpha | ❌ 不支持 | Babric | ❌ | ? 无 | Beta 和 Alpha 版本未来可能会得到支持,但旗舰功能 Chronos(世界修剪)将不可用。 |
[^1]: Forge 1.7.2 尚未构建完成(Unimined#184)。
[^2]: 未来可能通过 Legacy Fabric 在 Fabric 上提供支持。
[^3]: 排除 Paper 1.12.0 和 1.12.1,因为 Mojang 已从旧的 S3 下载 URL 中移除了原版服务器 JAR 文件。在获取 minecraft_server.1.12.jar / minecraft_server.1.12.1.jar 时,Paperclip 在引导过程中会因 FileNotFoundException 而失败。请使用 Paper 1.12.2(Forge 仍支持所有 1.12.x 补丁)。
配置
该模组的配置文件存储在 config/chronos.toml 文件中。此文件会在模组首次运行时自动创建,位于 config 文件夹中。在可预见的未来,将不提供图形用户界面(GUI)配置。配置选项包括:
backupFolderName: 存放备份的文件夹名称。
pruneChunks: 是否对备份启用区块修剪功能。
pruneTimeRequirementSeconds: 区块计入世界修剪所需的最少游戏时间(以秒为单位)。
pruneMaxWorkerThreads: 修剪操作的最大工作线程数。0(或更小)表示“自动”(修剪器会选择合理的默认值)。
scheduleBackups: 是否按计时器运行备份。
backupIntervalSeconds: 自动备份运行之间的间隔秒数。
maxStoredBackups: 每个世界本地存储以及每个启用的云目的地保留的最大备份数量。备份成功后,如果超过限制,将移除最旧的本地备份。云同步也会将远程 Chronos 备份修剪至这一上限。推荐值:5。可以使用低于 3 的值来节省空间,但如果发生灾难性错误,存在严重数据丢失的风险。低于 1 的值将禁用自动移除功能。
compressionMethod: 是将备份压缩为 ZIP 文件还是作为未压缩的文件夹存储。接受 "zip" 或 "none"。
googleDriveEnabled: 启用 Google Drive 作为云同步目的地(参见 云同步)。
shouldKeepLocalBackups: 当设置为 true 时,在成功上传云备份后保留本地备份。当设置为 false 时,一旦本地备份上传完成即删除。
commandRequiredPermissionLevel: 运行 /chronos 命令所需的权限等级。
copyBlacklist: 要从备份中排除的文件夹和文件列表。
此列表可能已过时。要查看最新的可用配置选项及其描述,请参阅 ChronosTomlSpec.java。
夜间构建版
GitHub Actions 会自动构建并将夜间构建版上传至 GitHub Releases 页面。这些与 Modrinth、CurseForge 或 GitHub Releases 上发布的稳定版不同,不应依赖或假定其稳定性。
Chronos Backups

The wonderful mod icon and banner were created by Mylèna Yarah Krijnen.
Chronos Backups is a multi-loader, multi-version Minecraft backup utility. Saves only the most important parts of your world, keeping backups smaller.
Features
- Multi-version, multi-loader architecture (Fabric, NeoForge, Forge, Bukkit, Spigot, Paper, Purpur and Folia).
- Scheduled and manual backups via an in-game
/chronos command with a configurable permission level.
- Backups are pruned and filtered to only include the most important parts of your world, keeping backups much smaller than traditional backups.
- Configurable file copy blacklist to exclude specific files and folders from the backup, prefilled with common server-related files and folders.
- Cloud sync: upload finished backups to your cloud provider of choice, and optionally delete them locally after a successful upload. Currently supported:
Commands
| Command |
Description |
/chronos backup |
Run a manual backup immediately. |
/chronos cancel |
Stop the backup currently in progress. |
/chronos speedtest <seconds> |
Run repeated backups for benchmarking (diagnostic. not for normal use). |
The required permission level defaults to 4.
Performance and benchmarks
On default settings, Chronos backups typically shrink to about 1–15% of the original world size. When Distant Horizons and/or Voxy data is filtered out as well, the backup is often under 7% of the full on-disk footprint (world + LOD).
| World |
Size |
Distant Horizon size (256 render distance) |
Voxy size (Full world) |
Average backup time |
Final size (%pruned, %filtered + pruned) |
| MY 100 DAYS SURVIVAL WORLD (1.19) |
189 MB |
106 MB |
85,8 MB |
1,25s |
28,0 MB (15%, 7%) |
| my survival world |
4840 MB |
888 MB |
3060 MB |
10,76s |
46,5 MB (0.96%, 0.53%) |
| My survival World (Mission) |
1290 MB |
630 MB |
708MB |
4,56s |
156 MB (12%, 6%) |
| My Survival World |
1260 MB |
501 MB |
816 MB |
6,68s |
29,3 MB (2%, 1%) |
Distant Horizons (render distance 256, existing chunks only). Voxy (/voxy import current, existing chunks only).
Method: Minecraft 26.2 Fabric, default Chronos config. Avg. time is mean backup duration over 120 seconds of continuous runs. CPU: AMD Ryzen 7 9800X3D. SSD: Samsung 970 EVO Plus 2TB.
Cloud sync
Chronos can upload finished backups to a remote cloud provider, then optionally remove the local copy.
Behaviour
- Local backups missing from the remote are uploaded, including catch-up after a failed upload or a restart.
maxStoredBackups also caps how many Chronos backups each enabled provider keeps per world (oldest removed first). Values below 1 disable automatic removal locally and remotely.
- If
shouldKeepLocalBackups is false, a backup is deleted from disk (only after it has been uploaded successfully).
When multiple worlds would map to the same remote folder (e.g. two servers both named "world"), Chronos attempts to resolve this by assigning a unique alias in chronos-alias.txt instead of overwriting. This favors safety over storage, so orphaned remote data may remain. Watch the console when enabling cloud sync on multiple servers.
Providers
Currently supported: . Enable it with googleDriveEnabled = true, restart, then follow the authorization URL printed in the console. Sign in once, tokens are stored on that machine under google-drive-tokens/. (Anyone with access to this token will be able to upload and delete backups from your Google Drive. They will not be able to access any other files in your Google Drive.) If you cannot open a browser on the server (for example a headless console), complete the OAuth flow on a local machine, then copy the google-drive-tokens/ folder to the server.
Google Drive was chosen because it is the most popular cloud provider, and has the most generous free tier, with 15GB of storage. OneDrive and Dropbox are planned. They are not available yet.
Limitations
Chronos prioritizes aged world data, chunks that do not yet count as "old enough" can be left out of a backup. If you enter a new chunk, change blocks or items, and a backup runs before that area is included, those changes may be missing from that backup (depending on configuration). That situation is seen as extremely rare and can only cause loss on restore, never duplication.
Supported versions
All currently supported versions are listed below. Chronos is committed to never drop support for a version.
| Minecraft |
Support |
Loader(s) |
Backup |
Config |
Notes |
26.x |
✅ Supported |
Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur and Folia |
✅ |
? File-only |
Fabric & NeoForge: 26.1–26.3. Paper plugin: 26.1.1+ (26.3 via experimental channel). Folia: 26.1.2, 26.2 (experimental). Bukkit/Spigot: through 26.2, not 26.3 yet. |
1.21.x |
✅ Supported |
Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur and Folia |
✅ |
? File-only |
Fabric/NeoForge: pre-1.21.11 vs 1.21.11+ split. Paper plugin: one jar for all 1.21.x. Folia: subset of patches. |
1.20.x |
✅ Supported |
Forge + Fabric + NeoForge + Bukkit, Spigot, Paper, Purpur and Folia |
✅ |
? File-only |
Forge: 1.20.0–1.20.1 only. Fabric: 1.20.x. NeoForge: 1.20.2–1.20.6. Paper plugin: all patches except 1.20.3. Folia: subset of patches. |
1.19.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot, Paper, Purpur and Folia |
✅ |
? File-only |
Folia: 1.19.4 only. |
1.18.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot, Paper and Purpur |
✅ |
? File-only |
- |
1.17.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot, Paper and Purpur |
✅ |
? File-only |
Forge: 1.17.1 only. |
1.16.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Paper plugin: 1.16.1+ only. |
1.15.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Fabric + Forge: unified 1.14-1.15.x jar. |
1.14.x |
✅ Supported |
Fabric + Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Fabric + Forge: unified 1.14-1.15.x jar. Forge: 1.14.2–1.14.4 only. |
1.13.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.13.2 only. [^2] |
1.12.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: all 1.12.x patches. Paper plugin: 1.12.2 only. [^2], [^3] |
1.11.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.11.0, 1.11.2 only. Paper plugin: 1.11.2 only. [^2] |
1.10.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.10.0, 1.10.2 only. Paper plugin: 1.10.2 only. [^2] |
1.9.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.9.0, 1.9.4 only. Paper plugin: 1.9.4 only. [^2] |
1.8.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.8.0, 1.8.8, 1.8.9 only. Paper plugin: 1.8.8 only. [^2] |
1.7.x |
✅ Supported |
Forge + Bukkit, Spigot and Paper |
✅ |
? File-only |
Forge: 1.7.10 only. Paper plugin: 1.7.10 only. [^1], [^2] |
1.6.x |
❌ Unsupported |
Forge |
❌ |
? None |
[^2] |
1.5.x |
❌ Unsupported |
Forge |
❌ |
? None |
[^2] |
1.4.x |
❌ Unsupported |
Forge |
❌ |
? None |
[^2] |
1.3.x |
❌ Unsupported |
Forge |
❌ |
? None |
[^2] |
1.2.x |
❌ Unsupported |
Forge |
❌ |
? None |
- |
| Beta & Alpha |
❌ Unsupported |
Babric |
❌ |
? None |
Beta & Alpha versions may be supported in the future, but the flagship Chronos feature (world pruning) will be unavailable. |
[^1]: Forge 1.7.2 does not build yet (Unimined#184).
[^2]: Might also be supported on Fabric through Legacy Fabric in the future.
[^3]: Paper 1.12.0 and 1.12.1 are excluded because Mojang removed the vanilla server jars from their old S3 download URLs. Paperclip fails during bootstrap with FileNotFoundException when fetching minecraft_server.1.12.jar / minecraft_server.1.12.1.jar. Use Paper 1.12.2 (Forge still supports all 1.12.x patches).
Configuration
The mod's configuration is stored in the config/chronos.toml file. This file is automatically created when the mod is first run, and is located in the config folder. For the forseeable future, there is no GUI configuration available. Config options include:
backupFolderName: The name of the folder that will contain the backups.
pruneChunks: Whether chunk pruning is enabled for backups.
pruneTimeRequirementSeconds: Minimum playtime (in seconds) for a chunk to count toward world pruning.
pruneMaxWorkerThreads: Maximum worker threads for pruning. 0 (or less) means "auto" (pruner picks a sensible default).
scheduleBackups: Whether to run backups on a timer.
backupIntervalSeconds: Seconds between automatic backup runs.
maxStoredBackups: Maximum backups kept per world locally and on each enabled cloud destination. After a successful backup, oldest local backups are removed if the limit is exceeded. Cloud sync also trims remote Chronos backups to this cap. Recommended value: 5. Values lower than 3 can be used to save space, but risks serious data loss if a catastrophic error occurs. Values below 1 disable automatic removal.
compressionMethod: Whether to compress the backups into a zip file or store it as an uncompressed folder. Accepts "zip" or "none".
googleDriveEnabled: Enable Google Drive as a cloud sync destination (see Cloud sync).
shouldKeepLocalBackups: When true, keep local backups after a successful cloud upload. When false, delete each local backup once it has been uploaded.
commandRequiredPermissionLevel: Permission level required to run /chronos.
copyBlacklist: Folders and files to exclude from the backup.
This list may be out of date. To see the latest available configuration options and their descriptions, see ChronosTomlSpec.java.
Nightly releases
Github Actions automatically builds and uploads nightly releases to the GitHub Releases page. These are not the same as stable releases found on Modrinth, CurseForge or Github Releases, and should not be relied upon or assumed to be stable.
评论 0
登录后参与评分
还没有评论,来抢沙发吧