原创 开源 ThinkrainBackup-让备份变得更加便捷~ 1.1.3-Bate

============================================================
ThinkrainBackup 插件介绍
============================================================

【插件名称】ThinkrainBackup
【插件版本】v1.13
【适用版本】Minecraft 1.21 ~ 1.21.11 (Paper/Bukkit API)
【开发语言】Java 21
【作者】Thinkrain

------------------------------------------------------------
一、插件简介
------------------------------------------------------------

ThinkrainBackup 是一款专为 Minecraft 服务器设计的世界备份
管理插件，支持自动定时备份、手动备份、一键回退等功能，
并集成 RAM 内存监控与二次元风格邮件报警系统。

------------------------------------------------------------
二、核心功能
------------------------------------------------------------

1. 自动备份
- 自动备份 world / world_the_end / world_nether 三个世界文件夹
- 压缩为 ZIP 格式，命名为 thinkrain_Backup_x.zip（x为编号）
- 默认每 10 分钟备份一次，可通过指令修改间隔
- 备份开始时在游戏内广播提示玩家
- 备份间隔与开关状态持久化存储于 config.yml

2. 手动备份
- 指令 /tb back now 立即执行一次备份
- 备份完成时在游戏内广播通知

3. 备份回退
- 指令 /tb unback <编号> 回退到指定备份
- 自动卸载当前世界，用备份内容完全替换
- 替换完成后 30 秒自动关闭服务器，提示管理员重启
- 替换失败时提示管理员手动操作

4. 备份清理与重编号
- 当备份数量超过 20 个时，自动删除最旧的 15 个
- 删除后将剩余备份重新编号为 1~5
- 新生成的备份从编号 6 开始递增
- 保持备份文件有序，避免编号无限增长

5. RAM 内存监控（静默检测）
- 每 60 秒检测一次服务器 RAM 占用
- 静默检测，不在控制台定期输出 RAM 占用日志
- 当 RAM 占用超过 80% 时：
* 发送二次元软萌猫猫主题 HTML 邮件报警
* 在游戏内广播通知管理员
- 同一次高内存事件仅报警一次，RAM 恢复后才会再次触发

6. 插件总开关
- config.yml 中新增 plugin-enabled 字段
- false = 关闭插件（不初始化任何功能）
- true = 开启插件（默认值）
- 关闭时在控制台提示管理员

7. 配置文件智能更新（增量式）
- 检测到旧配置缺少必要字段时，在旧配置中添加缺失字段
- 保留用户原有的所有配置内容，不会丢失已填写的 SMTP 信息
- 不再替换整个配置文件，升级更安全

8. 战斗血量显示
- 玩家攻击生物时，在生物头顶显示剩余血量

9. Tab 指令补全
- 所有指令支持 Tab 键自动补全
- 根据上下文提供智能建议

------------------------------------------------------------
三、指令列表
------------------------------------------------------------

/tb - 查看帮助
/tb help - 查看帮助
/tb back now - 立即执行一次备份
/tb back open - 开启自动备份
/tb back stop - 关闭自动备份
/tb back time <分钟> - 设置自动备份间隔（分钟）
/tb back time - 查看当前备份间隔
/tb unback <编号> - 回退到指定编号的备份
/tb unback - 查看当前备份数量

权限节点：thinkrain.backup.admin（默认仅 OP 可用）

------------------------------------------------------------
四、配置文件说明 (config.yml)
------------------------------------------------------------

# 插件总开关（false=关闭插件, true=开启插件）
plugin-enabled: true

# 自动备份间隔（分钟）
backup-interval: 10

# 自动备份开关（true=开启, false=关闭）
auto-backup-enabled: true

# 邮件报警配置（RAM超80%时发送）
mail-alert:
enabled: true # 默认关闭
smtp-host: smtp.qq.com # SMTP服务器地址
smtp-port: 465 # SMTP端口
smtp-username: "xxx@qq.com" # SMTP账号
smtp-password: "授权密钥" # SMTP授权密钥
mail-to: "xxx@example.com" # 报警接收邮箱

------------------------------------------------------------
五、两个版本的区别
------------------------------------------------------------

功能 默认
─────────────────────────────────────────────────
邮件报警默认 关闭 (enabled: false)
SMTP配置 需管理员手动填写
接收邮箱 需管理员手动填写
RAM静默检测 支持
备份重编号 支持
插件总开关 支持
配置增量更新 支持
JAR命名格式 ThinkrainBackup-x.xx
------------------------------------------------------------
六、安装与使用
------------------------------------------------------------

1. 将 JAR 文件放入服务器的 plugins 文件夹
2. 启动服务器，插件会自动生成默认配置文件
3. 根据需要修改 plugins/ThinkrainBackup-*/config.yml
4. 重启服务器使配置生效

【升级说明】
- 直接替换 JAR 文件即可升级
- 旧版配置文件会被保留，仅自动添加新增的缺失字段
- 用户已填写的 SMTP 等配置不会丢失

------------------------------------------------------------
七、技术特性
------------------------------------------------------------

· 世界保存/卸载/关闭操作均在主线程执行，避免异步异常
· 文件压缩/解压在异步线程执行，不阻塞主线程
· 通过 Bukkit.getWorldContainer() 正确定位服务器根目录
· ZIP 解压包含路径穿越防护（Zip Slip 漏洞防御）
· RAM 监控采用静默模式，不影响控制台日志整洁度

============================================================
ThinkrainBackup - 让你的世界永不丢失
============================================================