跳到主要内容

更新记录

每个版本的更新内容与发布日期。升级方式：关服，替换 JAR，开服；邮件、模板与设定文件会保留。

v1.2.1最新

彩色开服讯息

  • 优化开服侦测行改成彩色：不再整片白字、每行都带插件名，最后一行显示「共侦测到 N 个本系列插件」
  • 优化云界面邮箱的操作提示把「鼠标」改成「光标」
  • 优化简体授权版的 jar 文件名改成简体：StarMail-1.2.1-简体授权版.jar
  • 兼容升级直接替换 jar 即可，不需要改设定，画面档不受影响；星月市集 1.2.1 搭配本版本
v1.2.0

云海邮箱画面 · 全系列统一

  • 新增云界面邮箱画面改为云海风格：左边邮件列表、右边信纸预览，悬停预览、停留一下自动已读，左键领取、右键删除，「删除已读」与系统邮件分页
  • 优化开服两秒后在控制台印一次「星月邮箱 v1.2.0 已启用」与侦测到的本系列插件（例如星月造物：抽奖奖励寄到邮箱；星月市集：交易物品与收入寄到邮箱）
  • 优化还没填授权码只印一段一般消息说明怎么领取，不再是整片红字；授权码错误、过期或被停用才是警告
  • 优化设定写错时直接说哪个档、哪个键、写了什么、怎么改（例如 menu.date-format、templates.yml 的物品）；跨服同步偶尔失败会自动重试，连续失败 10 次才警告
  • 优化默认的云界面画面档如果服主没改过，升级后自动换成新版
  • 兼容升级直接替换 jar 即可，不需要改设定；星月市集 1.2.0 搭配本版本
v1.1.0

幂等寄送 MailDraft.key

  • 新增开发者 API 新增 MailDraft.key(String)：带 key 寄出的信同一个 key 只会存一次。重试、超时后重寄、寄出后当机再寄一次、两个子服同时寄，都只会有一份邮件，再次寄送直接返回第一次的邮件编号，见「开发者 API」页
  • 优化key 与邮件写在同一个数据库交易里：邮件存进去了 key 就一定存在，反之亦然；数据库主键保证并发寄送时只有一边成功
  • 优化key 记录在新表 mail_key（自动建立），与邮件记录一起按 mail.log-keep-days 清理
  • 兼容StarAuction 星月市集 1.1.0 起把买到的物品、卖出的收入、退回的东西都寄到星月邮箱，需要星月邮箱 1.1.0 以上
  • 兼容不使用 key 的寄信方式完全不变；升级只需替换 JAR
v1.0.1

安全审查修正

  • 修复玩家按下「寄出」后在检查完成前离线，附件不再丢失：改为寄一封「寄信中断 · 附件退回」的信，已扣的邮费一并退还
  • 修复写信的金币栏输入 NaN / Infinity 会被拒绝（以前会越过余额检查并让这名玩家的邮箱卡住）；/sm money 同样检查
  • 修复上一个领取 / 寄信还在处理时再次操作：附件退回背包并提示「请稍候」，不再无声吞掉
  • 修复关服或重载插件时，正在聊天栏输入标题 / 正文的玩家，写信界面里的附件退回背包
  • 修复死亡时不能领取附件（领到死亡背包里的物品会在复活时消失），提示复活后再领
  • 修复回信标题重新过滤，玩家不能借回信把 MiniMessage 标签写进标题
  • 优化邮箱列表的附件名称改为快取，翻页与刷新不再每次解码全部附件物品
  • 修复/sm log 页数过大时的错误；玩家名补全在 SQLite 下带底线的名字也能找到
  • 兼容安全审查结论：领取为数据库原子操作，跨服同时领取只会有一边成功；所有 SQL 皆为参数化；附件以完整字节保存，自定义物品（CloudItems / CraftEngine / MMOItems）的标签寄出前后完全一致
v1.0.0

首个版本

  • 新增玩家邮箱 /sm：按状态显示图标（待领取 / 未读 / 已读 / 已领取）、正文与附件预览、筛选、翻页、一键领取、全部已读、删除已读、书本阅读全文
  • 新增附件：物品（完整保存附魔、名称与自定义物品数据）、金币（Vault）、点券（PlayerPoints）、领取时执行的指令、附件说明
  • 新增领取前检查背包空间，放不下的邮件整封留在邮箱；写信取消、寄送失败时附件退回，背包满了另寄一封「物品退回」信
  • 新增玩家互寄 /sm write：写信界面、Shift 放入附件、回信、附带金币、邮费、冷却、每日次数、对方邮箱上限、物品黑名单
  • 新增玩家寄出的信过期未领取时，附件自动退回寄件人
  • 新增管理员写信 /sm admin：指定玩家 / 本服全部在线 / 全服（含新玩家）/ 全服（不含新玩家），自订寄件人、点券、领取指令、附件说明与期限
  • 新增全服邮件：在线玩家立即收到，离线与之后进服的新玩家上线时收到，每人一封；/sm broadcasts、/sm cancel 管理
  • 新增邮件模板：游戏内保存或手写 templates.yml，/sm send <目标> <模板> 发送，控制台可用
  • 新增指令发信 /sm text、/sm item、/sm money、/sm points，目标支持玩家名、@online、@all、@all-existing
  • 新增管理：/sm view 查看他人邮箱、/sm log 邮件记录、/sm restore 恢复邮件、/sm purge 立即清理
  • 新增SQLite（单服）与 MySQL（跨服）：跨服新邮件提示、每封邮件只能领取一次、全服邮件跨服发放
  • 新增三个菜单全部可在 menus/*.yml 自定义：格位、材质、说明、状态外观、自定义模型、item-model、提示框样式、头颅、自定义动作按钮
  • 新增云界面 CloudUI 邮箱画面：装了云界面时 /sm 打开全屏画面（邮件列表、筛选、一键领取、信件内容、附件格、领取 / 阅读全文 / 回信 / 删除），画面文件自动安装，文字可在 messages.yml 的 cloudui 段修改；无法显示的玩家自动改用箱子菜单
  • 新增提示：上线提示、新邮件聊天 / 标题 / 动作栏 / 音效、定时提醒未领取的附件
  • 新增PlaceholderAPI 变量 %starmail_unread%、%starmail_unclaimed%、%starmail_total%、%starmail_has_new%
  • 新增开发者 API StarMailAPI 与 MailSendEvent、MailClaimEvent 事件；StarCrate 星月造物的抽奖奖励可直接寄到邮箱
  • 新增支持 Paper / Purpur / Folia 1.20 – 26.x
最后于 更新