messages.yml

plugins/StarMail/messages.yml 是星月邮箱所有的提示文字：聊天栏消息、输入提示、邮件类型名称、时间格式、帮助列表等。改完执行 /sm reload 生效。

写法

prefix: '<gradient:#9BB8FF:#E7C6FF>✉ 星月邮箱</gradient> <dark_gray>» '
claimed: '<green>已领取 <white>{count}</white> 封邮件 <dark_gray>(<gray>物品 <white>{items}</white> · 金币 <white>{money}</white> · 点券 <white>{points}</white><dark_gray>)'

颜色：&a 这种颜色代码、&#RRGGBB 十六进制颜色、MiniMessage 标签（<gradient:#a:#b>…</gradient>、<bold>、<#FF8800>）都可以，也可以混着写。
前缀：大部分聊天消息前面会自动加上 prefix。
关闭某一句：写成 ''（空字符串）就不会发送那一句。
变量：{player}、{count} 这种大括号变量会被替换，每一句能用哪些变量见默认文件的写法（下面的表格也有列出常用的）。
缺少的键：文件里没有的键会自动使用插件内置的默认文字，所以升级后不会出现「Missing message」；想改那一句时再把键加进来。

文字里有 <、&、# 开头时

YAML 里以这些字符开头的文字要整段加单引号：join: '<white>你有…'。文字里本身有单引号时写两个 ''。

键的分组

基本

键	用途
`prefix`	聊天消息前缀
`cancel-word`	在聊天栏输入时取消用的字（默认 `取消`；`cancel` 永远有效）。`config.yml` 写了 `menu.cancel-word` 时以那边为准
`click-to-open`	鼠标移到「点击打开」提示上时显示的文字

通知

键	用途	变量
`join`	上线提示（可点击打开邮箱）	`{unread}` `{unclaimed}` `{total}`
`new-mail`	收到一封新邮件	`{sender}` `{title}`
`new-mails`	一次收到好几封（例如物品太多拆成几封）	`{sender}` `{count}`
`reminder`	定时提醒未领取的附件	`{unclaimed}`

新邮件的屏幕标题、副标题、动作栏与音效在 config.yml 的 notify.new-mail，见 config.yml。

领取 / 删除

键	用途
`claimed`	领取成功（`{count}` `{items}` `{money}` `{points}`）
`claimed-elsewhere`	有几封已经在别的子服领过了
`already-claimed` / `nothing-to-claim`	这封 / 全部都没有可领的附件
`no-space`	领取单封时背包空间不足（`{slots}` 需要几格）
`no-space-all`	一键领取时有几封因为背包满了没领（`{count}`）
`claim-failed` / `claim-broken`	领取失败 / 附件数据读不出来（`{id}`）
`claim-no-economy` / `claim-no-points`	没有经济插件 / PlayerPoints，无法领取金币 / 点券（`{title}`）
`deleted` / `delete-failed` / `nothing-to-delete`	删除结果
`confirm-delete` / `confirm-delete-unclaimed` / `confirm-delete-read`	删除时的二次确认
`cannot-delete-unclaimed`	附件还没领取不能删除
`overflow-mailed` / `overflow-dropped`	背包放不下的物品另寄一封信 / 掉在脚下（`{count}` 组数）
`load-failed`	读取邮箱失败
`broken-attachment`	邮件说明里附件读不出来时显示的一行
`attachment-claimed-lore`	单封邮件里已领取的附件物品，说明最后加的一行

写信

键	用途
`player-mail-disabled`	服务器关闭玩家互寄
`cooldown` / `daily-limit` / `receiver-full`	冷却中（`{seconds}`）/ 今日次数用完（`{limit}`）/ 对方邮箱太满（`{player}`）
`player-not-found` / `cannot-mail-self`	找不到收件人（`{player}`）/ 不能寄给自己
`item-blocked`	黑名单物品（`{reason}`：材质名或命中的文字）
`pay-money` / `pay-points` / `pay-no-economy` / `pay-no-points`	邮费付不起 / 没有对应的插件
`sent`	寄出成功（`{player}` 收件人、`{cost}` 邮费）
`send-failed`	寄送失败，附件退回
`compose-returned`	取消写信，附件退回（`{count}`）
`too-many-lines` / `invalid-input`	正文行数到上限（`{max}`）/ 输入格式不对（例如金币写了文字）
`reply-prefix`	回信时标题前加的字（默认 `回复：`）
`no-title`	没有标题时显示的文字
`compose.*`	写信界面里用的短文字：`unset` 未填写、`none` 无、`days` 天、`default-expire` / `default-icon` 默认，以及 `need-receiver`、`empty`、`confirm-group` 三句提示
`prompt.*`	点按钮后要求在聊天栏输入的提示：`receiver`、`title`、`body`、`money`、`points`、`command`、`note`、`sender`、`expire`、`template`（都可以用 `{cancel}` 代表取消用的字）

管理

键	用途
`admin-view-prefix`	`/sm view` 时加在界面标题前面（`{owner}`）
`admin-sent` / `admin-broadcast`	管理员发信结果（`{target}` `{count}` / `{id}`）
`template-*`	模板相关：`template-suffix`（模板界面标题后缀）、`template-saved`、`template-save-failed`、`template-not-found`、`template-deleted`、`template-none`、`template-list`、`template-bad-id`、`template-closed`（关闭模板编辑界面）、`template-broken`（模板物品数据读不出来，`{template}`）
`item-mail-title` / `money-mail-title` / `points-mail-title`	`/sm item` / `money` / `points` 没写标题时的默认标题
`hold-item` / `not-a-number`	`/sm item` 手上没东西 / 数量不是数字
`restored` / `restore-not-found` / `restore-returned`	`/sm restore` 结果：已恢复 / 找不到 / 过期后附件已退回寄件人、不能恢复（`{id}`）
`broadcast-cancelled` / `broadcast-not-found` / `no-broadcasts` / `broadcasts-header` / `broadcasts-line`	`/sm cancel`、`/sm broadcasts`
`purge-started` / `reloaded`	`/sm purge` / `/sm reload`
`log-header` / `log-empty` / `log-line`	`/sm log`（`log-line` 的变量：`{time}` `{action}` `{id}` `{detail}` `{server}`）
`version` / `version-public`	`/sm version`：管理员看到的详细版本（`{version}` `{edition}` `{database}` `{server}`）/ 一般玩家看到的版本（`{version}`）
`not-licensed` / `no-permission` / `players-only`	未授权 / 没有权限 / 只能玩家使用
`book-from`	书本阅读时第一页的「寄件人」行（`{sender}`）

名称对照

这些不是消息，而是界面与记录里显示的名称：

键	内容
`action.*`	`/sm log` 的动作名称：`receive` 收到、`send` 寄出、`claim` 领取、`delete` 删除、`admin_delete` 管理员删除、`expire` 过期、`restore` 恢复
`filter.*`	筛选名称：`all` 全部、`unread` 未读、`attachment` 待领取
`target.*`	发送对象名称：`player`、`online`、`all`、`all_existing`
`status.*`	邮件状态符号（`{status}`）：`attachment`、`unread`、`read`、`claimed`
`type.*`	邮件类型（`{type}`）：`system` 系统、`admin` 管理员、`player` 玩家、`return` 退回、`broadcast` 全服
`time.*`	时间文字：`just-now`、`minutes-ago`、`hours-ago`、`days-ago`、`minutes-left`、`hours-left`、`days-left`（`{n}` 数字）、`expired`、`never`

系统寄出的信

键	内容
`overflow.sender` / `title` / `content`	「背包已满 · 物品退回」那封信的寄件人、标题、正文
`returned.sender` / `title` / `content`	过期退信的寄件人、标题、正文（`{title}` 原标题、`{player}` 原收件人）

云界面邮箱（cloudui）

装了云界面 CloudUI 时，邮箱画面上的文字可以用 cloudui.<键> 修改，例如 cloudui.title、cloudui.claim-all。默认文件里没有这一段，需要时自己加上。全部键与默认值见云界面邮箱。

用法与帮助

键	内容
`usage.*`	指令参数不够时显示的用法：`send`、`text`、`item`、`money`、`points`、`template`、`view`、`log`、`restore`、`cancel`
`help.*`	`/sm help` 每一行：`header` 标题，其余每个子指令一行

写法​

键的分组​

基本​

通知​

领取 / 删除​

写信​

管理​

名称对照​

系统寄出的信​

云界面邮箱（cloudui）​

用法与帮助​

写法