安装与获取
下载与授权（免费）
- 打开 资源中心，注册并登录。
- 在 StarMail 星月邮箱 点「免费领取」，永久授权码会加入你的会员中心。
- 打开详情，下载最新的
StarMail-<版本>-簡體授權版.jar。
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Paper / Purpur / Folia 1.20 – 26.x（26.x 需要 Java 25） |
| 前置插件 | 无 |
| 数据库 | 默认 SQLite（单服，不用设置）；多个子服要跨服时 改用 MySQL / MariaDB，见 跨服设置 |
| 可选：Vault + 经济插件 | 金币附件、玩家写信附带金币、金币邮费 |
| 可选：PlayerPoints | 点券附件、点券邮费 |
| 可选：PlaceholderAPI | 变量（未读数、待领取数…） |
| 可选：云界面 CloudUI | /sm 改用全屏的邮箱画面，画面文件自动安装，见 云界面邮箱 |
| 不支持 | Spigot（需要 Paper 系服务端） |
实机测试：Paper 1.21.11（单服，以及两台子服共用 MySQL 跨服）；另外检查过 1.20.1、1.21.4、26.3 的接口兼容性。
全新安装
- 把插件放进
plugins/，启动服务器。 - 打开
plugins/StarMail/token.yml，填入授权码，重启（首次启动自动绑定本机）。 - 进游戏输入
/sm，打开邮箱就成功了。接着照 快速上手 寄出第一封信。
单服到这里就装好了。有好几个子服、想让玩家在任何子服都能收信领信，再看 跨服设置。
还没填授权码时
插件会正常启动，已经存在的邮件不会受影响，但邮箱功能处于锁定状态：/sm 指令只会提示「星月邮箱尚未授权」（/sm reload 与 /sm version 除外），PlaceholderAPI 变量显示为空，其他插件也暂时无法通过 API 寄信。填好授权码后重启即可；
如果是开服时连不上授权服务器，插件会每 60 秒自动重试，连上就立刻开启邮箱功能，不需要重启。
控制台显示「无法连接授权服务器」
第一次启动必须连上 license.plugins.wiki 验证一次，之后断网也能离线运行 72 小时。控制台会写出原因：
| 原因 | 处理 |
|---|---|
| DNS 解析不到 | 换 DNS（例如 223.5.5.5 / 119.29.29.29）后重启 |
| 连线被拒绝或无法建立 | 主机商 / 面板的防火墙放行对外 HTTPS；本机电脑检查杀毒软件是否拦截 java.exe |
| 连线超时 | 网络太慢或被拦截；稍后会自动重试 |
| HTTPS 握手失败 | 关闭会拦截 HTTPS 的代理或网络 设备；插件也会自动改用 HTTP 验证（回应带数字签名，安全性不受影响） |
本机电脑如果是靠加速器 / 代理（例如 Clash）才打得开网站：浏览器会走代理，但 Java 不会。请开启加速器的「TUN / 虚拟网卡」模式，
或在启动参数加 -Djava.net.useSystemProxies=true。
文件说明
| 路径 | 用途 |
|---|---|
config.yml | 数据库、跨服、邮件期限、玩家互寄规则、提示，见 config.yml |
messages.yml | 所有提示文字，见 messages.yml |
templates.yml | 邮件模板，见 邮件模板 |
menus/mailbox.yml | 邮箱主界面，见 菜单 |
menus/mail.yml | 单封邮件界面 |
menus/compose.yml | 写信界面（玩家写信与管理员写信共用） |
data.db | SQLite 数据库（使用 MySQL 时不会用到） |
token.yml | 授权码 |
升级
- 关服，备份
plugins/StarMail/（使用 MySQL 的话也备份数据库）。 - 删掉旧的 JAR，放入新的
StarMail-<版本>-簡體授權版.jar。 - 开服。邮件、模板、设定与授权码都会保留。
升级时设定文件的处理方式：
| 文件 | 新版本新增的项目 |
|---|---|
config.yml | 不会写进你现有的文件。没写的项目直接使用默认值，功能照常；想调整就自己把键加进去（键名与默认值见 config.yml）。 |
messages.yml | 不会写进你的文件，但缺少的提示文字会自动使用内置的默认文字，不会出现「Missing message」。想改那一句时再把键加进去。 |
menus/*.yml | 你的文件保持不变。想要新版的默认界面：把文件改名或删除，执行 /sm reload，会重新生成默认文件。 |
每个版本改了什么见 更新记录。