
SevenZipBackup
专为 Minecraft 服务器打造的第一个 7-zip 备份插件。
硬盘损坏?服务器托管商跑路?误删文件?
SevenZipBackup 是一款旨在通过远程备份为您的数据提供额外安全层保护的插件。
Minecraft 世界文件数量众多且分散,非常适合进行高效压缩。因此,我们使用 7-zip 为您的服务器创建备份!
功能特性
- 使用带有 LZMA2 算法的 7z 归档格式,最多可节省 50% 的磁盘空间!
- 异步创建备份,可同时创建多个备份!
- 支持将备份上传至 Google Drive、OneDrive、Dropbox、(S)FTP 服务器或兼容 S3 的 API。
- 支持备份 Minecraft 服务器的任意文件或文件夹。
- 根据指定的数量自动清理本地和远程的旧备份。
- 完全可配置的备份间隔时间和自定义计划任务。
依赖要求
通用要求
- Java 8 或更高版本
- 推荐使用 Java 21 或更高版本以获得更好的压缩性能!
平台特定要求
- Bukkit/Spigot/Paper/Purpur
- Minecraft 1.8 - 1.21.X
基本设置
- 下载插件并将其复制到服务器的
plugins文件夹中。 - 重启服务器。
- 编辑
plugins/SevenZipBackup文件夹中的config.yml并重新加载插件。
命令
- /7zbackup backup *立即执行备份
- /7zbackup linkaccount *绑定你的云盘账户
- /7zbackup reloadconfig *重载插件配置
- /7zbackup test *测试备份任务
- /7zbackup update *热更新插件
- /7zbackup nextbackup *获取下一次备份的计划时间
- /7zbackup status *检查备份状态
- /7zbackup unlinkaccount *解绑你的云盘账户
- /7zbackup v *检查插件及环境版本
权限
- 7zbackup.backup 创建、测试和上传备份
- 7zbackup.getBackupStatus 查看备份状态
- 7zbackup.getNextBackup 获取下一次备份的计划时间
- 7zbackup.reloadConfig 重载插件配置
- 7zbackup.linkAccounts 绑定你的云盘账户
配置说明
更改消息翻译
- 查看 GITHUB 并找到 YOUR-LANGUAGE.yml。
- 复制其内容并替换到 intl.yml 中。
- 重新加载插件。
本地存储
在 config.yml 中修改 local-keep-count 以设置保留的本地备份数量。设置为 -1 表示无限保留本地备份。
完成上述操作后,默认情况下备份任务将每小时自动运行一次。
Google Drive
只需运行 /7zbackup linkaccount googledrive 并按照屏幕提示操作即可。
OneDrive
只需运行 /7zbackup linkaccount onedrive 并按照屏幕提示操作即可。
DropBox
只需运行 /7zbackup linkaccount dropbox 并按照屏幕提示操作即可。

SevenZipBackup
The very first 7-zip backup plugin for Minecraft server.
Hard drive died? Server hosting provider stopped? Accidentally deleted?
SevenZipBackup is a plugin that aims to provide an extra layer of security to your data by backing it up remotely.
Minecraft world files are numerous and fragmented, making them ideal for solid compression.So we use 7-zip to create backups for your server!
Features
- Saving up to 50% of your drive space using 7z archive with LZMA2!
- Async backup creation, create multiple backups at the same time!
- You can also upload backups to Google Drive, OneDrive, Dropbox, (S)FTP server or S3 compatible api.
- Backup any files or folders for your Minecraft server.
- Automatically purges backups locally and remotely according to a specified amount.
- Fully configurable backup interval and custom schedule.
Requirements
General Requirements
- Java 8 or higher
- Java 21 or higher recommended for compressing performance!
Platform Specific Requirements
- Bukkit/Spigot/Paper/Purpur
- Minecraft 1.8 - 1.21.X
Basic Setup
- Download the plugin and copy it to the
pluginsfolder on your server. - Restart your server.
- Edit your
config.ymlinplugins/SevenZipBackupfolder and reload plugin.
Commands
- /7zbackup backup *Backup immediately
- /7zbackup linkaccount *Bind your cloud drive account
- /7zbackup reloadconfig *Reload plugin config
- /7zbackup test *Running a test for backup tasks
- /7zbackup update *Hot update plugin
- /7zbackup nextbackup *Get next backup scheduled time
- /7zbackup status *Check backup status
- /7zbackup unlinkaccount *Unbind your cloud drive account
- /7zbackup v *Check plugin and environment version
Permissions
- 7zbackup.backup Create, test and upload backips
- 7zbackup.getBackupStatus Check backup status
- 7zbackup.getNextBackup Get next backup scheduled time
- 7zbackup.reloadConfig Reload plugin config
- 7zbackup.linkAccounts Bind your cloud drive account
Configurations
Change messages translations
- Check GITHUB and find YOUR-LANGUAGE.yml.
- Copy the content and replace them in intl.yml.
- Reload the plugin.
Local
Change local-keep-count in the config.yml to set the number of backups to keep locally. Set to -1 to keep an unlimited number of backups locally.
Once you have completed the above instructions, backups will run automatically every hour by default.
Google Drive
Simply run /7zbackup linkaccount googledrive and follow the on-screen instructions.
OneDrive
Simply run /7zbackup linkaccount onedrive and follow the on-screen instructions.
DropBox
Simply run /7zbackup linkaccount dropbox and follow the on-screen instructions.
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SevenZipBackup
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
修复黑名单规则失效
新增选项 advanced.blacklist-regex(默认 true):
- 启用(默认):模式被视为 Java 正则表达式,与完整的相对路径进行匹配,分隔符统一归一化为
/,从而确保在 Windows 和 Linux 上行为一致。 - 禁用:模式被视为 glob 模式,仍然要求对文件名或路径进行完整匹配;使用
**可以跨目录匹配。
相关改动:
BlacklistEntry现在支持两种模式,并提供统一的入口点matches(Path)。- 无效的模式仅跳过该单条规则并记录警告,而不会影响其他规则。
- FTP 外部备份的黑名单遵循相同的开关逻辑。
ConfigMigrator在首次迁移时将旧版 glob 模式转换为等效的正则表达式;看起来已经是正则表达式的字符串将原样保留,以免破坏正确编写的规则。- 修复了
generateGlobFolderList中的缺陷,其中"./" + glob前缀从未与relativize的输出匹配,这意味着 glob 分支永远无法匹配任何目录。 - 如果备份位置不匹配任何目录,现在会记录明确的警告。这种静默跳过正是导致世界备份停滞且未被察觉的原因。
修复 Folia 线程问题
runSyncTaskAndWait之前使用了无超时的future.get(),如果从全局区域线程调用,将会永久阻塞。现在它使用 30 秒超时并正确传播中断状态。同时修复了一个缺陷,即finally { complete(null) }会将任务失败掩盖为成功。runWorldTaskAndWait现在检测是否已在目标区域线程上,以避免等待自身;当单个世界失败时,调用者记录日志并继续,而不是中止整个备份过程。prepareForBackup跳过保存失败的世界,而不是中断整个运行过程。- 添加了
Scheduler.runAsyncTask(),为异步工作提供单一途径,并在AsyncScheduler不可用时提供回退方案。 SevenZipBackupApi中的裸线程已替换为由调度器管理任务,以便在插件卸载时取消它们。- 添加了
Authenticator.shutdown(),从onDisable调用,以取消 OAuth 轮询任务,消除 PlugmanX 重载后的任务泄漏。
Dropbox 授权重构
问题所在
Dropbox 不支持设备授权授予 (RFC 8628),因此无法采用 Google/OneDrive 的方式。现在改用手动配置:
- 移除了无效的
drivebackup.com端点、Authenticator客户端密钥常量以及旧的轮询分支。 /7zbackup linkaccount dropbox现在打印逐步说明。- 添加了
dropbox.client-id和dropbox.client-secret选项:在刷新令牌时优先使用,如果为空则回退到内置值。这是必需的,因为refresh_token绑定于发出它的 App,因此用户创建的 App 发出的令牌不能使用内置凭据进行刷新。 - 在
HttpLogger中将getString("msg")更改为optString,以避免在字段缺失时抛出异常。
修正版本要求
插件现在需要 1.20+ 服务器才能运行。
其他修复
/7zbackup nextbackup始终失败:Scheduler.backupDatesList从未被填充,因此orElseThrow(NoSuchElementException)传播到了命令线程。列表现在在计划期间被填充,如果为空则显示友好消息。/7zbackup update静默失败:Updater中renameTo的返回值被丢弃。在 Windows 上,插件 jar 被 JVM 保持打开状态,因此替换几乎总是失败,但插件仍报告成功。现在使用原子移动 → 删除后移动 → 显式错误回退链,并在失败时清理残留的临时文件。linkSuccess配置回滚:由enableBackupMethod写入的enabled: true被随后的reloadLocalConfig从磁盘重新读取并覆盖回false。调整了顺序,使值首先持久化。- OneDrive 授权失败:原始的错误检查仅允许
authorization_pending,即使slow_down是正常的中间状态,也将其视为致命错误。现在两者都被视为可重试的状态。
升级说明
- 此版本需要 Java 21 和 Paper/Folia 1.20.5+;它不会在旧版本上加载。
- 配置文件将在首次启动时自动迁移到正则语法;之后请检查
backup-list部分以确认结果。 - 验证世界备份是否已恢复:升级并重启后,运行手动备份并检查
backups/world是否生成了新的归档文件。 - Dropbox 用户必须创建自己的 App 并按照 README “DropBox” 部分所述填写凭据;以前基于在线服务的授权方式不再可用。
Dropbox 授权重构
- 移除失效的
drivebackup.com端点、Authenticator客户端密钥常量及旧轮询分支。 /7zbackup linkaccount dropbox改为输出分步操作指引。- 新增配置项
dropbox.client-id与dropbox.client-secret:刷新令牌时优先使用,留空才回退内置值。这一点是必要的——refresh_token与签发它的 App 绑定,用户自建 App 签发的令牌无法用内置凭据刷新。 HttpLogger中getString("msg")改为optString,避免字段缺失时抛异常。
修正支持服务端版本
- 插件现在至少需要服务端版本1.20才能使用。
其他修复
/7zbackup nextbackup必然报错:Scheduler.backupDatesList从未被填充,orElseThrow(NoSuchElementException)直接抛到命令线程。现已在调度时填充,并在列表为空时返回友好提示。/7zbackup update静默失败:Updater中renameTo的返回值被丢弃。Windows 上插件 jar 运行时被 JVM 占用,替换几乎必然失败,但插件仍提示"更新成功"。现改为原子移动 → 删除后移动 → 明确报错的降级流程,并清理失败时残留的临时文件。linkSuccess配置回滚:enableBackupMethod写入的enabled: true会被随后的reloadLocalConfig从磁盘覆盖回false,已调整顺序确保先落盘。- OneDrive 授权失败:原错误判定只放行
authorization_pending,而slow_down属于正常中间状态,一旦微软返回就被当作致命错误终止轮询。现两者均继续等待。
升级须知
- 本版本要求 Java 21 与 Paper/Folia 1.20.5+,低于此版本无法加载。
- 首次启动会自动迁移配置文件到正则写法,建议迁移后检查
backup-list段是否符合预期。 - 请确认世界备份已恢复:升级并重启后执行一次手动备份,检查
backups/world是否产生新文件。 - Dropbox 用户需按 README 的「DropBox」小节自行创建 App 并填写凭据,原有依赖在线服务的授权方式已不可用。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧