变量
安装 PlaceholderAPI 后，星月邮箱会自动注册下面的变量（不需要 /papi ecloud download）。
开服时控制台会显示「PlaceholderAPI 变量已注册」。
| 变量 | 内容 | 例子 |
|---|---|---|
%starmail_unread% | 未读邮件数 | 3 |
%starmail_unclaimed% | 附件还没领取的邮件数 | 1 |
%starmail_total% | 邮箱里的邮件总数（不含已删除、已过期） | 12 |
%starmail_has_new% | 有未读或待领取的邮件时为 true，否则 false | true |
什么时候更新
- 玩家上线时读取一次，之后在这些时候自动更新：收到新邮件、阅读、领取、删除、管理员恢复邮件；邮件过期在每 5 分钟一次的过期检查时更新。
- 别的子服寄来的信，在
sync.interval-seconds（默认 3 秒）内更新，见 跨服设置。 - 变量直接读取内存中的数字，不会查询数据库，放在计分板、TAB 列表里频繁刷新也没有负担。
注意
- 只对在线玩家有效。离线玩家显示
0（has_new显示false）。 - 授权还没验证通过时，所有变量显示为空。
- 「未读」「待领取」是两件不同的事：一封有附件的信，看过但没领，算「待领取」不算「未读」；领了附件的信会自动标为已读。
使用范例
计分板显示邮件数：
&f✉ 邮件：&b%starmail_unread% &7未读 &6%starmail_unclaimed% &7待领
菜单插件里的邮箱按钮：用 %starmail_has_new% 是否等于 true 当条件，有新邮件时换一个发光的图标，点击执行 sm 打开邮箱（条件的写法依你的菜单插件而定）。