- ◆ 支持核心
- Arclight
- ◆ 游戏版本
- 1.21.1
CobbleBackup
作者：Polaris | Cobblemon 队伍/PC 备份插件一句话定位：为 Cobblemon 队伍与 PC 提供高可靠、可回滚的定时备份与恢复。
核心功能
- 定时备份（间隔/保留天数/每玩家最大数量可配）
- 手动备份：全员备份 / 单玩家备份
- 一键回滚：命令 + GUI，恢复前自动备份
- 备份原因标记（定时/手动/启动/关服/恢复前）
- 审计记录：最近恢复操作者与时间可追溯
- GUI 多页列表，含返回/刷新/确认保护
- 中英文多语言，支持十六进制颜色与渐变
插件命令 & 权限
| 命令 | 说明 | 权限 |
|---|---|---|
| /cobblebackup now | 立即备份所有在线玩家 | cobblebackup.admin |
| /cobblebackup backup <玩家> | 立即备份单个在线玩家 | cobblebackup.admin |
| /cobblebackup status | 查看备份状态 | cobblebackup.admin |
| /cobblebackup restore <玩家> <备份|latest> confirm | 恢复备份 | cobblebackup.admin |
| /cobblebackup gui [玩家] | 打开 GUI / 直达玩家备份 | cobblebackup.admin |
| /cobblebackup reload | 重载配置与语言 | cobblebackup.admin |
| /cobblebackup help | 查看命令帮助 | cobblebackup.admin |
兼容性
Java 21 | Minecraft 1.21.1 | Arclight 1.21.1（Bukkit + Fabric）Cobblemon 1.7.1+（优先官方 API）
安装与使用
- 将 CobbleBackup-1.0.0.jar 放入 plugins
- 启动服务器生成配置
- 按需调整配置后执行 /cobblebackup reload
- 管理员使用 /cobblebackup gui 或 /cobblebackup now
管理与配置亮点
- 备份节奏：interval-minutes / players-per-tick
- 保留策略：retention-days / max-per-player
- 安全恢复：restore-pre-backup / restore-force-save
- 可观测：控制台成功提示 + 审计记录
- 语言：zh_cn / en_us
颜色与渐变写法
支持十六进制与渐变，适用于 GUI 标题、按钮名、Lore、提示消息。- HEX 颜色：D18A文字 或 &#FFD166文字
- 渐变：<grad:#28D18A:#5CC8FF>文字</grad>
设计取舍（做什么 / 不做什么）
做什么：稳定备份、快速恢复、清晰审计、低 TPS 影响不做什么：不接管经济系统、不跨服同步、不替代 Cobblemon 原生存储
适用场景
- 长期运营 Cobblemon 服务器
- 重视数据安全与误操作恢复的服务器
- 需要管理端可视化回滚流程的团队
插件配置
YAML:
# 备份相关配置
backup:
# 是否启用定时备份
enabled: true
# 定时备份间隔（分钟）
interval-minutes: 30
# 是否仅备份在线玩家（建议保持 true）
online-only: true
# 每 tick 处理玩家数量，降低 TPS 压力
players-per-tick: 2
# 服务器启动时立即备份
backup-on-startup: false
# 服务器关闭时备份（可能拉长关服时间）
backup-on-shutdown: false
# 关服备份等待秒数
shutdown-wait-seconds: 5
# 恢复前自动做一次备份
restore-pre-backup: true
# 恢复后强制异步保存 Cobblemon 存储
restore-force-save: true
# 备份目录（相对插件目录）
dir: "backups"
# 备份保留天数（<=0 则不按天清理）
retention-days: 7
# 每玩家最大备份数（<=0 则不限制）
max-per-player: 48
# 日志输出
logging:
# 是否输出调试日志
debug: false
# 备份成功后在控制台提示
backup-success: true
# GUI 相关配置
gui:
# GUI 总开关
enabled: true
sounds:
# GUI 音效总开关
enabled: true
open:
# 打开 GUI 音效（Sound 名称）
name: "UI_BUTTON_CLICK"
# 音量（0.0 - 1.0+）
volume: 0.7
# 音高（0.5 - 2.0+）
pitch: 1.2
click:
name: "UI_BUTTON_CLICK"
volume: 0.6
pitch: 1.0
back:
name: "UI_BUTTON_CLICK"
volume: 0.6
pitch: 0.9
confirm:
name: "BLOCK_NOTE_BLOCK_PLING"
volume: 0.8
pitch: 1.6
error:
name: "BLOCK_NOTE_BLOCK_BASS"
volume: 0.8
pitch: 0.6
# 语言设置：zh_cn / en_us
language:
lang: "zh_cn"
