SweetMail 邮箱插件

SweetMail 插件介绍
概述

SweetMail 是一款面向 Minecraft Java 版服务端的玩家友好型图形化邮件系统插件，由 MrXiaoM（人间工作）开发并开源。插件允许玩家之间以及服务器向玩家发送"邮件"，邮件可携带游戏内物品、金币、控制台命令等附件，并支持 BungeeCord/Velocity 跨服通知、跨服务器查看与发送邮件。作者开发初衷是现有免费/付费邮件插件（含全球市场插件内置邮件系统）在物品附件与功能丰富度上均不尽如人意，因此自行设计了一款对玩家友好、功能相对强大的邮件插件。
插件名称：SweetMail（甜邮件）
开发者：MrXiaoM
最新版本：1.1.10（2026-05-29）
许可协议：AGPL-3.0（完全开源）
源码：https://github.com/MrXiaoM/SweetMail
项目地址：
Modrinth：https://modrinth.com/plugin/sweetmail
MineBBS：https://www.minebbs.com/resources/sweetmail-1-8-1-21.9922
MCIO Plugins 文档：https://plugins.mcio.dev/docs/mail/intro
说明：本插件优先在 GitHub 更新，Modrinth 与 MCIO Plugins 提供镜像下载；默认配置文件为中文，英文等其它语言可查阅 localization 仓库。目前官方 Wiki 仅提供中文版本。
兼容性

| 项目 | 说明 |
|---|---|
| 游戏版本 | Minecraft Java Edition 1.7.10、1.8–1.21.x、26.1.x |
| 服务端平台 | Bukkit、Spigot、Paper、Folia、Purpur、PufferFish、Leaves 等 |
| Java 版本 | 构建需 Java 21，构建产物目标为 Java 8（1.1.0+ 的 modern 构建适用于 1.17+）|

版本差异提示：
1.13 起进行扁平化，弃用数字 ID 与 Data 值（子 ID）；如需使用旧版子 ID 特性，在 ID 后加冒号，如 WOOL:15，插件不再支持数字 ID，请使用英文 ID。
1.14 起加入 CustomModelData，更旧版本设置的该选项无法用于资源包模型谓词。
1.19.3 起 Bukkit API 加入 Translatable 接口，可正常显示附件物品原版中文名；更低版本需安装前置 LangUtils 以显示原版物品名。
资源包界面仅在 Paper 及其衍生服务端 1.16+ 上可用。
核心特性
图形化邮件系统
全图形界面操作，玩家通过箱子菜单即可完成收件、发件、查看附件、领取附件等全部操作，使用门槛低。
丰富的附件类型
邮件支持多种附件，可通过权限控制玩家可用范围：
物品附件：邮件携带游戏内 ItemStack，支持 ItemsAdder、MythicMobs、CraftEngine、NeigeItems 等第三方物品提供器
金币附件：需搭配 Vault（经济插件）
控制台命令附件：领取时执行预设控制台命令（不推荐授予普通玩家）
邮件草稿
每位玩家拥有且仅拥有一个草稿，使用 /mail draft 创建或编辑。收件人、标题、内容、附件均在草稿界面中点击编辑。草稿目前不支持跨服同步——若部署在多服区，每位玩家在每个服区拥有各自独立的草稿。
系统邮件与泛收件人
管理员可在草稿中打开"高级设置"发送系统邮件，支持自定义发件人显示名，并可配置泛收件人（broad recipients），例如：近 7 天登录过的玩家、当前服务端所有在线玩家、通过代理获取的全服网络所有在线玩家等。
跨服支持
支持 BungeeCord / Velocity 代理网络下的跨服邮件通知、跨服务器查看与发送邮件；需配合 MySQL/PostgreSQL 等数据库实现多服数据同步（SQLite 不支持跨服）。
多语言与本地化
默认配置为中文；英文及其它语言文件可查阅 localization 仓库。玩家收到新邮件时、上线时可接收未读邮件通知（受 sweetmail.notice 权限控制）。
模板邮件与开发者 API
提供 IMail 接口，开发者可通过链式调用 IMail.api().createSystemMail(...).setIcon().setTitle().addContent().addAttachments().send() 以编程方式发送系统邮件；支持注册自定义附件类型、替换书本实现（草稿/收件箱/发件箱界面的打开成书逻辑）。构建产物目标 Java 8，便于老服集成。
可选软依赖
Vault（经济/金币附件）、PlaceholderAPI（邮件正文 PAPI 变量替换，1.1.0+）、ProtocolLib（非 Paper 服务端可选）、ItemsAdder / MythicMobs / CraftEngine / NeigeItems（第三方物品）、LangUtils（低版本物品中文名）等，按需安装。
安装方法
环境要求
Minecraft 1.7.10 或 1.8 及以上服务端
Java 21+ 运行环境（插件构建目标为 Java 8，主流服务端均可加载）
推荐使用 Paper 及其衍生核心（Folia/Purpur 等）以获得资源包界面与最佳 Adventure 兼容性
标准安装
从 Modrinth / MineBBS / GitHub Releases 下载 SweetMail-1.1.10-plugin.jar（约 833 KB）。
将 JAR 文件放入服务端的 plugins/ 目录。
启动或重启服务器，插件会自动生成配置文件与语言文件。
按需编辑配置文件（作者特别提醒：正式投入使用前请先阅读并修改配置文件内容）。
通过插件提供的重载机制使配置生效。
跨服网络安装
在每个服务端安装 SweetMail。
配置 MySQL / PostgreSQL 数据库（SQLite 不支持跨服），确保各服务端共用同一数据库。
按需配置 BungeeCord / Velocity 代理的消息通道以实现跨服通知。
适用场景
需要玩家间私信/物品赠送邮件系统的生存、RPG、小游戏服务器
希望通过系统邮件向玩家群发奖励、公告、活动通知的运营场景
BungeeCord / Velocity 跨服网络中需要统一邮件收发的多服务端架构
需要对接其它插件通过邮件模板命令发送奖励的开发场景
1.7.10 至最新 26.1.x 广泛版本覆盖的老服迁移与长期运营
相关链接
Modrinth 项目页：https://modrinth.com/plugin/sweetmail
MineBBS 资源页：https://www.minebbs.com/resources/sweetmail-1-8-1-21.9922
GitHub 源码：https://github.com/MrXiaoM/SweetMail
MCIO Plugins 文档：https://plugins.mcio.dev/docs/mail/intro
官方 Wiki（中文）：https://plugins.mcio.dev/docs/mail/