快速上手
这一页带你走一遍最常用的流程。开始前请先照 安装与获取 装好插件并填好授权码，用 OP 身份进游戏。
1. 打开邮箱
输入：
/sm
会打开一个 6 行的箱子界面（服务器装了云界面 CloudUI 时会打开全屏的邮箱画面，见 云界面邮箱，操作方式大同小异）。现在邮箱是空的，中间显示「邮箱空空如也」。 上方中间是你的头像（ 未读、待领、总数），下面一排是翻页、筛选、全部已读、一键领取、删除已读、写信按钮。
主指令是 /starmail，平常打 /sm 就好。服务器上如果有别的插件也用 /sm，玩家输入的 /sm 仍然会交给星月邮箱，见 config.yml 的 command-aliases。
2. 给自己寄一封信
/sm text 你的名字 测试邮件 第一行|第二行
- 第二个参数是收件人，第三个是标题（标题里要空 格的话用
_代替），后面全部是正文，用|分行。 - 你会马上看到「收到来自 星月邮局 的新邮件」的提示和标题动画，点一下聊天栏的提示就会打开邮箱。
再寄一封带附件的：
/sm money 你的名字 100 金币礼包
（需要 Vault 与经济插件。）也可以把一个物品拿在手上，输入 /sm item 你的名字 送你的，寄出手上物品的副本。
打开邮箱，带附件的信显示为箱子图标：
| 操作 | 效果 |
|---|---|
| 左键 | 打开这封信，看完整内容与附件 |
| 右键 | 直接领取附件 |
| Shift + 左键 | 用书本阅读全文 |
| Shift + 右键 | 删除（附件还没领的不能删） |
或者点下面的「一键领取」，全部附件一次领完。详见 玩家邮箱。
3. 在游戏里做一个模板
模板就是「存起来、可以反复发送的一封信」。我们做一个欢迎礼包：
- 输入
/sm template create welcome2，打开管理员写信界面，标题后面 会显示「模板 welcome2」。 - 点上方的 标题（名牌），在聊天栏输入
<gold>欢迎来到服务器！。 - 左键点 正文（书与羽毛笔），输入
很高兴见到你～|这是一份见面礼（|分成两行）。 - 把要送的物品放进中间的空格（例如面包、火把）。
- 想加指令奖励：左键点 领取时执行的指令（命令方块），输入
lp user {player} permission set kit.newbie true； 再左键点 附件说明（下界之星），输入新手礼包权限，玩家会在附件列表看到这一行。 - 点 存为模板（末影箱），在聊天栏输入
welcome2。看到「模板 welcome2 已保存」就完成了。
模板里的物品是「样品」：发送模板时每个玩家拿到的是复制品，你放进去的物品在保存后仍会退回背包。
用 /sm template edit 打开时，模板原有的物品是副本，关闭界面不会退回；你自己另外放进去的物品会退回背包。
插件也自带一个手写的范例模板 welcome，打开 plugins/StarMail/templates.yml 就能看到写法，见 邮件模板。
4. 发给 所有人
/sm send @all welcome2
@all：全服邮件。在线的玩家立刻收到，离线的玩家下次上线收到，之后第一次进服的新玩家也会收到；每个人只会收到一封。- 控制台执行一样有效（例如投票插件的奖励指令写
sm send {player} vote）。
控制台会回一句「全服邮件已发出（#编号）」。用 /sm broadcasts 可以看到它，想停止发放就 /sm cancel 编号。
其他目标写法：
| 目标 | 谁会收到 |
|---|---|
玩家名 | 一个玩家（在线、离线都可以，只要他进过服） |
@online | 执行指令的这个子服上现在在线的所有人 |
@all | 全服，包含之后第一次进服的新玩家 |
@all-existing | 全服，但只给发送前就进过服的玩家 |
5. 让玩家互相写信
玩家默认就有写信权限：
- 玩家输入
/sm write或在邮箱里点「写信」。 - 点 收件人（头颅）输入对方名字，点 标题、正文 填写内容。
- 把要寄的物品放进中间空格（也可以 Shift + 点击背包里的物品直接放进去）。
- 点右下角 寄出。
邮费、冷却、每日次数、物品黑名单都在 config.yml 的 player-mail 里调整。默认设置：不收邮费、冷却 10 秒、每天最多 30 封、基岩 / 命令方块等物品与名称带「绑定」「不可交易」的物品不能寄。
详见 玩家写信。