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

[MD] ## 修复 + PAPI 变量刷新问题 ([#52](https://github.com/MrXiaoM/SweetMail/issues/52)) + 统一使用 UTF-8 编码读写配置，以免在旧版本出现编码问题 + 在 1.7.10 使用旧方案来修改 NBT，以免出现自定义标签被覆盖的问题 + 在点击邮件图标后，立即设置 `read` 标志，以免多次提交数据库变更 + 增加重写 PAPI 变量的 `persist()` 方法，以免执行 `/papi reload` 之后掉变量 ([#53](https://github.com/MrXiaoM/SweetMail/issues/53)) + 修复因为错误判定参数长度，导致 `/mail draft [玩家]` 命令无法使用的问题 + 增加更加严格的金币扣除结果判定，修复可能出现的刷金币问题 + 如果服务端支持自动下载依赖库，则使用服务端根目录的 `libraries` 文件夹，修复部分场景下依赖版本不一致导致的冲突问题 ## 新增 + 使用 `/mail send` 命令时，支持指定未在当前服务器登录过的玩家 + 支持 1.7.10 (实验性功能)，但存在一些限制，例如无法一键打开邮件正文预览，需要玩家手动右键点击服务端发到手中的假成书物品 ## 优化 + 升级部分依赖库 [/MD]

[MD] ## 修复 + 与 Multiverse-Core 5.1.0+ 的兼容性 ([#51](https://github.com/MrXiaoM/SweetMail/issues/51)) + 领取附件后的菜单图标刷新问题 ## 新增 + 可以在菜单图标使用 NeigeItems 物品 ## 优化 + 升级部分依赖库 + 仅在依赖插件已安装时，添加相应物品提供器支持 [/MD]

[MD] ## 破坏性变更 + 由于增加 modern 构建，所有与 `adventure` 相关的方法签名变动，只要没有用什么犄角旮旯里的工具类、没有用之前通过 shadowJar 打包到 SweetMail 里的 `adventure` 接口，不会有什么影响 ## 新增 + 在邮件正文中支持 PAPI 变量（在显示时替换变量，而非在发送时替换变量） + 支持 1.21.7/1.21.8 + 添加过时书本实现选项，可选使用更稳定的方法打开邮件正文预览 + 支持在领取附件时，向玩家发送领取详情提示信息 ## 修复 + 发送模板邮件时，图标显示异常问题 + 管理员在草稿取回控制台命令附件时，会执行命令的问题 + 在部分低版本（如 1.18）启用插件时，出现不影响正常使用的报错的问题 ## 优化 + 添加 modern 构建，适用于 1.17+，在 Paper 服务端以获得最好体验 + 使用 modern 构建时，如果使用 Paper 及其衍生服务端（包括 Folia），则会使用本地的 adventure 平台实现而不是 `adventure-platform-bukkit`，以实现最高兼容 + 将 legacy 构建和 modern 构建合并为 plugin 构建，使用 [LibrariesResolver](https://plugins.mcio.dev/elopers/base/resolver) 处理外部依赖。新的构建理论上适用于 `1.8+`、`Java 8+` 版本 + `IMail` 接口的部分方法改为统一的链式调用样式，同时不造成破坏性变更 + 在 `1.16.5+` 版本，防止领取附件时背包空间不足时，溢出掉落的物品被其它玩家/实体捡走 [/MD]

[MD] ## 修复 + 在修改物品Lore时，没有读取为 MiniMessage 导致富文本降级的问题 + 未判定大小写，过时的大写 `§X` 十六进制颜色传入 MiniMessage 序列化器，导致报错问题 + 在草稿界面，邮件附件的 lore 没有替换 PAPI 变量的问题 + 部分泛收件人（如在线玩家、群组在线玩家等）在正版模式计算不正常问题 + 在草稿高级设置界面设置的时间只能使用 `XX:XX:XX` 格式，不能省略最前面的 `0` 的问题 ## 新特性 + 支持 1.21.6 + 支持在 `/mail send` 命令指定多个收件人，详见[文档](https://plugins.mcio.dev/docs/mail/commands/#%E6%8E%A5%E6%94%B6%E8%80%85%E8%A1%A8%E8%BE%BE%E5%BC%8F) ([#42](https://github.com/MrXiaoM/SweetMail/issues/42)) + 支持在邮件正文使用 MiniMessage + 要求玩家有权限才能在邮件标题和正文使用颜色以及富文本格式 ## 其它变更 + 遵循 [item-nbt-api 文档](https://github.com/tr7zw/Item-NBT-API/wiki/Using-Gradle#option-2-shading-the-nbt-api-into-your-plugin-not-recommended)的建议，添加空文件 `.mojang-mapped` 到插件 + 将一些硬编码的文字移到语言文件 [/MD]

[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]