跳到主要内容

安装与授权

下载与授权（免费）​

  1. 打开 资源中心，注册并登录。
  2. 在 StarAuction 星月市集 点「免费领取」，永久授权码会加入你的会员中心。
  3. 打开详情，下载最新的 StarAuction-<版本>-簡體授權版.jar。
  4. 同样在资源中心领取并下载 StarMail 星月邮箱（1.1.0 以上，也是免费的）：星月市集把买到的物品、卖出的收入、退回的东西都寄到星月邮箱。

运行环境​

项目要求
服务端Paper / Purpur / Folia 1.20 – 26.x（同一个 jar）
Java17 或以上（服务端版本本身的要求照常，例如 1.20.5+ 需要 Java 21、26.x 需要 Java 25）
前置插件StarMail 星月邮箱 1.1.0 以上（必装），见 星月邮箱寄送
数据库默认 SQLite（单服，不用设置）；多个子服要跨服时改用 MySQL / MariaDB，见 跨服设置 与 数据库
可选：Vault + 经济插件金币货币（type: vault）
可选：PlayerPoints点券货币（type: playerpoints）
可选：PlaceholderAPI变量（上架数、邮箱待领取、上限、累计收入…）
可选：云界面 CloudUI/sa 改用全屏的市集画面，画面文件自动安装，见 云界面市集
不支持Spigot（需要 Paper 系服务端）

物品货币（type: item）与经验等级（type: exp）不需要任何插件。

实机测试：Paper 1.21.11（单服；两台子服共用 MySQL、各自独立的经济插件跨服交易；云界面画面）。

全新安装​

  1. 把 StarMail-<版本>.jar 与 StarAuction-<版本>.jar 一起放进 plugins/，启动服务器。
  2. 打开 plugins/StarMail/token.yml 与 plugins/StarAuction/token.yml，分别填入两个插件的授权码，重启（首次启动自动绑定本机）。
  3. 进游戏输入 /sa，打开市集就成功了；/sa stash（或 /sm）打开星月邮箱。接着照 快速上手 上架第一件商品。
一定要先装星月邮箱

没装星月邮箱、星月邮箱没启用，或版本低于 1.1.0 时，星月市集不会启动，控制台显示：

[StarAuction] 星月市集需要星月邮箱 StarMail 1.1.0 以上（没有安装）：买到的物品与卖出的收入都会寄到星月邮箱。请安装 / 更新 StarMail 后重启，星月市集已停用

括号里会写出原因：「没有安装」「没有启用」或「版本 … 太旧」。装好或更新星月邮箱后重启即可。 星月邮箱装好了但授权还在验证时，市集照常运作，要寄的东西会等星月邮箱准备好再寄出。

开服时控制台会列出能用的货币，例如：

[StarAuction] 数据库已连接：SQLite data.db
[StarAuction] 市集已载入 0 件上架中的商品
[StarAuction] 可用货币：money(Vault:CMIEconomy)、points
[StarAuction] 授权验证通过（机器码 …）
[StarAuction] StarAuction 授权已生效，市集功能已开启

出现「这些货币的插件没有装或还没载入，暂时不能用」时，表示对应的 Vault 经济插件 / PlayerPoints 没有装，那种货币暂时不能用来上架。没有要用的货币可以在 config.yml 里删掉或加上 enabled: false，见 货币。

单服到这里就装好了。有好几个子服、想让玩家在任何子服都能买卖，再看 跨服设置。

还没填授权码时

插件会正常启动，已经上架的商品与还没寄出的东西都不受影响（到期的商品照常结算，退回的东西寄到星月邮箱），但市集功能处于锁定状态： /sa 指令只会提示「星月市集尚未授权，市集功能暂时关闭」（/sa reload 与 /sa version 除外），PlaceholderAPI 变量显示为空，其他插件调用 API 时 ready() 为 false。 填好授权码后重启即可；如果是开服时连不上授权服务器，插件会每 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数据库、跨服、货币、上架规则、权限组、价格范围、黑名单、星月邮箱寄送、提示、菜单、Webhook，见 config.yml
messages.yml所有提示文字与寄到星月邮箱的邮件文字，见 messages.yml
categories.yml市集分类（名称、图示、条件），见 逛市集
menus/*.yml箱子菜单：market、categories、buy、bid、fill、create、mine、history（另有 1.1.0 起不再使用的 stash），见 菜单
item-names.yml（选填，自己建立）补充或修改搜索用的中文物品名称，见 逛市集
data.dbSQLite 数据库（使用 MySQL 时不会用到）
token.yml授权码

装了云界面 CloudUI 时，画面文件会装进 plugins/CloudUI/screens/starauction/ 与 plugins/CloudUI/images/market/，见 云界面市集。

升级​

  1. 关服，备份 plugins/StarAuction/（使用 MySQL 的话也备份数据库）。
  2. 删掉旧的 JAR，放入新的 StarAuction-<版本>-簡體授權版.jar。从 1.0.x 升级到 1.1.0 时，同时装好 StarMail 星月邮箱 1.1.0 以上。
  3. 开服。商品、成交记录、设定与授权码都会保留。
从 1.0.x 升级到 1.1.0

1.1.0 起「领取箱」由星月邮箱取代。开服时：领取箱里还没领的东西自动寄到每位玩家的星月邮箱；config.yml 末尾自动加上 mail: 段；messages.yml 与菜单文件里默认的「领取箱」字样自动改成星月邮箱（你自己改过的文字不动）。 跨服时，每个子服的星月邮箱要连同一个 MySQL，见 跨服设置。详见 星月邮箱寄送 · 升级。

升级时设定文件的处理方式：

文件新版本新增的项目
config.yml不会写进你现有的文件（唯一的例外是 1.1.0 自动加上的 mail: 段）。没写的项目直接使用默认值，功能照常；想调整就自己把键加进去（键名与默认值见 config.yml）。
messages.yml不会写进你的文件，但缺少的提示文字会自动使用内置的默认文字，不会出现「Missing message」。想改那一句时再把键加进去。
categories.yml、menus/*.yml你的文件保持不变。想要新版的默认样子：把文件改名或删除，执行 /sa reload，会重新生成默认文件。

每个版本改了什么见 更新记录。

最后于 更新