Chunk Backup v2.0.0 —— 焕新登场！

⚠️ 重要提醒
v2.0.0 是一次完全重写的大版本升级，与旧版 v1.x 不兼容！
旧版备份数据无法直接在新版中使用，请务必阅读下方的「升级指南」。

---

✨ 新版本亮点

经过数月的重构与打磨，Chunk Backup v2.0.0 正式发布！本次更新带来了更强大的功能、更安全的操作以及更友好的用户体验。以下是主要变化：

🧩 全新命令系统

• 基于 MCDReforged 原生命令节点重写，支持 Tab 补全、参数提示和详细的指令帮助。
• 指令更直观，告别旧版复杂难记的语法。例如：
  • !!cb make 5 -s "我的备份" —— 半径备份并存储为静态备份。
  • !!cb back 3 -d —— 回档第3个备份并同时恢复玩家数据。

🛡️ 任务队列与确认机制

• 所有耗时操作（备份、回档、删除）均作为独立任务运行，避免阻塞服务器主线程。
• 新增 !!cb confirm 和 !!cb abort 指令，可随时确认或中断等待中的任务，彻底告别误操作。

🔄 智能版本适配

• 自动检测 Minecraft 服务端版本，无缝支持 1.20.5/1.21（26.1+） 后的新世界存储结构（dimensions/minecraft/...）。
• 无需手动修改配置文件，插件自动切换路径规则。

👤 玩家数据备份（需 Carpet Mod + candy_tools）

• 集成 Carpet Mod 和 candy_tools 插件，备份时自动收集选区内的玩家数据（物品栏、坐标、成就等）。
• 回档时添加 -d 参数即可同时恢复玩家数据，确保玩家进度与建筑同步。

📜 完整操作日志

• 每次备份、回档、删除操作都会生成详细日志，保存最近 100 条 记录。
• 通过 !!cb log list 和 !!cb log show 可查看任务状态、执行者、执行时间及结果。

🗂️ 备份索引文件

• 每个备份目录下生成 index.json，明确记录备份范围与外部区块，确保备份的完整性和可恢复性。
• 重要提示：info.json 是备份的核心标识，切勿手动删除或修改，否则备份将失效。

⚡ 高性能并发处理

• 使用线程池并行处理多个区域的区块导出/合并操作，大幅提升备份与恢复速度。
• 支持配置最大并发线程数（max_workers），在性能与资源占用间取得平衡。

🌍 多维度支持

• 配置文件支持自定义多个维度，可轻松添加模组维度（如暮色森林）。
• 每个维度可指定世界文件夹、区域文件夹路径、描述和整数 ID（用于命令输入）。

🛡️ 安全可靠的任务管理

• 自动回滚保护：回档前自动创建“回档前备份”（overwrite），若回档失败，插件会自动尝试恢复到此状态，最大限度保护存档。
• 重型任务与轻型任务分离，互不干扰。

🎮 人性化命令设计

• 提供详细的指令帮助，输入 !!cb help <指令> 即可查看用法示例。
• 支持 -s（静态备份）、-d（恢复玩家数据）、-c（跳过确认）等便捷参数。

---

⚠️ 不兼容性说明

由于 v2.0.0 完全重构了备份元数据格式、目录结构和任务调度逻辑，因此：

• 旧版本（v1.x）创建的备份无法直接在新版中恢复。
  如果你有重要旧备份，建议先使用旧版插件将其恢复到世界，再使用新版插件重新备份。
• 配置文件已大幅调整，旧版配置文件（chunk_backup.json）无法自动迁移。
  请删除旧配置文件，让插件在首次加载时生成默认配置，然后根据你的需求重新修改。
• 命令格式和权限体系已改变，原 !!cb make、!!cb back 等指令的语法有所不同，请查阅本文档的「指令帮助」部分。

---

🚀 升级指南

1. 备份你的世界和旧版插件数据（包括 cb_multi、cb_static 等文件夹）。
2. 卸载旧版插件（删除旧版 .mcdr 文件）。
3. 安装新版插件及前置插件 candy_tools（必须）：
   • !!MCDR plugin install candy_tools
   • !!MCDR plugin install chunk_backup
4. 启动 MCDR，插件会自动生成默认配置文件 config/chunk_backup/config.json。
5. 根据你的需求修改配置文件（特别是维度设置），然后输入 !!cb reload 重载。
6. 重要：如果你有重要的旧版备份需要保留，请先用旧版插件将备份恢复到世界，然后用新版插件重新备份这些区域。
7. 开始使用新版插件。

关于自定义备份：新版插件暂时不支持旧版的自定义备份（custom）功能。我们计划在未来版本中开发一个功能更强大、更易于使用的自定义备份系统，敬请期待。当前版本仅支持区块级备份和区域级备份。

---

Chunk Backup v2.0.0 —— 更安全、更强大、更易用的区块备份插件，期待你的体验！