玩家邮箱
玩家输入 /sm（或 /sm open）打开自己的邮箱，需要权限 starmail.use（默认所有人都有）。
下面说明的是默认的箱子菜单，所有位置、材质与文字都可以在 menus/mailbox.yml、menus/mail.yml 修改，见 菜单。
服务器装了云界面时，/sm 会打开全屏的邮箱 画面（左边邮件列表、右边信件与附件），领取与删除的规则和这一页相同。见 云界面邮箱。
邮箱主界面
默认是 6 行的箱子界面，中间 4 × 7 = 28 格放邮件，最新的邮件在最前面。超过 28 封会出现翻页箭头。
| 格位 | 按钮 | 作用 |
|---|---|---|
| 0 | 操作说明（知识之书） | 只显示，列出点击方式 |
| 4 | 邮箱概览（你的头像） | 只显示：未读数、待领附件数、邮件总数、当前筛选与页码 |
| 8 | 关闭（屏障） | 关闭界面 |
| 45 / 53 | 上一页 / 下一页 | 只有前面 / 后面还有页时才出现 |
| 47 | 筛选（望远镜） | 左键切到下一个筛选，右键切回上一个 |
| 48 | 全部标为已读 | 把邮箱里的未读邮件全部标为已读；没有未读时变灰 |
| 49 | 一键领取 | 领取所有邮件的附件；没有可领的附件时变灰 |
| 50 | 删除已读邮件 | 删除已读、且没有待领附件的邮件，需要连按两次确认 |
| 51 | 写信 | 打开写信界面；没有写信权限或服务器关闭了玩家互寄时不显示 |
邮箱打开期间收到新邮件、或在别的子服领取了附件，界面会自动刷新。
邮件图标
每封邮件按状态显示不同图标：
| 状态 | 默认图标 | 标题前的符号 | 什么时候 |
|---|---|---|---|
| 附件待领取 | 箱子 CHEST | 金色 ✉ | 有物品、金币、点券或指令奖励还没领取 |
| 未读 | 书与羽毛笔 WRITABLE_BOOK | 青色 ✉ | 没有附件、还没看过 |
| 已读 | 纸 PAPER | 灰色 ✉ | 没有附件、已经看过 |
| 附件已领取 | 地图 MAP | 深灰 ✔ | 附件已经领取 |
- 未读的邮件带有附魔光效（
glow-unread）。 - 附件待领取时，如果寄件的插件指定了图标（例如抽奖奖励显示奖品的图标），会改用那个图标（
use-mail-icon）。
说明文字
鼠标移到邮件上会看到：
- 类型与编号：例如「管理员邮件 · #128」。编号用于
/sm restore、/sm log等管理指令。 类型有：系统（插件或 API 寄出）、管理员（管理员写信或指令）、玩家（玩家互寄）、退回（退信与溢出退回）、全服（全服邮件）。 - 寄件人、时间（以及「3 小时前」这样的相对时间）。
- 过期时间：只有设了期限、而且附件还没领取的邮件才显示，例如「过期 6 天后」。永不过期的不显示。
- 正文预览：前 3 行，太长时显示「…… 点开阅读全文」。
- 附件预览： 最多 5 项（物品名称 × 数量、金币、点券、附件说明），超过时显示「还有 N 项」。 只有指令奖励而没写附件说明时，显示「特殊奖励 × 指令数量」。
- 可用的操作：只列出这封信现在能做的操作，例如已经领取的信不会出现「右键领取」。
筛选
| 筛选 | 显示 |
|---|---|
| 全部 | 所有邮件 |
| 未读 | 还没看过的邮件 |
| 待领取 | 附件还没领取的邮件 |
切换筛选会回到第 1 页。
点击邮件
| 操作 | 效果 |
|---|---|
| 左键 | 打开这封邮件（单封邮件界面），同时标为已读 |
| 右键 | 附件待领取时直接领取；没有可领的附件时等同左键打开 |
| Shift + 左键 | 关闭界面，用书本阅读全文，同时标为已读 |
| Shift + 右键 | 删除这封邮件，4 秒内再按一次才会真的删除 |
默认情况下，附件还没领取的邮件不能删除，提示「附件还没领取，不能删除」。
服主可以在 config.yml 把 mail.allow-delete-unclaimed 改成 true，这时删除会特别警告「附件会一起消失」，同样要连按两次。
一键领取
点「一键领取」（或输入 /sm claimall）会领取邮箱里所有附件待领取的邮件：
- 插件先模拟一遍你的背包，按邮件从新到旧逐封检查放不放得下。
- 放得下的邮件全部领取：物品进背包，金币、点券直接入账，指令奖励自动执行。
- 放不下的邮件整封保留在邮箱里，不会拆开领一半。聊天栏提示「背包已满，还有 N 封邮件没领取，整理背包后再领」。
- 领完提示「已领取 N 封邮件（物品 X · 金币 Y · 点券 Z）」。
几种特殊情况：
| 情况 | 结果 |
|---|---|
| 邮件附带金币，但服务器没有 Vault 经济插件 | 这封信跳过不领，提示无法领取金币 |
| 邮件附带点券，但服务器没有 PlayerPoints | 这封信跳过不领，提示无法领取点券 |
| 附件数据读不出来 | 这封信跳过不领，提示「邮件 #编号 的附件数据无法读取」，请联系管理员（见 跨服设置 的版本说明） |
| 同一封信已经在别的子服领过了 | 不会重复发放，提示「N 封邮件已经被领取过了」 |
| 领取过程中背包变化导致少数物品放不下 | 默认另寄 一封「背包已满 · 物品退回」的信给你，见 config.yml 的 mail.overflow |
全部已读 / 删除已读
- 全部标为已读：只改变已读状态，不会领取附件。
- 删除已读邮件：删除「已读、而且没有待领附件」的邮件（已经领完附件的、纯文字已读的）。 第一次点按钮会变成 TNT「再按一次确认删除」，4 秒内再点一次才执行。附件还没领取的邮件不会被删除。
删除的邮件不会立刻消失在数据库里，默认保留 14 天，管理员可以用 /sm restore 恢复，见 管理员写信与管理。
单封邮件界面
在邮箱里左键点一封邮件打开。默认布局：
| 格位 | 按钮 | 作用 |
|---|---|---|
| 4 | 信封 | 标题、类型与编号、寄件人、时间、期限；材质随状态变化 |
| 13 | 信件内容（成书） | 说明里显示完整正文；点击用书本阅读 |
| 19 – 43 中间三行 | 附件 | 物品原样显示（可以看到附魔与说明），金币、点券、附件说明各占一格 |
| 45 | 返回邮箱 | 回到原本的页码与筛选 |
| 46 / 52 | 附件上一页 / 下一页 | 附件超过 21 格时出现 |
| 47 | 阅读全文（书） | 用书本阅读 |
| 49 | 领取附件 | 显示物品组数、金币、点券；领取后变成「✔ 附件已领取」。没有附件的信不显示 |
| 51 | 删除这封邮件 | 点一次变成 TNT「再按一次确认删除」，4 秒内再点才删除；附件还没领取时变成灰色的桶「附件领取后才能删除」 |
| 53 | 回信 | 只有玩家寄来的信才显示，见下方 |
- 打开邮件就会标为已读。
- 领取后，附件格里的物品说明最后会加一行「✔ 已领取」（
dim-claimed-attachments）。 - 领取单封邮件时如果背包放不下，整封不领，提示「背包空间不足，需要 N 个空格」。
书本阅读
「Shift + 左键」、点信件内容或「阅读全文」都会关闭箱子界面，打开一本书：第一页是标题与寄件人，接着是全部正文，长的信会自动分页。 看完按 Esc 关闭书本即可。
回信
玩家寄来的信会有「回信」按钮。点了会打开写信界面，收件人自动填好寄件人，标题自动加上「回复：」。
需要写信权限 starmail.write，服务器关闭玩家互寄时不显示。写信规则见 玩家写信。
过期
- 每封邮件可以有期限：管理员、系统、插件寄的信默认 30 天，玩家互寄默认 7 天（
config.yml的mail区块）。 - 到期的那一刻邮件就会从邮箱里消失，未领取的附件也随之失效。
- 玩家寄出的信过期时如果附件还没领取，附件会退回给寄件人（默认开启）。
- 过期的邮件同样保留一段时间（
mail.keep-deleted-days），管理员可以恢复。
提示
| 时机 | 提示 |
|---|---|
| 上线 | 3 秒后提示「你有 N 封未读邮件，M 封附件待领取」，点击打开邮箱（默认只有在有未读或待领时才提示） |
| 收到新邮件（在线） | 聊天栏一行可点击的提示、屏幕标题、音效；跨服寄来的在几秒内提示 |
| 有附件没领 | 每 15 分钟提醒一次 |
这些都可以在 config.yml 的 notify 区块调整或关闭，见 config.yml。