跳到主要内容

变量

安装 PlaceholderAPI 后，星月市集会自动注册下面的变量（不需要 /papi ecloud download）。 开服时控制台会显示「PlaceholderAPI 变量已注册：%starauction_listings% / %starauction_stash% / …」。

一览​

变量内容例子
%starauction_listings%玩家上架中的商品数（一口价 + 拍卖 + 收购单）7
%starauction_listings_sell%上架中的一口价数4
%starauction_listings_auction%进行中的拍卖数2
%starauction_listings_order%进行中的收购单数1
%starauction_limit%一口价上架上限（含 starauction.limit.<数量>）25
%starauction_limit_auction%拍卖上限6
%starauction_limit_order%收购单上限10
%starauction_stash%等着玩家领的东西：星月邮箱里附件还没领的邮件数 + 市集还没寄出的笔数3
%starauction_stash_items%市集还没寄出的物品件数（所有物品笔数的数量加总；寄出后变回 0）0
%starauction_stash_money%市集还没寄出的款项笔数0
%starauction_group%所在的权限组名称vip
%starauction_tax%一口价交易税（%）2
%starauction_sold%累计卖出几笔（所有货币合计；卖给收购单也算）56
%starauction_earned_<货币ID>%用这种货币累计的税后收入，例如 %starauction_earned_money%、%starauction_earned_points%125,300.50
%starauction_market%全服上架中的商品总数（不需要玩家）1024

什么时候更新​

变量来源
listings*、market直接读取内存中的市集，即时；跨服时在 sync.interval-ms（默认 1 秒）内更新
stash*「还没寄出」的部分读取快取，有变动（包括别的子服的交易）或寄出时自动重新读取，第一次读取时在背景查询，可能先显示 0；「邮箱待领取」的部分读取星月邮箱的快取
limit*、group、tax每次即时计算玩家的权限
sold、earned_*从成交记录统计，快取 60 秒

这些变量都不会在主线程查询数据库，放在计分板、TAB 列表里频繁刷新也没有负担。

注意​

  • limit*、group、tax 只对在线玩家有效，离线时为空。其他玩家变量离线也可以用。
  • 1.1.0 起东西都寄到星月邮箱，成交后通常几秒内就寄出，所以 stash_items、stash_money 平常是 0，只有星月邮箱暂时不能用时才会累积。
  • %starauction_stash% 里「邮箱待领取」的部分是星月邮箱所有附件没领的邮件（不只是市集寄的），而且只对在线玩家有数字；离线时只算市集还没寄出的笔数。只想看邮箱本身可以用星月邮箱的 %starmail_unclaimed%。
  • 授权还没验证通过时，所有变量显示为空。
  • sold 与 earned_* 统计的是成交记录，受 cleanup.trade-days（默认保留 365 天）影响：超过保留天数的成交不再计入。
  • earned_ 后面的货币 ID 区分大小写，要和 config.yml 里的货币段名完全一样。

使用范例​

计分板显示市集状态：

&f✦ 上架：&b%starauction_listings%&7/&b%starauction_limit%
&f✦ 邮箱待领：&6%starauction_stash%
&f✦ 累计收入：&e%starauction_earned_money%

菜单插件里的市集按钮：用 %starauction_stash% 是否大于 0 当条件，有东西待领时换一个发光的图标，点击执行 sa stash（打开星月邮箱；条件的写法依你的菜单插件而定）。

最后于 更新