原创 开源 娱乐 SweetMail —— 开放式邮件系统 | 邮件群发 | 物品附件 | 跨服支持 | Folia 支持 [1.8-1.21] 1.0.3

[MD]
## 破坏性变更
+ 将 `top.mrxiaom.sweetmail.depend.title.ProtocolLib` 移动到 `top.mrxiaom.sweetmail.depend.protocollib.PLComponentTitle`

## 修复
+ 所用 java 版本过低，导致 jitpack 不可用的问题
+ 支持 craft-engine 物品，导致使用 java 21 以下无法加载插件的问题
+ 在页面内容数量为 `0` 时，最大页数显示不正常问题
+ 使用 SQLite 时，发送邮件5秒后报错的问题

## 新增
+ 可在配置文件指定，点击邮件图标是否打开书与笔界面

## 优化
+ 在开启 `return-when-move` 时，等待 `0.5s` 再开启监听器
+ 在前后打开菜单的大小相同时，平滑切换菜单，不移动鼠标指针 ([#41](https://github.com/MrXiaoM/SweetMail/issues/41))
+ 在关闭选择图标菜单后，重新打开草稿菜单
[/MD]

[MD]
## 破坏性变更
+ 删除 `ColorHelper`
+ `Util#legacyBook` 删除一个未使用参数

## 修复
+ 无法发布到本地仓库，导致 jitpack 不可用的问题

## 新增
+ 增加物品提供器接口，方便对接其它可提供物品作为界面图标的插件
+ 支持在界面图标使用 `CraftEngine` 物品 ([#38](https://github.com/MrXiaoM/SweetMail/issues/38))
+ 支持对接 ProtocolLib，使用修改发包的方式，在非 Paper 服务端支持在界面标题使用 MiniMessage（实验性）
+ 支持使用 PluginBase 格式的操作命令（`[console]`, `[player]`, `[message]`, `[actionbar]`, `[delay]` 等）

## 优化
+ 优化界面标题中的 `offset` 变量，支持缩写，支持不增加 font
+ 从 PluginBase 同步一些特性
[/MD]

[MD]
## 修复
+ CustomModelData 未正确应用的问题
+ 玩家进服时，数据库语句执行异常的问题

## 其它变更
+ 升级 item-nbt-api 和 FoliaLib
[/MD]

[MD]
> [资源包界面](https://plugins.mcio.dev/docs/mail/resourcepack/)正在制作，发布正式版与资源包界面的制作并不冲突，于是决定先发布正式版。

## 破坏性变更
+ 移动了依赖插件支持功能到它们该在的地方 ([18120bf](https://github.com/MrXiaoM/SweetMail/commit/18120bf1ade651f53680ddd6a4f4d2a3f4f8dab9))
- `utils.comp` -> `depend`
- `utils.mythic` -> `depend.mythic`

## 新增
+ 玩家在收件箱领取附件后，在控制台留一条日志作为简单的记录
+ 菜单图标泄露保护，拿出菜单的图标物品将会自动没收
+ 收件箱相关情况变量
+ 从 PluginBase 引入本地化管理器，将 `config.yml` 中的插件文本移到 `messages.yml`
+ 支持在收件箱/发件箱，显示简短或完整的邮件正文（默认不显示）
+ 新增附属插件 [SweetMailNotice](https://plugins.mcio.dev/docs/mail/notice)，用于给已绑定电子邮箱的玩家发送电子邮件通知
+ 支持在菜单图标使用 base64 头颅
+ （实验性）在预览正文后，移动视角以重新打开上一个菜单

## 修复与优化
+ 一些拼写错误
+ 使得 mysql 5.x 也可以正常获取最大页数
+ 玩家将错误的物品放入草稿界面的`正文`图标时，提示玩家应该拖入书与笔
+ 高版本设置 CustomModelData 报错的问题
+ 草稿过期时间判定问题
+ 重置草稿不归还附件的问题
+ 1.20.5 及以上设置菜单图标 `glow: true` 报错问题
+ `save` 命令不支持低版本（如 1.8）的问题

## 其它
+ 优化代码，优化配置文件
+ 所有消息支持 MiniMessage
+ 解耦经济接口，使其变为非必选依赖
+ 将 README 中的部分内容移到了 MCIO Plugins 文档
+ 支持 1.21.5
+ 附件接口支持设定是否可以在重置草稿时归还
+ 升级 adventure 和 MiniMessage 到最新版
[/MD]

[MD]
[界面材质](https://github.com/MrXiaoM/SweetMail/tree/resourcepacks)正在制作，这个版本可能是最后一个预览版，正式版将在我做好界面材质后，找一个有空的时间发布。

## 修复
+ Minecraft 旧版本（如 1.8）的 gson 依赖不受支持问题
+ 附件使用异常问题
+ 无法获取 BungeeCord 玩家列表的问题
+ 修复一些为插件添加新特性导致的琐碎问题

## 新增
+ Folia 支持
+ 添加“打开书”接口，第三方插件可更改“查看邮件正文”操作
+ 支持在收件箱/发件箱的物品 Lore 直接显示正文（用于龙核等场景）([#25](https://github.com/MrXiaoM/SweetMail/issues/25))
+ 针对低于 1.19.3 的旧版本，可安装前置 [LangUtils](https://github.com/NyaaCat/LanguageUtils) 以便在收件箱支持显示附件中文名
+ 支持在收件箱/发件箱的物品 Lore 显示邮件附件到期时间
+ 支持根据邮件模板发送邮件（实验性）([#28](https://github.com/MrXiaoM/SweetMail/issues/28))
+ 支持在界面标题使用 Mini Message 格式（仅支持 1.16.5+ 的 Paper 服务端），为材质界面做前置支持
+ 支持在界面标题替换 `<offset:偏移值>` 使用类似与 ItemsAdder 的 `%img_offset_偏移值%` 变量，需要配套材质包，为材质界面做前置支持

## 优化
+ 优化部分代码
+ 有限的 MySQL 5.x 数据库支持，仅仅不支持显示收件箱/发件箱的最大页数（在界面中，最大页数将替换为问号`?`）

[/MD]

[MD]
## 修复
+ 在线模式开启时，管理员无法查看系统发件箱的问题
+ 低版本不支持在物品名、物品Lore使用 component 格式的问题
+ “添加附件”界面的默认图标不支持 mc 旧版本的问题
+ 有事件以错误的形式调用，导致管理员无法发件的问题

## 优化
+ 服务端 SQLite JDBC 版本过低时进行提醒
+ 物品 ID 兼容部分 1.13 以前的旧版本物品，自动转换
+ 将硬编码的“添加附件”界面的图标移到配置文件
+ 服务器启动完成后，检查与 CMI、Essentials 插件的兼容性

## 实验性
+ 添加“支持 folia”标记，使得插件可在 folia 加载（未测试）
[/MD]

[MD]
## 修复
+ 定时发送模块未注册问题
+ 未编写右键标记全部已读功能问题
+ 菜单的 `custom-model` 选项无效问题
+ 无附件的邮件无法标记已读问题（仅限更新插件后发送的邮件，旧的邮件没办法）
+ `blacklist-players` 选项的作用范围过大问题
+ 低版本服务端无法连接数据库问题
[/MD]

[MD]
## 修复
+ 聊天补全未通过异步触发问题
+ 优化部分代码，修补漏掉的空检查
+ 时区问题导致输入的时间不正确
+ 开启正版模式（UUID匹配）时，参数过长无法存入数据库问题
+ 预览邮件文本内容时，不再设置成书标题。因为新版本设置了 32 字符限制，处理颜色后必超
+ 与旧版本 PlaceholderAPI 的兼容问题
+ 允许更宽容的日期格式，原本仅支持 `2025-01-01`，现在 `2025-1-1` 也可以了
+ 将 HikariCP 数据库连接池的依赖 slf4j 也打包到插件里，否则旧版本服务端会报错

## 新增
+ 为其它玩家打开草稿的命令
+ 邮件发送事件
+ 管理员可在玩家的发件箱界面删除玩家的邮件
+ 在草稿因为玩家手动重置，或者草稿过期重置时，在后台留一条日志作为记录
[/MD]