云界面邮箱
服务器装了 云界面 CloudUI 时，玩家输入 /sm 打开的不再是箱子菜单，而是一个全屏的邮箱画面：左边是邮件列表，右边是选中的信件与附件。
不用另外设置，装好云界面、重启服务器就会自动启用。
启用条件
| 条件 | 说明 |
|---|---|
| 安装云界面 CloudUI | 开服时控制台显示「检测到云界面 CloudUI：邮箱将使用云界面画面（无法显示的玩家仍使用箱子菜单）」 |
config.yml 的 menu.cloudui: true | 默认就是 true；改成 false 则一律使用箱子菜单。这个设定要重启才会生效 |
| 授权已验证 | 授权还没通过时 /sm 本来就不能用 |
第一次连接时，星月邮箱会把画面文件装进云界面的资料夹：
| 文件 | 内容 |
|---|---|
plugins/CloudUI/screens/starmail/starmail.yml | 画面布局（元素位置、字体、颜色、动画） |
plugins/CloudUI/images/starmail/*.png | 背景、面板、按钮、邮件行、附件格等图片 |
已经存在的文件不会被覆盖，你改过的画面在升级后会保留。想恢复默认，删掉对应的文件后重启即可重新安装。
哪些地方会打开云界面
| 操作 | 打开 |
|---|---|
/sm、/sm open | 云界面邮箱 |
| 点击聊天栏的「新邮件」「上线提示」「未领取提醒」 | 云界面邮箱 |
其他插件调用 StarMailAPI.open(player) | 云界面邮箱 |
/sm write、画面里的「写信」「回信」 | 箱子菜单的写信界面（关闭云界面后打开） |
/sm view <玩家>、/sm admin、/sm template | 箱子菜单（管理功能都用箱子菜单） |
什么时候改用箱子菜单
以下玩家会自动打开原本的 箱子菜单邮箱，功能完全一样：
- 云界面判断无法显示画面的玩家：例如拒绝了服务器资源包的玩家、基岩版玩家；
- 当下打不开云界面画面时（例如云界面要求玩家站在地面上，而玩家正在半空中）。
画面说明
左边：邮件列表
| 区域 | 说明 |
|---|---|
| 标题与计数 | 「星月邮箱」与「未读 N · 待领取 N · 共 N 封」 |
| 写信 | 打开写信界面；没有 starmail.write 或服务器关闭玩家互寄时不显示 |
| 筛选分页 | 全部 / 未读 / 待领取，点一下切换，回到第 1 页 |
| 邮件行 | 每页 6 封：图标、标题、「寄件人 · 多久以前」、右边的状态（待领取 / 已领取 / 未读 / 已读，各有颜色）。未读与选中的邮件行外观不同 |
| 翻页 | 列表下方的 ‹ › 与页码 |
| 一键领取 N | 领取全部附件（N = 待领取的封数）；没有可领取时不显示 |
邮件行的操作：
| 操作 | 效果 |
|---|---|
| 左键 | 选中这封邮件，在右边显示 |
| 右键 | 选中这封邮件，如果附件待领取就直接领取 |
图标和箱子菜单一样：附件待领取是箱子（或寄件时指定的图标），未读是书与羽毛笔，已读是纸，已领取是地图。
右边：信件内容
| 区域 | 说明 |
|---|---|
| 标题 | 选中邮件的标题 |
| 寄件人 · 时间 | 寄件人、寄出时间与「多久以前」 |
| 过期 | 有期限而且附件还没领取时显示，例如「6 天后过期」 |
| 正文 | 最多 8 行，太长时最后一行改成「…… 点「阅读全文」看完整内容」 |
| 附件 | 8 × 2 的附件格：物品、金币、点券、附件说明各一格，显示数量；鼠标移上去显示名称与说明。附件已领取时变暗，标题变成「附件（已领取）」 |
| 领取附件 | 附件待领取时显示 |
| 阅读全文 | 关闭画面，用书本阅读全部正文 |
| 回信 | 只有玩家寄来的信才显示，关闭画面后打开写信界面 |
| 删除 | 点一次变成「再按一次」，4 秒内再点才删除。附件还没领取时不显示（除非 mail.allow-delete-unclaimed: true） |
- 打开画面时自动选中第一封邮件；选中一封邮件就会把它标为已读。
- 还没选中邮件时，右边显示「选择左边的一封邮件」；邮箱是空的时，列表显示「邮箱空空如也」。
- 画面开着的时候收到新邮件、或附件在别的子服被领走，画面会自动刷新。
领取、背包空间不足、一键领取跳过放不下的邮件等规则，都和箱子菜单相同，见 玩家邮箱。
修改画面文字
画面上的文字可以在 messages.yml 加一个 cloudui 段来修改（文件里没写的使用内置默认值）。改完 /sm reload：
cloudui:
title: '星月邮箱'
counts: '未读 {unread} · 待领取 {unclaimed} · 共 {total} 封'
write: '写 信'
claim-all: '一键领取 {n}'
| 键 | 默认 | 位置 |
|---|---|---|
title | 星月邮箱 | 左上标题 |
counts | 未读 {unread} · 待领取 {unclaimed} · 共 {total} 封 | 标题下的计数 |
write | 写 信 | 写信按钮 |
tab-all / tab-unread / tab-attachment | 全部 / 未读 / 待领取 | 筛选分页 |
claim-all | 一键领取 {n} | 一键领取按钮 |
pick | 选择左边的一封邮件 | 还没选中邮件时 |
empty | 邮箱空空如也 | 没有邮件时 |
from | {sender} · {time} | 寄件人与时间 |
expire | {left}过期 | 过期时间（{left} 例如「6 天后」） |
attachments / attachments-claimed / no-attachments | 附件 / 附件（已领取）/ 没有附件 | 附件区标题 |
claim / read / reply / delete | 领取附件 / 阅读全文 / 回 信 / 删 除 | 按钮文字 |
delete-confirm | 再按一次 | 删除等待确认时 |
status-attachment / status-unread / status-read / status-claimed | 待领取 / 未读 / 已读 / 已领取 | 邮件行右边的状态 |
money / points | 金币 / 点券 | 附件格的金币、点券名称 |
more-lines | …… 点「阅读全文」看完整内容 | 正文超过 8 行时的最后一行 |
修改画面外观
画面的位置、大小、字体、颜色与图片都在 plugins/CloudUI/screens/starmail/starmail.yml 与 plugins/CloudUI/images/starmail/，修改方式请参考云界面的说明。
画面里的 {键} 由星月邮箱即时提供，在云界面编辑器的「变量」分页可以看到每个键的说明（例如 {counts}、{mail_title}、{claim_all_label}）。