跳到主要内容

常见问题

指令​

输入 /sa 或 /ah 打开的不是市集？/ 和别的插件指令冲突？​

星月市集的主指令是 /starauction，/sa、/ah、/market 是别名。服务器上如果有别的插件也注册了同样的指令，原本会由服务器决定交给谁。 星月市集为此提供了 config.yml 的 command-aliases（默认 [sa, ah, market]）：玩家输入列表里的指令时，一律交给星月市集。

  • 想把 /ah 让给别的插件：从列表里拿掉 ah。
  • 控制台不受这个设定影响，冲突时请在控制台写 starauction。

见 config.yml。

玩家没有权限打开市集？​

starauction.use 默认所有人都有。如果被权限插件拿掉了，加回来：lp group default permission set starauction.use true。全部节点见 权限。

上架​

提示「创造模式不能交易」？​

默认 listing.block-creative: true，防止用创造模式刷物品卖钱。切到生存模式，或给需要的人 starauction.bypass.creative。

提示「这种货币现在不能用（服务器没有装对应的插件）」？​

那种货币需要的插件没装或没载入：vault 要 Vault + 经济插件，playerpoints 要 PlayerPoints。开服时控制台会列出「可用货币」与「暂时不能用」的货币。 不打算用的货币，在 config.yml 里删掉那一段或加上 enabled: false；默认货币不能用时会自动改用第一种能用的货币。见 货币。

提示「金额太大了」？​

金额超过了那种货币的单笔上限：点券、物品货币、经验等级最多 2147483647，金币最多 10 万亿。这个上限保护插件与经济插件不会因为溢出变成负数，任何权限都不能免除。 注意一口价检查的是整批总价（单价 × 数量）。见 货币 · 单笔金额上限。

提示「单价低于 1 点券，这件商品改为只能整批购买」？​

零买的单价比货币的最小单位还小（例如 64 个物品卖 10 点券，单价 0.16 点），零买会被四舍五入成 0，所以自动改成只能整批买。想让买家零买，请把总价提高到「每个至少 1 点券」。见 一口价。

提示「这个物品不能上架（盒子里有…）」？​

潜影盒、箱子、木桶、收纳袋里面装着黑名单物品（嵌套的也会检查，最多 8 层）。把里面的东西拿出来再上架，或调整 blacklist。见 价格与黑名单。

改价时为什么多扣了钱？​

上架手续费是按价格的百分比计算时，调高价格要补交手续费的差额（提示「价格调高，已补交手续费 …」），避免先低价上架省手续费再改高价。调低不退。 手续费默认是 0，这种情况只会在你设了 listing-fee.percent 时发生。见 权限组与费用。

/sa sell 的价格是总价还是单价？​

默认是整批总价（listing.sell.command-price: total）。想让玩家输入单价，改成 each。上架菜单的价格输入也跟着这个设定。

购买与拍卖​

按了确认购买却提示「价格或出价刚刚变动了」？​

卖家在你两次点击之间改了价（或有人先买走了一部分）。星月市集第一次按下时会记住价格，价格变了就不会用新价格成交——请看清新价格再确认一次。见 逛市集 · 确认购买。

拍卖为什么不能下架？​

默认已经有人出价的拍卖不能下架、不能改起拍价（listing.auction.allow-cancel-with-bids: false），保护出价的玩家。想允许下架就改成 true（下架时最高出价退回）。管理员的 /sa remove 不受限制。

商品时间到了，为什么不能下架？​

时间到了的商品由系统结算（一口价退回剩下的物品、拍卖交给最高出价者），不能再手动下架。每 10 秒结算一次，稍等一下东西就会寄到你的星月邮箱。

出价被超过了，钱去哪了？​

原数寄回你的星月邮箱（一封「出价被超过」的邮件，附件就是那笔钱），并提示「你在 … 的出价被超过了，… 已退回 [再出价]」。打开 /sa stash（或 /sm）领取。

钱与物品​

东西卖了，钱没到帐？​

1.1.0 起收入不会自动入帐，而是寄到你的 星月邮箱（一封「卖出收入」的邮件），打开 /sa stash 或 /sm 领取附件才会存进余额：

  • 你当时离线：邮件在邮箱里等你；下次上线后几秒（notify.join-delay-seconds）也会告诉你离线期间卖了什么。
  • 你所在的子服不能用那种货币（例如没装 PlayerPoints）：那封邮件领不了，留在邮箱里，到能用的子服再领。
  • 邮箱里没有：可能星月邮箱暂时不能用（例如授权还在验证），东西在待寄清单里，恢复后自动寄出；%starauction_stash% 会把还没寄出的笔数也算进去。见 星月邮箱寄送。

买到的东西 / 拍到的东西在哪？​

全部寄到你的 星月邮箱：一口价买到的、拍得的、收购单收到的、到期或下架退回的，每一笔一封邮件，/sa stash 或 /sm 打开邮箱领取。 背包放不下时星月邮箱会整封留着，整理背包后再领。

市集寄的邮件默认永不过期（mail.expire-days: 0）。见 星月邮箱寄送。

关服 / 重载的时候东西会不会丢？​

不会。成交与「写进待寄清单」是同一个数据库事务，寄到星月邮箱时每一笔带唯一编号、只会存一封，寄到一半当机也会在开服后重寄；上架菜单里的物品会退回背包；关服时会等还没做完的数据库操作做完再关闭。关服期间到期的商品在开服后结算。

开服时控制台说「星月市集需要星月邮箱 StarMail 1.1.0 以上」，插件停用了？​

1.1.0 起星月邮箱是必装的前置插件。到资源中心领取并安装 StarMail 星月邮箱 1.1.0 以上（免费），确认它有启用，再重启服务器。括号里的「没有安装」「没有启用」「版本 … 太旧」就是原因。见 安装与授权。

跨服时，在 A 服买到的东西在 B 服的邮箱里看不到？​

每个子服的星月邮箱也要连同一个 MySQL（同样的 table-prefix）。星月邮箱各自用 SQLite 时，邮件只存在寄出它的那个子服。见 跨服设置 · 星月邮箱也要跨服。

交易税是谁付的？​

收钱的一方：一口价与拍卖是卖家，收购单是把物品卖给收购单的玩家。税率在上架时就决定，见 权限组与费用。

跨服​

在 A 服上架的商品，B 服看不到？​

依序检查：

  1. 两边的 /sa version 是不是都显示 MySQL？显示 SQLite 表示那个子服还在用自己的 data.db。
  2. 两边的 database 设定（地址、数据库名称）与 table-prefix 是不是完全一样？前缀不同就是不同的表格，互相看不到。
  3. 改了数据库设定之后有没有重启？/sa reload 不会重新连接数据库。

同步有 sync.interval-ms（默认 1 秒）的延迟，属于正常。详见 跨服设置。

各子服的经济不互通，可以跨服交易吗？​

可以。钱只在玩家自己在线的子服、从他自己的帐户扣或存，卖家的收入寄到星月邮箱，在他领取的那个子服存入。见 跨服设置 · 经济。

市集里的商品显示成屏障「物品资料无法读取」？​

那件商品是在更新版本的子服上架的，这个子服的 Minecraft 版本比较旧，读不懂。共用数据库的子服请使用相同的 Minecraft 版本，见 跨服设置。

其他​

装了云界面 CloudUI，/sa 打开的画面不一样？​

是的。装了云界面时 /sa 打开全屏的市集画面；拒绝资源包的玩家、基岩版玩家仍然打开箱子菜单。不想用画面，把 config.yml 的 menu.cloudui 改成 false 再 /sa reload。见 云界面市集。

搜索中文找不到某个物品？​

内置的中文名称只包含常用物品。在 plugins/StarAuction/item-names.yml 写 物品ID: 中文名 补充，/sa reload 后新上架的商品就能用这个名字搜到。见 逛市集 · 中文物品名称。

支持 Folia 吗？​

支持。Paper、Purpur、Folia 1.20 – 26.x 都可以使用同一个 jar。

可以从别的市集插件导入商品吗？​

目前没有导入功能。建议在旧插件里让玩家先下架商品、领完东西，再换成星月市集。

还没填授权码 / 连不上授权服务器会怎样？​

商品与还没寄出的东西完全不受影响（照常寄到星月邮箱），只是市集功能暂时锁定（/sa 会提示尚未授权）。连不上时每 60 秒自动重试，连上就立即开启，不需要重启。排查方法见 安装与授权。

怎么备份？搬服要带走什么？​

见 数据库 · 备份与搬服。

最后于 更新