xvmail玩家使用教程文档
xvmail 玩家完全使用教程
适用版本：xvmail 1.7.0。文中的每日次数、付费金额、附件大小、验证码有效期等数值都由服主在配置文件里决定，实际以本服公告为准。
一、一分钟上手
| 想做的事 | 怎么做 |
|---|---|
| 打开邮件中心 | 输入 /mail |
| 查看新邮件 | 登录后会自动提示未读数量，或打开收件箱 |
| 给朋友发邮件 | /mail send <玩家名> <正文>，或在邮件中心点「写邮件」 |
| 绑定真实邮箱 | /mail bindeamil <邮箱> → 去邮箱查收验证码 → /mail verifyemail <验证码> |
| 查看已绑定的邮箱 | /mail myemail |
收件人必须曾经加入过本服务器，插件才能找到他的档案；在线、离线都可以收到，离线时邮件会存在他的收件箱里，上线后查看。
二、邮件中心与收件箱
输入 /mail 打开「邮件中心」，里面有以下入口：
- 收件箱：分页浏览，每页最多 45 封。未读邮件用书与笔图标标出，已读为纸张图标，并显示发件人和 8 位短 ID。
- 写邮件：按聊天提示依次输入收件人、主题、正文。任何一步输入
cancel都可以取消。 - 附带手持物品写信：把要寄的物品拿在主手再写。
- 付费发送：免费次数用完后使用。
- 邮件模板：选择服主预设的模板，再输入收件人即可。
- 绑定邮箱、清空邮箱（需要二次确认）。
点击一封邮件进入详情页：这里能看到完整正文、发件人和附件；正文太长时会提示用 /mail read <短ID> 在聊天里看完整内容。详情页还有「返回收件箱」「删除邮件」按钮，以及领取奖励邮件时的「点击领取」按钮。
聊天命令同样可以管理邮件：
/mail 打开邮件中心
/mail list 列出最近 10 封（含 8 位短 ID）
/mail read <ID> 阅读并标记为已读
/mail clear <ID> 删除指定邮件
/mail clear all 清空自己的邮箱
注意：删除或清空邮箱时，邮件里尚未领取的附件物品会一起消失，不会退回。请先领取附件再删除邮件。
三、写邮件
命令方式
/mail send <玩家名> <正文>
这条命令会自动把主题设为「来自 <你的玩家名>」，适合快速留言。正文里可以换行吗？命令方式不支持换行，长内容建议用 GUI 写信。
GUI 方式（推荐）
在邮件中心点「写邮件」，然后按提示依次输入：
- 收件人玩家名（输错会提示重输，输入
cancel取消） - 主题（默认上限 80 字）
- 正文（默认上限 2000 字）
输入完成后插件会进行内容检查并投递，成功会提示「邮件已发送」。
为什么我的邮件发不出去？
内容审核只针对玩家发的邮件，管理员和系统发的通知不经过审核。插件会先做内容审核，以下情况会被拒绝：
- 正文或主题里出现网址、
www.、域名样式（mc.example.com）、邮箱地址、IP 地址等； - 出现「服务器 + IP / 地址 / 进群 / 群号 / 加入 / 欢迎」这类被判定为宣传的组合用语；
- 服主开启了 AI 审核，而审核服务超时、报错或返回拒绝。
服主可以开关本地的链接 / 宣传粗筛（默认关闭，交给 AI 判断）；如果开启了，正文里的网址、域名、IP、邮箱地址，以及「服务器 + IP / 进群 / 推广」这类组合会被拦截。写邮件时尽量用纯中文短句、不要放联系方式。发送失败时聊天里会给出具体原因，反复失败请把原因发给管理员，或让管理员查后台审核日志。
四、附件（把物品寄给朋友）
- 把要寄的整组物品拿在主手；
- 在邮件中心点「附带手持物品写信」；
- 按提示填收件人、主题、正文；
- 发送成功后主手物品才会被移除并转入邮件。发送失败（审核不通过、对方邮箱已满等）物品会留在主手或退回给你。
收件人打开详情页，点击附件图标即可取回；每封邮件的附件只能领取一次。背包放不下的部分会掉落在脚边。如果领取时你已离线或插件刚好关闭，物品会被暂存，下次登录时自动补发。服主可以设置单个附件的数据大小上限（默认 32768 字节），NBT 过多的物品可能被拒绝。
五、免费次数与付费发送
/mail send使用每日免费次数（默认 10 次），用完后会提示改用/mail sendex。/mail sendex <玩家名> <正文>或 GUI 的「付费发送」会扣除服主配置的货币（Vault 金币或 PlayerPoints 点券），并受每日付费次数上限限制。- 只有邮件真正投递成功才会保留次数和扣费；审核不通过、收件人找不到、邮箱已满、服务异常时，次数和费用都会退回。
- 付费发送需要服务器装好对应的经济插件。如果提示「Vault 未注册经济服务」或「PlayerPoints 未安装」，请联系服主，不是你的余额问题。
六、邮件模板
服主可以预设一些模板（例如欢迎信、活动通知）。在邮件中心点「邮件模板」，点击模板后输入收件人即可发送；也可以用命令：
/mail template <模板名> <玩家名>
模板里的 {player} 会替换成收件人名，{sender} 会替换成你的名字。模板名写错会提示「找不到邮件模板」。
七、领取奖励邮件
管理员可以发「领取邮件」，你在详情页会看到一个「点击领取」按钮。点击后插件会以服务器控制台身份执行管理员预先设置的奖励命令（例如发放物品），每封邮件只能领取一次，领取后按钮变成「已领取」。
如果提示「奖励命令执行失败」或「领取命令配置无效」，请不要反复删除、重领邮件，直接联系管理员处理——领取状态已经写入，重复点击不会再次发奖。
八、绑定真实邮箱
绑定后，别人给你发的游戏邮件会同步一封 HTML 邮件到你的真实邮箱（服务器需已启用 SMTP，且同步功能默认开启）。
绑定步骤
/mail bindeamil <你的邮箱地址>
这是本服指定的拼写；插件也兼容正确拼写
/mail bindemail <邮箱地址>，两者效果一样。
插件会发送一封 HTML 验证码邮件到该邮箱，然后你在游戏里输入：
/mail verifyemail <6位验证码>
验证成功后才会保存绑定关系。其他相关命令：
/mail myemail 查看当前绑定的邮箱
/mail unbindemail 解绑，之后不再收到同步邮件
验证码规则
- 申请验证码有冷却时间（默认 60 秒），别连续重复申请；
- 验证码有时效（默认 10 分钟），过期要重新申请；
- 输错次数有上限（默认 5 次），超过后验证码作废；
- 验证码只存在服务器内存里，服务器重启或插件重载后需要重新申请；
- 验证码不要发给任何人，包括自称管理员的人。没收到邮件先检查垃圾邮件箱，再联系服主确认 SMTP 配置。
九、同步到真实邮箱的邮件长什么样
同步邮件是完整的 HTML 邮件（Content-Type: text/html; charset=UTF-8），按来源使用两套模板：
- 玩家发给你的（Player Mail）：顶部品牌栏、圆形首字母头像 + 发件玩家 ID、「向你发送了一封邮件 · <服务器名>」、保留换行的正文、📎 附件说明（有物品 / 有可领取奖励 / 无附件）、「如需回复请在游戏内打开邮件系统」提示条、页脚与版权。
- 管理员 / 系统发的（System Notice）：顶部品牌栏、
System Notice标记、系统通知 / 邮箱验证标签、大标题、正文和页脚。验证码也走这套模板，验证码用大号高亮区块显示。
邮件的发件人显示名同样区分来源：玩家互发是 <玩家名> (via <服务器名>)，例如 Steve (via teana server)；管理员或系统发的则是服务器名。实际发信地址始终是服主配置的邮箱，不会用玩家邮箱冒充发件。
你写的内容会被转义成纯文本显示（换行保留），不会被当成 HTML 代码执行，所以写 <b> 不会变成加粗。模板样式由服主维护，可以按服务器品牌调整。
隐私提醒：邮件主题和正文会经过服主配置的 SMTP 服务商，开启 AI 审核时还会发送给第三方审核接口。请先了解本服的隐私说明；不想接收同步邮件可以随时
/mail unbindemail，或让服主关闭同步功能。
十、常见问题
Q：游戏里收到了，但真实邮箱没有？
A：依次确认：① 是否已用 /mail myemail 看到绑定邮箱；② 服主是否启用了 SMTP；③ 是否关闭了同步功能；④ 邮件是否在垃圾邮件箱。同步失败不会重复补发，也不会影响游戏内邮件，可让服主查看后台日志。
Q：邮件里的发件人怎么是服务器名？
A：管理员、控制台、系统发的邮件就显示服务器名；只有玩家互发才显示玩家 ID + via 服务器名。如果你确认是玩家发的却仍显示服务器名，请让服主检查 mail.console-sender-name 是否被改成了某个玩家名。
Q：发送失败会扣次数或钱吗？
A：不会，次数和费用都会退回；附在邮件里的物品也会退回。
Q：附件不见了？
A：附件只能领一次；如果误删了带未领取附件的邮件，物品不会退回。联系管理员查询 mail/pending-attachments.yml，那里只保存发送失败或领取失败时暂存的物品。
Q：领取按钮点了一次没反应？
A：先看提示文字。若显示「已领取」，说明奖励已经发过；若提示命令执行失败，请找管理员，不要重复点击或删邮件。
十一、命令速查
/mail 邮件中心
/mail send <玩家> <正文> 普通发信（免费额度）
/mail sendex <玩家> <正文> 付费发信
/mail template <模板名> <玩家> 发送模板邮件
/mail list 列出邮件
/mail read <ID> 阅读邮件
/mail clear <ID|all> 删除 / 清空
/mail bindeamil <邮箱> 申请绑定验证码
/mail bindemail <邮箱> 同上（兼容拼写）
/mail verifyemail <验证码> 完成绑定
/mail myemail 查看绑定
/mail unbindemail 解绑