标记了 ☑️ 的命令代表控制台也可以执行，反之标记了 ❇️ 的只有玩家可以执行。
<> 代表必选参数，[] 代表可选参数。 根命令为 /sweetmail，可简写为 /mail 或 /sm

命令

	命令	描述	权限
	玩家命令
❇️	/mail draft	打开草稿界面	sweetmail.draft
❇️	/mail inbox [all/unread]	打开收件箱界面(所有/未读分区，默认未读)	sweetmail.box
❇️	/mail outbox	打开收件箱界面	sweetmail.box
	管理员命令
☑️	/mail draft <玩家>	为某人打开草稿界面	sweetmail.draft.other
☑️️	/mail inbox <all/unread> <玩家>	为某人打开收件箱界面	sweetmail.box.other
☑️	/mail outbox <玩家>	为某人打开发件箱界面	sweetmail.box.other
❇️	/mail admin inbox <all/unread> <玩家>	打开某人的收件箱界面	sweetmail.admin
❇️	/mail admin outbox <玩家>	打开某人的发件箱界面	sweetmail.admin
❇️	/mail admin outbox #Server#	打开系统发件箱界面	sweetmail.admin
☑️	/mail admin timed <定时序列>	查看定时发送邮件序列简要信息	sweetmail.admin
☑️	/mail admin cancel <定时序列>	取消定时发送邮件序列	sweetmail.admin
❇️	/mail save <模板>	将你的草稿保存为邮件模板	sweetmail.admin
☑️	/mail send <模板> <接收者表达式> [参数...]	根据已配置的模板发送邮件（接收者表达式详见下文）	sweetmail.admin
☑️	/mail players <接收者表达式> [--book/-b]	计算接收者表达式最终的玩家列表（用于测试）	sweetmail.admin
☑️	/mail reload database	重载并重新连接数据库	sweetmail.admin
☑️	/mail reload	重载配置文件，不重连数据库	sweetmail.admin

备注

• send 命令中的 [参数...] 的格式是 键=值，多个参数使用空格来隔开。对于有哪些参数，在模板配置中定义，详见示例模板的变量配置。

接收者表达式

接收者表达式用于进行快速地添加泛收件人，可以使用以下格式

• 玩家名 将邮件发送给指定玩家
• 玩家1,玩家2,玩家3 使用逗号分隔玩家名，将邮件发送给多个指定玩家
• @all 发送给所有在指定时间内登录过游戏的离线玩家，默认时间阈值在配置文件中指定
• @all[timespan=30d]/@all[ts=30d] 同上，但自定义时间阈值，时间格式在下方说明
• @all[from=5-25] 同上，但自定义时间阈值，时间格式在下方说明
• @all[from=5-25,to=6-25] 同上，但自定义时间阈值，时间格式在下方说明
• @self/@me 发送给自己，该选项仅限玩家执行命令时使用
• @online 发送给所有在线玩家
• @online[bc] 发送给所有从群组端获取的在线玩家，需要目标玩家在当前子服登录过才会添加到接收者列表

时间格式

适用于 timespan (ts) 的时间格式 天数d小时数h分钟数m秒数s，如 1d2h3m4s，不输入的单位默认取 0。

适用于 from 和 to 的时间格式

• 月-日 年取今年，时分秒取零
• 年-月-日 时分秒取零
• 年-月-日_时 分秒取零
• 年-月-日_时:分 秒取零
• 年-月-日_时:分:秒 完整格式

权限

• sweetmail.admin 邮件管理员权限，可在草稿打开高级设置发送系统邮件等
• sweetmail.icon.<图标> 允许使用某个预设图标 (配置文件的 preset-icons)
• sweetmail.icon.custom 允许使用自定义图标 (在选择图标界面使用物品栏里的物品)
• sweetmail.price.<价格组> 设定玩家在哪个价格组内，详见配置文件 price 的注释
• sweetmail.notice 玩家是否在收到新邮件时、上线时接收新邮件通知
• sweetmail.attachment.command 允许使用控制台命令附件 (不推荐给玩家)
• sweetmail.attachment.money 允许使用金币附件
• sweetmail.attachment.item 允许使用物品附件

以下是在邮件标题、正文中使用 MiniMessage 格式的权限。旧版的 & 格式会先转换为 MiniMessage，再进行权限判断，剔除无权限的标签。

1.0.4 新增

• sweetmail.format.all 所有标签（不推荐给玩家）
• sweetmail.format.color.basic 基本颜色和十六进制颜色
• sweetmail.format.color.gradient 渐变颜色
• sweetmail.format.color.rainbow 彩虹颜色
• sweetmail.format.decoration.basic 加粗、斜体、下划线、删除线
• sweetmail.format.decoration.bold 加粗
• sweetmail.format.decoration.italic 斜体
• sweetmail.format.decoration.underline 下划线
• sweetmail.format.decoration.strike 删除线
• sweetmail.format.decoration.obfuscated 乱码
• sweetmail.format.shadow 文字阴影
• sweetmail.format.font 自定义字体
• sweetmail.format.translatable 客户端翻译
• sweetmail.format.keybind 按键显示
• sweetmail.format.hover 悬停显示
• sweetmail.format.click 点击操作
• sweetmail.format.insertion Shift点击插入操作