更新记录
每个版本的更新内容与发布日期。升级 方式:关服,替换 JAR,开服;商品、成交记录与设定文件会保留(1.1.0 起还需要 StarMail 星月邮箱 1.1.0 以上)。
彩色开服讯息
- 优化开服侦测行改成彩色:不再整片白字、每行都带插件名,最后一行显示「共侦测到 N 个本系列插件」
- 优化简体授权版的 jar 文件名改成简体:StarAuction-1.2.1-简体授权版.jar
- 兼容升级直接替换 jar 即可,不需要改设定,画面档不受影响;星月邮箱 1.2.1 搭配本版本
全系列统一 · 指令都打开云界面
- 优化/sa search、/sa <关键字>、/sa view、/sa list、/sa mine、/sa history、/sa open <编号> 在能显示云界面的玩家身上直接打开对应的云界面画面;不能显示时照旧是箱子菜单
- 优化开服两秒后在控制台印一次「星月市集 v1.2.0 已启用」与侦测到的本系列插件(例如星月邮箱:买到的、卖出的、退回的东西都寄到邮箱)
- 优化还没填授权码只印一段一般消息说明怎么领取,不再是整片红字;授权码错误、过期或被停用才是警告
- 优化设定写错时直接说哪个档、哪个键、写了什么、可以写什么、怎么生效,例如 config.yml 的 currencies.points.type 写错
- 优化默认的云界面画面档如果服主没改过,升级后自动换成新版
- 修复上架菜单「零买」按钮的「关」状态一直不显示(菜单文件里的 off 被读成布林值)
- 兼容升级直接替换 jar 即可,不需要改设定
后台不出现多余的黄字 · 云界面市集更新
- 优化默认附带的可选货币(例如点券)对应插件没装时,开服只用灰字一行带过;只有默认货币或上架中商品用到的货币不能用时才黄字警告
- 优化授权服务器暂时连不上(离线授权仍有效)、HTTPS 被拦截改走 HTTP、星月邮箱单次寄送失败、本服暂时寄不出的待寄都改为灰字;寄送连续失败 6 次才警告
- 优化云界面市集:左边拿掉「星月邮箱」分页、右上拿掉邮箱数字(邮箱从服务器主选单或 /sm 打开);分页、分类、搜索、角标、数量文字上下置中;空卡与停用按钮改成淡实线框
- 修复云界面市集从主选单按钮或 /cui open 直接打开时,商品区是空的(分类计数却有数字):商品列表现在和计数一样自动更新
- 兼容需搭配新版云界面;旧画面档会自动更新并备份为 .old
改寄星月邮箱 · 云界面四个分页
- 新增StarMail 星月邮箱 1.1.0 以上成为必装前置:没装、没启用或版本太旧时星月市集不会启动,控制台写出原因(没有安装 / 没有启用 / 版本太旧);星月邮箱装了但还没准备好(例如授权还在验证)时市集照常运作,要寄的东西等它准备好再寄出
- 新增「领取箱」由星月邮箱取代:买到 / 拍得 / 收购到的物品、卖出收入、被超过与流拍退回的出价、到期 / 下架 / 管理员下架退回的物品与预付款、退款、背包放不下的物品,全部以邮件寄到玩家的星月邮箱,在邮箱里领取,见「星月邮箱寄送」页
- 新增货币随邮件寄出:Vault 金币 → 邮件金币、PlayerPoints 点券 → 邮件点券、物品货币 → 物品本身、经验等级 → 领取时执行的指令
- 新增每一笔只寄一次:成交与「待寄清单」写在同一个数据库事务;寄送时先租下那一笔,邮件带唯一编号
starauction:<安装编号>:<编号>,星月邮箱回传邮件编号后才标记已寄出。当机、超时、两个子服同时寄都不会重复,也不会遗失 - 新增寄送失败自动重试:开服后、玩家上线时、每次成交后、别的子服有新成交时,以及每
mail.retry-seconds秒 - 新增
config.yml新增mail:段:sender寄件人、retry-seconds重试间隔、expire-days邮件期限(默认0永不过期)、keep-sent-days已寄出记录保留天数 - 新增
messages.yml新增mail.<来源>.title/content邮件标题与正文({item}{amount}{money}{player}{id});邮件里的物品名称是中文名,云界面邮箱等服务器画出的画面不会再显示英文材质名 - 新增云界面市集改为四个分页:市集、上架物品(直接从背包选物品,设置方式 / 数量 / 价格 / 一口价 / 保留价 / 零买 / 时长,按两次确认,物品确认后才离开背包)、我的上架(下架按两次、改价)、交易记录;左边一排分页同组原地切换,另有「星月邮箱」与「返回主菜单」,右上显示上架数与邮箱待领取数,见「云界面市集」页
- 优化
/sa stash(claim、collect)与市集 / 我的上架的按钮改为打开星月邮箱;{stash}、%starauction_stash%= 星月邮箱里附件没领的邮件数 + 还没寄出的笔数 - 优化收购单卖家的成交通知补上对方名字与数量
- 优化云界面弹出输入框不再显示聊天栏用的「输入取消」字样
- 兼容移除
stash.auto-collect-money与stash.direct-delivery:收入不再自动入帐、买到的物品不再直接放进背包 ,一律寄到星月邮箱;stash.keep-claimed-days由mail.keep-sent-days取代(没写时沿用旧值) - 兼容从 1.0.x 升级:开服时领取箱里还没领的东西自动寄到每位玩家的星月邮箱;
config.yml末尾自动加上mail:;服务器上messages.yml与菜单文件里默认的「领取箱」字样改成星月邮箱(自订文字不动) - 兼容跨服时每个子服的星月邮箱也要连同一个 MySQL(同样的
table-prefix),玩家才能在任何子服领取,见「跨服设置」页 - 兼容云界面画面文件改为
screens/starauction/starauction_market.yml等四个文件与images/market/,开服自动安装;1.0.x 的starauction.yml不再使用
名称更正为 StarAuction
- 优化插件名称更正为 StarAuction(原本少一个 c):插件名、主指令
/starauction(/sa、/ah、/market不变)、权限starauction.*、变量%starauction_*%、云界面画面starauction - 兼容从旧版升级:删除旧的
StarAution-*.jar、放入StarAuction-1.0.2.jar即可,开服时会自动把plugins/StarAution资料夹改名为plugins/StarAuction,设定、数据库、领取箱全部沿用(数据库表前缀不变);两个 jar 同时存在时控制台会提示 - 兼容权限组插件与 PlaceholderAPI 里写的旧名称
staraution.*/%staraution_*%请改成新名称
安全审查修正
- 修复在上架菜单输入价格后再
/sa reload或关服:菜单里的物品现在会退回背包(以前这个菜单脱离追踪,关服时物品会消失) - 修复领取箱发放途中经济插件或物品出错时,那一笔放回领取箱并提示,玩家不再永远卡在「上一个操作还在处理」;离线时也会清掉这个状态
- 修复本服读不出物品资料的商品(更新版本子服上架的)不能再购买或出价,和供货一样提示「物品资料无法在本服读取」,不会付了钱却领不到
- 修复拍卖的保留价不能高于一口价(否则按一口价买下会低于保留价成交)
- 修复超长自定义物品名称不再把领取箱通知里的对方名字与数量挤掉
- 优化控制台
/sa remove立即更新本服市集快取;成交均价快取有上限 - 兼容安全审查结论:每笔交易为单一数据库交易加条件更新,跨服同时抢购只成交一次;出价与结算有版本校验;领取箱每笔只领一次;金额全部有限且有上限;16 执行绪并发搶購与金钱 守恒单元测试通过
- 兼容装了跨服背包同步插件时,请把
notify.join-delay-seconds设得比它套用背包的时间长(设置文件已加说明)
首个版本
- 新增三种交易方式:一口价(整批或零买)、拍卖(整批竞拍)、收购单(预付货款,别人把物品卖给你)
- 新增上架:指令
/sa sell、/sa auction、/sa order,或上架菜单/sa list(可一次放入多组同种物品,Shift 点击放入,关闭时物品退回);价格支持1.5k、2w、3万 - 新增一口价零买按「已卖 + 本次」的累计总额四舍五入,一个一个买的总花费刚好等于整批价格;单价低于货币最小单位时自动改为只能整批购买
- 新增拍卖:出价先扣款冻结、被超过自动退回领取箱、最低加价(百分比与固定值取较大者)、防狙击延时、一口价、保留价、最近 5 次出价
- 新增收购单:样品比对(名称、附魔、耐久、数据都要相同)、发布时预付 单价 × 数量、到期或取消时退回没用完的预付款
- 新增领取箱:所有给玩家的东西都先进领取箱,永不过期;收入自动入帐、买到的物品直接进背包、背包满了留在箱子里;每一笔只领一次,关服与断线都不会丢
- 新增逛市集:分类(
categories.yml,一件物品可属于多个分类)、类型筛选、六种排序、搜索(中文物品名、自定义名称与 1.20.5+item_name、说明、附魔、玩家、#编号)、近 N 天成交均价 - 新增确认购买会锁定第一次按下时的价格:卖家在两次点击之间改价就不成交,要重新确认;
confirm-purchase: false时市集里 Shift + 左键直接整批买下 - 新增我的上架:改价(调高价格补交手续费差额)、下架、全部下架;商品时间到了由系统结算,不能再下架;交易记录菜单
- 新增四种货币:Vault 金币、PlayerPoints 点券、物品货币(
/sa currencyitem把手上的物品设为货币)、经验等级;小数位数、使用权限、单笔金额上限(整数货币 2147483647),超过时提示「金额太大了」 - 新增权限组:一口价 / 拍卖 / 收购单上架上限、交易税、上架手续费(固定 + 百分比);
starauction.limit.<数量>单独提高一口价上限 - 新增交易规则:每种货币的价格范围、个别物品价格上下限(支持通配)、黑名单(材质、文字、CustomModelData、PDC 键、耐久),检查潜影盒 / 箱子 / 木桶 / 收纳袋里的物品,嵌套最多 8 层;上架冷却、创造模式与禁用世界限制,以及对应的免除权限
- 新增管理:
/sa remove <编号|玩家>强制下架(玩家名 = 下架他的全部商品,物品与出价退回、手续费退 还)、市集中 Shift + 右键强制下架、/sa log操作记录、/sa trades最新成交 - 新增SQLite(单服)与 MySQL / MariaDB(跨服),内置 HikariCP 连接池;事件表同步(默认每秒)、每笔交易只成交一次、各子服经济不需互通、通知送到玩家所在的子服
- 新增九个菜单全部可在
menus/*.yml自定义:格位、材质、说明、状态外观、item-model、提示框样式、头颅、自定义动作按钮 - 新增云界面 CloudUI 市集画面:装了云界面时
/sa打开全屏画面(分类、类型分页、搜索、排序、商品卡片、详情与购买 / 出价 / 卖给他 / 下架),二次确认锁定金额,CloudUI 之后安装或重载也会自动接上;无法显示的玩家自动改用箱子菜单 - 新增提示:卖出 / 被超过 / 拍得 / 收购到货 / 到期 / 被下架的跨服通知,上线提示领取箱,卖出标题与音效,新商品全服公告,Discord Webhook
- 新增PlaceholderAPI 变量:上架数、上限、领取箱、权限组、交易税、累计卖出与收入、全服商品数
- 新增开发者 API
StarAuctionAPI与AuctionListEvent、AuctionPurchaseEvent、AuctionBidEvent、AuctionTradeEvent四个事件 - 新增支持 Paper / Purpur / Folia 1.20 – 26.x