MCDR2Restic
Schedule deduplicated incremental restic backups with multi-channel notifications.
management
Installation command
!!MCDR plugin install mcdr2resticAuthor
Repository
Homepage
Synced at
...
Last update
...
Latest version
Total downloads
137
Back to catalogue
MCDR2Restic_v0.12.2.mcdr
Version
0.12.2
Date
November 18, 2026
Size
326.04 KiB
Downloads
9
MD5
4d1cdbe7f61c5f3f20c5c8f9a7c5ffd9SHA256
2db1177f529edc41451af293f3b08104f7681d28e5161d650a07bbc69a8ae851Dependencies
MCDR Plugin Dependencies
| Plugin ID | Requirement |
|---|---|
| mcdreforged | >=2.12.0 |
Python Package Requirements
| Python Package | Requirement |
|---|---|
| PyYAML | >=6.0 |
| websocket-client | >=1.8.0 |
Python Package Installation Command
pip install "PyYAML>=6.0" "websocket-client>=1.8.0"Release notes
新增
- 中转库(staging,beta、默认关闭):备份先写入本地中转库,解冻后再由后台线程复制到远端,把
save-off冻结窗口从“上传耗时”缩短为“本地写入耗时”。新增!!m2r staging status / copy / purge与staging:配置段;适合远端上传慢、玩家高峰期长的服务器。beta 功能不建议作为唯一备份手段,启用前请阅读 中转库文档 - 陈旧备份告警重做:改由独立看门狗按固定节奏检查,不再依赖备份调度周期(每天只跑一次的 cron 也能按时告警)。计时改为“首次被人数门控推迟以来的服务器运行时间”,成功备份立即复位,停用备份时清零;告警后每 24 小时提醒一次,并说明停滞起点、当前人数与阈值
- 玩家人数门控改进:推迟中的备份可取消,放行后复检;拿到备份槽位后再次复检在线人数,避免等待期间人数超阈值仍进入
save-off;新生成配置默认阈值 5,本地库也预先开启(确认备份很快可显式改为 0 关闭) - 维护结果区分成功 / 跳过 / 失败三态,并接入通知与状态页;计划点改为游标重算,调度线程不再被推迟中的备份或维护阻塞
修复
- 中转库数据安全:新增游标覆盖性不变量,游标与本地快照不一致时不再“假成功”,跳过本地 prune 并全量重放;永久复制失败后仍保留远端落后告警;
purge与restore互斥并支持阶段间取消;复制 worker 启停加代际校验,避免重载后出现两个复制循环;初始化 deadline 与取消语义修正 - 失败分类统一:
context deadline exceeded等超时不再被误判为配额不足;鉴权 / 配额 / 分块错误停止自动重试;中英繁三种语言下归类一致 staging status在远端不可达时不再阻塞约 60 秒并触发 MCDR WatchDog,复用探测结果与共享 deadline- 中转库配置校验:与远端仓库路径相同或互相包含、
password_file缺失、backup_command自带仓库参数时,在备份前直接给出配置错误 - 自定义 Webhook 的
{message}保留完整正文,不再被短摘要覆盖;修改command.root后reload给出重载提示 - 远端读取失败后
staging status只探测一次;backlog 未知时写-1并标记远端状态不可信;S3 签名错误归类为鉴权失败并停止重试 - YAML 解析错误提示包含行号、列号与解析器原因;对已初始化仓库重复
init返回友好提示 - 快照缓存从未成功刷新时显示“刷新失败”;快照来源改为显示目录名;拒绝 MCDR 折叠后的单反斜杠管理共享路径
- 日志打印真实执行的 Minecraft 命令(如
save-all flush);取消与门控中断显示真实原因,不再统一写成“收到停止请求” - 首次备份等待期间按状态变化节流,不再每 30 秒写状态并刷 info 日志
变更
- 配置文件版本 10 → 13,升级自动迁移:门控阈值收敛为单开关、新增
staging段、旧门控注释与旧版陈旧备份通知文案自动更新 - 文档:新增中转库文档,配置、命令、快速开始与 README_EN 同步更新
- 发布构建会把内置 restic 信任清单 pin 到当前最新稳定版;已有仓库无需迁移
安装
下载下方 MCDR2Restic_v0.12.2.mcdr 放入 MCDR 的 plugins/ 目录,执行 !!MCDR reload all。
或
在 MCDR 中执行 !!MCDR plugin install mcdr2restic 自动安装。